Configuring My Invoices
With the The My Invoices widget, people who are logged in can see all of their invoices from the past 360 days and pay remaining balances. See the Quick Start Guide to empower your people to connect with you when they need to most.
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
- Target URL
- This is the URL of the webpage that has your Invoice Details & Payment widget. This directs the person that is logged in to the widget so they can pay an outstanding balance.
- Attribute: targeturl
- Valid Value: a fully qualified URL
- Example:
targeturl="https://example-church.com/invoicedetails"
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-invoices targeturl="https://example-church.com/invoicedetails"></mpp-my-invoices>Optional Attributes
- Key Word
- This filters the result using keywords. Keyword search looks for a match in the invoice title, status, or product name, so use your keyword attribute strategically.
- Attribute: keyword
- Valid Value: any keyword
- Month
- This filters by a month ID
- Attribute: monthid
- Valid Value: 1 to 12 (1 = January)
- Invoice Status
- This filters by invoice status ID. The default is empty.
- Attribute: invoicestatusid
- Valid Value: invoice status ID (or empty)
- Hide Free Events Checkbox
- This determines whether you include $0 invoices. The default is false.
- Attribute: hidefreeeventscheckbox
- Valid Value: true or false (or empty)
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
Event: Add an image to your event record to help people select their invoices at a glance.
Product: The product name displays on the invoice card, so make sure your product names are clear. If your event doesn't have an image, add to one to the product record.
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 the "Pay Balance" button to say "Make a Payment"? 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-checkout.invoicePayNowButtonLabel: The label on the button someone clicks to pay an outstanding balance. The default is "Pay Balance."
- mpp-my-invoices.pageTitle: The title at the top of the page. The default is "My Invoices."
- mpp-my-invoices.pleaseLoginMessage: The message a person sees inviting them to log in to see their invoices. The default is "Please login to view your invoices."
- mpp-my-invoices.noInvoicesFoundMessage: The message someone who's logged in sees if they do not have any invoices in the past 360 days. The default is "You currently do not have any invoices."