Filtering Event Finder

Learn to filter events by attributes, URL parameters, and advanced URL filters.

You can filter the Event Finder widget in two ways:

Attribute filters: Use widget attributes before adding the widget to your webpage.
URL filters: These are added to the end of your URL when someone views the webpage.

You can use optional attributes to create different versions of the widget for different purposes. For example, let's say you have a page dedicated to children's ministry. When you add the Event Finder widget to that page, you can filter the widget to only display upcoming children's ministry events because, chances are, people that are already on the children's ministry page are interested in finding the events related to children's ministry.

Adding attribute filters presents a limited version of the widget. People cannot see or change the applied filters but can layer on other filters to further narrow results. Events displayed by the widget will always be limited by these filters.

Note: To filter by multiple-select filter options, separate the filter options with a comma. For example, mission trip,Puerto Rico. You can only filter single-select filter options by one value. For example, congregation ID.

These attributes are related to the event and are different from contact attributes.

Congregation

This filters the results by a congregation, parish, or campus.

Attribute: congregationid
Valid Value: Congregation ID
Example:
```
congregationid="1"
```

Tip: Want to show events available to any congregation? Set the COMMON, GlobalCongregationID configuration setting, which the Event Finder sees as a church-wide congregation.

Key Word

This filters the result using keywords. Keyword search looks for a match in the event title name, event description, program name, and/or ministry name, so choose your key word attribute strategically.

Attribute: keyword
Valid Value: Any keywords
Example:
```
keyword="mission to mars"
```

Month

This filters by a certain month.

Attribute: monthid
Valid Value: one value between 1 and 12 (1 = January, 12 = December)
Example:
```
monthid="12"
```

Ministry

This filters by a specific ministry.

Attribute: ministryid
Valid Value: one Ministry ID (or empty, the default)
Example:
```
ministryid="16"
```

Sign-up Type

This filters by the type of registration available. The default is empty.

Attribute: signuptype
Valid Value: "1" for Open Registration, "2" for Open Volunteer Opportunities, or empty for unspecified. "0" will display all events.
Example:
```
signuptype="2"
```

Event Type

This filters by a specific type of event.

Attribute: eventtypeid
Valid Value: one Event Type ID (or empty, the default)
Example:
```
eventtypeid="3"
```

Featured

This filters by only displaying featured events. The default is empty.

Attribute: isfeatured
Valid Value: "true" (or empty)
Example:
```
isfeatured="true"
```

Program

This filters by a program. The default is empty.

Attribute: programid
Valid Value: Program ID (or empty)
Example:
```
programid="16"
```

Limit Occurrence

This limits the number of times people see a series of events. The default is empty.

Attribute: reduceseriesto
Valid Value: Any number greater than or equal to 1. There is no limit to the number of events you want to show.
Example:
```
reduceseriesto="3"
```

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. For example, this Event Finder defines the resource path, congregations, and ministries.

<mpp-event-finder target="https://example-church.com/events" congregationid="7" ministryid="8"></mpp-event-finder>

URL Filters

Search parameters are added to the URL when accessing the widget page. Using URL filtering, people can see and change all filters in the widget on your website.

Congregation

This filters by a congregation ID.

Parameter: "congregationId"
Valid Value: A single congregation ID or empty for unspecified.
Example:
```
?congregationId=1
```

Key Word

This filters by keywords.

Parameter: "keyword"
Valid Values:
- Empty for unspecified (the default value)
- URL encoded keywords
- Standard A-Z and 0-9 characters are all valid.
- Replace spaces with a plus (+).
  
  Note: This is different from the Key Word Attribute filter, which does not require the plus.
- Other characters must be encoded.
- The easiest way to determine to encode is to search using the criteria and copying from the resulting URL.
Example:
```
?keyword=mission+to+mars
```

Month

This filters by one month.

Parameter: "monthId"
Valid Value: Any single month between "1" and "12"
Example:
```
?monthId=12
```

Ministry

This filters by a ministry ID.

Parameter: "ministryId"
Valid Value: A single ministry ID
Example:
```
?ministryId=16
```

Sign-up Type

This filters by sign-up type. The default is empty.

Parameter: "signUpType"
Valid Value: "1" for Open Registration or "2" for Open Volunteer Opportunities, or empty for unspecified.
Example:
```
?signUpType=2
```

Event Type

This filters by a specific type of event.

Parameter: "eventtypeid"
Valid Value: one Event Type ID
Example:
```
?eventtypeid=3
```

Featured

This filters to show featured events. The default is empty.

Parameter: "isFeatured"
Valid Value: "True" for featured or empty for unspecified.
Example:
```
?isFeatured=true
```

Program

This filters by a program ID.

Parameter: "programid"
Valid Value: A single program ID or empty for unspecified.
Example:
```
?programId=1
```

Note: The first parameter is preceded by a question mark (?). Additional parameters follow with ampersands (&).

?eventId=&programId=&congregationId=&keyword=&monthId=&ministryId=&signUpType=2

Advanced URL Filters

Multiple Filters

URLs can have multiple filters separated by an ampersand (&). There's no limit to the number of filters, allowing you to refine event searches effectively.

/events?congregationid=5&ministryid=16

Multiple Keywords

URLs cannot contain spaces. Use "%20" or "+" to separate keywords. This helps refine searches when individual keywords return too many results. For example, combining "adult" and "community" can narrow down the events.

/events?keyword=adult+community

What would you like to know more about?

Filtering Event Finder

Attribute Filters

URL Filters

Advanced URL Filters

Multiple Filters

Multiple Keywords

Footer Section

Additional Resources

Company

We’re here for you.