home

MinistryPlatform

RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

Event Finder

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 the appropriate webpage, replacing "example-church.com" with the base URL of your church's website.

<script id="MPWidgets" src="https://example-church.com/widgets/dist/MPWidgets.js"></script>

Add the following snippet of code (after replacing the required attributes) in the body of your chosen website page to create the Event Finder:

<mpp-event-finder targetURL="https://example-church.com/event-details"></mpp-event-finder>
Tip: While not mandatory, this snippet would typically be placed inside a <div> element with the class "container".

Widget Configuration

Required Attributes

  • Target URL: This is the URL of the webpage that contains your Event Details widget. This 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 Value: relative or fully qualified URL
    • Examples:
      targeturl="https://example-church.com/event-details" targeturl="/event-details"
Important: You can place the Event Finder widget on a church website, and when the user clicks See Details, they can be directed to the Event Details & Registration widget. 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 Event Details & Registration widget or the Portal Event Details page.

Configure Your Widget

Fill out the Widget Configurator below, copy your generated widget code, and paste it into your website.

Platform Configuration

  • Events can be selected in the Event Finder Widget when they meet the following criteria:
    • The appropriate Ministries display in the drop-down list for filtering purposes when their Available Online field is set to Yes.
    • The Online Registration Product is set on the Event record, even if it's a free event.
    • Today's date is on or before the Start Date.
    • The Start Date is within 120 days. Or, for featured events, the Start Date is within 360 days.
    • The following Default Process is included and configured during installation. A SPoC may alter the Process, or create new Processes, at any time as needed:
      • Event Approval: A one-step process that assigns an approval task to a specified user.
    • The Event has been approved, meaning both Approved and Web Approved are set to Yes.
    • The Visibility Level is:
      • 2- Staff Only: Visible only for authenticated users with at least one current Group Participant Record where Employee Role is set to Yes (belonging to any Group of any Group Type).
      • 3- 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.
      • 4- Public: Visible for any user.
    Note: Events with a Hidden visibility level do not display in the Event Finder, but they are visible through a direct URL.
  • Want to share events between campuses? You can set the COMMON, GlobalCongregationID configuration setting, and it is honored in the Event Finder as a church-wide congregation.
  • If Featured on Calendar is set to Yes, a "Featured" flag displays in the upper right of the event's image.
  • If more than 100 events are eligible to display, the first 100 will show, along with a prompt to use search filters to narrow the results.
  • Attach a compelling image to the Event record, which displays in the widget. If there is no image, a stock image is used. File formats supported both by browsers and the Platform are: bmp, gif, jpg, and png. The widget will crop and focus 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.

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? To make changes, go to System Setup > Application Labels and update the appropriate label(s). Note that you are responsible for all translations if the default is not used.

  • 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".
thumb_upYes thumb_downNo

portal
MinistryPlatform

Last updated: March 25, 2025

Related Articles: