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 your desired webpage. Be sure to replace "{your platform domain}" in the following code with your church's base MP URL.

<script id="MPWidgets" src="https://{your platform domain}/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 discussed below.

<mpp-my-pledges></mpp-my-pledges>

Widget Configuration

The My Pledges Widget functions without any additional attributes, but you can add optional attributes.

• Hide Cancel Button: Determines whether the option to cancel an active Pledge is displayed. The default is "True."
  • Attribute: hidecancelbuttonpledge
  • Valid Values: true (or empty) or false. 

​hidecancelbuttonpledge="true"

• Cancel Pledge Email Template: Confirmation email sent after a User has successfully cancelled an active Pledge. Note: If hidecancelbuttonpledge = false then this value must be configured.
  • Attribute: cancelpledgeemailtemplate
  • Valid Values: Message ID

cancelpledgeemailtemplate="1200"

All 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). Each attribute's value should be wrapped in quote 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 will also have the opportunity to create an account through the Login flow. If desired, 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.

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 "True."

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? You can update that (and more)! Navigate to System Setup > Application Labels (note that churches are responsible for all translations if the default is not used) and make your update.

• mpp-my-pledges.pageTitle - Page title. Default is "My Pledges."
• mpp-my-pledges.cancelPledgeButtonText - Text on the Cancel Pledge button. Default is "Cancel Pledge."