Results Layout Shortcodes and Attributes

Changing the results layout is a feature provided for Professional level accounts. Users of the self-managed WordPress plugins will find this 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.

Recovering From Critical Error After WordPress Plugin Updates

petaled flower drawing on white egg shell

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.

Here is how to recover from these issues.

Step 1: WordPress Users Need A Google API Key

SaaS users can skip this step. Store Locator Plus® for WordPress 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. 

If you are a subscriber to  Store Locator Plus® – our SaaS directory and locator service, you can ignore this page, we’ve got it covered. Go to our Getting Started guide and move on to Step 2.

For the Store Locator Plus® for WordPress 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. Google will bill you directly for your monthly map views and location look-ups.

Step 3: Add A Location Map To Your Site

stock

Add a location map to your site by putting the SaaS embed code or WordPress shortcode on any page. You’ll need to have an active Store Locator Plus® SaaS subscription or have the Store Locator Plus® for WordPress plugin installed and activated.

Make sure you’ve completed the initial configuration and setup steps outline in the Store Locator Plus® Getting Started article.

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.

How To : Location Categories

Assumptions

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

  1. Click on Store Locator Plus® | Categories in the WordPress sidebar menu.
  2. In the left “Add New Category Form”…
    1. Type a category name. (Restaurant)
    2. 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

  1. Click on Store Locator Plus® | Locations in the WordPress sidebar menu.
  2. Click the Edit action icon on the first location.
  3. Check off the box next to “Restaurants” in the Power | Categories section of the form.
  4. 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

  1. Click on Store Locator Plus® | Settings in the WordPress sidebar menu.
  2. Change the Category Selector setting to “Single Drop Down”.
  3. Click Save
  4. 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

  1. On the front end, go to the page that has the [slplus] shortcode.
  2. Enter an address, choose a category.
  3. Click “Find Locations”.

Upgrading Store Locator Plus

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.

Where to find the Store Locator Plus for WordPress Plug-in versions and updates

WordPress Plug-in Log-in

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.

How to manually update.

General Settings

(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.