home

MinistryPlatform

RealmRealm AccountingMinistryPlatformeGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformeGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

thumbnailMinistryPlatform

Opportunity Finder

Filtering Opportunity Finder

Optional attribute and URL filters can be to used to create different versions of the widget for different purposes, further customizing your church's experience.

  • Attribute filtering is set using widget attributes before adding the widget to your webpage.
  • URL filtering is appended to the URL when someone views the webpage.
Note:
  • If you filter your Opportunity Finder by Congregation, that Congregation must be available online for the filter to apply. If the Congregation isn't available online, the filter won't be applied and all of your Opportunities will display in the finder.
  • If the allow users to filter the Opportunity Finder by Attribute Type, the Attribute Types you choose to display must be available online. If no Attribute Types have Available Online set to Yes, the Attribute Type filter will not display in the finder.

Attribute Filters

Optional attributes can be used to create different versions of the widget for different purposes. For example, pages can be created for Congregations or Ministries and filtered for those pages.

Note: Filters that are multi-select in the Finder can be filtered by multiple, comma separated values. But filters that are single-select in the Finder (for example, Congregation ID) can only be filtered by one value.
These attributes are different (in form and function) from Contact Attributes.
Important: Filter attributes will pre-filter the widget results, so the Opportunities displayed by the widget will always be limited by these filters.
  • Congregation: Filters the results by a Congregations using IDs
    • Attribute: congregationid
    • Valid Value: Congregation Id
    • Example: 
      congregationid="2"
  • Key Word: Filters the result using key words. A Key Word search looks for a match in the Title, Description, Program Name, and Ministry Name, so choose your keyword attribute filter strategically.
    • Attribute: keyword
    • Valid Value: This should be a URL encoded Standard A-Z and 0-9 characters are all valid. Other characters must be encoded.
    • Example:
      keyword="summer bbq"
  • Ministry: Filters by a Ministry ID. Default is empty.
    • Attribute: ministryid
    • Valid Value: Ministry ID or empty.
    • Example:
      ministryid="7"
  • Gender: Filters by gender.
    • Attribute: genderid
    • Valid Value: "1" for Male" or "2" for Female.
    • Example:
      genderid="2"
  • Minimum Age: Filters by a minimum age requirement.
    • Attribute: minimumage
    • Valid Value: An integer representing age in years.
    • Example:
      minimumage="18"
  • Frequency: Filters by the frequency of the Opportunity.
    • Attribute: frequency
    • Valid Value: "1" for Ongoing or "2" for One Time.
    • Example:
      frequency="1"
  • Event: Filters for Opportunities associated with an Event.
    • Attribute: eventid
    • Valid Value: Event ID
    • Example:
      eventid="541"
  • Program: Filters Opportunities based on Program affiliation.
    • Attribute: programid
    • Valid Value: Program ID
    • Example:
      programid="17"
  • Show Attribute Filter: Allows the user to filter based on Opportunity Attribute Types.
    • Valid Value: true or null to show the filter drop-down list in the Opportunity Finder, or false to hide it.
    • Example:
      showattributefilter="true"
  • Attribute IDs: Limits the Attribute Types that users are able to choose from in the drop-down list in the Opportunity Finder.
    • Attribute: attributeid
    • Valid Value: One or more Attribute IDs or ranges of Attribute IDs, separated by commas.
    • Example:
      attributeids="1,3,5-7,9"

Attributes must be included before the opening widget tag is closed. Attributes may be listed in any order and should be separated by a space or other whitespace. An attribute's value should be wrapped in quotation marks.

<mpp-opportunity-finder target="/opportunity-details" congregationid="1" programid="5"></mpp-opportunity-finder>

URL Filters

URL Filters are applied when someone accesses the Finder widget. This can be used to direct users to a widget page with search values pre-selected. Users can continue to search by adding or changing parameters. The base URL of the Opportunity Finder widget can be appended with specific filters to apply your search criteria. Pre-filtering the URL is a convenient way to contextually limit Opportunities.

Note: Filters that are multi-select in the Finder can be filtered by multiple, comma separated values. But filters that are single-select in the Finder (for example, Congregation ID) can only be filtered by one value.
For example, if your Children's Ministry is accepting volunteers in the fall, you may provide a pre-filtered link showing only those Opportunities:
/opportunities?keyword=small
Or you may introduce several new classes that meet in the evening, and provide a pre-filtered link for this time period:
/opportunities?meetingtimes=evening
  • Congregation: Filters the results by a Congregation ID
    • Attribute: congregationid
    • Valid Value: A single Congregation ID.
    • Example:
      ?congregationid=1
  • Key Word: Filters the result using key words.
    • Attribute: keyword
    • Valid Value: Should be URL encoded.
      • Standard A-Z and 0-9 characters are all valid.
      • Spaces should be replaced with a plus (+).
        Note: The is different from than the Key Word Attribute filer, which does not require the a plus.
      • Other characters must be encoded.
    • Example:
      ?keyword=summer+bbq
  • Ministry: Filters by a Ministry ID
    • Attribute: ministryid
    • Valid Value: A single Ministry ID.
    • Example:
      ?ministryid=1
  • Gender: Filters by a required gender.
    • Attribute: genderid
    • Valid Value: "1" for Male or "2" for Female.
    • Example:
      ?genderid=2
  • Minimum Age: Filters by a required minimum age.
    • Attribute: minimumage
    • Valid Value: An integer representing age in years.
    • Example:
      ?minimumage=12
  • Frequency: Filters by the frequency of the Opportunity, either one time or ongoing.
    • Attribute: frequency
    • Valid Value: "1" for Ongoing or "2" for One Time.
    • Example:
      ?frequency=1
  • Event: Filters by Opportunities associated with an Event.
    • Attribute: eventid
    • Valid Value: A single Event ID.
    • Example:
      ?eventid=541
  • Program: Filters for Opportunities associated with a Program.
    • Attribute: programid
    • Valid Value: A single Program ID.
    • Example:
      ?programid=17
MinistryPlatform
portal

Last updated: May 17, 2024