If you have the WPSLP Experience Add On or the MYSLP/Professional plan an additional setting is available under labels and will show you a new field named Radius first entry under the Settings/Search user interface. When a Radius First Entry has been set it will appear as the first field in the radius drop down that the user sees on your search form. The value will be set to the default miles that you have set in Radii Options. The other radiis you have entered to allow users to search will appear in numerical order in the dropdown but the label for the first entry will appear first regardless of numerical order.
Countries and Languages
Plugin Text
The Store Locator Plus plugin is now part of the WordPress Translate project. You can get the current status of the Store Locator Plus translations on the WordPress Translation website. If you would like to see the plugin fully translated into your language, please send a request to be added to the WordPress translate team for your language. As soon as a language reaches 100% completion for the stable release of the Store Locator Plus plugin, the custom language files will be removed from Store Locator Plus and be replaced by the more-efficient Translate system.
Cluster Map Markers
Cluster Map Markers is available as part of the Premier plugin included with the Premier Subscription for Store Locator Plus or the Enterprise level of MySLP. Cluster Markers show a single map marker graphic (circle with number inside it) when two or more (you set this number) markers are within close proximity to one another on the current map view. As a user zooms in on the cluster, the clusters break apart to show the individual markers. When zoomed out the individual location markers combine into a single marker graphic with the count of locations represented by the graphic shown in the center. You determine the default radius and minimum number of locations before cluster map marker is engaged. Your “center map at” and default radius setting will effect where the map center is located.
Turn On Cluster Markers
Go to the Store Locator Plus : Settings / Map and look under the Appearance section for “Enable Cluster Markers”.
Read the Store Locator Plus news articles about Cluster Map Markers.
Creating A List Of Location Pages [slp_pages]
This feature is available with an active Premier Subscription only.
Create a list of location pages, the Store Pages created by the Pages option of the Power add on, requires version 4.5 or later of the Power add on with the Pages option enabled.
Listing location pages is done by adding the [slp_pages] shortcode to your WordPress page or post. Only published Store Pages are shown. By default new pages created via the Manage Locations interface are created in ‘draft’ mode.
The Store Page [storepage] Shortcode
The [storepage] shortcode is used by the Pages and Power add ons to render live location data on a location (store) page. The template is set under the Pages / Settings tab in the Initial Page Features group via the Page Template setting.
The [storepage] Shortcode
By default the [storepage] shortcode does not output any content. You need to use one of the following attributes to generate location-specific output.
Attributes
- class – augments the tag attribute with the specified CSS class
- field – specify which location field to display
- hard_coded_value – output the text in the wrapper
- map – show a map with the location marker
- post – output the WordPress post attributes for the page
- tag – wrap the output with the specified HTML tag
- title – output a title for list of pages
- type – specify the type (style) for the output
Example CSV Import Files
CSV Imports are the most-used feature for our MySLP Professional users and for our WordPress SLP self managed DIY customers that purchased the Power add on.
Learn about CSV Import formatting and other import notes.
Below files are examples only, you will need to set up your own import files to add your locations.
Example CSV Import Files
9 Restaurants Basic CSV Import
We consider this the simplest usable format for most businesses. It includes the Store Name (Store), Address, City, State, and Zip columns.
You can download our example on our server here
9 Restaurants Full Address
A full address format of the 10 Restaurants Basic CSV Import format. It includes the Store Name (Store), Address, Address 2, City, State, and Zip, and Country columns.
https://drive.google.com/open?id=1jE_BZTGpHrAuZzYy-K7CwLcFanPzKGC9
9 Restaurants With Latitude and Longitude
The same 9 places with full address and latitude and longitude. Including latitude and longitude gets the locations online and active on the site faster. This was created from an Export CSV of the above Full Address file when we stripped the sl_id column and all the blank columns at the end, relabeled the header row to be user friendly.
https://drive.google.com/open?id=1jkfRlY4K2retNGFaRVcW17WSLi_tfRmj
Remote file Retrieval; (Currently being patched )
One quick way to tell if your file is accessible is to put the URL you are using for your imports into your browser. Does it download a CSV file you can open with a text editor? If No; It isn’t a “vanilla” CSV file readable by the “Internet”.
This is the link you can use to see if remote file retrieval is working
For example — if you go HERE
https://demo.storelocatorplus.com/wp-content/uploads/2020/04/9-Restaurants-With-Lat-Lng-Cat.csv
you see an option to download a file
But if you go here :
https://demo.storelocatorplus.com/9-restaurants-with-lat-lng-cat/
it shows you a web page. That second link above from our demo site is NOT a valid remote CSV file URL
Google changed how share links on drives are working and we have found no way to get to the raw CSV file with any links they provided to us.
So Google Drive hosted CSV files is likely never going to work again. Just one more way for them to track everything you do online by using an embed object vs. a flat CSV that they give you access too.
Limiting Search Results By Territory
The Premier Add On provides territories for locations. Each location can have a territory assigned that describes a rectangular area with a boundary specified in miles or kilometers north, south, east, and west of the location.
You can restrict the list of locations a user sees via the Radius Behavior setting in Store Locator Plus. The options and their influence on results returned is described in Radius Behavior.
Importing Locations With Territories
Importing locations with territories follows the same procedure as importing a standard locations file. As with all location files the format must be a proper CSV file exported using the UTF-8 character set with no special or non-printable characters.
To load the territory data you must have first enabled the territories feature in the Premier Add On. You will also need to have installed and activated with the Pro Add On or Power Add On for Store Locator Plus.
Your CSV file should add the following five columns to the file. Make sure you add the field names to the top of each of these new columns as listed here:
- territory_distance_unit
- territory_distance_north
- territory_distance_south
- territory_distance_east
- territory_distance_west
Within each column you will want to have the following values:
- territory_distance_unit can be ‘miles’, ‘km’, or be blank. If this is not set to ‘miles’ or ‘km’ it will assume the territory is not enabled for this location.
- territory_distance_north , south, east, and west should be the distance north, south, east, or west from the location that is part of its territory.
The territory boundaries will automatically be calculated for each location during the import.
Highlighting Locations Served By Territory
Version 4.5 of the Premier Add On for Store Locator Plus introduces territories to locations.
Once a location is setup with a territory the map markers that are sent back from the server during a user search will include a ‘in_territory’ property set to ‘1’ if the user’s location is within the territory and ‘0’ if not. An additional ‘in_territory_class’ property will also be set to either ‘in_territory’ or a blank string. Both settings are part of the ‘data’ property of the location marker.