[Pro] Display external list of active entries

You are here:

In the Pro version you can add a list or dropdown of the entries that exist on the map. Interactions with the list or dropdown entries will also reflect on the map. To add the list or dropdown to your page you’ll need to use shortcodes. Small pieces of code that will then be converted to the list of entries when the actual page loads.

So if you’re using a shortcode also for the map, you would have something like:

[display-map-list id='25'] [display-map id='25'] 

You can use your page builder to divide this in columns for example. Below are more information on how to implement this.

Display a List

To display a list with the active entries from a specific map that interacts with the map itself, you can use the following shortcode format:

[display-map-list id='X']

Replacing X with the ID of the map you want to represent. Since this is a shortcode you can display it anywhere you want on your page.

Display a dropdown

To display the list in a dropdown format, you can use the following shortcode:

[display-map-dropdown id='X']

When an option is selected in the dropdown, it will trigger the click action on that option, if the map is on the same page.

Using the list/dropdown on different pages

You can use the above shortcode on different pages, where the map is not present. You can include the extra ‘url’ parameter to have the entries link to the page where the map is and have the selected entry display on the map by default.

[display-map-dropdown id='X' url='https://link_to_map_page']

Change Label

If instead of the name of the region/marker you need to use a different label for your list entries, you can use the label parameter in the shortcode. This is particularly useful if you’re using external data sources. At the moment however it only supports top level parameters. For the dropdown, you can control this directly in the map edit screen, in the map controls options.

[display-map-list id='X' label='name']

Include Overlay Entries

The dropdown option will follow the options set in the Map Features > External dropdown.
For the list option, if your map has overlays and you want to include them, use following parameter:

[display-map-list id='X' include-overlay='1']

Styles

Currently it’s only possible to change the visuals of the list using custom css. You can use variations of the following custom css example to target the list:

ul.igm_entries_list li {
  list-style-type: circle;
}

Troubleshooting

If nothing happens when you select an entry from your dropdown or list, the most common reason is the region/marker title/identifier having special characters. Make sure the title of the entries doesn’t have any commas, quotes and other characters like that. The tooltip content and action content can have special characters, just the title/identifier shouldn’t have them.