WP Multi Store Locator Documentation – Pro Version

WP Multi Store Locator is a WordPress plugin that provides numerous functionalities if you are running some online Store and want some smart search functionality with respect to location and categories. It also gives ability to admin in backend to manage their stores and sales manager for respective franchise.

It’s a complete package with lots of features like search store, nearby store functionality, Multiple Templates Support, on map detail direction from point A to Point B, set your custom Markers & Clusters, embed map functionality (you can easily paste embed code anywhere on your site), Snazzy map style support, Import/Export Using excel sheet, Stores Statistics and much more.

For Pro Version Visit following URL:

https://codecanyon.net/item/wp-multi-store-locator-pro/19385351?gclid=EAIaIQobChMIr4qNua3w4gIV1JTVCh3IfQkhEAAYASAAEgL51fD_BwE

• Download from codecanyon the latest Wp Multi Store Locator version.
• Extract the zip archive.
• Use your favorite FTP application to move the “wp-multi-store-locator-pro” folder to the wp-content/plugins folder on your server.
• Activate the plugin through the “Plugins” menu in WordPress.
• Visit Store Locator > Settings to configure the plugin.

Google Maps API:

API key A server key allows you to monitor the usage of the Google Maps Geocoding API.

As of June 22, 2016, Google Maps no longer allows requests for new projects that don’t include an API key. 

🡪Search in google

To use the Google Maps JavaScript API, you must register app project on the google API Console and get a Google API key which you can add to your app.

Once you get your API KEY

Click the button below, which guide you through the process of registering a project in the Google API Console, activates the Google Maps javascript API and any related services automatically, and generates a generic, unrestricted API key.

Go to the Plugin Settings🡪 Click on Initialize Tab🡪 Paste API Key in the text box 🡪and click on save changes button 

When a server request to the Google Maps Geocoding API to convert an address into a set of latitude, longitude. This appears when a different location is made in the admin area, or when a CSV file is imported and the Latitude, longitude is not included in the CSV file data.

Click here to Create Server Key.

On the first page, select the project and click ‘Continue’.

On the screen, set the referrer to the IP deliver of your server to limit the use of the key.

Click on the ‘Create’ button, copy the shown API key, and set it in the ‘Server key’ field on the settings page in the ‘Google Maps API’ section of your wp multi-store locator.

Use an Existing Project in The Google API Console

If you have already created a project for your website in the Google API Console, make sure to enable the following Google Maps APIs on the Library > Google Maps APIs page.

• Google Maps JavaScript API
• Google Maps Geocoding API
• Google Maps Directions API
• Google Maps Distance Matrix API
• Google Maps Elevation API
• Google Places API Web Service

2,500 free requests per day. If you need more, then you need to enable billing.

Troubleshooting

If after setting the Server key you get a gray map on the front-end or a gray input field for the start location on the settings page, then there is a problem with the used API key. The only way to find out the exact problem is by checking the console output in your browser.

You can access the console in Firefox with ctrl+shift+k, or ctrl+shift+j in Chrome.

When you have opened the console, reload the page and check for any errors that are identified with Google Maps. The error itself, for the most part, incorporates a connection clarifying the explanation behind the error and how to settle it.

General Map Setting Screen:

🡪 Show map on the frontend

Enable the display of the map on the frontend and show the map submitted shortcode page.

🡪 Map width and height

 Set the width and height of the wp multi-store locator to show on the frontend.

🡪 Map type for the google map location preview

Chose any one option from the four options: – 

1- Roadmap – display the default road map view.

2- satellite – display satellite images.

3- Hybrid – displays a combination of normal and satellite views.

4- Terrain – displays a normal street map based on terrain information.

🡪 Search unit

 Set the search unit to measure the distance in kilometer or miles.

🡪 Default Map zoom level

 Set Default map zoom level in number.

🡪 Location Search zoom level

 Set Location search zoom level in number.

🡪 Fit Screen To Stores

This option will fit the screen to stores found within the radius, If the radius is too big and the stores are only found in a small area around the default location. the extra space will be left out of screen.
’Default Map Zoom Level’, ‘Location Search Zoom Level’ and ‘Fill Radius with color’ will not apply if ‘Fit Screen To Stores’ is enabled

