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 versions and updates

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 but until the plug-in is re-approved by WordPress you will need to download from our storefront and manually update the plug-in.  (MySLP or SLP SaaS subscribers do not need to worry about having the latest versions, we do that for you automatically)

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 not available in the WordPress plug-in directory at this time.  Please visit our storefront to purchase the base plug-in and read the latest  news for changes. If you purchased an add-on  you will  need to log into your WPSLP account and download it manually as well.

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.

Search by Name

Additional Search settings are available if you are using either:

Word Press Store locator Plus plugin with the Experience Add-on , or  the Store Locator Plus SaaS / Professional level plan.  have multiple search tool options to display on the front page when a site visitor lands on your locator page. Search by Name is a checkbox that is found under the Store Locator Plus “Settings/Search” menu.   

The default is “Name” 

 

WPSLP Premier General Admin

WPSLP Premier customers will need to add their User ID and subscription ID under the Store Locator Plus / General /Admin tab. To find your Premier account information, log into WordPress Store Locator plus account .

Scroll to Premier Subscription Info
Thank you for being a Premier Member. You will need to enter your User ID and Subscription ID via the Store Locator Plus General Settings Tab under the Admin section in order to get the latest updates to the Premier Plugin.

Your user ID is: (A number will be here)

Subscription id is : (numbers will be here)

Legacy Locator Styles

locator stylesheets

With built-in custom CSS rules now standard for most WordPress themes, version 5.4+ of Store Locator Plus® has dropped legacy CSS styles. Up to version 5.4 users could place a CSS file in the Store Locator Plus® plugin CSS directory and then use the Settings | View | Plugin Style to select that CSS file in place of the default “A Gallery Style”.

Adding The Style With Experience Add On

Copy the CSS from one of the legacy CSS stylesheets listed below an paste it into the Settings | View | Custom CSS box. This requires the WordPress Experience Add on.

Adding The Style With WP Themes

Custom CSS support is built into WordPress core and themes only need to tell WordPress they support that option to enable the functionality. Many modern themes now include this option. Go to Appearance | Customize | Additonal CSS and paste the CSS there.

Legacy CSS Styles

MySLP Store Locator Plus® SaaS

Users of our MySLP SaaS offering don’t have to worry about this sort of thing. The built-in style gallery will suffice for most sites and those that need custom CSS can use the built-in CSS tools provided by platforms like Wix, Weebly, Squarespace, and more.

WordPress Custom CSS Rules

You can add custom CSS rules to WordPress to style your directories and location maps without having to wait for a custom Store Locator Plus® style or a theme that supports full CSS rules. WordPress has a built-in CSS customization tool that applies to all pages on the site.

You can use this custom CSS tool to do things like format the MySLP SaaS, or WPSLP plugin, directory listings.

How To Add Custom Rules

Login to your site as a site administrator.

Click on the Customize menu entry in the admin toolbar.

Click on Additional CSS in the sidebar.

Enter a fully qualified CSS rule.

This example is used to style the MySLP SaaS directory listings on the site. MySLP is a pure JavaScript embed implementation and requires the site hosting the embed to add extra CSS rules. The output changes the MySLP Directory state selector from a vertical list to a horizontal list as shown on the MySLP Directory page.

Translating Store Locator Plus ADD-ONs

Store Locator Plus uses the built-in WordPress internationalization and localization tools to translate the interface text into various languages.  Store Locator Plus plug-in is part of the WordPress Translate project.  You can contribute translations for the base plugin at the Store Locator Plus directory at WordPress Translate.

If you do not see the base plugin in your language, check the SLP Translate report for the latest Stable Release and make sure your language is at 100%.  The Translate system will not create a language export for partial translations.  If you want to help with the translation, send a request to be added to the WordPress PolyGlots project.

Learn About Translate.WordPress.Org.