Filter markers by taxonomies

To add your taxonomies as new filters, do the following:

Step 1: Adding a taxonomy

  1. Edit your map
  2. Open the widget “Progress Map Settings”, scroll down and click on the menu “Markers filter Settings”
  3. Scroll down to the section “Filter fields”
  4. Open the group field “Field 1” or click on the button “Add new field” if this is not your first taxonomy to add.

Step 2: Setting up the taxonomy parameters

  1. In the field “Field title”, enter the title of your taxonomy (e.g. “Categories”). In the frontend, the title also allows to toggle the list of options/terms.
  2. In the field “Visibility”, select the option “Show” to show your taxonomy on the filtering form. To hide it, select the option “Hide”. The visibility works like an on/off option.
  3. In the field “Field type”, select the option “Taxonomy Term(s)”.
  4. In the field “Taxonomy name”, select your taxonomy (e.g. “Categories”). Please note that a taxonomy can only be used once in the filtering form!
  5. The field “Single?” will let you choose whether to allow the users to search by one term or by multiple terms:
    • To allow searching by multiple terms, choose the option “Multiple”. This will display the taxonomy terms as checkboxes.
    • To allow searching by one term, choose the option “Single”. This will display the taxonomy terms as radio buttons.
  6. Choose the field display type by selecting an option in the field “Field display type”:
    • The option “List” will display the options/terms as a list.
    • The option “Dropdown List” will display the options/terms inside a dropdown list.
  7. Choose whether to display the options list horizontally or vertically by selecting an option in the field “Options list layout”.
    • The option “Horizontal” will display the terms horizontally, one next to the other.
    • The option “Vertical” will display the terms vertically, one above the other.
  8. In the field “List max options/rows”, specify the maximum number of options/terms to display in the options’ list before activating the scroll. For instance, if your taxonomy contains 20 terms in it and that you choose to display 5 rows, you’ll end up having a scrolling list showing the first 5 terms. To see the other terms you’ll have to scroll down the list. Set to 0 to display all options/rows.
  9. Choose whether or not to show the options list when opening the filter form by selecting an option in the field “Options display status”. When set to “Hide”, the users will have to click on the field title to display the options list.
  10. To change the order of the taxonomy terms, select an option in the field “Orderby parameter”, then, choose the ascending or descending order in the field “Order parameter”
  11. Choose wether or not to show the number of posts assigned to your taxonomy by selecting an option in the field “Show count”.
  12. Choose whether or not to show the number of posts assigned to each taxonomy term by selecting an option in the field “Show options count”.
  13. To add a new taxonomy, click on the button “Add new field” and repeat the above steps.

Step 3: Defining the relationship between all your taxonomies

Under the button “Add new field”, in the field “Taxonomies “Relation” parameter”, select the parameter that defines the relationship between all your taxonomies. For example, let’s say you have two taxonomies, each with different terms:

  1. Category:
    1. Colored
    2. Not colored
  2. Color:
    1. Red
    2. Blue
    3. Yellow

Let’s also imagine a situation where a user wants to filter the markers by the category “Colored” and the color “Red”:

    • By selecting the relation parameter “AND”, the plugin will try to get all posts with the category term “Colored” and the color term “red”. Note that a post must have these two terms in order to be displayed!
    • By selecting the relation parameter “OR”, the plugin will try to get all posts with the category term “Colored” or with the color term “Red”. Note that a post must have only one of these two terms in order to be displayed!