Updating from v2 to the latest version

Before you update, please be sure to backup your database to ensures that your website can be rolled back quickly and safely if any issues arise!


Watch the Video Tutorial below!
  1. Click here # to see how to update the plugin. Do not use FTP to upload the latest version, you must do it from your website administration!


  1. Click on the menu “Progress Map”.
  2. Double check the settings in “Plugin settings” and be sure the appropriate (custom) post types to use with “Progress Map” are well selected in the field “Post types”.

    Previously in version 2, the settings page under the menu “Progress Map” was for creating the master/main map. That settings page has all the options needed to build a map and to control some of the plugin fonctionalities. Since version 3, almost all the settings has been removed and the ones that remains there are now called “Default … settings”. That means that you can override all the default settings later. The usage of the default settings in the latest version will be limited to the single post maps. They’ll also be used as the default fields options in the “Add new map” page.

    In the latest version, you’ll also notice two new menu items, “All Maps” and “Add New Map”.

  3. Click on the menu “All Maps”, you’ll find a built in map called “Auto generated map based on v2 settings”. This is a map that was created during the update process (This is why you should not use FTP to update to the latest version). This map uses all the settings that you were using in the version 2. Edit this map, double check all the settings, especially the options in “Query settings” and be sure that each option is as it should be, otherwire, edit the option and update your map.
  4. Copy the shortcode in the widget “Map Shortcode”. For example: [cspm_main_map id="1"]
  5. Edit your map page, the page where you use the version 2 shortcode [codespacing_progress_map] and change that shortcode by the new one in step 4, then, update your page.

That’s it!

Getting started (Video)

The below video is simply an introductory video that will show you the first steps to set up the plugin. You still need to go through each step mentioned in “first steps” guide!

Note: The plugin settings page in the latest version of “Progress Map” is different than the one you’ll see in this video, still, the concept is the same! Another note regarding the custom post type (“Listings”) in the video. Please note that “Progress Map” doesn’t provide a new custom post type (CPT). The plugin can work with any CPT already available in your website. If you want to use the plugin with a new CPT (e.g. “Listings”), use the plugin Custom Post Type UI or similar to create one.

Connect the plugin with your custom “Latitude” and “Longitude” fields

If you were using another map plugin before switching to “Progress Map”, this usually means that you’ve already created locations. This also means that you were – probably – geolocalizing a location by adding its coordinates (Latitude & Longitude) inside custom fields (custom fields that were designed by your old map plugin).

If this is not your case, you can skip this post!

Two of the main things we’ve taken into consideration while developing “Progress Map”, is to avoid to the customer to rebuild and/or to re-geolocalize their locations. Let’s see how to do that.

Before we start, please note that you must have the coordinates (“Latitude” & Longitude”) saved inside two separated custom fields! The “Latitude” saved inside a custom field and the “Longitude” saved inside another custom field, otherwise, this won’t work!

To connect the plugin with your custom fields, follow these steps:

  1. In your administration menu, click on the menu “Progress Map”.
  2. Click on the menu “Plugin Settings”.
  3. Scroll down to the section (“Add location” Form fields).
  4. In the field (“Latitude” field name), enter the name of the custom field that you were using to save the latitude of your locations.
  5. In the field (“Longitude” field name), enter the name of the custom field that you were using to save the longitude of your locations.
  6. Save your settings by clicking on the button “Save changes”.
  7. Now that you’ve connected your custom fields, you need to regenerate your markers/locations to fit to the structure of “Progress Map”. This operation won’t duplicate your (custom) posts in your Database! To do that, click on the menu Troubleshooting”, then, click on the button “Regenerate markers” and you’re done.

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 that!). 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”.

Create an API Key & activate the required APIs

The plugin requires certain Google Maps APIs to properly work.

Very Important Note: We assume that you’re already aware that Google Maps requires a billing account to continue using their APIs and that you’ve already created one. If you didn’t create any billing account, or that you’re new to Google Maps Platform, please visit this link to see how to create a Billing Account, how to enable APIs and how to Generate & restrict API keys!

After creating a Billing Acount, enable the required APIs by doing the following or watch the below video tutorial:

  1. Go to your Google API Console.
  2. From the projects list, select a project or create a new one.
  3. If the APIs & services page isn’t already open, open the console left side menu and select APIs & services, and then select Library. Make sure to enable the following APIs:
      • Maps JavaScript API
      • Directions API
      • Distance Matrix API
      • Geocoding API
      • Places API
  4. Click the API you want to enable. If you need help finding the API, use the search field.
  5. Click ENABLE.
  6. To create your API Key, watch the below video tutorial (from 1:40 until the end) or visit this link.

Note: The process of enabling an API varies depending on the API.

What are the required APIs?

These are the required APIs to use with “Progress Map”:

  1. Maps JavaScript API
  2. Directions API
  3. Distance Matrix API
  4. Geocoding API
  5. Places API