Configuring Opportunity Details
Set up the Opportunity Details widget.
The Opportunity Detail widget works with the Opportunity Finder widget. Review Quick Start for how they work together and to get them both 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
- The URL where the Opportunity Finder widget is on your website. This is required for the Opportunity Detail widget to work correctly.
- Attribute: returnurl
- Valid Value: relative or fully qualified URL
- Examples:
returnurl="https://www.example-church.com/opportunities"returnurl="/opportunities"
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 display in the Opportunity Details widget, opportunities must meet the following criteria:
- Today's date is the publish date or later.
- Today's date is before than the opportunity date (if defined).
- The ministry associated with the opportunity must have Available Online set to Yes. Tip: To determine which ministry is associated with the opportunity:
- Find the program associated with the opportunity on the opportunity record.
- Click the jumplink next to the program name to go to the program record.
- Find the ministry name on the program record.
-
The visibility level is either:
- 2- Staff Only: This is visible only for people logged in with at least one current group participant record where Employee Role is set to Yes (belonging to any group of any group type).
- 4- Public: This is visible to anyone.
- The total number of placed responses is less than the maximum needed. An opportunity is removed from the Opportunity Details widget when the number of placed responses (that is, those with Response Result set to Placed) is equal to or greater than the maximum needed on the opportunity record.
Review your eligible opportunities to ensure they display as expected.
This widget supports basic HTML text formatting (bold, italics, underline, unordered lists, ordered lists, and hyperlinks) for the opportunity description. You can format the text in the Description field on the Opportunity 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.
- Title
- The name of the opportunity.
- When
- The opportunity date. If blank, this is replaced with "Ongoing".
- Description
- A brief description of the opportunity. You may include line breaks.
- Location
- The program's congregation autofills this field.
- Contact Person
- The person responsible for following up with people interested in the opportunity. If configured, they will be notified when there is an opportunity response.
- Remaining Need
- This displays the number of responses still needed. This is calculated as the maximum needed minus the total number of responses (where Response Result is Placed).
- Response Message
- An optional message that can you can send to the interested volunteer.
- Custom Form
- Add your custom form to collect additional information from the person responding to the opportunity, like t-shirt size, food allergies, or age group interest.
Attach a compelling image to the opportunity, which will display in the widget. If there is no image, a stock image will display. File formats supported by both browsers and MinistryPlatform 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. The finder images are 800x433 intrinsically but resized to fit at 295x160.
If you show the attribute filter (so people can filter opportunities by attribute type), make sure you add the appropriate attributes on the Attributes tab of the opportunity record.
Customization
Customize the Opportunity Details widget to change button colors, update labels, and more to match your church brand.
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 the button to "Sign Up" instead of "Submit Response"? 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-opportunity-details.responseButtonText: The text that displays on the response button. The default is "Submit Response".
- mpp-opportunity-details.thankYouMessage: The message that displays after a response is successfully submitted. The default is "Thank you for responding about this opportunity! If needed, use the form below to respond for another household member".
- mpp-opportunity-details.validationFailedMessage: The message that displays after an unsuccessful response. The default is "Some field values are incorrect or missing. Please correct and try to submit the form again."