Shortcodes
Overview
This section covers how to display maps on the front end, using shortcodes instead of Gutenberg blocks. Shortcodes can be used to displayed maps as configured in the Map editor, or addional parameters can be included to modify certain aspects of how the maps are displayed
Prerequisites
The Following Plugin/s need to be installed and active
- WP Go Maps
- WP Go Maps Pro add-on
Sections
Default Shortcode
To add your Map to a page on your website, you will need to add the Map shortcode to your WordPress Post or Page. To find the Map shortcode, please see the shortcode listed against the corresponding map record on the maps page.
WP Go Maps -> Maps
You can copy and paste the shortcode shown to the far right in the list of your Maps on the Post or Page where you want to display your Map. The shortcode framed in red wpgmza id="1" displays the Map with ID “1”.
Map Mashup
A Map Mashup allows you to join multiple maps into one map. Your shortcode for a Map Mashup will look something like this:
You will need to use the shortcode parameters below to create your Map Mashup:
- ID: The ID parameter is the ID of the Main Map (This MUST be the same as the parent_id – so in the example above “2”
- Mashup: Set as true to indicate you that you would like this map to be a mashup.
- Mashup IDs: Include the IDs of all Maps you want to “mashup” in a comma-separated list.
- Parent ID: The parent_id identifies the specific map from which the map settings will be drawn for the Map Mashup. In this case, whatever color or size is set for Map ID 2 will be used for the Mashup Map.
Category Usage
Suppose you only want to show a certain marker category on your map. You need to make sure that the Category exists and that the Category ID is correct. See:
WP Go Maps -> Categories
To restrict your map to only the Europe category, add the Category ID (6 in this example above) to your shortcode as follows:
Only the markers that have the Europe category will be displayed on the Map.
Focus on a Specific Marker (at a Specific Zoom Level)
This can be achieved by adding the following parameters to your Map shortcode:
Marker
Accepts the Marker ID (number) you want to reference. You can find the Marker ID in your Marker Listing
WP Go Maps -> Maps (edit your chosen map) -> Markers (scroll to the bottom of the page where existing markers are listed)
Zoom
The zoom level you want for the Map. This is a number between 1 and 21.
For example:
Enable/Disable Directions
Suppose you”ve enabled directions for a Map using the WP Go Maps Dashboard interface, but need to use the Map without directions on a specific Post or Page. Simply include the enable_directions parameter in your shortcode. enable_directions="1" will enable and enable_directions="0" will disable directions.
Enable/Disable the Category Filter
Suppose you’ve enabled a Category filter for a Map using the WP Go Maps Dashboard interface, but need to use the Map without the filter on a specific Post or Page. Simply include the enable_category parameter in your shortcode. enable_category="1" will enable and enable_category="0" will disable the category filters.
Override ‘Opening InfoWindow Links in a New Tab’ Setting
If you”ve enabled opening InfoWindow links for a Map in a new tab/window using the WP Go Maps Dashboard interface, but need to change that setting on a specific Post or Page, you can simply include the new_window_link parameter in your shortcode. new_window_link="yes" will enable and new_window_link="no" will disable the link opening in a new window.
Separate Visitor-Generated Markers Form from Map
If you”d like to have your Visitor-Generated Marker form appear on a separate page from your Map, you can use the wpgmza_vgm_form link_to_map="1" shortcode. Please note, however, that his shortcode requires the Visitor Generated Markers Addon.
Paste the following shortcode on the page where you want the VGM form:
wpgmza_vgm_form link_to_map – The map ID you”d like your markers to be added to. (Required) redirect_to – The url of the page where the visitor will be redirected to, after adding the marker. (Optional)
If the redirect_to attribute directs to the map where the marker was added, remove the VGM form on that page by adding the following attribute to the map shortcode disable_vgm_form="1"
