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: Set in Widget Attributes when it is added to a web page. 
• Url Filtering: Appended to the URL when viewing the page.

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. Here are the available attribute filter options.

• Congregation: Filters the results by a Congregations using IDs
  • Attribute: congregationid
  • Valid Values: Congregation Id

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 Values: should be url encoded
    • Standard a-z and 0-9 characters are all valid.
    • Other characters must be encoded.

keyword="summer bbq"

• Ministry: Filters by a Ministry ID. Default is empty.
  • Attribute: ministryid
  • Valid Values: Ministry ID or empty

ministryid="7"

• Gender: Filters by gender.
  • Attribute: genderid
  • Valid Values: "1" for Male" or "2" for Female

genderid="2"

• Minimum Age: Filters by a minimum age requirement.
  • Attribute: minimumage
  • Valid Values: an integer representing age in years

minimumage="18"

• Frequency: Filters by the frequency of the Opportunity.
  • Attribute: frequency
  • Valid Values: "1" for Ongoing or "2" for One Time

frequency="1"

• Event: Filters for Opportunities associated with an Event.
  • Attribute: eventid
  • Valid Value: Event ID

eventid="541"

• Program: Filters Opportunities based on Program affiliation.
  • Attribute: programid
  • Valid Value: Program ID

programid="17"

• Show Attribute Filter: Allows the user to filter based on Opportunity Attribute Types.
  • Valid Values: "true" or null to show the filter drop-down list in the Opportunity Finder, or "false" to hide it
    

showattributefilter="true"

• Attribute IDs: Limits the Attribute Types that users are able to choose from in the filter drop-down list in the Opporutnity Finder.
  • Attribute: attributeid
    
  • Valid Values: one or more Attribute IDs or ranges of Attribute IDs, separated by commas
    

attributeids="1,3,5-7,9"

All 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). Each attribute's value should be wrapped in quote marks.

<mpp-opportunity-finder target="/opportunity-details" congregationid="1" programid="5" showattributefilter="true"></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 the search values pre-selected. Users can continue to search by adding or changing parameters. The Opportunity Finder Widget's base URL can be appended with specific filters to apply desired 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

Here are the available URL filter options.

• Congregation: Filters the results by a Congregation ID.
  • Attribute: congregationid
  • Valid Values: A single Congregation ID

?congregationid=1

• Key Word: Filters the result using key word.
  • Attribute: keyword
  • Valid Values: 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 filter, which does not require the a plus.
    • Other characters must be encoded.

?keyword=summer+bbq

• Ministry: Filters by a Ministry ID.
  • Attribute: ministryid
  • Valid Values: A single Ministry ID

?ministryid=1

• Gender: Filters by a required gender.
  • Attribute: genderid
  • Valid Values: "1" for Male or "2" for Female

?genderid=2

• Minimum Age: Filters by a required minimum age.
  • Attribute: minimumage
  • Valid Values: An integer representing age in years

?minimumage=12

• Frequency: Filters by the frequency of the Opportunity, either one time or ongoing.
  • Attribute: frequency
  • Valid Values: "1" for Ongoing or "2" for One Time

?frequency=1

• Event: Filters by Opportunities associated with an Event.
  • Attribute: eventid
  • Valid Values: An single Event ID

?eventid=541

• Program: Filters for Opportunities associated with a Program.
  • Attribute: programid
  • Valid Values: A single Program ID

?programid=17

Advanced URL Filters

Multiple Filters
A URL may contain multiple filters separated by an ampersand. There is no limit to the number of filters which may be included and combining filters offers a useful way to return a specific set of Opportunities. For example:

/opportunities?congregationid=5&meetingtime=evenings

Multiple Filter Values
A single filter may contain multiple ID values separated by a comma. Employing a comma separated list of IDs can expand the set of Opportunities returned. For example:

/opportunities?meetingtimes=afternoons, evenings

Multiple Keywords
URLs cannot contain spaces, but %20 or + may be used instead. This is useful when filtering by two sequential keywords. Perhaps both "adult" and "community" would individually return too many Opportunities. In this case a combination could be used. For example:

/opportunities?keyword=adult+community