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
- Map Mashup
- Category Usage
- Focus on a Specific Marker (at a Specific Zoom Level)
- Enable/Disable Directions
- Enable/Disable the Category Filter
- Override ‘Opening InfoWindow Links in a New Tab’ Setting
- Separate Visitor-Generated Markers Form from Map
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
Locating your map shortcode
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”.
[wpgmza 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:
[wpgmza id=”2″ mashup=true mashup_ids=”2,3″ parent_id=”2″]
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.
Mashup example
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
Restricting categories
To restrict your map to only the Europe category, add the Category ID (6 in this example above) to your shortcode as follows:
[wpgmza id=”1″ cat=”6″]
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
Zoom #
The zoom level you want for the Map. This is a number between 1 and 21.
For example:
[wpgmza id=”1″ marker=”17″ zoom=”5″]
Marker and Zoom arugments
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.
[wpgmza id=”1″ enable_directions=”1″]
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.
[wpgmza id=”1″ enable_category=”0″]
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.
[wpgzma id=”1″ new_window_link=”yes”]
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=”Map ID” redirect_to=”Page Link”]
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)
Inserting the VGM form
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″
[wpgzma id=”1″ disable_vgm_form=”1″]
