WordPress Interactive Map Plugin (CMML) - Using Shortcodes


Shortcodes

Back to User Guide

TIP: What Are Shortcodes

Shortcodes add dynamic content to your site via a small piece of code. Learn more: Shortcodes - How To Use

What Are Shortcodes

Shortcodes allow you to add a dynamic map with your locations to posts and pages. The WordPress Interactive Map plugin has different shortcodes depending on what you want to display. To use them, you must identify locations or categories by their IDs - learn how to display these in the edit pages.

Additionally, you can make them more specific by using parameters. For instance, you can use "category=tech" to only show that specific category.

Below, we list all the shortcodes and their parameters, along with samples to make it easier to understand. 

For reference, you can always find the list of shortcodes listed under the Shortcodes option.

Shortcodes list - Google Maps WordPress Plugin
Shortcodes list

Locations Shortcodes

1) Snippet

  • Shortcode: [cmloc-snippet]
  • Use: Displays a location's snippet. You can edit what is shown on the snippet under the Settings tab. Learn more by checking the related article on editing settings.
  • Filtering parameters:
    • id - set location ID to display specific location map
  • View paramteres:
    • featured - set the map to display interactive map or image for a static image
  • Sample: By using the shortcode [cmloc-snippet id="487" featured="map"], we are able to add a snippet of this location to the blog post.

    Displaying a location snippet - Maps Plugin
    Displaying a location snippet

2) A Specific Location Map

  • Shortcode: [cmloc-location-map]
  • Use: Shows a specific location on a map.
  • Filtering parameters:
    • id - location ID
  • View parameters:
    • theme - Choose between:
      • silver 
      • retro 
      • dark 
      • night 
      • aubergine
    • mapheight - the height of the map in pixels (decimal value without px string)
    • mapwidth - width of the map in pixels (decimal value without px string)
    • width - width of the entire widget in pixels (decimal value without px string)
    • showtitle - 0 for no, 1 for yes
    • showdate - 0 for no, 1 for yes
  • Sample: [cmloc-location-map id=1767 mapwidth=640 mapheight=480 width=700 showtitle=1 showdate=1]

    Displaying a map with specific location - Store Locator WordPress Plugin
    Displaying a map with specific location

3) Multiple Locations Map

  • Shortcode: [cmloc-locations-map]
  • Use: Displays maps with locations from a chosen category
  • Filtering parameters:
    • showonlybyparams - makes the index show only a specific map. Set as 1 in the page used for sharing locations. In technical terms, when enabled, the index will take the query of the URL in account
    • limit - the maximum number of locations (e.g. 5)
    • page - the maximum number of pages (e.g. 1)
    • category - set category ID/slug to displays locations from this category
    • taxonomy_key - set taxonomy key to displays locations from this custom taxonomy
  • View parameters:
    • theme - Choose between:
      • silver 
      • retro 
      • dark 
      • night 
      • aubergine
    • list - Choose between:
      • none
      • left
      • right
      • bottom
      • compact
    • mapwidth - width of the map in pixels (decimal value without px string)
    • width - width of the entire widget in pixels (decimal value without px string)
    • menu - show or hide a menu above the map with the buttons All locations, Add Locations and My Locations ("1" to show, "0" to hide)
    • tooltip - show or hide the info tooltip when a user clicks on a location  ("1" to show, "0" to hide) 
    • map - show or hide map ("1" to show, "0" to hide)
    • usertracking - show user track location/path ("1" to show, "0" to hide)
    • from_date - date format is ddmmyyyy. Note: this parameter was introduced in version 2.7.5
    • to_date - date format is ddmmyyyy. Note: this parameter was introduced in version 2.7.5
  • Get parameters:
    • bgcolor - add color
    • bgcolor_filter - show bgcolor filter ("1" to show, "0" to hide). Note: this parameter was introduced in version 2.7.5
    • time - add time such as l1, l3, l6, l12, p3, p6, p12
    • time_filter - show time filter ("1" to show, "0" to hide). Note: this parameter was introduced in version 2.7.5
    • identifier - add identifier
    • identifier_filter - show identifier filter ("1" to show, "0" to hide). Note: this parameter was introduced in version 2.7.5
    • from_date - date format is ddmmyyyy
    • to_date - date format is ddmmyyyy
    • hours - add hours such as 12, 24, 48
    • path - show path ("1" to show, "0" to hide)
  • Sample 1: With [cmloc-locations-map category="mountains"], we are able to display a map with all locations from a single category.
Displaying a map with multiple locations - Maps WordPress Plugin
Displaying a map with multiple locations
  • Sample 2: With [cmloc-locations-map list=left limit=4 page=1 category="111"], we can display the map with a list of locations.
Displaying a map with multiple locations and the list next to the map - WordPress Interactive Map Plugin
Displaying a map with multiple locations and the list next to the map

