CSV Import Zip / Postal Codes

When creating a CSV import file make sure the zip / postal code column is properly formatted as text so you do not lose leading zeros.

The column header for postal/zip codes is zip or sl_zip.

In the United States many northeastern postal codes start with zero.   Many sheets, Microsoft Excel in particular, LOVE to lead off the leading zero if you enter a zip code as 03907 and save as CSV.

Invalid Postal Codes
Invalid Postal Codes

In Excel, and many other apps, you can force a field where you are typing in numbers to be text by starting your entry with an apostrophe (‘).  Type ‘03907 when entering the data NOT 03907.

A good test is to open your CSV file in Google Sheets and see what it looks like.  Does it look like the sheet above missing a zero?  The data is likely wrong.

Another indicator that this column is set to a numeric type and not an text type is the data is on the RIGHT SIDE of the cell.  Text is left-justified (like sl_state) and numbers are right-justified.

 

Store Locator Plus Additional Functionality

Store Locator Plus .    Premier subscription holders with active subscriptions for WordPress  Store Locator Plus or are Enterprise level subscribers for MySLP have a module that adds URL control functionality.

 

Upgraded  Premium Features

Enabling Modules

The application separates functionality into different application modules.    This will ensure that extra overhead is not incurred for features not being deployed in your environment.  The interface for turning modules on and off is found under the General | Server tab in the Web App Settings section.

Power Users

The WordPress plugin includes a module for building SEO friendly web pages based on location data.   The option is a checkbox to enable the Pages module . This can be found under the General | Server | Web App Settings section.

Enterprise / Premier Users

Enabling the Territory Bounds module was moved from the General | Data tab to the General | Server | Web App Settings section.

URL Control

A  URL Control module was been added to the application for Enterprise or premier subscribers.   Enabling this module will turn on the interface to allow additional data to be presented in a web page URL to impact how the locator behaves.

URL Control : Allow Location In URL

The first URL Control option is to pass a location ID in via a URL.   Adding ?location=<id> to the end of a web page address that hosts the locator will cause the page to load with the specified location being highlighted as if the map marker was clicked.  The default behavior is to show the info bubble for that location.

 

Downgrading Store Locator Plus

As we continue to phase out the legacy add ons you may find that one of the add ons you purchased no longer works with the latest version of the free Store Locator Plus plugin for WordPress.  You have a few options when this happens.

Option 1 : Upgrade Your SLP WordPress Add On

The features that were part of the following Legacy add-ons , Enhanced Map, Enhanced Search, Enhanced Results, and the Widget Pack,   are now part of the Experience add on along with dozens of new features that have been added over the past 2 years.

Features and  functionality found in the Legacy add-ons , Pro Pack, Tagalong, Pages, Contact Extender and Directory Builder,  are included in the  Power add on with the exception of the CSS layout box which is now part of the Experience add-on.

Combining multiple add ons into a single larger add on allowed us to make the code more efficient and use less overhead on your site.  They are  faster, use less memory (important for high traffic sites), and work with the latest features of Store Locator Plus 4.7+ and WordPress 4.5 and above.

Option 2 : Downgrade Store Locator Plus

If you upgraded moments ago and have not published new blog posts, received WooCommerce orders, or had other activity you want to retain since upgrading the base plugin you should be able to restore your latest site backup.  You are backing up your site with a solution like VaultPress, aren’t you?    If so a few clicks will put your Store Locator Plus plugin back to the version you were running earlier today.

No backup or too risky to restore?  You can download and re-install the older version of Store Locator Plus.

NOTE:

We absolutely do NOT recommend rolling back any plugins or themes on a live site. Test the rollback locally first, have backups, test on a staging or dev site first and  use WordPress  best practice tools available to you. Research first!

You can get the older versions of the install zip files from the WordPress directory.

https://wordpress.org/plugins/store-locator-le/developers/

Select the latest version that did not disable your legacy add on.  It will download a zip file.

Login to your WordPress admin panel.

Deactivate Store Locator Plus and delete it (your locations and most* settings will be retained).

Add a new plugin, select “upload” and select the SLP zip file you just downloaded.

