Section: Countries search

---

To change the display order of the countries, you need to add a special PHP code in the file “functions.php” of your theme/child theme. This task requires some developer skills!

Copy and paste the following code in the file “functions.php” of your theme. The code will change the field “Countries” from a multicheck list to a multiselect & sort field.

/**
 * Progress Map WordPress Plugin.
 * Change the countries field type to "Multiselect & Sort".
 *
 * @since 3.0
 */

add_filter("cspm_countries_field_type", function(){ return true; });

Once you added the code to your theme, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zoom to country”.
4. In the field “Countries”, remove the countries you don’t want to use by clicking on the “x”. To sort them, drag a country name to the position where you want it to be.

---

To choose the countries to use for the search, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zoom to country”.
4. Select the countries to use in the field “Countries”. To select/deselect all countries, click on the button “Select/Deselect all”!

---

To show/hide the countries flags and/or names in/from the countries list, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zoom to country”.

Show the countries flags:

• To show the flags, select the option “Yes” in the field “Country flag”.

Hide the countries flags:

• To hide the flags, select the option “No” in the field “Country flag”.

Show the flags and Hide the countries names:

• To show the flags and hide the countries names, select the option “Yes & Hide country name“ in the field “Country flag”.

---

Countries names can be displayed in so many languages. To choose a language, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zoom to country”.
4. Select a language in the field “Display language”. Note that not all languages in this filed are available! If a language is not available, English will be used instead!

---

To automatically open the countries list once the map is loaded, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zoom to country”.
4. Select the option “Open” in the field “Countries list display status”.

---

To show the country bounds, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zoom to country”.
4. Select the option “Show whole country” in the field “Country bounds”.

---

The plugin provides the possibility to navigate through countries with ease. This feature will add a dropdown list in your map with all countries so that when you select a country in the list, the map will be draged or zoomed to that country’s center point. You can choose to display all or just specific countries. To activate this functionality in your site, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zooming to countries”.
4. Select the option “Yes” in the field “Zoom to country option”.
5. In the field “Countries list display status”, choose whether to open the countries dropdown list once the map is loaded or not.
6. In the field “Country bounds”, choose how to show a country when the user chooses one in the list. The option “Show whole country” will display the whole country, the option “Zoom to country center” will zoom the map to the center point of that country.
7. If you’ve selected the option “Country bounds => Zoom to country center”, you may want to choose a different zoom level to use when displaying the contry’s center point. Modify the zoom level in the field “Map zoom”.
8. To change the countries list placeholder, change the text in the field “Dropdown list placeholder”.

---

To zoom the map to the country’s center point, do the following:

1. Edit a map
2. Open the widget “Progress Map Settings”.
3. Click on the menu “Zoom to country”.
4. Select the option “Zoom to country center” in the field “Country bounds”.
5. To change the zoom level used when zooming the map, choose another zoom level in the field “Map zoom”.