Configuring Event Details & Registration
Set up the Event Details & Registration widget so people can find the events they want to attend.
The Event Details & Registration widget works with the Event Finder widget. Use both to help people find the event they want to attend. Then the Invoice & Payment widget summarizes the transaction and sends it to the payment vendor. See Quick Start to get these up and running.
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
- Return URL
- This is the URL of the webpage that contains your Event Finder widget. This is required for your widget to work correctly.
- Attribute: returnurl
- Valid Value: relative or fully qualified URL
- Examples:
returnurl="https://www.example-church.com/events"returnurl="/events"
- Checkout Target URL
- The navigation path to the Invoice & Payment widget. This attribute provides a summary of the invoice and total amount due. Double-check to make sure you're working with one of our verified vendors so people can register for your events!
- Attribute: checkouturl
- Example:
checkouturl="https://www.example-church.com/index.php/checkout/"
Optional Attributes
- Opportunity Finder Target URL
- The navigation path to Opportunity Finder when someone clicks the Volunteer button for an opportunity. The event ID is added to this path to filter for the specific event. The button only displays for others if you've configured this attribute and at least one opportunity is linked to the event using the Add to Event field on the opportunity record. If you don't want the button to display, you can skip this attribute.
- Attribute: opportunityfinderwidgettargeturl
- Valid Value: relative or fully qualified URL
- Example:
opportunityfinderwidgettargeturl="https://www.example-church.com/volunteer/"
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
To select events in the Event Detail & Registration widget, the events must meet the following criteria:
- Today's date is on or before the start date.
- The event's start date is is within the next 120 days for regular events or within 360 days for featured events.
- Your event has been approved.
- The Visibility is set to one of the following:
- 2- Staff Only: Visible only for those logged in with at least one current group participant record with Employee Role set to Yes.
- 3- Staff & Church: Visible to anyone without logging in. The difference between Staff & Church and Public visibility depends on how you use them internally for views, filters, and/or reports.
- 4- Public: Visible to anyone. Tip: Is your event set to 5- Hidden: URL Required but you still need to share a link to it? You can use this format to create the link:
[URL of the Event Details widget]/?id=[Event_ID]
This widget supports basic HTML text formatting (bold, italics, underline, unordered lists, ordered lists, and hyperlinks) for the event meeting instructions and description. You can format the text in the Meeting Instructions field and/or the Description field on the Event record. This field prevents unsupported HTML tags from displaying in the widget. While other formatting options may work, we do not guarantee or recommend using them.
Events
- Title
- The name of the event.
- Date & Time
- The event's start and end date and time.
- Event Contact
- The event's primary contact. If there is an image attached to the primary contact's contact record, it will display.
- Meeting Instructions
- Any instructions to include for the event meeting.
- Location
- The place the event will occur. If there is a latitude and longitude associated with the location, a map will display.
- Event Registration
- The online registration product and registration form associated with the event.
- External Registration URL
- If there is a value in this field, a Register button will display. Clear this field to hide this button.
- Force Login
- If set to Yes, no registration options will display until the person logs in.
Registration Considerations
- Product Option Group Note Label
- This note label displays before each option price.
- mpp-event-details.freePriceLabel
- This application label displays as the "price" for free events. The default is "Free".
- Payment Vendor
- Select your payment vendor to process transactions and no longer use an Authorize.net account. Important: To use this widget, you must work with one of our verified vendors. See our list of verified vendors. If you don't already work with one, reach out to get started.
Registrations create payment details, invoice, invoice detail, and payment records.
Event registration respects the maximum quantities on required option prices. If a required option group exists and all options within it have reached their maximum, registration will not be available.
Customization
Customize the Event Details & Registration widget to match your branding.
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 to change "Register" to "Sign Up"? 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-event-details.registerButtonText: The text on the register button. The default is "Register".
- mpp-event-details.registrationAddressLabel2: The Address Line 2 field label. Perhaps "Apt. or Suite #" suits you better? The default is "Address Line 2".