Load Locations from WordPress Locator to MYSLP®

Load locations does not replace the csv file import functionality available to the Professional or Enterprise level plan subscribers but it  can be used to  load basic location data from your WordPress Store Locator Plugin (such as WP Store Locator Plus®,) into your MYSLP  account. It will not load category tables.

This functionality can be found from the MYSLP account, the SLP sidebar tab and under Locations as shown in the screenshot below.

The  loader supports loading locations from WordPress sites running the WordPress Store Locator Plus plugin.   If you are using a locator or directory plugin other than Store Locator Plus, please contact us to discuss the possibility of beta testing if it does not load.

 

Google Server (Browser) Key for WPSLP

Get  Google API Keys

This section pertains to the WordPress Store Locator Plus plug-in   which is the free base plugin for those WordPress administrators who are controlling the plugin and updates.  If you are a subscriber to  MySLP, our fully managed locator SaaS service, you can ignore this page.

Before you get started you will need to get a Google Maps Javascript API Key.

Please note, there are some misleading instructions in the Google developer console telling you to  create a browser-restricted API key when you move your site to production. You do not need to include any restrictions  but if you do then you will also need a second unique key to add in the second field under the SLP/General settings the Geocoding API key.  Either way you must “enable” both the Maps  and Geocoding APIs. Updates to how Google APIS are deployed and the explanation can be found in Google Platform  When you create your project , obtain  your Maps Javascript API  .  The geocoding API is now contained under the “Places” API. The APIS you will need  are now contained under Maps, and Places.  Check to see that both boxes are enabled for your project. View the support documents under Google Product updates for more information. They have added many different APIs. The ones you need for WPSLP to work properly are the two in the screenshot below, referred to as Maps Javascript and geocoding (not to be confused with geolocation). The Geocoding API  converts addresses into geographic coordinates (geocoding), which you can use to place markers or position the map. This API also allows you to convert geographic coordinates into an address (reverse geocoding).

Step 1: Go To the Google Developer Site

Map Controls

More map controls

Our MYSLP Enterprise level users or WPSLP Premier subscribers will find several additional map controls to enable or disable built-in Google Map elements.  A simple checkbox  allows users to turn the Full Screen and zoom controls on or off in addition to the previously-available  Hide “Stick Man” , scale, and type controls.

This option is also available to WordPress plugin users with an active Premier subscription.

CSV Import Duplicates Handling

The WPSLP Power Add On  or MySLP/Professional plan   allows you to import CSV files with several options.     Under SLP/Locations/Import  options.  You select which option you wish to use when determining how to update  locations  that match pre-existing locations.

There are several options available for duplicates handling. They are  Add, Skip, and Update.

Location Sensor Aware

The Location Sensor capability is a Power feature in WPSLP or Professional feature in MYSLP.

Location sensor feature can be  turned on/off with a simple check box under the SLP/General/User Interface tab.

MYSLP Power Level or higher Plan
WPSLP Power add-on General tab

 

 

 

 

 

When the box is checked and a visitor to your site performs a search , SLP queries the browser and requests their current location.    If the browser allows location queries it will return their geographic location which will be used to set the default search location.

