home

MinistryPlatform

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

MinistryPlatform and PocketPlatform guides, answers, and development resources.

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

My Pledges

Configuring My Pledges

Quick Start

Help people visualize and manage their current pledges. See the Quick Start Guide for tips on getting the My Pledges Widget up and running.

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>

Create a webpage on your website that will display your My Pledges Widget or identify the page on your website where it will be displayed.

Add the My Pledges Widget to your church website by adding following snippet of code in the body of your chosen website page, modifying the required attributes.

<mpp-my-pledges></mpp-my-pledges>
Tip: While not mandatory, this snippet would typically be placed inside a <div> element with the class "container".

Widget Configuration

Optional Attributes

  • Hide Cancel Button: Determines whether the option to cancel an active pledge displays. Default is true.
    • Attribute: hidecancelbuttonpledge
    • Valid Value: true (or empty) or false
    • Example:
      ​hidecancelbuttonpledge="true"
  • Cancel Pledge Email Template: Confirmation email sent after a user successfully cancels an active pledge.
    Note: If hidecancelbuttonpledge = false, then you must set this value.
    • Attribute: cancelpledgeemailtemplate
    • Valid Value: Message record ID (dp_Communications.Communication_ID)
      Note: The cancel pledge email comes from a Message, not a Message Template. Similar names but very different things.
    • Example:
      cancelpledgeemailtemplate="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-my-pledges hidecancelbuttonpledge="false" cancelpledgeemailtemplate="1200"></mpp-my-pledges>
Note: This widget is only available to users who have authenticated via the Login Widget. New users have the opportunity to create an account through the Login flow. If needed, the page containing this widget could be added as a navigation item in the Login menu, making it available only after authentication. See Login Configuration for information about extending the drop-down menu.

Configure Your Widget!

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

Platform Configuration

Pledges are eligible to appear in My Pledges whenever they meet the following criteria:

  • Today's date is less than the End Date or the End Date is undefined.
  • The Show On My Pledges field on the Pledge Campaign record is set to Yes.
Note: Pledges that are Active or Completed will continue appearing for six months after the Campaign End Date. If an image is attached to the Pledge Campaign in the Platform, it will be displayed. If there is no image, a stock image will be displayed. File formats supported both by browsers and the Platform 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.

Customization

All Widgets are customizable, so change the button color and update the labels to match YOUR church!

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

Application Labels: Call them Gifts or Donations instead of Pledges? 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-my-pledges.pageTitle: Page title. Default is "My Pledges".
  • mpp-my-pledges.cancelPledgeButtonText: Text on the Cancel Pledge button. Default is "Cancel Pledge".
thumb_upYes thumb_downNo

portal
MinistryPlatform

Last updated: March 25, 2025

Related Articles: