FAQ – Frequently Asked Questions

Pre-purchase Questions

Can I display multiple maps per page?

Yes you can. You can create multiple maps and display them all the in the same page or post.

Do I have to upload my own SVG maps, or the plugin already includes the maps?

You don’t have to upload any maps. The maps are all already included. You just need to choose what area to display from a dropdown menu. The plugin creates the maps with the Google Geochart API that includes maps of all the world. The plugin only works with the SVG maps provided by Google.

Are the maps responsive?

The plugin includes an option to transform all the maps in Fully Responsive Maps. This will use jQuery to check if the window size changed and will redraw the map with the new available space.

Is this plugin compatible with a WordPress Multisite installation?

Yes, although it must be activated in a specific way to work properly.

The correct way to install this plugin in a multi-site setup is to install it as network admin, but activate it as blog admin. This way the plugin will get the proper database prefix and will create tables for each blog. While at the same time the files will not need to be copied in every blog.

If you activate this plugin as network admin it simply won’t work correctly in the network blogs.

Does the plugin include a map of US divided by counties?

The current version of the plugin only has the US divided by States and DMA regions. It doesn’t include a map of US divided by counties.

This limitation comes from the Google Geochart API, which the plugin uses to generate the maps. The API doesn’t have a county map for US. It’s a very popular request, but so far Google people didn’t make these maps available. If they ever make the US counties map available my plugin will for sure include the map.

Does the plugin include a map of UK divided by counties?

The current version of the plugin only has the UK divided in it’s 4 sub-divisions (ENG, NIR, SCT and WLS).

This limitation comes from the Google Geochart API, which the plugin uses to generate the maps. The API doesn’t have a county map for UK. It’s a very popular request, but so far Google people didn’t make these maps available. If they ever make the UK counties map available my plugin will for sure include the map.

Is there a limit to the number of markers/regions I can render in a single map?

The Google Geochart API only allows up to 400 entries of data for each map. So your map can only render 400 markers for example.

Is there a non-WordPress version of this plugin?

Yes. You can find more information about the standalone version here.

Issues

I want the map regions/markers to open a link when they are clicked, but nothing happens!

Some users forget to choose the ‘Action’ the map needs to perform when the user clicks the region/marker. There is an option called ‘Active Region Action’, where you have to select ‘Open New URL’. This will make sure the plugin knows what to do when the user clicks the region/marker. Check this screenshot for reference.

The markers / labels in my map are loading very slowly!

If you’re using “Markers Mode – Text Location” the text needs to be converted into coordinates by google geocoding which takes some time, specially if there are a lot of markers. To speed up the process you should use “Markers Mode – Coordinates Mode” instead. This way the markers already know where to be plotted, they don’t need the time to be converted from text to coordinates when loading. The same applies for the Text Labels mode.

When I use a map on a page, the scroll from that page stops working.

Some users have reported conflicts with ‘Smooth Scrolling’ option from Themes. If you are using a Theme that allows you to enable/disable a ‘Smooth Scrolling’ effect, try disabling it to see if it solves the issue.

I have placed the shortcode but the map does not display.

If this is happening, the most likely cause is that your theme is missing the wp_head() function in header.php or the wp_footer() function in footer.php.

If your theme already has this functions or you added them and the problem still persists, contact me via the form on my profile page

Why doesn’t the country X display on continent Y? (In other words: Why doesn’t Turkey render data in regions mode on Europe map, for example?)

The plugin uses the Google Geochart API, which follows the hierarchy and distribution of regions listed here: http://unstats.un.org/unsd/methods/m49/m49regin.htm

In this list countries like Turkey and Cyprus are listed under the Western Asia region. This is something controlled by the API, that I don’t have control. Many people asked Google to change this, and it’s something they said they would update at some point. When they do, the plugin will also reflect this change. Until then we have this limitation in regions mode.

Why isn’t the region X / country X visible on the map? I have included correct data but it is not visible.

If you are not seeing some regions is because they might be too small to display at the scale the map is built. The data is being rendered, but visually the size of the region is smaller than a pixel at the current scale and therefore not visible.

