CONTACT USBack to MinistryPlatform Site
Your Knowledge Base has moved to the new Help Center.  Check out the release notes for details. And don't forget to update your bookmarks and in-house documentation before May 28.

Configuring Event Finder

 

Quick Start

The Event Finder widget is used in tandem with the Event Details & Registration and Invoice Details & Payment Widgets for a great experience from start to finish. See Finder Widgets + Details Widgets to learn more about how they interact. And see Quick Start to get started. 

If the shared script hasn't been added to your website, add it to your desired webpage. Be sure to replace "{your platform domain}" in the following code with your church's base MP URL. 

<script id="MPWidgets" src="https://{your website domain}/widgets/dist/MPWidgets.js"></script>

Add the following snippet of code in the body of your chosen website page to create the Event Finder

<mpp-event-finder 
     targeturl="https://{your website domain}/event-details">
</mpp-event-finder>
Tip: While not mandatory, these snippets would typically be placed inside a <div> element with the class "container."

Widget Configuration

Required attributes are necessary for Widgets to function
  • Target URL: The Target Url defines the navigation path to Event Details and is required for your Widget to function correctly. When a specific Event is chosen, the ID is appended to this route. 
    • Attribute: target or targeturl
    • Valid Values: relative or fully qualified URL
target="https://{your website domain}/event-details"
targeturl="https://{your website domain}/event-details"

Important! The Event Finder Widget may be placed on a church website and choosing "See Details" can direct a user to:

While custom pages may appear to be successful when other Urls are used, this success cannot be guaranteed. The only supported target values are the Portal Event Details page or Event Details & Registration Widget.

Configure Your Widget!

Simply fill out the Widget Configurator below, copy your generated Widget, and paste it into your website. 

Update Configuration Parameters

Setting Name
My Value
Description

Preview & Copy

Platform Configuration

  • Events may be selected from the Event Finder Widget whenever they meet the following criteria:
    • The appropriate Campuses Available Online field is set to "True." 
    • The appropriate Ministries appear in drop-down for filtering purposes when their Available Online field is set to "True." 
    • Today's date is equal to or less than the Start Date.
    • The Start Date is within 120 days.
    • For Featured Events, the Start Date is within 360 days.
    • The Event has been approved (meaning both Approved and Web Approved are set to "True.")
    • The following Default Process is included and configured during installation. A SPoC may alter the Process, or create new Processes, at any time as desired: 
      • Event Approval: A 1-step Process that assigns an approval task to a specified User.
    • The Visibility Level is:
      • Staff: Visible only for authenticated users with at least (1) current Group Participant Record where Employee Role = True (belonging to any Group of any Group Type).
      • Staff & Church: Visible to any user without logging in. The difference between Staff & Church and Public visibility is determined by however you might want to use them internally for views, filters, and/or reports.
      • Public: Visible for any user. 
      • Note: Events with a Hidden visibility level will not appear in the Event Finder, but are visible via a direct URL.
  • If "Featured on Calendar" is set to Yes, a "Featured" flag displays in the upper-right corner of the Event's image.
Note: If more than 100 Events are eligible to appear, the first 100 will display along with a prompt to use search filters to narrow results.
 

Attach a compelling image to the Event record so it displays in the widget. If there is no image, a stock image displays. The following file formats are supported by browsers and the Platform: bmp, gif, jpg, and png. The widget software crops and focuses on the center of the image according to an ideal ratio of 59/32. The finder images are 800 x 433 intrinsically but resized to fit at 295 x 160. We do not recommend using images with a transparent background; this results in a gray background in the widget.

Customization

Widgets let you do YOUR church YOUR way, so change those button colors and labels!

CSS: Every Widget accepts the Custom CSS attribute. Include it before the opening Widget tag is closed to customize your Widgets.

Application Labels: Want to customize the Event Finder Widget? Maybe change the "Any Campus" label to an "Any Congregation" label? You can do that! Navigate to System Setup > Application Labels (note that churches are responsible for all translations if the default is not used) and make your update.

  • mpp-event-finder.congregationLabel - Label for the Congregation drop-down filter. Default is "Campus."

  • mpp-event-finder.congregationPlaceHolderText - Label for the drop-down value of all Congregations. Default is "Any Campus."