🡪 Fill Radius with color

This option enables the radius to be filled with the color defined in ‘Fill color’ option.

🡪 Fill color

Admin need to add the hex code of color.

🡪 Search radius options

 Choose search options here. the default one will be between square brackets.

🡪 Show street view control?

 Show street control on the map in the frontend.

🡪 Show Map Cluster?

The number on a cluster indicates how many markers it contains. Notice that as you zoom into any of the cluster locations, the number on the cluster decreases, and you begin to see the individual markers on the map.

🡪 Scroll to Map top after Search

Click on the check box to enable scrolling option after search

🡪 Show map type control?

 Enable the user to change the map type from the frontend.

🡪Zoom by the scroll on the map?

Enable/Disable zoom by the scroll on the map.

🡪 User marker

 This marker is a point as per user search on the map.

🡪 Or add Custom marker URL

The custom marker upload by the user as per their choice

🡪 Store Marker

 The map uses markers to point out the stores on the map.

🡪 info window content

You can customize the content of the info window here by adding HTML if you need. Also, you can use the below variables in the content.

<pre>

<div><div>{image}</div><h3>{name}</h3><p>{address} {city}, {state} {country} {zipcode}</p><span>{phone}</span><span>{website}</span></div>

</pre>

🡪 Customized Map Style

You can customize the look of the map by adding styles here. You can get some styles from Snazzy Maps.

🡪 Reset to default

(Global admin settings) This resets the Map Settings to the default ones in admin area.

Grid Setting Screen

🡪 Show grid on the frontend

 Show the results in the grid in the frontend.

🡪 Maximum Number of Marker to be displayed

A Select number of stores to be displayed per page.

🡪 Autoload results on the scroll

Enable/Disable autoload results when scrolling down.

🡪 Displayed Columns

Select the displayed column in the grid in the frontend by order.

🡪 Map Result Show on

User can select the display location where search result showing on the front end (1) On Map Left side (2) On Map Right Side (3) Below Map

🡪 Map Search Options Window Show on

User can select where they wanted to show Search Option on front end (1) On Map Left side (2) On Map Right Side (3) Below Map

Single Page Settings Screen:

🡪 Link store to a single page?

Enable/Disable when clicking on store go to a single page for more details.

🡪 Enter Unique Slug Name

User manually adds any unique slug by their choice. 

🡪 Show the featured image of the store??

Enable/Disable the display of the feature image of the store in the inner page.

🡪 Show map on page??

Enable/Disable showing a map on the inner page of the store.

🡪 Displayed Columns?

Select the displayed column in the page in the frontend by order using any tag.

How to Setup Individual Map: 

Go to the Maps option under Store Locator and click on Add New Map.

Initialize Map Screen:

🡪 Use global settings

Enable this option to use Default Settings

🡪 Map Landing Address

Insert (Address, Country, City, Postal code) to showing defined data on the front end.

Map Setting: 

🡪 Use global settings

Enable this option to use Default Settings.

🡪 Show map on the frontend

Enable the display of the map on the frontend and show the map submitted shortcode page.

🡪 Map width and height

 Set the width and height of the wp multi-store locator to show on the frontend.

🡪 Fit Screen To Stores

This option will fit the screen wrt to stores found within the radius, If the radius is too big and the stores are only found in a small area around the default location. the extra space will be left out of screen.
’Default Map Zoom Level’, ‘Location Search Zoom Level’ and ‘Fill Radius with color’ will not apply if ‘Fit Screen To Stores’ is enabled

🡪 Fill Radius with color

This option enables the radius to be filled with the color defined in ‘Fill color’ option.

🡪 Fill color

Admin need to add the hex code of color.

🡪 Map type for the google map location preview

Chose any one option from the four options: – 

1- Roadmap – display the default road map view.

2- satellite – display satellite images.

3- Hybrid – displays a combination of normal and satellite views.

4- Terrain – displays a normal street map based on terrain information.

🡪 Search unit

Set the search unit to measure the distance in kilometer or miles.

🡪 Directions

In our plugin we have two types of direction:

• On Map Detail Direction

• Redirect to Google Maps

🡪 On Map Detail Direction

