FAQ

If your question is not answered below, please check the documentation or see the support page for further information on how to get help.

Expand allClose all

General (7)

Can I import markers via CSV or KML?

This feature is planned for the pro version, planned to be released in q1/2013 – please be patient!

Permalink. Mark as helpful. 28

Can I display routes (GPX) on maps?

This feature is planned for the pro version which will be available in Q1/2013 – please be patient!

Permalink. Mark as helpful. 14

I would like to use this plugin on wordpress.com

Unfortunately this is not possible at the moment, as plugins for wordpress.com are selected by automattic. Nethertheless you can write an email to plugins@wordpress.org and ask if this plugin could be included in the future (which I would very much appreciate ;-) )

Permalink. Mark as helpful. 1

Can I use this plugin within a commercial context?

Yes, you can use this plugin for free also within a commercial context. The only requirement beside following the GPL 2.0-licence is that the attribution links to the plugin and the licence conditions of the used maps don´t get removed from each map shown through the plugin on your website.

Since v2.5 the plugin also supports the usage of Google Maps as basemaps. Please be aware, that to stay in accordance with the Google Terms of Usage you have to use an API key for commercial usage. Please see http://www.mapsmarker.com/google-maps-api-key for more details.

If you are using this plugin within a commercial context, please also consider making a donation, which allows the plugin´s author to spend more time developing, maintaining and supporting this plugin.

Permalink. Mark as helpful. 2

Do I need any key or any registration to show maps in my blog?

No – you don´t need an API-Key or registration to show maps in your blog.

Permalink. Mark as helpful. 0

I would like to have feature XY in one of the next versions of the plugin

If you would like to see a special feature in one of the next versions of the plugin, please add your idea here. You can also vote for other ideas, which helps the plugin´s author aligning the plugin to the users needs.

Permalink. Mark as helpful. 0

Installation (3)

I can only see one marker icon after installation – where are the others?

I have tested the plugin installation successfully on webservers of different hosting providers. Nethertheless in some rare cases you might get following warning after the first activation of the plugin:

Warning: the custom map icon directory at /wp-contents/uploads/leaflet-maps-marker-icons could not be created due to file permission settings on your webserver. Leaflet Maps Marker will work as designed, but only with one map icon available.
You can add the included map icons manually by following the steps at http://www.mapsmarker.com/incomplete-installation

This means that the installation was successful but the default map icons included in the plugins package could not be unzipped due to permissions settings on your server. The plugin will work as designed though – but only with one map icon available.

If you want to add the included default map icons manually, please follow these steps:

  1. Create the directory /wp-content/uploads/leaflet-maps-marker-icons/
  2. copy the file /wp-content/plugins/leaflet-maps-marker/inc/img/mapicons/mapicons.zip to the directory /wp-content/uploads/leaflet-maps-marker-icons/
  3. unzip mapicons.zip into the directory /wp-content/uploads/leaflet-maps-marker-icons (you can also unzip the file locally & upload the icons)

After that, the default map icons should be available for selection on marker and layer maps. You can also repeat the steps above for more map icons from the Map Icons Collection, which consist of over 700 map icons which are compatible with Leaflet Maps Marker.

Please note that if you had to follow the steps above for the map icons to show up, the plugin´s uninstall function might also not work completely on your server (resulting in files still on your webserver after uninstall of the plugin through WordPress / Plugins). You might then have to uninstall the directory wp-content/uploads/leaflet-maps-marker-icons manually too.

Permalink. Mark as helpful. 1

Does the plugin work with PHP 4.x?

No, you need at least PHP 5.2 installed on your server to run this plugin.

One remark: support for PHP 4 has been officially discontinued since 2007-12-31, so it might generally be a good idea to update. If you´re using WordPress on a shared host, please contact your web host provider and ask them to update to at least PHP 5.2

Permalink. Mark as helpful. 1

What´s the minimum required WordPress version?

The minimum required WordPress version to run Leaflet Maps Marker is 3.0

Permalink. Mark as helpful. 1

KML (1)

KML-Issue: Custom icons don´t show up in Google Maps

Please see this article for more info about this issue and a workaround.

Permalink. Mark as helpful. 0

Troubleshooting (5)

I only get “loading map – please wait…” and no map

Since v3.1, all needed javascripts are loaded into the footer of your website for better performance. This is done by using the default function wp_footer(); which can be found in most themes in footer.php or index.php (and is also recommended for all themes by WordPress as otherwise some default functions might not work either). Here an example of footer.php:

<?php wp_footer(); ?>
</body>
</html>

So please check first within your template (e.g. wp-content/themes/YOUR_TEMPLATE_NAME/footer.php) if the function wp_footer() is present and if not, please add it to your theme as many other plugins and WordPress itself also depends on it.

If you don´t have the file footer.php, please check if the function wp_footer() is present in the file index.php.

If you added the template tag and the message “loading map – please wait…” gets displayed anyway, please follow the steps from the readme-first post in the support forum, as this could be a conflict with another plugin.