4) Current Locations Map

  • Shortcode: [cmloc-current-locations-map]
  • Use: Shows the current locations maps
  • Filtering parameters:
    • limit - the maximum number of locations (e.g. 5)
    • page - the maximum number of pages (e.g. 1)
  • View parameters:
    • theme - Choose between:
      • silver 
      • retro 
      • dark 
      • night 
      • aubergine
    • mapwidth - width of the map in pixels (decimal value without px string)
    • width - width of the entire widget in pixels (decimal value without px string)
    • tooltip - show or hide the info tooltip when a user clicks on a location  ("1" to show, "0" to hide) 
  • Sample: [cmloc-current-locations-map theme='silver' limit=5 page=1 mapwidth=600 width=600 tooltip=0]

5) Locations Search

  • Shortcode: [cm-location-search]
  • Use: Shows a search form to find locations
  • Sample

    Displaying the search bar - Google Maps WordPress Plugin
    Displaying the search bar

6) My Locations Table

  • Shortcode: [my-locations-table]
  • Use: Displays the user's location table, the same that is showing up in the user's dashboard
  • Parameters:
    • controls - set "1" (default) if you want to show the "Edit" and "Delete" buttons for each location or "0" if you don't
    • addbtn - set "1" (default) if you want to show the "Add location" button or "0" if you don't
  • Sample: [my-locations-table controls=1 addbtn=1]

    Displaying the user's locations table - Maps Plugin
    Displaying the user's locations table

7) REST API

Note: this shortcode was introduced in version 3.0.8.

  • Shortcode: [cmloc-api]
  • Use: Enables or disables REST API.
  • Parameters
    • status - Set "on" to enable it and "off" to disable.
    • output - Set "1" to display the status of the API, and "0" to hide output. Default value is "1". Note: this parameter was introduced in version 3.0.9.
  • Samples: [cmloc-api status="on"] or [cmloc-api status="off"]

Integration Shortcodes

1) Common Map with Routes Integration

  • Shortcode: [cmmrm-cmloc-common-map]
  • Use: Displays a common map with locations and routes from the WordPress Travel Map plugin
  • Filtering parameters:
    • showonlybyparams - makes the index show only a specific map. Set as 1 in the page used for sharing locations. In technical terms, when enabled, the index will take the query of the URL in account
    • categoryfilter - Show/Hide category filter above the map. 0 for hiding, 1 for showing. Includes categories for both plugins (WordPress Travel Map plugin and WordPress Interactive Map plugin)
    • autoexpandcategoryfilter -  set "1" to expand the category filter by default. Only works if categoryfilter="1" 
    • categoryfilterautoselect - selects certain categories as soon as the page loads. Input the categories' id, separated by commas. Only works if categoryfilter="1" 
  • View parameters:
    • theme - Choose between:
      • silver 
      • retro 
      • dark 
      • night 
      • aubergine
    • path - set "1" if you want to display path or "0" if not.
    • mapheight - the height of the map in pixels (decimal value without px string)
    • mapwidth - width of the map in pixels (decimal value without px string)
    • width - width of the entire widget in pixels (decimal value without px string)
  • Sample: [cmmrm-cmloc-common-map path=1 categoryfilter=1 categoryfilterautoselect=1,5,22 mapwidth=900 mapheight=500 width=900]
Displaying locations and routes on the common map - WordPress Plugin Show Route
Displaying locations and routes on the common map

2) Business Directory Plugin Integration

  • Shortcode: [cmloc-business]
  • Use: Displays map with the Business Directory plugin records
  • Filtering parameters:
    • category - set business category to display business on the map
  • View parameters:
    • theme - Choose between:
      • silver 
      • retro 
      • dark 
      • night 
      • aubergine
    • categoryfilter - show or hide category filter over the map
    • searchbar - show or hide the search bar ("1" to show, "0" to hide)
    • mapheight - the height of the map in pixels (decimal value without px string)
    • mapwidth - width of the map in pixels (decimal value without px string)
    • width - width of the entire widget in pixels (decimal value without px string)
  • Sample: [cmloc-business category=tech categoryfilter=1 mapwidth=640 mapheight=480 width=700]
Displaying businesses on the map - Business Directory Plugin
Displaying businesses on the map

3) Expert Directory Plugin Integration

  • Shortcode: [cmloc-expert]
  • Use: Displays map with the Expert Directory plugin records
  • Filtering parameters:
    • category - set expert category to display business on the map
  • View parameters:
    • theme - Choose between:
      • silver 
      • retro 
      • dark 
      • night 
      • aubergine
    • categoryfilter - show or hide category filter over the map
    • searchbar - show or hide the search bar ("1" to show, "0" to hide)
    • mapheight - the height of the map in pixels (decimal value without px string)
    • mapwidth - width of the map in pixels (decimal value without px string)
    • width - width of the entire widget in pixels (decimal value without px string)
  • Sample: [cmloc-expert category="56" categoryfilter=0 searchbar=0 mapwidth=600 mapheight=600 width=600 theme='silver']

More information about the WordPress Interactive Map Plugin

Other WordPress products can be found at CreativeMinds WordPress Store

Let us know how we can Improve this Product Documentation Page

To open a Support Ticket visit our support center
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.