Use these tools to get the directions between any point using store locator. Enter a city or an address in both the From and the To address inputs. Click Find Directions, and the tool will display the route you need to take to get from your starting location to your end location. The turn by turn directions will be displayed below the map and will contain the distance and approximate time it will take to get from one location to the other.

🡪 Search radius options

Choose search options here. the default one will be between square brackets.

🡪 Show Map Cluster?

The number on a cluster indicates how many markers it contains.

🡪 On page load get location

Once User Landing on Map page they will get their current location showing on the map.

🡪 Scroll to Map top after Search

Click on the checkbox to enable scrolling option after search

🡪 Show map type control?

Enable the user to change the map type from the frontend.

🡪Zoom by scroll on the map?

Enable/Disable zoom by the scroll on the map.

🡪 User marker

This marker is a point as per user search on the map.

🡪 Or add Custom marker URL

The custom marker upload by the user as per their choice

🡪 Category Marker for Store 

The map user markers to point out the stores on the map as per category wise

🡪 info window content

You can customize the content of the info window here by adding HTML if you need. Also, you can use the below variables in the content.

<pre>

<div><div>{image}</div><h3>{name}</h3><p>{address} {city}, {state} {country} {zipcode}</p><span>{phone}</span><span>{website}</span></div>

</pre>

🡪 Customized Map Style

You can customize the look of the map by adding styles here. You can get some styles from Snazzy Maps.

🡪 Embed Map

 You can copy the embed code and then proceed to paste it on the source code anywhere in your website.

Grid Setting Screen:

🡪 Use global settings

Enable this option to use Default Settings.

🡪 Show grid on the frontend

 Show the results in the grid in the frontend

🡪 Displayed Columns

Select the displayed column in the grid in the frontend by order.

🡪 Map Result Show on

User can select the display location where search result showing on front end (1) On Map Left side (2) On Map Right Side (3) Below Map

🡪 Map Search Options Window Show on

User can select where they wanted to show Search Option on front end (1) On Map Left side (2) On Map Right Side (3) Below Map

Placeholders Settings Screen

🡪 Use global settings

Enable this option to use Default Settings.

🡪 Get Location Text Button

Set Get Location Text Button showing on the front end.

🡪 Enter Location Text

Insert Location Text showing on the front end

🡪 Select Category

Insert Category you can use on the front end

🡪 Select Tags

Select pre-defined tags showing on front end

🡪 Search Options Button Text

Insert Search Options Button Text showing on front end

🡪 Location not found text

Insert Location not found text showing on front end.

Store Categories Settings Screen: –

User can manually add categories from the back end and search category wise direction like office, clinics, store from the front end.

Map Layout Screen: –

User can select any layout type Custom or Fullscreen showing on the front end as per their requirement.

• Developer friendly code. It uses custom post types and includes almost 20+ different filters that help you change the look and feel of the store locator.
• User can manage Map Settings like Show map on the frontend, Map Width, Map Height, Map Type, Search Unit, Search radius options, Enable Search
• Can Add Multiple Maps on Website search like Get my location, Radius field, category field…
• Whether you own a static website, WordPress, Joomla, Drupal or others, you can copy and paste the embed code to publish your store finder immediately without any hassle.
• You can create your own custom map style by either writing your own style code, or you can use existing map styles from Snazzy Maps
• Can manage Stores.
• Customizable Map Markers
• Can manage Sale managers of their added Stores.
• Can manage Store Categories.
• Can manage Store Tags.
• Can add custom marker URL
• Select Multiple map layout type
• Can add the shortcode [ store_locator_show ] to show Store Locator.
• WP Multi Store Locator is compatible with WPML, one of the leading multilingual plugins.
• Measure the distances in either km or miles.
• with categories, Enable Search with Tags, show street view control, Show map type control, Zoom by scroll on map, Marker Cluster, Cluster Size, User Marker, and more…
• User can select any layout type Custom or Fullscreen showing on the front end as per their requirement.

