WordPress Interactive Map Plugin (CMML) - Troubleshooting

WordPress Interactive Map Plugin TroubleShooting Guide

Back to User Guide

Here are some basic troubleshooting checks you should take when the WordPress Interactive Map plugin does not work as expected.

Map canvas is blank

  1. Make sure you've provided the Google Maps App Server Key (not the browser key) in the plugin settings. Read the article about setting up the API keys.
  2. Check if a WordPress plugin or theme didn't embed another Google Maps Javascript API on the same page within your website: open your browser's web console (Ctrl + Shift + J in Google Chrome or Ctrl + Shift + K in Firefox) and check if there's an error message telling that the multiple Google APIs has been called. 

    Since our plugin embeds the Google API only when it's needed and other plugins often do this on each page, you may need to disable the conflicting plugin or change your theme to fix this issue.

  3. Open your browser's web console (as described above) and check for the Javascript errors. Some error (which comes from other plugins or the theme) can stop processing our script which is responsible for loading the map.

    Checking JavaScript errors
    Checking JavaScript errors
  4. If your theme or some other plugin have "Google PageSpeed Optimization" option - please disable it. It crashes the JavaScript variables embedded in the HTML code and can be the reason your map doesn't show up.

I cannot search for places on the edit map page

Make sure you've enabled the Places API in your Google Maps App settings. 

Enabling Google Places API
Enabling Google Places API

Geolocation error shows up on the map page

From the recent web browsers' versions the Geolocation Web API works only on websites that uses https protocol. It won't work with the standard http websites without SSL/TLS encryption.

So you must have SSL / HTTPS running on your website.

404 Page not found error

It seems your Wordpress doesn't recognize the routes pages' permalink correctly.

  1. Make sure you don't have a page or post with the same slug (name) as you give for the plugin's permalink part in the plugin settings. If there's a post with the same slug you may need to change it's slug or the maps permalink part in the plugin settings.
  2. Go to Admin Dashboard → Settings → Permalinks and make sure that the Post name has been set as the permalink structure.

    Setting up the 'Post name' permalinks structure
    Setting up the 'Post name' permalinks structure
  3. Install "Rewrite Rules Inspector" plugin. Then go to Admin Dashboard → Tools → Rewrite Rules and press the Flush rules button.
  4. Make sure that your post pages are loading correctly using pretty URLs. This is rare issue but if not this mean that your server doesn't support URL rewrite, the htaccess files is not setup correctly on Apache server or you're using other HTTP server where you need to setup the rewrite manually. Please contact with your server administrator to solve this.

Some icons are not being displayed or there's a rectangle in some text labels

Our plugin uses the Wordpress' build-in Dashicons set. However, on some themes the dashicons are not displayed properly on the front-end. It's not the plugin's issue, but we didn't need more information to understand where this conflict come from.

Google Maps Javascript API Error - "RefererNotAllowedMapError"

When you see a message like on the screenshot below instead of the map, check the console. It can be caused by the error RefererNotAllowedMapError.

Google Maps Javascript API Error
Google Maps Javascript API Error

It happens because the site which is loading the Maps JavaScript API is not in the list of allowed referrers. It demands additional configuration of your API, so navigate to your account in Google Cloud Platform Console to the Credentials section.

Google credentials
Google credentials

Find needed API and click on it to edit:

Editing needed API
Editing needed API

There you need:

  1. Choose None under the section Set an application restriction.
  2. Choose Don't restrict key under the section API restrictions.
  3. Click Save.
Disabling API restrictions
Disabling API restrictions

It will take up to 5 minutes to apply the changes. After that you can check the map integrated to your site - it should work.

Now you can enable the restrictions back (in case if you don't want any unauthorized users to use your API key). Get back to the editing of API.

Do the following under the section Set an application restriction:

  1. Choose the needed restriction type - for example Websites.
  2. Enter your domain without www part.
  3. Click Done.
Enabling restriction for certain website
Enabling restriction for certain website

Choose Restrict key under the section API restrictions, then click on the dropdown Select APIs.

Restrcting the key for selected APIs
Restrcting the key for selected APIs

Choose Geolocation API and Maps JavaScript API. Click OK, then - Save.

Selecting needed APIs
Selecting needed APIs

The changes will be applied with 5 minutes.

Index, Dashboard and Add Location Pages Are Blank

This issue can appear as a conflict with the block themes such as Twenty Twenty-Two, Twenty Twenty-Three, Twenty Twenty-Four, etc.

The solution is you need to replace the default index.php file by the custom one, which you can download using This Link. The steps are (as example, we use the theme Twent Twenty-Two):

  1. Unzip the downloaded index.php file.
  2. Use file manager to access the following path: /wp-content/themes/twentytwentytwo/
  3. Replace the file index.php file by the one you downloaded.
Path for replacing index.php - Google Maps WordPress Plugin
Path for replacing index.php

Now head to Admin Dashboard → CM Map Locations Pro → Settings → General tab. In the field Other page template file add index.php as shown on the screenshot below:

Specifying custom template file - Maps Plugin
Specifying custom template file

Then save the changes. The issue should be gone.

More information about the WordPress Interactive Map Plugin

Other WordPress products can be found at CreativeMinds WordPress Store

Let us know how we can Improve this Product Documentation Page

To open a Support Ticket visit our support center
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.