How to update from v3.1.1 to v4 and migrate existing maps

Category:

User guides

Topic:

Migration from v3.1.1

Update January 2023: as Maps Marker Pro 3.1.1 (and below) is not compatible with PHP 8.x – you have to switch to PHP 7.4 or lower to be able to update to Maps Marker Pro 3.1.1 (which is needed for – optional – data migration)

As technically speaking Maps Marker Pro 4 is a new plugin in contrast to v3.1.1, the update process is a bit different than usually:

In order to be able to update to v4, you first have to update to v3.1.1:

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.

After update to v3.1.1 is finished, you are ready to start the installation of “Maps Marker Pro” 4 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) before activating “Maps Marker Pro” (v4):

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

Starting with Maps Marker Pro 4.0, marker maps have been deprecated, but can still be used for backwards compatibility. However, additional shortcode attributes are needed in order to make them look the same. Due to the high risk of doing this programmatically, we require you to replace these shortcodes manually. Start the migration check to get a list of used marker maps and their updated shortcodes. Only shortcodes in posts and pages can be detected, so please also check if you are using any shortcodes in widgets or other places. Start this check by clicking on the button “Check migration”:

If you are using marker shortcodes in your posts or pages, you will be shown a list of a table of results:

As next step, click on “Start migration” (to migrate your map data from the old to the new database schema).

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

Afterwards use the edit link for each marker shortcode appearance and replace the marker shortcode in related content with the shortcode from the row “New shortcode”. Example: the post “Events” from the screenshot above uses the shortcode [mapsmarker marker="1"] – this has to be replaced with [mapsmarker marker="1" basemapDefault="osm" width="640" widthUnit="px" height="480" panel="true"] once.

Please do not delete Maps Marker Pro 3.1.1 until you have verified that all data has been migrated correctly. We also recommend to make a backup of the wp_leafletmapsmarker_layers and wp_leafletmapsmarker_markers database tables, to be able to run the migration again at a later point, should it become necessary.


Updated on 13 February 2023