Configuring Mission Trip Finder
Set up the Mission Trip Finder widget so people can find trips more easily.
The Mission Trip Finder widget works with the Mission Trip Details 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.
Widget Configuration
Required Attributes
- Mission Trip Campaign Type
- This determines which pledge campaigns display in the widget.
- Attribute: missiontripcampaigntypeid
- Valid Value: Campaign Type ID
- Example:
missiontripcampaigntypeid="7"
- Target URL
- This is the URL of the webpage that has your Mission Trip Details widget. This is required for your widget to work correctly. When you select a specific mission trip, the ID is added to this URL.
- Attribute: target or targeturl
- Valid Value: relative or fully qualified URL
- Examples:
targeturl="https://example-church.com/trip-details"targeturl="/trip-details"
Configure Your Widget
- Go to your Widgets Library by appending "/widgets" to your system domain. For example,
https://example-church.ministryplatform.net/widgets. - Click the Navigate to... drop-down menu, and select Widget Configurator.
- Select the widget you want to configure, then customize your widget.
- Click Try it Out to see what your widget will look like!
- Copy the generated code from the Embed Code box.
- Add the code to the designated page on your website.
Platform Configuration
Mission Trip Criteria
- The Pledge Campaign associated with the trip must have a Campaign Type set to the type specified for the Mission Trip Campaign Type option in the widget configuration.
- The Pledge Campaign record has Allow Online Pledge set to Yes.
- The Pledge Campaign record has Event set to the mission trip.
- The mission trip's Event record has an End Date in the future.
- The mission trip's Event record has been approved, meaning both Approved and Web Approved are set to Yes on the event record.
- To display the appropriate ministries in the Ministries drop-down list to filter trips, set Available Online to Yes in the Ministry record.
Other Considerations
- Want to share mission trips between campuses or parishes? You can set the COMMON, GlobalCongregationID configuration setting, and the Mission Trip Finder sees it as a church-wide congregation.
- If more than 100 trips 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 Pledge Campaign 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 Mission Trip Finder widget? Maybe change the "Campus" label to a "Congregation" label? To make changes, go to and update the appropriate label(s). Note that you are responsible for all translations if the default is not used.
- mpp-mission-trip-finder.congregationLabel: The label for the Congregation drop-down filter. The default is "Campus".