Required Attributes

Target URL

This determines the navigation path to Opportunity Details and is required. When someone selects an opportunity, the ID is added to this path.

• Attribute: target or targeturl
• Valid Value: relative or fully qualified URL
• Example:

  targeturl="https://example-church.com/opportunity-details"

Recommended URLs

The easiest way to set up interaction between the Opportunity Finder and Opportunity Detail widgets is to use query string parameters to identify opportunities. To use this method, specify a target URL (with or without a trailing slash). The Opportunity Finder widget adds a query string and an opportunity ID to the target URL.

For example, for the target URL "/opportunity-details" the link to opportunity 25 would look like this:

https://example-church.com/opportunity-details?id=25

Advanced Routing Options

To use more advanced routing, you can use different URLs. This is an option if the query string method does not work well with your CMS. In this case, you must:

• Define a route in your website to support the ID.
• Use a target URL with or without a trailing slash.

For example, the target URL "/opportunity-details/" the link to opportunity 25 would look like this:

https://example-church.com/opportunity-details/25

Configure Your Widget

For more information about the filter parameters, see Filtering Opportunity Finder

To display in the Opportunity Finder 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 Finder 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.

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.