What would you like to know more about?

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.

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 Online Direct displayed by the widget will always be limited by these filters.
  • 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.
    • Example:
      /online-directory?keyword=anderson
  • Household: Filters by a Household ID
    • Attribute: householdid
    • Valid Value: A single Household ID.
    • Example:
      /online-directory?householdid=1126