*Most settings will be retained.   Sometimes we migrate settings between versions to speed up the options processor.  When we add a new feature or fix a bug we may find that we need to rename a setting.    If something is not exactly the same check your settings first.  99% of your settings will not change.  We also try not to change settings between upgrades but sometimes it is inevitable.    Also – this is ANOTHER great reason to be using a backup service.    Point-in-time restores will not only restore the plugin code but all the settings in the options table!

Option 3 : Migrate to My Store Locator Plus

MySLP is our SaaS service that works with any web or mobile app including WordPress and brings most of the features you find in the base plugin plus some extras with it.   The Professional level includes all of the Experience and Power add on features.  The Enterprise level includes all of that plus the Premier features.

We take care of backing up the data, fully testing the software between releases, and are adding custom MySLP features on a regular basis.     We manage the location server, geocoding limits, and all the other overhead of the locator.  You just enter locations , turn the “dials” to set the look and feel of the locator, and paste a short snippet of JavaScript code on any page or post where you want your locator to appear.

 

Google Map Style

The WPSLP Experience Add On and MySLP Professional support the  Google Map Style rules. These rules let you control the “inner style” of the map itself. Pre-defined map rules allow you to set a variety of styles via the  map settings on the SLP admin panel.

For MySLP go to Store Locator Plus > Settings > Map > Map Style

For WPSLP go to Store Locator Plus > Settings > Map > Map Style

The value of this entry is a Google Maps JSON style string.  Some of our Plugin Styles in the Style Gallery will set this for you.    You can also build your own with services like Map Style With Google.

Getting Started with WPSLP

Get A Google API Key

Updated , see Google Sever key

Before you get started you will need to get a Google Maps  API Key. Please note, there are some misleading instructions in the Google developer console telling you to restrict your API key when you move your site to production. The recommended way to do this for the majority of our WP SLP customers is to add  HTTP referrer and add a geocoding key. The two key approach is available for version 4.9.15.

Step 1: Go To the Google Developer Site

Google API Key Step 1
Google API Key Step 1

Getting Started With Buy Here For WooCommerce

Buy Here For WooCommerce 520x520

Buy Here For WooCommerce is a free WordPress plugin that allows you to associate Store Locator Plus locations with WooCommerce products.   When customers search for physical locations they will see a list of products offered at that location.

This document describes the initial installation and setup for Buy Here For WooCommerce.

Install The Required Plugins

Login to your WordPress site and go to the Plugins / Add New screen.

Search for “Store Locator Plus” from the WordPress Plugin Directory.   Install and activate that plugin.

Search for “WooCommerce” from the WordPress Plugin Directory.   Install and activate that plugin.

Search for “Buy Here For WooCommerce” from the WordPress Plugin Directory.   Install and activate that plugin.

Note: Buy Here For WooCommerce requires Store Locator Plus 4.4.18 or higher and WooCommerce 2.4.10 or higher.  If either are not installed or are not activated the Buy Here For WooCommerce plugin will not activate.

Note: While this plugin is being reviewed by the WordPress Plugin team it can be “purchased” at not cost from the Store Locator Plus store.

Add Locations

From your WordPress admin login go to Store Locator Plus, go to the Locations tab and Add Locations.

Add Products

From your WordPress admin login go to WooCommerce  Products and Add Products.

Connect Locations To Products

While adding a new product, click the Locations panel in the Product Data section.

Start typing the name of a location or the postal/zip code.    When you type the 3rd letter a list of Store Locator Plus locations that match your search will appear.  Select a location that you wish to have associated why the product.

Create A Locations Page

Go to Pages and add a new page.     On that page put the [slplus] shortcode.

Open that page to see your location search form, map, and list of locations.

Locations that have product data associated with it will show the product data under the details column on the right side of the location listing.

BHWC Location Search Results
BHWC Location Search Results

Do More

There are a lot of add ons available for WooCommerce and Store Locator Plus to tailor the user experience to meet your needs.  For Store Locator Plus you may want to start with the Experience add on to customize the look-and-feel of the location listing results.

Related