WordPress Interactive Map Plugin (CMML) - Integration - Expert Directory

Integration with WordPress Member Directory Plugin

Back to User Guides

Table of Contents

• What is this feature
• Showing map
• Expert pages with a map
• Expert Directory with a map
• ZIP search in Expert Directory
• Expert promoted by ZIP code

What is This Feature

The WordPress Interactive Map plugin can be integrated with the WordPress Member Directory plugin. 

This way, you can add a map to the listing of experts.

1) Showing Map

You can display the map by using a shortcode [cmloc-expert]

It has two attributes:

• category - Specify one or more categories by their id or slug.
• theme - Use one of the following values to choose the needed map theme: "silver", "retro", "dark", "night" or "aubergine".
• categoryfilter - Set "1" to allow users to filter categories and "0" to disable it (Default is "1").
• searchbar - Set "1" to display the search bar or "0" to hide.
• mapheight - Define the map height in pixels.
• mapwidth - Define the map width in pixels.
• width - Define the width in pixels.
• show_map_on_load - Set "1" to show the map on the page load. If set to "0", the map will be hidden. This parameter is needed to override the option Show map on page load in plugin settings of the WordPress Member Directory plugin. Note: this option was introduced in version 3.0.6.

[cmloc-expert category="id|slug" categoryfilter="1|0" show_map_on_load="1|0"]

Latitude and Longitude are Required!

The map will only display items that have latitude and longitude in their address.

You can add them by choosing the precise point on the map. To do so, enable the option Place the marker manually.

Alternatively, you can use services such as Get Lat Long from Address Convert Address to Coordinates to obtain coordinates.

2) Expert Pages With a Map

You can also show a Google map on each listing page.

Choose the default options in Admin Dashboard → CM Expert Directory Pro → Settings → Expert Page tab.

Then configure Show a Google map and Display map (where and how it should be shown).

TIP 1: Enabling/Disabling on Single Page

While editing an expert page, you can toggle the map on or off for that page alone.

TIP 2: Enabling Marker On the Index Page

Since the version 3.4.2 of the WordPress Interactive Map plugin it is also possible to Exclude marker by enabling the relevant option. It means that the expert will still be listed on the index page, but will not be shown on the map on the index page.

3) Expert Directory With a Map

You can show a Google map on the expert directory.

Navigate to Admin Dashboard → CM Expert Directory Pro → Settings → Expert Directory tab.

• Show CM Locations Map - Shows the map or not.
• Map position - Select the map position on the index page. Choose between:
  • Before filters
  • Between the filters and results

  • After results

    Note: this option was introduced in version 1.9.8.

• Show map on page load - Show the map by default or with a button click. Disabling might be recommended if the map takes time to load.
• Shows all experts on map - Show all experts or only the ones shown in the current page.

Then navigate to Admin Dashboard → CM Map Locations Pro → Settings → Index page tab.

Find the section Map and configure the following options:

• Enable map - Enable this option to display the map on the Expert Directory page.
• Enable marker clustering - If enabled, multiple markers will be combined as a single when overlapping due to the zoom.
• Enable info window on marker clustering - Shows a tooltip when clicking on a clustered marker, listing each location.
• Marker label type - Choose the label type with the marker's name on the location's map. The options are:
  • Show always below the marker
  • Show tooltip on mouse hover
  • Do not show label
• Clicking on the map marker will - Choose the action when the user click on the marker. The options are:
  • None
  • Open the location's page - Directs to the expert page
  • Redirect to custom URL - Directs to the address in the "URL" field of the location entry. 
  • Show tooltip with information about location - Displays part of the description without directing the user to another page. This feature has extra settings.

Example on the Front-end:

4) Zip Search In Expert Directory

You can enable a ZIP search filter in expert directory as well. This includes both a ZIP code filter and a Radius dropdown.

Example

Enabling ZIP Search

To enable this filter, you have to check the WordPress Interactive Map plugin setting. Head to Admin Dashboard → CM Map Locations Pro → Settings → Index Page tab.

Scroll down to the ZIP code radius filter section. Here we need the following 2 options:

• Enable ZIP code neighborhood filter - Adds the two search boxes: ZIP filter and Radius.

  

• Country code for the ZIP code searching - The ZIP filter will work only within a single country. Note: it works only within a single country that you've set up in the settings.

Note that geolocation does not work with WordPress Member Directory plugin.

Still in this screen, you can also set the Radius field increments. Learn more WordPress Interactive Map Plugin (CMML) - Searching by ZIP

Expert Promoted by Zip Code

Each expert can be additionally promoted by zip code. For each expert you can specify a list of zip codes, and when a user searches for one of these zip codes, the search results will show him the promoted expert even if it is out of the searched radius. The list of related zip codes can be defined specifically for each expert.

To do this, when editing an expert, find a metabox CM Expert Directory Custom Fields. Find there the following options:

• Is promoted by zip codes - Enable this option to promote expert when searching by zip.
• List of promoted zip codes - Add a list of zip codes that should trigger displaying the current expert as the promoted one once the user searches for one of these zip codes. Each zip code should be written on the new line. You can also import a list of zip codes from the CSV file. Check the CSV file example.

Front-end Example:

By default, all expert locations are displayed on the map. Once the user enters a zip code and defines a radius, he can see a search results - it shows the experts that are found withing the searched radius. It also shows the experts promoted by zip - the ones where we specified related zip codes.

In the list of found results the relevant experts are marked as Promoted (in List View and Expert Directory View only):

Important

Have a note that Latitude and Longitude must be specified for expert locations in order to make the zip search feature work correctly.

Also, in the dashboard for managing experts you can see 2 new columns:

• Promoted by zip code - Allows to track if the zip code promotion is enabled for the expert.
• Place Marker - Allows to track if Latitude and Longitude are specified for the expert. If not, you can click Set Marker, and both values will be automatically generated based on the address info.

	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