Skip to main content

Installation

Uploading​

Once you've purchased the MapSVG WordPress mapping plugin, download the .zip file from the MapSVG Dashboard to your computer.

Now you need to upload MapSVG to your WordPress website. There are 2 ways of doing this:

1. Upload via WordPress Admin​

Open your WordPress admin panel, go to Plugins > Add new > Upload, and select the .zip file that you downloaded from CodeCanyon.

info

If you see a "The link has expired" error — this usually means you need to increase the max upload file size in php.ini settings:

upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

Now in your WordPress admin panel go to Plugins > Installed plugins, find MapSVG and click Activate. MapSVG will appear in the main WP Menu on the left.

2. Upload via FTP​

An alternative, in case WordPress Admin Upload does not work: unzip the file that you downloaded from CodeCanyon. Open your WordPress installation folder using any FTP manager (for example Cyberduck, FileZilla, or Total Commander). Go to the wp-content/plugins/ folder and upload the "mapsvg" folder you previously unzipped.

Now in your WordPress admin panel go to Plugins > Installed plugins, find MapSVG and click Activate. MapSVG will appear in the main WP Menu on the left.

Activating​

Activating and enabling automatic updates​

  1. Log in to the MapSVG Dashboard
  2. Find your license in the table and copy your License Key
  3. Open WP Admin > MapSVG and paste your License Key in the activation info box at the top
  4. Click Activate

Enabling support chat in the plugin​

  1. Log in to the MapSVG Dashboard
  2. Go to Settings
  3. Click the Show button next to the API token field. The token will be copied to the clipboard automatically.
  4. Go to WP Admin > MapSVG
  5. Click the Support button in the top toolbar
  6. Paste the API token and click Save

Updating the plugin​

Automatic updates in WP Admin​

This feature is available since version 5.8.0.

  1. Log in to the MapSVG Dashboard
  2. Copy your License Key
  3. Go to WP Admin > MapSVG and paste your License Key
  4. Click Activate. 2

WordPress will now periodically check for updates. You can also check for updates manually: go to WP Admin > Plugins. Find "MapSVG" in the list of installed plugins and click the Check for updates link.

To update the plugin, click Update now: 1

Manual update: uploading .zip in WP Admin​

Download the .zip with the new plugin version from the CodeCanyon > Downloads page to your computer.

Now you need to upload MapSVG to your WordPress website. There are 2 ways to do this:

Open your WordPress admin panel and go to Plugins. Find MapSVG, click Deactivate. When the page reloads, find MapSVG again and click Delete. Now go to Plugins > Add new > Upload. Upload the .zip with the plugin, then click Activate.

Updating from versions <5.4.0

If you uploaded custom marker images to the mapsvg/markers folder, they will be lost with this method of updating. You'll need to upload them again, or use the second method of updating shown below that doesn't delete the mapsvg/ folder. Since v5.4.0, markers are uploaded into a separate folder.

Updating from versions 1.x or 2.x

If you uploaded custom maps — they will be lost if you delete the plugin folder. Back up your custom maps from the mapsvg/maps folder via FTP.

Manual update: uploading via FTP​

An alternative, in case WordPress Admin Upload does not work: unzip the file that you downloaded from CodeCanyon. Open your WordPress installation folder using any FTP manager (for example Cyberduck, FileZilla, or Total Commander). Go to the wp-content/plugins/ folder and upload the mapsvg folder you previously unzipped, overwriting the existing wp-content/plugins/mapsvg folder and all files inside it.

Now in your WordPress admin panel go to Plugins > Installed plugins, find MapSVG and click Activate. MapSVG will appear in the main WP Menu on the left.

Migrating to another server​

MapSVG includes WP-CLI commands for exporting and importing map data (available since version 8.10.0). Use these when moving MapSVG to another WordPress site.

1. Export maps on the old server​

SSH into the old server, go to your WordPress root directory, and run:

wp mapsvg export

This creates an SQL dump of all MapSVG database tables.

If the new site will use a different domain, replace the old domain in the export:

wp mapsvg export --toDomain=new-domain.com

2. Import maps on the new server​

Copy the generated .sql file to the new server. Install and activate MapSVG there, then run:

wp mapsvg import /path/to/file.sql

3. Copy custom SVG files​

If you uploaded custom SVG files on the old server, upload them on the new server with the Upload SVG file button on the MapSVG start screen, or copy them via FTP from wp-content/uploads/mapsvg to the same path on the new server.