CONTACT USBack to MinistryPlatform Site
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 Opportunity Details

 

Quick Start

The Opportunity Detail Widget is used in tandem with the Opportunity Finder Widget. Review Quick Start for how they work together and to get them both up and running.

Note: Because the Opportunity Finder and the Opportunity Details Widgets work together, they must be set up at the same time to function correctly. See Finder Widgets + Details Widgets to learn more about how they interact.

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 Opportunity Details or identify the page on your website where it will be displayed.

Add the Opportunity Details Widget to your church website by placing this snippet of code in the body of your chosen webpage.

<mpp-opportunity-details
     returnurl="/opportunities">
</mpp-opportunity-details>
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 your Widget to function.

Return URL: Defines the path back to the Opportunity Finder and is required for the Opportunity Detail Widget to function correctly. It can be a relative or fully qualified url.

The following are valid examples of the widget using different return URLs:

<mpp-opportunity-details returnurl="https://www.ministryplatform.com/opportunities"></mpp-opportunity-details>
<mpp-opportunity-details returnurl="/opportunities"></mpp-opportunity-details>
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

Opportunities may be selected from the Opportunity Finder Widget whenever they meet the following criteria:

  • Today's date is equal to or greater than the Publish Date. 
  • Today's date is less than the Opportunity Date (if defined).  
  • The Ministry associated with the Opportunity is Available Online = True
  • The Visibility Level is either:
    • Staff: Visible only for authenticated users with at least (1) current Group Participant Record where Employee Role = True (belonging to any Group of any Group Type).
    • Public: Visible for any user. 
    • Hidden Url: Visible to anyone who has been provided a direct link to the Opportunity.
  • The total number of Placed Responses is less than the Max Needed value. 

Review your eligible Opportunities to ensure they display as expected.

  • Title: Opportunity Title.
  • When: Opportunity Date. If blank, this is replaced with "Ongoing." 
  • Description: Opportunity Description. Line breaks are supported.
  • Location: Populated from the Program's Congregation.
  • Contact Person: Individual responsible for following up with people interested in the Opportunity. If configured, they will be notified when there is an opportunity response.
  • Remaining Need: Displays number of Responses still needed. This is calculated as the total number of Responses (which have a Response Result value of "Placed") subtracted from Maximum Needed.
  • Response Message: An optional message that can be sent 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. 

Customization

You can customize the Opportunity Details Widget (or any Widget!) to be consistent with your branding, look and feel!

CSS: Every Widget accepts the Custom CSS attribute. Include it before the opening Widget tag is closed and customize backgrounds, button colors, and more!

Application Labels: Want to change the button to "Sign Up" instead of "Submit Response"? You can do that! Navigate to System Setup > Application Labels and update the label to fit your context (note that churches are responsible for all translations if the default is not used).

  • mpp-opportunity-details.responseButtonText - Text that appears on the response button. Default is "Submit Response."
  • mpp-opportunity-details.thankYouMessage - Message that is displayed after a response is successfully submitted. Default is "Thank you for responding about this Opportunity! If desired, use the form below to respond for another household member."
  • mpp-opportunity-details.validationFailedMessage - Message that is displayed after an unsuccessful response. Default is "Some field values are incorrect or missing. Please correct and try to submit the form again."