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

Mission Trip Application

Configuring Mission Trip Application

Set up the Mission Trip Application widget.

See the Quick Start Guide for tips on getting the Mission Trip Application widget up and running.

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

Optional Attributes

Pledge Campaign ID
This determines the mission trip that displays in My Mission Trips.
  • Attribute: pledgecampaignid
  • Valid Value: Pledge Campaign ID (this is the Missions Trip ID)
  • Example: 
    pledgecampaignid="2"

Optional URL Parameter

If you have multiple mission trip applications going on, you can use a URL parameter instead of the pledge campaign ID attribute. So you would add the widget to your website without the pledgecampaignid attribute, then use the parameter of the same name in the URL that you send to applicants.

Pledge Campaign ID
This determines the mission trip that displays in My Mission Trips when you send the link.
  • Parameter: pledgecampaignid
  • Valid Value: Pledge Campaign ID (this is the Missions Trip ID)
  • Example: 
    ?pledgecampaignid=2
Applicant Email Template
The confirmation email sent after someone has successfully submitted an application.
  • Attribute: applicantemailtemplate
  • Valid Value: Message record ID (dp_Communications.Communication_ID) or empty for unspecified
    Tip: This attribute uses a Message ID to send the email. If you don't see your message in the list, you'll need to mark the message to show as an option. If you want to use an existing template, you'll need to convert it to a message first.
  • Merge Fields and Snippets: Personalize your message with Merge Fields! Want to get fancy? You can use snippets in your widget messages. Just add the Domain_GUID and Contact_GUID to the default field list of the table on which the record the widget created.
    1. Open the domain record and copy the Domain GUID.
    2. Open the page record and edit the default field list.
    3. Add Contact_ID_Table.[Contact_GUID] AS [Contact GUID].
    4. Add '<DOMAIN GUID HERE IN QUOTES>' AS Domain_GUID.
    5. Save the default field list.
    6. Ensure your snippet includes both the Domain_GUID and Contact_GUID.
  • Example: 
    applicantemailtemplate="1200"

Attributes must be included before the opening widget tag is closed. Attributes may be listed in any order and should be separated by a space or other whitespace. An attribute's value should be wrapped in quotation marks.

<mpp-mission-trip pledgecampaignid="5" applicantemailtemplate="1200"></mpp-mission-trip>

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

You can configure any pledge campaign for the Mission Trip widget. To display in the widget, the pledge campaign must meet the following criteria:
  • Registration start and end dates are defined, and today's date is between them.
  • The Allow Online Pledge field is set to Yes.
  • The amount of maximum registrants (if defined) has not been reached.
  • The fundraising goal is defined. This will be the total pledge for each applicant.
  • You can associate a pledge campaign with an event. If associated, trip dates from the event record display. Otherwise, the trip dates will be hidden.

This widget supports basic HTML text formatting (bold, italics, underline, unordered lists, ordered lists, and hyperlinks) for the campaign description. You can format the text in the Description field on the Pledge Campaign record. This field prevents unsupported HTML tags from displaying in the widget. While other formatting options may work, we do not guarantee or recommend using them.

Associate a Custom Form with the Mission Trip Application

You may need to gather more information from the applicant during registration. You can create a custom form and attach it to the pledge campaign record.

  1. Create a custom form asking the questions you need to know.
  2. In the navigation menu, click Contributions > Pledge Campaigns.
  3. Open the pledge campaign record.
  4. Click Edit Record.
  5. Add the custom form in the Registration Form field.
  6. Click Save.

Mark a Message to Show as an Option

When configuring your widgets, there are fields where you can select an email template. To keep the list manageable, the messages that display as options must be marked as templates.

If the message you want does not display in the Widget Configurator, you can mark it as a template on the message record. (The Template field is hidden by default through System Setup > Field Management, so you'll need to unhide it first.)

  1. Confirm that the message you want is not an option in the Widget Configurator.
  2. In the navigation menu, click System Setup > Field Management.
  3. In the Field Name column, search for Template.
  4. In the Page column, search for Messages.
  5. Open the record, and click Edit Record.
  6. In the Hidden field, select No.
  7. Click Save.
  8. In the navigation menu, click Communications > Messages.
  9. Open the message you want to display as an option in the Widget Configurator, and click Edit Record.
  10. In the Template, select Yes.
  11. Click Save.
  12. Refresh the Widget Configurator if you had it open in your browser .

You can now select this message as an option when you configure the widget.

Convert a Template to a Message

Widgets use message IDs, not template IDs. You can use the Template Editor Tool to create the template you want, but you must turn the template into a message and use that ID in the widget. Here's how!

  1. Create and save your template using the Template Editor Tool. Make sure you can access the template.
  2. Open the New Message Tool, click Insert > Templates, and select your newly created template from the list. Click Send > Save as Draft.
  3. In the navigation menu, click Communications > Messages.
  4. Open the draft you just created.
  5. Click the subject line to open the message record. The Message ID is listed under the subject line.
  6. Use this ID for the Template ID attribute value when you configure the widget.

Customization

Customize the Mission Trip Application widget to change button colors, update labels, and more to match your church brand.

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: Call them service trips instead of missions trips? Call it trip cost instead of fundraising goal? 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-mission-trip.applyTitle: The application form header. The default is "Apply to this Mission Trip".
  • mpp-mission-trip.goalLabel: The label for the pledge goal. The default is "Goal".
  • mpp-mission-trip.fundraisingGoalLabel: The label for fundraising goal. The default is "Fundraising Goal".
portal
MinistryPlatform
Widgets

Last updated: November 24, 2025

Related Articles: