MapPress FAQ

Maps don’t load

If maps don’t load at all, or you just see a spinning icon, then the MapPress javascript was not loaded on the page.  This can be caused by a theme or another plugin. 

Try deactivating your other plugins and switch to a standard theme to isolate the conflict.  The most common issues are:

  • Themes that don’t call wp_footer()
    See here for details: http://codex.wordpress.org/Function_Reference/wp_footer
  • Themes and plugins that load obsolete versions jQuery
    Check your web page’s HTML source for “jquery”, the current version is 1.8.3.  You will need to update the theme or plugin to load the right version.
  • “Minifier” plugins
    You will need to exclude the MapPress files (mappress.min.js) or Google URL (maps.googleapis.com) from your minifier plugin.

Scrollbars in InfoWindows

There are two common causes for unwanted scrollbars:

  1. Images without CSS sizes
    Solution: by default, WordPress will set the image size using the width and height attributes of the <img> tag.  But Google needs it in CSS.  Try adding a style to your image tag, for example:
    <img style="width:100px; height: 100px">
  2. A bug in the Google Maps API causes the infoWindow to size incorrectly.  Please take a moment to ‘star’ this issue
    Solution: From version 2.41 on, MapPress includes a workaround for this problem.  It may work for you.  Set ‘Fix Scrollbars’ on the settings screen to enable it. 

If the ‘Fix Scrollbars’ setting doesn’t work, here are some other solutions:

  • Set a fixed width for the infoWindow (class .mapp-iw)
  • Switch to MapPress ‘infoBoxes’, which don’t have the sizing problem (you can select infoBoxes in the settings screen)

Only a corner of the map displays, the rest is a gray square

This is an issue with the Google Maps API.  When displaying a map inside an element that is initially hidden (such as a hidden tab or slider) the map is drawn at minimum size.

MapPress includes a workaround for jQuery UI TabsFor other libraries or controls, you’ll need to implement your own solution using Javascript or CSS:

  • Javascript
    Javascript can be used to re-draw the map (at the correct size) when the hidden element is displayed.  Some controls include an event for this purpose, or you can attach an onclick() handler to an element such as a link or a tab header.  This line will re-draw the first map on the screen:
    mapp0.resize();
  • CSS
    In some cases it’s possible to use CSS instead of Javascript.  The idea is to position hidden content off-screen instead of hiding it.  For example, use “visibility:hidden” or “left:-99999″ instead of “display:none” for hidden elements.

AJAX errors

The primary reasons for AJAX errors are:

Error “sensor parameter must be true or false”

This error indicates that another plugin or the theme is also loading the Google Maps API (incorrectly), or that the sensor parameter is being removed, usually by a caching or minifying plugin.  Try disabling your other plugins and switching to the twenty twelve theme to isolate the problem.  If you are using the “rocket loader” then see the next issue below for information about disabling it.

Map is visible, but POIs are missing and the map can’t be moved

This is caused by a bug in the “rocket loader” from Cloudflare.com.  To disable rocket loader, login to your cloudflare account, then go to Settings > Performance Settings, and set the ‘Rocket Loader’ setting to ‘off’:

POIs are in the Ocean near Africa

This happens when a POI can’t be geocoded.  Either the POI location is invalid or you are over your Google query limit.  See the documentation for information about query limits.

If you are generating maps from custom fields, the plugin will write any error messages to a custom field called ‘mappress_errors’ when a post is saved or published.  If you creating maps using PHP, the geocode() function returns a WP_Error object with any messages.

Changing marker icons

MapPress Pro is required to change the map icons.  

Map exists but doesn’t appear in the post

Check that a shortcode is present in the post.  The documentation shows you how to do it step by step.

A post displays the shortcode

This indicates MapPress has been deactivated or it can occur because of a very old WordPress bug: each shortcode must be on a separate line.  Edit the post and check that there is a carriage return between shortcodes and any surrounding text.

The infoWindows have thick black shadows

This is a bug in Google Maps that affects Internet Explorer when the browser zoom is anything other than 100%.  The only fix is to set the zoom using the IE menu “view –> zoom”.

How can a marker be moved?

In the map editor just drag the marker to the correct position.

General troubleshooting tips

These simple steps will fix most issues:

  1. Disable all other other plugins and switch to a standard theme
    Most conflicts occur because of theme or plugin conflicts.  If disabling them corrects the problem, re-activate until you find the conflict. 
  2. Out of memory
    By default WordPress allocates barely enough memory to run a blog without plugins.  There are several plugins to check free memory (for example: http://wordpress.org/extend/plugins/wp-memory-usage/).   If memory is low increase the blog’s memory.

Translating MapPress

WordPress plugin translations are created using the POEdit utility. MapPress translation files are stored in the languages directory of the plugin. 

Creating a New Translation

  1. Download the latest POEdit
  2. Run POEdit and open the master file mappress.pot or mappress.po from the languages directory of the MapPress plugin
  3. Use the menu File->Save as to save it as a .po file (a translation).  The file name must include an extension for your language.  For example, ‘mappress-es_ES.po’  is for Spanish.  A list of valid language extensions is here.
  4. Translate the strings.
  5. When you’re done use menu ‘file->save’ to save the file again.  POEdit should create a .MO file (a compiled translation) with the same base name as your .PO file.
  6. Send me both the .PO and .MO files, and I’ll include them with all future versions of MapPress!

Updating an Existing Translation

MapPress texts change frequently so you may find there is an existing .PO file for your language but the translation isn’t up to date.  If that happens:

  1. Run POEdit and open the .po file.  For example, for Spanish open mappress-es_ES.po
  2. Use the menu Catalog->Update from POT file. Select the file mappress.pot or mappress.po
  3. Update any missing strings.
  4. Correct any fuzzy strings (they appear in a different color at the top of the file).  For each one, click on menu Edit->Translation is Fuzzy to remove the fuzzy indicator.  You can also hit ALT-U.
  5. Save your .PO file.  POEdit should re-generate the corresponding .MO file.
  6. Send me both the .PO and .MO files, and I’ll include them with all future versions of MapPress!

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.