How to validate Premier with Multi-site Installations

Enroll in a Premier Subscription

Premier Subscription Licenses must be validated on the primary site of a multi-site install. This is typically the FIRST site in your site list, but can be changed via wp-config. If you are using multi site you should know which site is the primary Blog ID. Adding your Premier id and your license on your sub sites will not validate the WPSLP Premier license. (This information only applies to WordPress SLP and not MYSLP.

Communication with the SLP license server is required for any licenses to be validated. You can check if standard web requests are working between your WordPress install and SLP. This can be tested from within your PHP environment with a simple PHP script that uses a ‘curl’ or ‘file get contents ‘operation.

You can also click on the Store Locator Plus / info tab in the back end of the plug-in. If you are seeing “Latest News” with fairly current dates then the problem is most likely not a blocked communications via a firewall. In those cases the issue is most likely an incorrectly typed subscription ID or you have entered the info on the wrong site of a multi-site install.

Results Layout Shortcodes and Attributes

The ability to change results layout is included in the Experience add on.

Default Format

The default format for the results string uses the numerical encoding for the various data elements that can be rendered.   This default string format is present in the base Store Locator Plus plugin.  You can reset  to the default at any time by deleting the entry in the Results Layout field under  Settings/Results/Appearance and saving the settings.

Custom CSS

MYSLP subscriber  with the Professional level or Enterprise level plan  , allows you to customize the style sheets ( CSS ) for Store Locator Plus  map, results, and search layouts.   There are additional styles also available with  the higher level plans making it less likely that you will need to use custom styling sheets. If you are an Enterprise level subscriber and need a style to work with your general theme, you may wish to contact us.  Any CSS updates entered  will be retained in future updates .

For WordPress SLP plugin users, The Experience Add On  is available to purchase for the self managed WordPress SLP plugin , the CSS is stored in the WordPress options table.

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, we’ve got that covered!

For the WPSLP plugin users these instructions are a general guideline. You will need to visit Google and read their User guide to obtain a new account or update your existing account to get a current Google Maps Javascript API Key.

You do not need to include any additional restrictions  but if you do  then you will also need a second unique key to add in the  field under the SLP/General settings called the Geocoding API key.   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 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 as the Google documentation is updated and may supercede the instructions or screenshots contained in this document.  The APIS 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

CSV Import Duplicates Handling

The WPSLP Power Add On  or MySLP/Professional plan   allows you to import CSV files with several options.    View the information under SLP/Locations/Import .  You have various  options to consider when determining how to update  locations  that match your pre-existing locations.

Options available on how to handle duplicates:  Choose to Add, Skip, and /or Update.

T_PAAMAYIM_NEKUDOTAYIM

T_PAAMAYIM_NEKUDOTAYIM is the scope resolution operator.    In most languages it is the double-colon (::).

Most people that are looking for this odd-looking word are probably running into an issue with a PHP program.   For as often as it comes up, there is very little information on what is causing the problem.

With PHP it typically means the application has a syntax error.    The PHP interpreter cannot figure out how to compile your code properly and crashes with the Unexpected T_PAAMAYIM_NEKUDOTAYIM error message.   Often it is due to a class name or static method reference that PHP cannot handle.  Either the class name is entered incorrectly OR your PHP version is so old it cannot process variable names before the double-colon operator.

For Store Locator Plus™ users that are still using the WordPress plugins it most likely means the version of PHP you are running on your web server is very outdated.  Upgrade PHP to a newer version, preferably something that is supported in the past 5 years like PHP 7.

User that chose the fully managed Store Locator Plus™ service don’t have to worry about things like this.

How Store Pages Templates and [slp_pages] Work

Available In: WordPress Store Locator Plus™ with the Power add on.
Not yet available Coming Soon (ETA 2019): Fully Managed Store Locator Plus™ (MySLP) service.

Showing A List Of Pages — Full Content

[slp_pages style=”full” no_map=”1″ pages_directory_entry_css_class=”slp_page location_details col-xs-12″]
Because there is not template specified it will display the “full” (entire/complete) SEO page.    Login to the WP site and go to Store Pages as admin, click on any page.  What you see there is what you’ll get on the page list output.
That means when we add descriptions to SEO pages (either manually editing the SEO page OR with some new description magic in development today) the ENTIRE page will show up.

Location Sensor Aware

The Location Sensor capability is a Power  add-on feature in WPSLP for secured sites.   It is  also available with the subscription service plan Professional or higher 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.

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 ,  Enable WP debug  , and other info is 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.