The #1 mapping solution for WordPress sites
Ready-to-use with free maps & free geocoding

Maps Marker Pro v4.0-beta2 is available

With the release of Maps Marker Pro v4.0-beta2 we are getting one step closer to final release, thanks to all beta testers for your feedback!

Version 4.0 of Maps Marker Pro features a complete object-oriented rewrite of the codebase. While this process took quite a few months to complete, the long-term benefits are absolutely worth it. Not only does the new code dramatically decrease load times and enhance security, but it also makes it much easier for us to fix bugs or implement new features.

Please note that we are still optimizing the code during the beta phase. This version includes a fundamental change to the database, which means you MUST reset the database or run the data migration again if you updated from version 4.0-beta1.

To avoid loss of data, please do not use beta versions for production sites and do not delete version 3.1.1 until 4.0 has been released, as more fundamental changes might be necessary!

Please be aware of some profound changes:

  • changes to map concept: with v4.0 only maps and markers will be available anymore (the term layer maps is no longer used; marker maps cannot be created anymore – existing marker maps will be migrated).
  • support for gpx elevation charts and waypoints has been added
  • Leaflet.GestureHandling support has been added (Brings the basic functionality of Maps Gesture Handling into Leaflet and prevents users from getting trapped on the map when scrolling a long page).
  • all settings for “Map defaults” in the Settings area have been removed – you can use the link “Save current values as defaults for new maps” instead when created a new map
  • options to display the list of markers right or left to a layer map has been added
  • MapQuest basemap support has been removed (due to MapQuest basemaps now requiring their own API, making them incompatible to be implemented into a standard Leaflet installation; existing MapQuest maps will be switched to OpenStreetMap automatically)
  • (retired) Wikitude augmented reality API has been replaced with API
  • (retired) Visualead QR code generator has been replaced with local QR code generator BaconQrCode

New features/changes/fixes since v4.0-beta1:

  • support for (unlimited) custom basemaps and overlays
  • Photon@Mapsmarker: show street+housenumbers if available
  • implement newer Bing Maps plugin (with support for additional styles)
  • update gesture handling plugin to latest version (including translation support)
  • rewrite and reorganize settings page
  • load GPX tracks automatically on backend and fit bounds
  • improve GPX file selection
  • implementing button to remove GPX track on backend
  • show map name in ‘assigned to map’ tab
  • add column sorting for map list
  • add column sorting for marker list
  • enable chunked loading for marker cluster
  • remove worldCopyJump setting (enabled by default)
  • remove Google Maps API dequeue logic
  • remove obsolete ORS settings
  • don’t show filters control if no filters are available
  • don’t show layers control if no basemaps or overlays are available
  • don’t show minimap if no basemaps are available
  • only show GPX files when using media library on edit map page
  • fix broken maps inside tabs (shortcode attribute tabbed=”true” has to be added)
  • fix GoogleMutant iOS issue (links in popups not clickable)
  • fix maps not showing in IE/Edge
  • fix admin bar menu order
  • fix map defaults not saving correctly
  • fix bulk actions for maps and markers
  • fix errors and warnings during data migration
  • fix directions link in popups and update ORS URL

The following feature has not been ported yet but will be added with the next v4.0 beta release:

  • CSV/XLS(X)/OS import and export (will be replaced with JSON import/export)

The following feature has not been ported yet and will be added with v4.1:


The design and interface on backend is also not final yet – the current focus is to test the new features and optimized code.

Let us you think about this new release & send your feedback by using our helpdesk (prefered) or directly via email to

Full changelog

Development changelog for version 4.0

