MapPress FAQ

How can I make Leaflet maps look better?

For better-looking maps, create a Mapbox account and enter your access token in the MapPress settings.

How can I get a Google API key?

Please see this page to get your key: How to Get A Google Maps API Key

Map doesn’t display

Most display problems are due to theme or plugin conflicts.  Here’s how to check:

  1. Disable all plugins except MapPress.  If the maps are now working, re-activate one by one to find the conflicting plugin. Conflicts are often caused by “minifier” or “optimizer” plugins, or with other map plugins.
  2. Install and activate a standard WordPress theme, like “twenty twenty”.  Check the maps again.  If they’re working, there’s a theme problem. Most themes that include maps also have a setting to disable loading the Google Maps API, to prevent this kind of conflict.

Other Common Problems:

  • “Minifier” or “Optimizer” plugins
    These plugins often mangle the MapPress JavaScript and CSS files.  They usually have a setting where you can exclude certain scripts. Try excluding the Google Maps API and the MapPress JavaScripts and CSS:
    • mappress_index.js
    • mappress_admin_index.js
    • mappress.css
  • Theme missing wp_footer() call
    The wp_footer() call is used to load JavaScripts. It’s a required call, but it’s sometimes missing in custom themes. The fix is to just add it to the theme footer file:

Map error

The map container may show an error message instead of the map:

  • Google Maps API key missing
    Enter a Google API key in the MapPress settings screen.
  • Google Maps API loaded multiple times
    This is caused by another plugin or the theme loading the Google Maps API twice. Try checking the setting ‘Prevent loading Google Maps multiple times’ or “Output maps in iframes”, in the in the MapPress settings. If this doesn’t resolve the issue, contact the author of the other plugin/theme to determine how to prevent it from loading the Google Maps API.
  • Google Maps API not loaded or Leaflet library not loaded
    This is a theme or plugin problem. See the section “Map Doesn’t Display” to figure out which one.
  • Underscore library not loaded or Obsolete jQuery version
    Some themes and plugins load obsolete versions of the jQuery or underscore.js JavaScript libraries.  See the section “Map Doesn’t Display” to figure out which plugin (or theme) is causing the problem. Try to update the theme or plugin to the latest version.  If that doesn’t help, you’ll need to contact the author to resolve the problem, or deactivate it.

Address not found

MapPress includes several geocoders, which are responsible for finding addresses and translating them into map coordinates. The free geocoders (Nominatim and Algolia) aren’t very accurate. If you have an address that can’t be found, try either switching to Google or using the Mapbox geocoder with Leaflet maps.

Will I lose my maps when I upgrade to MapPress Pro?

No! All of your maps will continue to work.  You’ll gain all the new Pro features but your existing maps are fully compatible.

Translating MapPress

Please see here: Translating MapPress

Maps not displaying inside tabs or other hidden elements

Please see here: MapPress in Tabs and Hidden Elements

Still Stuck?

I’ll be happy to help.  Please contact me and let me know you’ve already taken the steps listed above.  Please send everything I might need to reproduce the problem, including any error messages and a URL or screenshots illustrating the problem.