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!
Optional attributes can be used to create different versions of the widget for different purposes. These attributes are related to the Group and are different (in form and function) from Contact Attributes. 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.
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.
congregationid="2"
keyword="summer bbq"
ministryid="7"
meetsonline="True"
parentgroupid="16"
groupfocusid="17"
lifestageid="4"
meetingdays="1,6"
meetingtimes="afternoon"
When you've chosen your attribute, add it to your Widget before the opening tag is closed:
<mpp-group-finder target="/group-details" congregationid="1"></mpp-group-finder>
Want to filter Groups by multiple Meeting days? You can do that! If the attribute is multi-select in the Widget, you can include multiple, comma separated values in the attribute filter.
<mpp-group-finder target="/opportunity-details" meetingdays="2,4,6"></mpp-group-finder>
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. 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.
The Group 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 Groups. In the following examples a church has defined the path/groups for their Group Finder
https://{your church domain}/groups
This should be adapted to fit each church's placement of their Group Finder
https://{your church domain}/getinvolved/smallgroups
For example, if a church's Small Groups are accepting new members in the fall this church may provide a pre-filtered link showing only those Groups.
/groups?keyword=small
In another example, a church may introduce several new classes which meet in the evening and provide a pre-filtered link for this time period:
/groups?meetingtimes=evening
?congregationid=1
?keyword="new+wine
?parentgroupid=16
?citypostalcode=87659
?groupfocusid=17
?lifestageid=4
?meetingdays=1,6
?meetingtimes=afternoon
?meetsonline=true
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 Groups.
/groups?congregationid=5&meetingdays=4
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 Groups returned.
/groups?meetingdays=2,3
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 Groups. In this case
a combination could be used.
/groups?keyword=adult+community