Configuring RSS Feeds
Quick Start
The RSS Feed Widget is a simple, high-impact addition to your Church's website. See the Quick Start Guide to get it up and running in just a few steps.
If the shared script hasn't been added to your website, add it to the appropriate webpage, replacing "yourbaseministryplatformURL" with the base URL with your base MinistryPlatform URL.
<script id="MPWidgets" src="https://yourbaseministryplatformURL.com/widgets/dist/MPWidgets.js"></script>Add the RSS Feed Widget to your church website by placing this snippet of code in the body of your chosen webpage.
<mpp-rss-reader publicationname="GeneralAnnouncements"></mpp-rss-reader>Widget Configuration
Required Attributes
- Publication Name: Specifies the publication that will populate this feed.
- Attribute: publicationname
- Valid Value: Value from the Name field on the Publication record (no spaces)
- Example:
publicationname="PrayerDevotion"
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
Any Publication is eligible to display as an RSS Feed. A list of all Publications can be found in one of two places:
- Platform: In the navigation menu, click .
-
API: Append your church's URL with the Publications.svc endpoint (for example,
https://yourchurch.com/ministryplatformapi/publications.svc/).
Messages will display in a configured RSS Feed when they meet the following criteria:
- Associated with the Publication through the interim Publication Messages Page.
- Today's date is equal to or greater than the Start Date.
- Today's date is less than the Expire Date.
Review your publication and message to make sure it displays in the RSS Feed widget as expected.
- Ensure each publication has the name you want to show. This value should have no spaces. The name is different than the title, and may display as the last field on the record.
- Ensure a message is added to the publication on the Messages tab. Tip: Be sure the Template field is set to Yes.
- Ensure that the message in the publication have a Start Date in the past and a Status of Sent.
- Ensure that the message has an End Date in the future.
Customization
Each RSS Feed Widget displays the content stream for a single Publication. Want to include more than one Publication? Add more RSS Feed Widgets to the page you want.