• User can search Store from their current location (SSL must be active) and with the desired location.
• With Geo Location, wherever location your customers browse your store finder, it will detect nearby stores and display them sorted by nearest to the furthest distance. This way, customers can get to your physical without any hassle.
• Slick Collapse-able panel to showcase available categories/tags and available regions which can be fully customized via admin.
• User can search Stores by selected units(km/miles).
• User can search by Selected Store Tags and Categories.
• User can use shortcode to display search map anywhere in page or post.
• You can easily change your Listing Positions Left or Right
• Edit support for Google Custom Map style
• Search stores by Region
• You can copy the embed code and then proceed to paste it on the source code anywhere in your website.

On map detail direction from start to end location showing on the front end with Detailed Driving direction, Nearby Places, and Road map.

CUSTOM MAP STYLING

Customize Colors and Styles for your store locator to suit your company and website branding / corporate branding. You can change the map color, panel colors, text colors and many more from the administrator’s panel.

Custom MAP Styling Video

Note:
Custom Map Styles will only work when map type is road map.

As an Administrator, you can customize point of interest which you can set for your customers to quickly know on your whereabouts. 

Tracker’s import and export features can help you save time with a range of activities. For example, you can move stores, sales managers from a third-party tool or archive stories and epics from a project.

Click here to get WP Store Locator Stores CSV sample file

Stores, Sales Manager data can be imported and exported to a comma-separated value (CSV) file. The imported and exported CSV file contains column headers as the first row of the CSV file that corresponds to Tracker field names.

Import/Export Stores, Sales manager.

Export by Categories

Now you can export the stores by categories, if you want to export all the stores regardless of categories then you need to select the All Categories option.

Clear Stores

When you upload a csv, the stores are first saved in temporary memory, after that when you click on ‘Click here To Import New/Pending Stores’ these stores are actually imported in wordpress.

Now if you need to do changes in some of the stores and upload them via csv again the temporary memory might not let the stores be imported. So you will have to clear the temporary memory before trying to upload again. The ‘Clear Stores’ button clears the temporary memory.

WP Multi Store Locator supports Import/Export store addresses with categories in any hierarchical order. The pattern followed by WP Multi Store locator for categories is described below.

⦁ For a Single Category for store address just add category name in category column.

⦁ For Multiple Categories add category names separated by | (vertical bar) in category column like

Category 1 | Category 2 | Category 3 | Category 4

For adding child category to any level is just to simply add all category level names separated by “,” (comma). First name will be last child.

Example:
Izmir, Adanye, Artempo

Artempo is parent category of Adanye is parent category of Izmir and only Izmir category is assigned to store with same hierarchy

Note:
All category names are checked before if these exist just used otherwise are added with hierarchy.

Shortcodes to display store locator as you like.

Map shortcode screen: –

You can place map shortcode anywhere you’d like, and it will add a specific feature to your page, post, or other content.

Statistics gives commercial enterprise proprietors valuable insight into store recognition, new store demand, and product performance.
With this enterprise method device, you can:

• Preserve music of which shops get hold of the maximum search traffic and modify keep inventory to suit call for.
• Make knowledgeable decisions approximately where to expand based totally on seek analytics that displays the top searched places in which you do now not presently have a shop.
• See which product classes perform first-rate and align your commercial enterprise approach to match the call for.
• Whether you need to preserve tabs on which present store places are the maximum looked for, or plan for business enlargement, intelligence from the facts upload-on can substantially benefit business approach.

Version: 4.0
Date: 18/2/2020
Added - Fit Screen To Stores Option.
Added - Fill Radius with color Option.
Added - Fill color Option.
Added - Export stores by category option.
Added - Reset map option in search.
Added 'Reset to Default' option in Global Map Settings.
Improvement - Stores now showing from closest to the farthest in grid.
Improvement - in custom maps on clicking a store info-window the address will now populate in directions route end field
Improvement - displayed a message when map is disabled from back-end
Fixed - 'Default Map Zoom Level' was not being applied.
Fixed - 'Location Search Zoom Level' was not being applied.
Fixed - Category Image was not saving on update in category page.
Fixed - Showing all categories in search options instead of the ones assigned to map.
Fixed - 'Maximum number of markers to be displayed' not working
Fixed - after import, stores not visible on map until we update each store.
Fixed - Map not rendering in Elementor page editor.
Fixed - All visible warnings and notices.
Removed - 'Location not found text' option from admin options