If this does not help either (or if you don´t like to add this template tag to your theme), please navigate to the plugins settings in the backend and try setting the option “Where to insert Javascript files on frontend?” under Misc / General settings to “header (+inline javascript)”:

header

Permalink. Mark as helpful. 11

I get the error “Map could not be loaded – please enable Javascript!”

Leaflet Maps Marker needs a browser which supports Javascript in order to display maps. Current version of common browsers (Firefox, Chrome, Internet Explorer or Safari) support Javascript out of the box – if you use an old version, please update to the current version (you will benefit from it in general, believe me!).

If this doesnt help, please check if you have same Javascript blocking addons/plugins like NoScript installed and active – those addons need to be disabled in order to show maps.

Permalink. Mark as helpful. 0

I can only see one marker icon after installation – where are the others?

I have tested the plugin installation successfully on webservers of different hosting providers. Nethertheless in some rare cases you might get following warning after the first activation of the plugin:

Warning: the custom map icon directory at /wp-contents/uploads/leaflet-maps-marker-icons could not be created due to file permission settings on your webserver. Leaflet Maps Marker will work as designed, but only with one map icon available.
You can add the included map icons manually by following the steps at http://www.mapsmarker.com/incomplete-installation

This means that the installation was successful but the default map icons included in the plugins package could not be unzipped due to permissions settings on your server. The plugin will work as designed though – but only with one map icon available.

If you want to add the included default map icons manually, please follow these steps:

  1. Create the directory /wp-content/uploads/leaflet-maps-marker-icons/
  2. copy the file /wp-content/plugins/leaflet-maps-marker/inc/img/mapicons/mapicons.zip to the directory /wp-content/uploads/leaflet-maps-marker-icons/
  3. unzip mapicons.zip into the directory /wp-content/uploads/leaflet-maps-marker-icons (you can also unzip the file locally & upload the icons)

After that, the default map icons should be available for selection on marker and layer maps. You can also repeat the steps above for more map icons from the Map Icons Collection, which consist of over 700 map icons which are compatible with Leaflet Maps Marker.

Please note that if you had to follow the steps above for the map icons to show up, the plugin´s uninstall function might also not work completely on your server (resulting in files still on your webserver after uninstall of the plugin through WordPress / Plugins). You might then have to uninstall the directory wp-content/uploads/leaflet-maps-marker-icons manually too.

Permalink. Mark as helpful. 1

I messed up with the plugin settings – what can I do?

Please use the function “Reset to defaults” in Settings and all settings will be reset to default.

Permalink. Mark as helpful. 0

Known incompabilities with other plugins

With v2.1 of Leaflet Maps Marker, I added an automatic check for incompatible plugins and instructions how to solve corresponding bugs (if possible). Here you find the list of plugins, which cause problems when activated together with Leaflet Maps Marker and which is also used for the automatic plugin compatibility check:

Jquery colorbox
Maps won´t be displayed if you activated the option “Automate jQuery Colorbox for all  images in pages, posts and galleries. Instead you have to choose “Automate jQuery Colorbox for images in WordPress galleries only” and “Automate jQuery Colorbox for all other images” in order for maps to show up. See this thread for details.

cformsII
When the plugin cformsII is active, the tinymce editor is broken on marker maps edit page (see here and here for details why). To fix this, please navigate to the admin area of cformsII in WordPress, select “Global settings”, then “Wp Editor Support Button” and check the option “Fix TinyMCE error”. This solves this nasty bug.

WP Google Analytics
Users reported that with this plugin active, the maps are broken. As the development of the plugin seems to be discontinued (last update was 2010), I would advise switching to a newer Google Analytics plugin, like Google Analytics for WordPress.

Better WordPress Minify
The plugin “Better WordPress Minify” can cause marker maps to break if the option “Minify JS files automatically?” is active. Please disable this option (Settings / BWP Minify) or add leafletmapsmarker to the form field “Scripts to be ignored (not minified)”

Javascript to Footer
Please deactivate this plugin in order to be able to use Leaflet Maps Marker.

Lazy Load
Please deactivate this plugin in order to be able to use Leaflet Maps Marker.

Permalink. Mark as helpful. 0

Usage (7)

How do I change the basemap to xyz?

Some people ask, how they can set the basemap to country xy for example. There seems to be some misunderstandings about the terms, which I hopefully can explain with this faq entry:

A map in Leaflet Maps Marker needs a basemap which is used for creating the map on which the markers will be displayed. By default you can use basemaps from OpenStreetMap for example with different rendering options (OSM mapnik, OSM osmarender or Mapquest OSM). These three basemaps cover the whole world, so there is no need to set an extra basemap for a specific area/country.

So if you want to add a marker for Europe, Asia or Australia, the process is quite the same: choose your location by using Google Places Search, entering coordinates or clicking on the map (see this tutorial for details).