Note:  This will only work with most browsers if you have a secure site or if your site visitor “allows” there location to be visible to you.  Google Chrome has had restrictions since Chrome version 50 (released in 2016)  that they will only return locations using location sensor if the  request is generated within the url of a valid secured site (https://).  See the Google developers console for more information.

Google  returns a “No results found” if you do NOT have an HTTPS site and will stop the javascript from loading. An update to SLP with the Power add-on will negate Location sensor settings entirely if you do not have https://  so that your page continues to load.   If you require the location sensor functionality to work properly you must have  a valid SSL certification.

Location Aware Browsing

Accuracy varies greatly from location to location. In some places, service providers may be able to provide a location to within a few meters.  All locations returned by service providers are estimates only and we do not guarantee the accuracy of the locations provided.  Your SLP settings also determine the number of locations shown nearest the site visitor.  Settings for radius, number of results to return and center of map  all interact to show locations nearest to the site visitor.

Google Geocoding and Browser keys

This article effects the WordPress StoreLocatorPlus  users “Do it yourself “

MAP Service and API Keys

Changes as of June 11, 2018 will effect the WordPress Store Locator Plus (DIY) community.  Google requires all sites  using map services to have an API key with a billing account attached. See Google Developers console.

The Browser key is used to display the map and handle user-input addresses during a location search.  The Geocoding API  is used on your WordPress server to geocode locations you’ve entered via the Google “Places” box and  APIs. You do not need the additional geocoding “key”   unless you have added referrer restrictions.  You do however, need to have the geocoding API enabled in your Google projects library.

Mixed Content Warnings and Site migration

Google’s push for all websites to be HTTPS  has been a game changer over the past few years with many companies  switching from HTTP to HTTPS with some hiccups along the way.  Some of the site transfer mishaps are minor, but if done incorrectly can cause your plug-ins to misbehave , and often is the case, after the transition team has left the building.

Mixed Content Warnings – Loading Assets Over HTTP

If you have never had HTTPS on your site, you will undoubtedly run into an issue with how your site assets are loaded. By assets we are referring to things like images, JavaScript, and even your CSS.   Insecure assets may not stop the green padlock from showing in browsers, but it will add an exclamation point warning to your users that information is being loaded insecurely.

 Site Migrations Vary

Occasionally we see comments from customers that Store locator Plus broke their site or is not working. When asked if they recently  migrated their site they often state nothing has changed.   On further investigation , or by inspecting their console  we often see the “Mixed Content warnings” quite often for images or icons from older versions of Store Locator Plus. This is a sure fire clue that there was indeed a “site migration”. They started out with their site when  the SLP plug-in was originally installed as HTTP and now , at least part of their site, is HTTPS.  This is known as  a protocol migration. If you migrate your site from HTTP to HTTPS, Google treats this as a site move with a URL change. That means you may need to obtain a new Google API key for SLP to work properly. With version SLP 4.9.15 you are allowed to add HTTP referrers now as long as you also obtain a geocode key. See  info about those changes under news

Upfront Investment

A site migration is a great opportunity to address legacy issues. If you have outdated legacy add-ons  this is a good time to invest in your future by planning for and including any  update expenses in your overall budget.  Including these costs in the project scope is the most cost-effective method to ensure your site stays relevant and on-track. When you consider that  issues that may arise after going live will require additional time , resources and, yes, may even create downtime and loss of traffic  to your site it is worth including the new versions in your budget. Contact support if you have made a recent purchase or check our What to Buy guide for options.

 

General Settings

There are settings under the General tab for Admin , User Interface, Server, and Data. This documentation has been updated to reflect the Google API changes

Admin

The Admin tab is where your SLP Premier subscription Accounts ID , Add-on packs User info , and Update Notices are located. There is also a Reset Manage Locations button available for use to reset the back end Manage Locations  display page to the default view (10 locations per  page view). This feature was previously only available with the free SLP  Janitor Add-on.
2016general-admin
There is also a Locations management option  to Highlight the locations that are not geo-coded on the Panel that displays your entered locations.

Search Form Labels

 Set the Labels for the Search Form

The label that will be displayed in front of the Search form box on your locator page can be changed under Settings/Search in the Appearance section Label. If none are set, a blank box will appear on your site. The “Address” Label you enter will appear in front of the search box. The “radius” information indicates to the site visitor that this is the radius (whatever radii you entered in the search form  for radii options.

Consider this label as  a help text tool for the site visitor to assist them as to what  to enter in the box.   Label Examples:  zip code, city, street, or a combination such as  address / zip code.  The more detailed the better. We find address and zip code to be the most useful hint.  If you leave this label blank nothing will appear in front of the search form box and your site visitors will be guessing what to enter as keywords to search (the same as any other search boxes). They can type in anything that comes to mind and end up with no results.

The second search box is the drop down menu for your distance units.  We find the words “Within” useful.  If you prefer to enter another language for the labels that appear on the front end , that is your option as well.

Additional Search settings are available with  Experience or Premier add-ons.

Horizontal | Vertical Checkbox Category Selector

*Included with  WPSLP Premier subscription or MySLP Enterprise level Subscriptions. 

The Horizontal or Vertical Checkbox Category Selector feature is available for WPSLP Premier or MySLP Enterprise level subscription customers. The checkbox works with an “OR” selection based on the Parent category.

For example : If you check the [] red and [] blue boxes on the category selector it will show any location in the red OR blue category.