For example, District Columbia state will most likely be too small to be visible in the map of United States. You need to have the US map very big for it to be visible. Alternatively you can use the map of Maryland, or DC to display it.

Other examples include Malta, Singapore, Gambia, among other small territories that might not be visible because they are too small.

As a workaround to make these regions clickable, you can place markers on those locations, using the ‘overlay markers map’ technique.

The click action doesn’t work on my iPhone/iPad, but works on Desktop and Android devices!

The maps are generated using the Google Geochart API, which currently seems to have a bug when displaying HTML tooltips on iOS devices:
https://code.google.com/p/google-visualization-api-issues/issues/detail?id=1597
https://groups.google.com/d/msg/google-visualization-api/PS6BxPxU62Q/gdGLihGWusEJ
This is something that unfortunately doesn’t depend only on me to solve.

So the only solution for now would be to disable the HTML tooltips in the settings or implement a code change to disable HTML tooltips only on iOS devices:

Open the file includes/shortcode.js and search for this block of code:

/* Disable HTML tooltips on iOS */
/*if (navigator.userAgent.match(/(iPod|iPhone|iPad)/)) {
usehtml = 0;
}*/

And replace it with:

/* Disable HTML tooltips on iOS */
if (navigator.userAgent.match(/(iPod|iPhone|iPad)/)) {
usehtml = 0;
}

Seems iOS has further bugs dealing with tooltips. Hopefully the Google team will look into them:
https://github.com/google/google-visualization-issues/issues/2071

The map only displays when I load the page a second time!

If this is happening most likely your theme has some ajax loading effect or transition effect when changing pages in your website. When loading content this way, the page doesn’t process the necessary javascript for the maps to display. Only when the page is loaded directly this works well. Check in your theme options if this transition effect is something you can disable or if there’s a field where you can specify which pages not to use this effect. If this is the case place the URL for the page where your map is there.
The plugin also includes an option to load the map scripts across your website, which might solve this in some situations, but it’s not the recommended solution.

Customizations

How can I hide empty tooltips?

This might be corrected in a future update, but currently you can use this CSS in the custom css field in the settings:
.iwm_map_canvas #map_canvas_1 .google-visualization-tooltip { background:none; border:none; margin-top:20px; margin-left:20px; }
.iwm_map_canvas #map_canvas_1 li.google-visualization-tooltip-item:first-child { display:none; }
.iwm_map_canvas #map_canvas_1 li.google-visualization-tooltip-item:empty { display:none; }
.iwm_map_canvas #map_canvas_1 li.google-visualization-tooltip-item { background:#FFF; padding:3px; }

HTML tooltips should be enabled for this to take effect.

How can I add an image to the tooltip?

If you have the HTML tooltips option enabled in the settings, you can HTML tags in your content. To add an image with HTML you just need to add the following code to your tooltip content field:
<img src="https://link_to_your_image.png" alt="description" width="42" height="42" />

Can I use custom icons instead of Markers?

The maps are generated using the Google Geochart API, which doesn’t provide options to use custom markers, only round coloured markers. However, using the text labels display mode, we can choose the font-family and this way we can use font icon sets like fontawesome. Learn more about this technique.

Updates & Support

How do I update this plugin?

When a new update comes out, make sure you read the update description log on the bottom of the plugin’s page at codecanyon. After reading, you can decide if you need the update or not.

If you decide to update, here’s how you can do it:

Update via FTP – This is the safest way. If you have access via FTP to your site files, you can replace the plugin files with the updated ones. Just go to wp-content/plugins/interactive-world-maps and replace the files with the ones on the zip of the updated plugin.

Update via WordPress Admin – From the tests performed, you can deactivate and delete the plugin on the Plugin’s administration page of WordPress and upload and active the updated files. This operation should not affect the entries you have already made. However, we recommend the FTP solution, because it’s safer.

What kind of support is included?

Item support includes:

  • Availability of the author to answer questions
  • Get assistance with reported bugs and issues

Item support does not include:

  • Customizations and installations
  • Hosting, server environment, or software conflicts

For more details, view the item support policy from Envato.