Pro Category Filter
Make an incredibly powerful category toggler
Last updated
Make an incredibly powerful category toggler
Last updated
Category filters are a common and remarkably complex feature used on many maps to allow users to more easily comb through your data. We've bundled a lot more options into Pro for you to build fantastic filters. See examples here.
When you've installed Pro, more options will immediately appear in the Category Filter section of your maps.
You can set Functionality to Inclusive or Exclusive. 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 means that 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).
Initial Visibility allows you to start the map with all categories and properties being turned off or on.
Render in External Div means that 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.
Additional Filters make it so you can 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:
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.