Version: 3.5.0 
Date: 14/1/2020
Fixed - Sales Managers not saving.
Fixed - Use category markers for store markers not working.
Fixed - Different Map Styles Not working.
Fixed - Get Directions showing directions in terms of 'walking' instead of 'driving'.
Added - 'clear stores' button on import.
Added - Longitude and Latitude in import and export.
Fixed - Shortcode showing custom and fullscreen map should now be compatible with Gutenberg and Divi theme.
Fixed - Stores show up in frontend, even after they are deleted from trash in wordpress admin.

Version : 3.0.1
Date : 28/10/2019
Fixed - Old shortcode CSS issues fixed

Version: 3.0
Date: 02/09/2019
Added Multiple Maps By Categories.
Added Info Window Customization.
Added Google Maps Detailed Direction On Map & Redirect.
Added Custom Markers.
Added Category Based Markers
Added Embed Map Functionality
Added Multiple Templates Support For Maps

Version:2.9  
Date: 17/01/2019
Fixed - Admin Backend CSS issue fixed
Fixed - Fixed minor PHP bugs

Version: 2.8 
Date: 12/06/2018
Fixed - Snazzy Maps styles issue.
Fixed - Infobox store featured image issue.
Added - Number of markers to be displayed on the map.
Added - Visit website label to be dynamic.

Version: 2.7
Date: 30/03/2018
Fixed - Search box toggle issue.

Version: 2.6
Date: 07/03/2018
Fixed - Get my location SSL check.
Added - Search location with function-based.
Fixed - Map Search Open as Default with back end-setting.

Version: 2.4 
Date: 15/02/2018
Added - Introduced map clusters functionality
Added - Import/export categories.
Added - Default location.
Added - Map Zoom by scroll dynamic setting.
Added - Added new layout.
Added - Added multiple layout options.
Fixed - Search locations.
fixed - Admin settings in an easy way.
fixed - CSS related issues.

Version: 1.8
Date: 18/1/2018
Added - Store List Dynamic Label. 
Added - Support for import/export store categories. 
Added - Optimized Import/Export Store compatibility.

Version: 1.5  
Date: 11/10/2017
Fixed - Statistics Page Fixes.
Fixed - Store import instantly.
Added - Confliction with nice select removed.
Added - Clickable Call button on store phone number infowindow.

Version: 1.4
Date: 19/09/2017
Added - Translation support using .PO .MO files

Version: 1.3.1
Date: 08/09/2017
Added - Compatible with Jupiter Version: 5.9.7
Fixed - Responsive CSS on search store layout.

Version: 1.3
Date: 21/08/2017
Fixed - cross browser CSS fixes.
Fixed - Map Height Setting.
Fixed - Listing Setting.
Fixed - WooCommerce Confliction.
Added - Support For Divi builder.
Added - Support For Elementor builder.
Added - Support For Beaver builder.
Added - Support For UPD Power Builder ( Cherry framework ).
Update - Overhaul the of import functionality.

Version: 1.2.2
Date: 28/07/2017
Added - Single Page Functionality For Your Stores.

Version: 1.2.1  24/07/2017
Fixed - Js store_locatore_search_lat,store_locatore_search_lng 
remove from hidden field to get direction.

Version: 1.2
Date: 07/07/2017
Added - RTL Support
Added - Add Support For WPML
Added - Add Support For Avada (Fusion Builder)
Added - Add Support For Divi Builder
Added - Add Support For Visual Composer.

Version: 1.1.1 
Date: 14/06/2017
Fixed - broken icon in listing
Added - Optimized Code
Added - Optimized JS

Version: 1.1 
Date: 30/05/2017
Added - attribute "Location" in the shortcode. Added attribute "City" in the shortcode. Added attribute "State" in the shortcode. 
Added - attribute "Radius" in the shortcode. 
Added - Option to display default map with in specific radius/location. [ store_locator_show city="Alabama" state="US" radius="25" ]
Fixed - Direction Icon.
Added - New Layouts
Added - Store Listings
Added - Counter icon
Added - Custom Map Styling
Added - Option to Enable/ Disable Search Filter
Added - Search Placeholder Option
Added - Add Your Own Marker
Added - Search Toggle Disable / Enable Option

Version: 1.0
Date: 
initial release.