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.
This article provides information on how to recover from critical errors after a plugin update. Critical updates can occur for a variety of reasons. These errors can take your WordPress site offline until the error is resolved.
For the purpose of this article we are going to delve into an example where a Store Locator Plus® add on is running an outdated version and the base plugin is updated to an incompatible version. While newer versions of the Store Locator Plus® plugin will auto-detect incompatible add on versions and disable them automatically, there are some third party add ons that do not report version updates properly and can prevent this auto-detection from working.
SaaS users can skip this step.Store Locator Plus® for WordPress plug-in users need a Google API key to utilize the full features available in the the plugin. WordPress administrators who are self-managing their plugin updates, security, and Google services need to setup a Google API account so they can start billing for map services.
For the Store Locator Plus® for WordPress users these instructions are a general guideline. You will need to visit the Google developers page and read their User guide to obtain a new account or update your existing account. Google will bill you directly for your monthly map views and location look-ups.
When a visitor goes to a page with the Store Locator Plus® map code embedded, it will show a default search form and a map centered in your country or on the “Center Map At” address you entered when configuring Store Locator Plus®. When someone searches for a zip code that is close enough to a location you entered it will show those locations on the map.
All Store Locator Plus® software updates are handled for you.
There are no Google or other map location service API keys to manage.
Store Locator Plus® bills a low easy-to-understand monthly fee.
WordPress
You must manage your own Store Locator Plus® software updates.
Google requires an API key for all products using their map software. You must create, manage, and secure your own API key.
Google will bill you for every map view and location geocoding request. Rates are on a sliding scale and are different for map views and location look-ups.
WordPress environment is setup and configured including activation of the following plugins
Store Locator Plus®
SLP Power add on
In addition map service (Google API keys) should be in place and some locations should be added to the system.
A page has been created with the [slplus] shortcode present and the map is rendering properly.
Users are logged in as a WordPress administrator (the process will be slightly different for SaaS users).
Adding Categories To Locations
Objective
Create a location category and attach it to an existing location.
User Action: Add A Location Category
Click on Store Locator Plus® | Categories in the WordPress sidebar menu.
In the left “Add New Category Form”…
Type a category name. (Restaurant)
Click Add New Category
Result
The new category should appear on the category list on the page.
Category list after adding the restaurant category.
User Action: Attach Category To Location
Click on Store Locator Plus® | Locations in the WordPress sidebar menu.
Click the Edit action icon on the first location.
Check off the box next to “Restaurants” in the Power | Categories section of the form.
Click Save.
Result
The category is assigned to the location and appears on the location table.
The location with an assigned restaurant category. This view is showing fewer columns as the Screen Options was updated to removed unused columns from the table view.
User Action: Show Category Select On Front End
Click on Store Locator Plus® | Settings in the WordPress sidebar menu.
Change the Category Selector setting to “Single Drop Down”.
Click Save
On the front end, go to the page that has the [slplus] shortcode.
Result
The search form for the map should show a category drop down.
The front end page with the [slplus] shortcode, showing the category selection filter.
User Action : Filtering Locations With Category
On the front end, go to the page that has the [slplus] shortcode.
There are five to seven sections under the Settings/Results tab admin panel depending on which add-ons you have activated. Each section describes when and/or where the results will appear under your map.
Not all of the settings will appear if you have the Advance level plan for SaaS or do not have the Experience and/or the Power add-ons for the basic WPSLP self managed plug-in.
At Startup
You determine the Number of results you want to appear on the map and locator page as soon as the page loads when you have “Show locations at startup” checked. We recommend 50 for most sites unless you have the Premier add-on or Enterprise level plan (if using MYSLP) which allows less clutter on the map by virtue of “cluster markers”.
The next setting is the radius to search initially when “Show locations at startup” is checked. Leave empty to use the map radius default. Recommended : Set to a large number to search everywhere.
And the third setting is : ” Number to show initially.” How many results do you want to show under the map? This is the part that populates the actual information regarding your locations (under or next to your map depending on the style) with the address, website info, phone, etc.
If you are signed up for the MYSLP, the Professional level plan) additional settings can be enabled , for example do NOT show the results until after a search has been performed”. The setting is labeled “Disable Initial directory”
The base Store Locator Plus plugin and add ons are updated on a regular basis. Often the updates include security and bug fixes or fundamental changes that are designed to improve performance by reducing the memory and/or disk request load when your visitors are interacting with the map.
The most common reason your legacy add on stopped working is because it is no longer supported with the latest version of Store Locator Plus or vice versa
You may wish to choose to stay with your WPSLP Self Managed plugin and upgrade to the replacement bundled add-ons or switch to the managed MySLP.
Make sure you have a backup copy of the current version of SLP you have installed that IS working with your add on packs. We ALWAYS recommend that your site uses VaultPress or JetPack
Whenever you update the base plugin make sure ALL of your SLP add-on packs are updated to the latest version.
For the WordPress SLP stand alone (do it yourself) plug-in , the latest update to the Word Press base plugin normally appears in your WordPress site Plugin menu for auto update
To check your version against what is currently available please see the site home page under Support/Versions
The WordPress Store Locator Plus base plug-in is again available in the WordPress plug-in directory. If you purchased an add-on you will need to log into your WPSLP account and download it manually the first time you use it.
ALWAYS BACK-UP your site immediately before updating any Plug-ins.
(This section has been updated to reflect updates in SLP version 5.5.)
There are settings under the General tab for Admin , User Interface, (Server and Data tabs in earlier versions, now are included under the APP tab). This documentation has been updated to reflect the Google API changes for our WPSLP self managed plug-in customers. The tab “App” Map is where you will enter your own Google API keys. MySLP customers do not need to worry about that. We do it for them.
Admin
The Admin tab is where your SLP Premier subscription Accounts ID , Log Schedule Messages, 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.