Category Filter

Allow users to toggle features on and off based on different categories.

The Category Filter creates a toggleable list of Categories that you have associated with your Locations, Lines, and Polygons added to the current map. These are presented in a list, and include parent and child relationships. Users can toggle checkboxes on or off, thereby adding and removing different features from the map. You can initialize features as on or off depending what you require.

Categories will also display hierarchically if you have child categories.

Any feature that has a child category should also have its hierarchical parent categories, otherwise the layout may not work properly.

A basic example of the category filter.

Category Display

Select if categories will show colors, icons, or nothing beside them. These colors and icons can be defined in the Categories section of the Wordpress plugin (inside Maps > Categories).

Checkbox Display

Pick whether your categories will be toggled with switches or checkboxes.

Advanced Features ^_[Pro]

Show Number of Features ^_[Pro]

Display the number of features included in a given category in parentheses.

Functionality ^_[Pro]

This applies to cases in which features may have more than one category or filterable property. Filters are exclusive when any of the properties or categories being turned off means the feature disappears. Inclusive means that all of the properties or categories must be turned off before the feature disappears.

Independent Children ^_[Pro]

Child categories will function independently of whether or not their parent category is turned on. For this, you'll want to make sure that your child categories don't have the parent category clicked on (or, use inclusive filtering).

Parent Category Display ^_[Pro]

Choose whether you want parent categories to show checkboxes or only be used for visual structural organization of their child categories.

Excluded Categories ^_[Pro]

Select any categories that should not be shown in the category filter.

Initial Visibility ^_[Pro]

Set whether categories should be on or off when the map first loads.

Preselected Categories ^_[Pro]

If you turn initial visibility off, you can still choose individual categories that should be started as visible.

Category Order ^_[Pro]

Allows you to have the categories appear, both parents and children, in whatever order you want.

Reset Button ^_[Pro]

Adds a button to reset all categories to their original loaded state.

Additional Filters ^_[Pro]

Use properties from your geographic data (imported or added onto posts), or ACF data, to create additional filters.

First, you'll need to make sure your features actually have the data. You can see properties from geographic data in any given feature under "Custom Properties", and ACF fields will show up in the appropriate post types.

Next, you'll use some special syntax to tell the Category Filter which properties to include under which headers. The syntax looks like this:

property_name : Label

acf_property_name : Label 2

If you are using a Custom Property, enter the property name only (no acf_ required) and then the label you want to show for that property heading, separated by a colon.

Unlike the Advanced Popup, you don't need to get the field ID from ACF, and you don't need to use curly braces. Just enter the "name" of the ACF field, or the name of the property. This feature will run into problems if you have a property and an ACF field with the same name, though.

If you've added these correctly, they will now show up alongside your categories in the Category Filter, and will integrate completely with the Inclusive and Exclusive filtering.

Render in External Div ^_[Pro]

The category filter will render into a div of your choosing on the page, instead of appearing directly as a control on the map. This can free up space in the appearance of your map.

Accordion Layout ^_[Pro]

Makes a neater appearance by having categories render in dropdown expandable rows.

Nested categories can be rendered as an accordion, which will open the first parent automatically and then only open other parents when they are clicked open by the user. This is great when you have a lot of categories.