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.
If the shared script hasn't been added to your website, add it to the appropriate webpage, replacing "example-church.com" with the base URL of your church's website.
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.
Widget Configuration
Required Attributes
-
Return URL: The URL where the Opportunity Finder widget is placed on your website. This is required for the Opportunity Detail Widget to function correctly.
- Attribute: returnurl
- Valid Value: relative or fully qualified URL
- Examples:
returnurl="https://www.example-church.com/opportunities" returnurl="/opportunities"
Configure Your Widget
Fill out the Widget Configurator below, copy your generated widget code, and paste it into your website.
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 has Available Online set to Yes.
- The Visibility Level is either:
- 2- Staff Only: Visible only for authenticated users with at least (1) current Group Participant Record where Employee Role is set to Yes (belonging to any Group of any Group Type).
- 4- Public: Visible for any user.
- 5- Hidden: URL Required: 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: The Opportunity Title.
- When: The Opportunity Date. If blank, this is replaced with "Ongoing".
- Description: The Opportunity Description. Line breaks are supported.
- Location: This field is populated from the Program's Congregation.
- Contact Person: The 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: This field 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.