What might be confusing to some of you is the fact, that per default, the also integrated basemap from OGD Vienna is displayed as default when adding a new marker. In the context of their open government initiative, this basemap has been release to the public under a Creative Commons licence and can be used freely by everyone. The main difference between OSM maps is, that this basemap only covers the area of Vienna.

If you want to add markers in the area of Asia regularly for example, I would advice you to change your default settings for new markers. To do this, go to settings / basemap and change the basemap to OSM mapnik for example. Then switch to the tab “marker defaults” and change the latitude and longitude values for new markers to the desired location. After saving your changes and clicking on new marker, the new default location with the default basemap gets displayed. Same steps can be done for layer maps (go to settings / layer defaults).

If your city/country/region/company… also provides a WMTS server for displaying custom map tiles (like OGD Vienna), you can configure this server via settings / basemap / custom basemap.

Permalink. Mark as helpful. 0

How do I change the shadow of markers?

The shadow image is located in /leaflet-dist/images and can be replaced there. Please note that the original file will be added again after each plugin update – I will check if I can add this to the settings in one of the next versions so that changes dont get overwritten.

If you want to disable the shadow completely, you have to set .leaflet-shadow-pane to display: none; in /leaflet-dist/leaflet.css on line 131.

Permalink. Mark as helpful. 1

How can I add maps to widgets?

Just copy the shortcode (e.g. [mapsmarker marker=”1″]) into the widget you want the map to appear.

Permalink. Mark as helpful. 3

How can I add Open Cycle Map as basemap?

1. Navigate to Settings / Basemaps / Custom basemap 1 settings
2. enter the following:

Tiles URL: http://tile.opencyclemap.org/cycle/{z}/{x}/{y}.png

Attribution: © OpenStreetMap contributors, CC-BY-SA

Min-Zoom: 1
Max-Zoom: 17
TMS: false
Support for subdomains: no
Enable continuousWorld?: false
Enable nowrap?: false

3. Navigate to Settings / Map Defaults / Available basemaps in control box

4. check the checkbox “Custom basemap”

5. Navigate to Settings / Map Defaults / Names for default basemaps

6. Change “Custom1″ to “Open Cycle Map”

7. Save Settings.
Done.
Afterwards, Open Cycle Maps is available on each marker and layer map within the layer control box.

Permalink. Mark as helpful. 0

Can I add custom marker icons?

Yes, you can choose from more than over 700 icons from http://mapicons.nicolasmollet.com. Just save the icons from there and upload them to the directory wp-content/uploads/leaflet-maps-marker-icons/ and they will show up afterwards immediately on marker/layer-edit page.

Permalink. Mark as helpful. 6

Basemap switches to OGD Vienna basemap automatically!

This is not a bug – it´s a feature :-) Leaflet Maps Marker Plugin – “Meine Platzl im Grätzl”-Edition has a built in function which checks the coordinates on new markers and layers. If the coordinates are within the boundaries of Vienna/Austria, the high-resolution maps from OGD Vienna (http://data.wien.gv.at) are preselected for you.

If you don´t want to use this feature (e.g. if you would always like to use OpenStreetMap for locations in Vienna), you can modify or disable this feature completely under Leaflet Maps Marker / Settings / Default Basemap / OGD Vienna Locator.

Permalink. Mark as helpful. 0

Can I remove the attribution text from the maps?

As this plugin is Open Source Software, you could by editing the source files directly – but I strongly encourage you not to do so, as this opposes at least the license conditions of used maps from OpenStreetMap, MapQuest and OGD Vienna.

I also ask you not to remove the link to MapsMarker.com as this plugin can be used for free and a higher publicity helps building up a user base for the plugin and encourages the plugin´s author to continue developing new features :-)

Permalink. Mark as helpful. 5

Wikitude (1)

The ARML API link doesnt display any results

If you click on the ARML link for Wikitude on a marker or layer map and don´t see the marker(s) in the output, this doesnt mean that the Wikitude API isn´t working. In order to display your marker(s) in Wikitude, you have to follow the instructions on this page first.

Once you registered your layer on wikitude.me, Wikitude accesses your given URL with the URL parameter &latitude= and &longitude= (among others)

Leaflet Maps Marker then checks if there are any markers within the radius (which you can also set in the settings of the plugin). If there are any, they get delivered as a result to Wikitude.

If a URL like http://www.[your-domain].com/wp-content/plugins/leaflet-maps-marker/leaflet-wikitude.php?layer=all gets called without the parameters &latitude= and &longitude=, the default longitude and latitude settings are used (which can also be set in the settings of the plugin, default: Vienna in Austria). I therefore would recommend setting those values within the radius of the markers you would like to display in Wikitude.
With v1.1 of Leaflet Maps Marker, there is no need anymore to set debug longitude and latitude in settings to get results when calling Wikitude API links as marker lat/lon respectively layer center lat/lon are used if Wikitude API links are called manually for testing purposes without the parameters &latitude= and &longitude=.

Permalink. Mark as helpful. 1