complete rewrite / refactorization of the code base from procedural to object oriented
separation of JavaScript from PHP to allow for caching and significantly increase page loading speed
decreased download size for marker data, allowing for up to 75% faster map loading
advanced customisation for maps: settings are now saved on a map basis instead of globally
upgraded leaflet.js ("the engine of Maps Marker Pro") from v1.0.3 to v1.3.4 including optimizations and bugfixes - please see blog post on and full changelog for more details
support for gpx elevation charts and waypoints
support for HERE basemaps
options to display the list of markers right or left to a layer map
option to add a link instead of a popup for markers
Leaflet.GestureHandling support (prevents users from getting trapped on the map when scrolling a long page)
(retired) Wikitude augmented reality API has been replaced with API
optimized permission system with Maps Marker Pro capabilities for better access control (attention: by default only admins have access!)
fractional zoom support (new interaction options: zoomDelta and zoomSnap)
separate settings to show address, coordinates (new) and directions of markers in popup
support for Google Traffic and Google Transit layers (disabled by default)
support for bing canvas dark, canvas light and canvays grey basemaps
option to set maximum boundaries for maps to limit panning (button "restrict to current view")
possibility to override global settings for each map by using new shortcode parameters
batch selection buttons (all/none) for layers in filter controlbox
API dashboard for Photon@Mapsmarker geocoding at showing the API usage of the last hour
automatically parse map shortcodes in category & post tag description and term fields
support for condensed attribution
options to change positions of all available control boxes
option to add existing markers to maps added with shortcodes only (e.g. [mapsmarker lat="48" lon="16" markers="1,2,3,4"] )
new shortcode parameter tabbed="true" for displaying maps in tabs
Easily change defaults for new maps by using the "Save current values as defaults for new maps" feature
compatibility check for LiteSpeed Cache which can cause maps to break
add Yoast SEO sitemap integration
improved performance by reducing the number of database queries needed and the use of caches where possible
optimized CSS & JS loading mechanism resulting in load time reduction of up to 20%
CSV/XLS(X)/ODS import/export has been replaced with native JSON import/export feature (tutorial for converting JSON into office formats)
simplified map concept: "marker maps" have been removed, "layer maps" were renamed to "maps" (to which you can assign objects like markers)
simplified multi-layer-map concept, now called filters with the option for custom sort order of filters
Photon@Mapsmarker: show streetnames+housenumbers for geocoding results if available
removed MapQuest basemap support (due to MapQuest basemaps now requiring their own API, making them incompatible to be implemented into a standard Leaflet installation; existing MapQuest maps will be switched to OpenStreetMap automatically)
removed depreciated Mapbox v3 integration (will be replaced with v4 with a future release)
removed six compatibility checks for plugins/themes which are not needed anymore due to Maps Marker Pro 4.0 rewrite
removed settings for (depreciated) mobile web app launch images and add simplified support for web app icons
replaced (retired) Visualead QR code generator with local jQuery QR code generator (QR codes can now be accessed on backend / "list all maps" only)
disabled tooltips by default on mobile devices as hover event is not available (thx Dirk!)
set interaction option "tap" to false by default to prevent issues with scrolling over maps on mobile devices (thx Thomas!)
increased rate limit for Photon@MapsMarker geocoding from 5.000 to 10.000 requests per day and from 10 to 20 requests per second
load map tiles for OSM Black&White and DE variant via https to prevent mixed-content warnings (thx Annette!)
reduced timeouts for license API fallback calls to prevent issues on sites with connection issues
update leaflet-locatecontrol from v0.58 to v0.62 (includes bugfixes & leaflet 1.1.0 compatibility)
update leaflet-fullscreen codebase (support AMD and Node/CommonJS module systems, thx mpschaeuble!)
updated minimap addon from v3.4.0 to v3.5.0 (support for miminize/restore events - release notes)
optimized plugin folder structure (some plugin compatibility configs might need to be re-applied)
updated Algolia autocomplete.js from v0.21.7 to v0.28.2 (changelog)
updated es6-promise for IE11/Google Mutant from v4.1.0 to v4.1.1 (bugfix release)
updated Leaflet.MarkerCluster.LayerSupport from v1.0.3 to v1.0.4 (fixing issues with chunkedLoading)
do not strip input tags from popuptexts if option "HTML filter for popuptexts (wp_kses)" is enabled
updated EdgeBuffer plugin for pre-loading tiles beyond the edge of the visible map to v1.0.6
minimum required WordPress version for Maps Marker Pro increased to 4.5 (needed for Gutenberg compatibility)
removed hash plugin
shortcode parsing for WordPress audio and video tags in popups on layer maps was broken if wp_keses() was enabled
list of markers: show entries only once if marker is assigned to several layers
activation & deactivation functions were not processed since v3.0
broken permalink compatibility check returning wrong URL
incorrect marker count on list of markers when using multi-layer-maps
incorrect content-type when using callback for GeoJSON
WPML/Polylang: missing string registration for translatable elements if importer is used (thx Laurent!)
admin dashboard widget could be broken if PHP 7.1+ was used
OOM (Out of memory) error during SPBAS local key validation
manual selection of Slovenian as interface language was broken (thx Igor!)
Google logo link was broken on iOS devices
improved: global sanitation check for settings array instead of individual output filtering
updated Bosnian translation thanks to Kenan Dervišević→ contribute
updated Catalan translation thanks to Roc, Efraim Bayarri, Vicent Cubells and Marta Espinalt→ contribute
updated Czech translation thanks to Viktor Kleiner and Vlad Kuzba→ contribute
updated Danish translation thanks to Mark Aabo Pedersen, Mads Dyrmann Larsen and Peter Erfurt→ contribute
updated German translation thanks to Daniel Luttermann and Thorsten Gelz→ contribute
updated Greek translation thanks to Philios Sazeides, Evangelos Athanasiadis and Vardis Vavoulakis→ contribute
updated Spanish translation thanks to David Ramí­rez, Alvaro Lara, Victor Guevara, Ricardo Viteri, Juan Valdes & Marta Espinalt and Fernando Coello→ contribute
updated Spanish/Mexico translation thanks to Victor Guevera and Eze Lazcano→ contribute
updated Finnish (fi_FI) translation thanks to Jessi Björk→ contribute
updated French translation thanks to Vincèn Pujol, Rodolphe Quiedeville, Fx Benard, cazal cédric, Fabian Hurelle and Thomas Guignard→ contribute
updated Galician translation thanks to Fernando Coello→ contribute
updated Hungarian translation thanks to István Pintér and Csaba Orban→ contribute
updated Croatian translation thanks to Neven Pausic, Alan Benic and Marijan Rajic→ contribute
updated Indonesian translation thanks to Andy Aditya Sastrawikarta & Emir Hartato and Phibu Reza→ contribute
updated Italian translation thanks to Luca Barbetti and Angelo Giammarresi→ contribute
updated Japanese translations thanks to Shu Higash and Taisuke Shimamoto→ contribute
updated Korean translation thanks to Andy Park→ contribute
updated Lithuanian translation thanks to Donatas Liaudaitis and Donatas Liaudaitis→ contribute
updated Latvian translation thanks to Juris Orlovs and Eriks Remess→ contribute
updated Malay translation thanks to Mohd Zulkifli→ contribute
updated Norwegian (Bokmål) translation thanks to Inge Tang→ contribute
updated Dutch translation thanks to Marijke Metz, Patrick Ruers, Fokko van der Leest and Hans Temming→ contribute
updated Polish translation thanks to Pawel Wyszyński, Tomasz Rudnicki, Robert Pawlak, Daniel and Paul Dworniak→ contribute
updated Portuguese - Brazil (pt_BR) translation thanks to Fabio Bianchi, Andre Santos and Antonio Hammerl→ contribute
updated Romanian translation thanks to Arian, Daniel Codrea and Flo Bejgu→ contribute
updated Russian translation thanks to Ekaterina Golubina (supported by Teplitsa of Social Technologies - and Vyacheslav Strenadko,→ contribute
updated Slovenian translation thanks to Igor Čabrian→ contribute
updated Slovak translation thanks to Zdenko Podobny→ contribute
updated Swedish translation thanks to Olof Odier, Tedy Warsitha, Dan Paulsson, Elger Lindgren, Anton Andreasson and Tony Lygnersjö→ contribute
updated Thai (th) translation thanks to Makarapong Chathamma and Panupong Siriwichayakul→ contribute
updated Turkish translation thanks to Emre Erkan and Mahir Tosun→ contribute
updated Ukrainian translation thanks to Andrexj, Sergey Zhitnitsky and Mykhailo→ contribute
updated Vietnamese (vi) translation thanks to Hoai Thu→ contribute
updated Chinese translation thanks to John Shen and ck→ contribute
updated Chinese (zh_TW) translation thanks to jamesho Ho→ contribute

how to update to 4.0-beta2

Warning: Please note that we are still optimizing the code during the beta phase. This version includes a fundamental change to the database, which means you MUST reset the database or run the data migration again if you updated from version 4.0-beta1.

To avoid loss of data, please do not use beta versions for production sites and do not delete version 3.1.1 until 4.0 has been released, as more fundamental changes might be necessary!

In addition we recommend to backup your site (especially the database) regularly so in case of an issue with this beta release you can always perform a full rollback if needed!

As technically speaking Maps Marker Pro 4.0 is a new plugin, the update process is a bit different than usually:

In order to be able to update to this beta release, you first have to set beta-testing in Settings / Misc to enabled:

As next step after saving your settings, navigate to Plugins and click on the link “Manually check for updates” next to “Maps Marker Pro”:

As next step click on the link “Update now” to update to v3.1.1-beta1.

After update to v3.1.1-beta1 is finished, you are ready to start the installation of “Maps Marker Pro” 4.0 as new plugin. So please click “please click here for more information” to proceed to the next step:

This will take you to the “Update to Maps Marker Pro 4” page. Start the installation as new plugin by clicking on the button “Sounds good! I want to update to Maps Marker Pro 4 now!”:

After the plugin has been installed, please first deactivate “Maps Marker Pro” (v3.1.1-beta1) before activating “Maps Marker Pro” (v4.0-beta2):

After activating v4.0-beta2, you will see an admin notice which will take you to the data migration tool page:

As next step, please start the datamigration by clicking the button “Start Migration”:

After migration is finished, you will see the message “Data migration completed successfully”:

That´s it – now you can start using Maps Marker Pro v4.0-beta2.

Please do not delete v3.1.1 at least unless v4.0 final is available, as there still might be changes to the database structure and the need to re-run the migration tool to update your data!

how to install 4.0-beta2 from scratch

For directly downloading and installing the v4.0-beta2 package as zip file, please click here.

Please make sure to also set beta-testing in Settings / Misc to enabled to get notified about future beta releases!

how to rollback to v3.1.1-beta1

If you want to use v3.1.1-beta1 again, please first deactivate Maps Marker Pro v4.0-beta2 and then activate Maps Marker Pro v3.1.1-beta1 again.

Please be aware that any maps which have been created with Maps Marker Prov 4.0-beta2 will not be visible with Maps Marker Pro v3.1.1-beta1, as a complete new database schema is used!

Leave a Comment

XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>