home

MinistryPlatform

RealmMinistryPlatformPDSACSAccountingGivingConnectShepherdGrowth MethodGo MethodMissionInsiteGatherHeadMaster ChildcareTrust Center
RealmMinistryPlatformPDSACSAccountingGivingConnectShepherdGrowth MethodGo MethodMissionInsiteGatherHeadMaster ChildcareTrust Center

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

Event Finder

Configuring Event Finder

Set up the Event Finder widget so people can find events more easily.

The Event Finder widget works 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 "YOUR-BASE-MP-URL" with the base URL with your base MinistryPlatform URL.

<script id="MPWidgets" src="https://YOUR-BASE-MP-URL.com/widgets/dist/MPWidgets.js"></script>

Create or identify a page on your website where you want to display the widget. To add this widget to your church website, add the code you generate in the Widget Configurator widget (with the required attributes) in the body of your chosen website page.

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 has your Event Details widget. This is required for your widget to work correctly. When you select a specific event, the ID is added to this URL.
  • 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 someone clicks See Details, they can be directed to the Event Details & Registration widget. While custom pages may seem successful when you use other URLs, we can't guarantee this success. The only supported target values are the Event Details & Registration widget or the Portal Event Details page.

Configure Your Widget

Use the Widget Configurator widget to configure your widget:
  1. Go to your Widgets Library by appending "/widgets" to your system domain. For example, https://example-church.ministryplatform.net/widgets.
  2. Click the Navigate to... drop-down menu, and select Widget Configurator.
  3. Select the widget you want to configure, then customize your widget.
  4. Click Try it Out to see what your widget will look like!
  5. Copy the generated code from the Embed Code box.
  6. Add the code to the designated page on your website.

Platform Configuration

Event Criteria

To select events in the Event Finder widget, the events must meet the following criteria:
  • To display the appropriate ministries in the Ministries drop-down list to filter events, set Available Online to Yes in the ministry record.
  • The online registration product is set on the event record, even the event is free.
  • Today's date is on or before the event's start date.
  • The event's start date is within 120 days for regular events or within 360 days for featured events.
  • The Event Approval process is included and configured during installation. This process is a one-step process that assigns an approval task to a specific MinistryPlatform staff member. A SPoC may alter the process or create new processes at any time as needed.
  • The event has been approved, meaning both Approved and Web Approved are set to Yes on the event record.
  • The visibility level is one of the following:
    • 2- Staff Only: Visible only for those logged in with at least one current group participant record where Employee Role is set to Yes.
    • 3- Staff & Church: Visible to anyone without logging in. The difference between Staff & Church and Public visibility depends on how you use them internally for views, filters, and/or reports.
    • 4- Public: Visible to anyone.
Note: Events with a Hidden visibility level do not display in the Event Finder widget, but they are visible through a direct URL.

Other Considerations

  • Want to share events between campuses? You can set the COMMON, GlobalCongregationID configuration setting, and the Event Finder sees it 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, only the first 100 will display, 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 will display. File formats supported by both browsers and MinistryPlatform are: .bmp, .gif, .jpg., and .png. The widget software 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

CSS: Every widget accepts the Custom CSS attribute. Include it before the closing of the opening widget tag to customize backgrounds, button colors, and more!

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: The label for the Congregation drop-down filter. The default is "Campus".
  • mpp-event-finder.congregationPlaceHolderText: The label for the drop-down value of all congregations or parishes. The default is "Any Campus".
portal
MinistryPlatform
Widgets

Last updated: November 24, 2025

Related Articles: