Section: Query settings

Query settings

The query settings menu contains all possible options that allows you to filter the posts/locations to display on the map. You can filter locations by taxonomies/categories, custom fields, status etc…

By default, the map will display all available posts/locations, so, please note that you can always get the information you want without actually dealing with any parameter.

Change the posts display order

To change the display order of the posts/locations in the map, in the carousel and the list of the extension “List & Filter”, do the following:

  1. Edit a map.
  2. Open the widget “Progress Map Settings”.
  3. Click on the menu “Query settings”.
  4. Scroll down to the section “Order & Orderby parameters”.
  5. Choose the orderby paramater in the field “Orderby parameter”.
  6. Select the order parameter in the field “Order parameter”.

How to order by custom field value?

  1. In the field “Order parameter” select the option “Order by string meta value” in the field “Orderby parameter”.
  2. Enter the custom field name in the field “Custom field name”.
  3. Select the custom field type in the field “Custom field type”.

Display posts by author(s)

To show or hide posts/locations associated with certain author(s) from the map, do the following:

  1. Edit a map.
  2. Open the widget “Progress Map Settings”.
  3. Click on the menu “Query settings”.
  4. Scroll down to the section “Authors parameters”.

To show all posts associated to certain author(s):

  1. Select the option “No” in the field “Authors condition”.
  2. In the field “Authors type”, select the option “Defined Authors”.
  3. In the field “Authors”, select the author(s).

To hide all posts associated to certain author(s):

  1. Select the option “Yes” in the field “Authors condition”.
  2. In the field “Authors type”, select the option “Defined Authors”.
  3. In the field “Authors”, select the author(s).

To show only posts of the logged-in author/user: First introduced in v5.6.5

  1. Select the option “No” in the field “Authors condition”.
  2. In the field “Authors type”, select the option “Logged-in Author/User”.

To hide only posts of the logged-in author/user: First introduced in v5.6.5

  1. Select the option “Yes” in the field “Authors condition”.
  2. In the field “Authors type”, select the option “Logged-in Author/User”.

Display or remove posts by IDs

To display or remove posts/locations by their IDs, do the following:

  1. Edit a map.
  2. Open the widget “Progress Map Settings”.
  3. Click on the menu “Query settings”.
  4. Scroll down to the section “Post parameters”.
Display posts by IDs:

In the field “Posts to retrieve”, select the posts to display on the map. You can find a post in that field by typing its title or just by clicking on the keyboard key “Space” and selecting a post from the list.

Remove posts by IDs:

In the field “Posts not to retrieve”, select the posts to remove from the map. You can find a post in that field by typing its title or just by clicking on the keyboard key “Space” and selecting a post from the list.

 

Display posts by custom field(s)

To display posts/locations associated with certain custom field(s), do the following:

  1. Edit a map.
  2. Open the widget “Progress Map Settings”.
  3. Click on the menu “Query settings”.
  4. Scroll down to the section “Custom fields parameters”.
  5. Click on the group field “Custom field 1”.
  6. Enter the key/name of the custom field in the field “Custom field key/name”.
  7. Enter the value(s) of the custom field in the field “Custom field value(s)”.
  8. Select the custom field type in the select list “Custom field type”.
  9. Select the compare parameter to test the custom field value(s) in the field “”Compare” parameter”.
  10. To add a new custom field, click on the button “Add new custom field”.

To find the custom field name, edit one of your (custom) posts, once the edit page opened, click on the link “Screen Options” located in the top-right corner of your page. A window will be displayed; make sure to select the option “Custom Fields” (Note: If you can’t find this option, you should contact your theme support to show you how to add it!). After selecting that option, scroll down and you’ll find a metabox/widget titled “Custom Fields”. In this metabox/widget, look for the custom field you want to use and copy the name that you’ll find in field “Name”.

Display posts by status

To display posts/locations associated with certain status, do the following:

  1. Edit a map.
  2. Open the widget “Progress Map Settings”.
  3. Click on the menu “Query settings”.
  4. Scroll down to the section “Status parameters”.
  5. Select the status in the field “Status”.

Display posts by categories/taxonomies

To display posts/locations associated to certain category, do the following:

  1. Edit a map.
  2. Open the widget “Progress Map Settings”.
  3. Click on the menu “Query settings”.
  4. Scroll down to the section “Taxonomy parameters”.
  5. Find the category/taxonomy to choose from, then, select the terms related to your posts. Note that a category/taxonomy will be represented by its title and its unique name (slug). For example “Categories (category)”!
  6. In the field “Operator” parameter right below your category, select the parameter to use when searching for posts. For example, if you want to display posts associated to multiple terms (“term1”, “term2” and “term3”), each parameter will allow you to display different results. The operator “AND” will display only the posts associated to all the selected terms. The operator “IN” will display the posts associated to at least one of the selected terms. The operator “NOT IN” will display all posts that are not associated to any of the selected terms.

What if you want to display posts/locations associated to multiple categories/taxonomies?! In this case, do the following:

  1. Repeat the above steps 5 & 6 (find another category, select the terms and choose the operator parameter).
  2. Scroll down to the field “Relation” parameter and select the logical relationship between each inner category/taxonomy.

Limit the number of posts to display on the map

To limit the number of posts/locations to display on a map, do the following:

  1. Edit a map.
  2. Open the widget “Progress Map Settings”.
  3. Click on the menu “Query settings”.
  4. Enter the maximum number of locations to display in the field “Number of posts” or leave it empty to display all locations.

Connect the map to a (custom) post type

In order to display your posts/locations on the map, you need to connect it to a (custom) post type. To do that:

  1. create a new map or edit an existing map, then, open the widget “(Custom) post type & Map settings”.
  2.  Choose your (custom) post type in select list “Main post type”.
  3. Save or Update your map.

What if your (custom) post type is not available in the select list?! If that’s the case, do the following:

  1. Click on the admin menu “Progress Map”.
  2. Click on the menu “Plugin settings”.
  3. Select your (custom) post type in the select list “Post types”.
  4. Save your settings