Filtering Online Directory
Optional attribute and URL filters can be 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.
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 and filtered for those pages.
- Congregation: Filters the results by a single Congregation.
- Attribute: congregationid
- Valid Value: Congregation ID
- Example:
congregationid="2"
- Key Word: Filters the result using a key word. A Key Word search looks for a match in the first name, nickname, last name, mobile phone, home phone, or email address, so choose your keyword attribute filter strategically.
- Attribute: keyword
- Valid Value: This should be URL encoded:
- Standard A-Z and 0-9 characters are all valid.
- Other characters must be encoded.
- Example:
keyword="Anderson"
URL Filters
URL Filters are applied when someone accesses the Online Directory 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 Online Directory Widget's base URL can be appended with specific filters to apply your search criteria. Pre-filtering the URL is a convenient way to contextually limit the Online Directory. For example, you may want to provide a direct URL for filtering for each Congregation so members can only search for members of the Congregation they attend.
/online-directory?congregationid=3
- Congregation: Filters the results by a single Congregation ID:
- Attribute: congregationid
- Valid Value: A single Congregation ID.
- Example:
/online-directory?congregationid=1
- Key Word: Filters the result by a single keyword. A Key Word search looks for a match in the first name, nickname, last name, mobile phone, home phone, or email address, so choose your keyword attribute filter strategically.
- Attribute: keyword
- Valid Value: This should be URL encoded.
- Standard A-Z and 0-9 characters are all valid Note: Multiple keyword filtering is not supported.
- Other characters must be encoded.
- Standard A-Z and 0-9 characters are all valid
- Example:
/online-directory?keyword=anderson
- Household: Filters by a Household ID
- Attribute: householdid
- Valid Value: A single Household ID.
- Example:
/online-directory?householdid=1126