Your Knowledge Base has moved to the new Help Center.  Check out the release notes for details. And don't forget to update your bookmarks and in-house documentation before May 28.

Configuring My Giving

 

Quick Start

Help people visualize their giving. See the Quick Start Guide for tips on getting the  My Giving 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 Giving Widget or identify the page on your website where it will be displayed.

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

<mpp-my-giving></mpp-my-giving>

<mpp-my-giving
hidesoftcredits="true">
</mpp-my-giving>

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

Widget Configuration

Required attributes are necessary for Widgets to function
  • Hide Soft Credits: Determines whether the option to view soft credit donations is available to the authenticated User. The default is "False."
    • Attribute: hidesoftcredits
    • Valid Values: False (or empty) or True 

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.

Configure Your Widget!

Simply fill out the Widget Configurator below, copy your generated Widget, and paste it into your website. 

Update Configuration Parameters

Setting Name
My Value
Description

Preview & Copy

Platform Configuration

  • Donations appear four years prior through the current day. Future donations will not appear.
  • The My Giving Widget will not display the value of a donation if the "Omit Amount on Statement" field is "True."
  • The donation description itself will still be listed, but the value will be blank.If there are two Heads of Household and both have their Statement Type set to Family, a spouse label will appear next to donations made by the authenticated User's spouse.

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: Want to change the soft credit donation disclaimer? 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-giving.byProgram - Donut Chart label. Default is "By Program."
  • mpp-my-giving.offeringsLabel - Tithes and offerings giving label. Default is "Tithes/Offerings."
  • mpp-my-giving.softDonationsSubtitle  - Soft Credit Donation subtitle. Default is "Soft Credit Donations will not appear on your tax statement as they were given by another entity at your request."