Forceload Javascript Warning

Store Locator Plus has a checkbox under the General /User Interface tab called Force Load Javascript

Having this checked forces the JavaScript for Store Locator Plus to load in the header of EVERY page on your site. This can slow down your site and will disable various Store Locator Plus features. If you need to do this to make SLP work you should ask your theme author to add proper wp_footer() support to their code, or switch to a theme that behaves properly.

Settings vs. Experience in the User Interface

If you see the word Experience in the SLP back end you are not using the latest version of SLP. As of version 4.7.9 the menu tab formerly named “Experience” is now named Settings in Store Locator Plus . This change was made because of the confusion people had with the name in the menu and the Experience add-on.  The settings under this tab determine how the front end, that part of the plugin your site visitors interact with, looks and behaves. The settings under this  tab change how the plugin appears to the site visitor and what functionality is available to the site visitor. Some of the attributes set here can be overridden via shortcode attributes with the Experience Add-on.

Store Locator Plus Base free plugin under the OLDExperience tab
Store Locator Plus Base free plugin under the OLD Experience tab
SETTINGS Tab under version 4.7.9

Results Settings and interaction

Additional Results Interaction features  are available with the MySLP/Enterprise or   WPSLP Premier Add On.  The results interaction set of features provides a variety of visual cues on the location map to indicate the location a user has clicked  when viewing a list of locations., providing a variety of additional options beyond the standard Info Bubble that Store Locator Plus displays when a location is clicked.

Use the Experience add-on to completely disable the Info Bubble under the map and only use these interactive result indicators. When a visitor to your site clicks on the results marker they will see additional information such as description you have entered for that location, in addition to the fields that are populated for the location.

Info bubble turned off, marker clicked shows the additional info for that location

WordPress White Screen

The “White Screen” in WordPress is one way that a WordPress site will show bugs in the underlying PHP code or system configuration.   In geek-speak this is known as a fatal error.    It can be a bug in PHP code or an incompatibility between the code and the server configuration.

The most common cause is a bug in the PHP code itself.  Plugins, themes, and WordPress can be the source of the problem.    If you have upgraded more than one item on your site prior to noticing a white screen, any of the updated items is suspect.

Note: You should ALWAYS back-up your site before upgrading to new versions of WP or any plugins. We suggest using JetPack . BAck-up your Word Press site

Here are some ways to track down the source of a “white screen” and recover from it quickly.

Debugging With Debug Log

With WordPress it is very easy to debug the activation process of a plugin and get a detailed log file of exactly what is going on.

Often there are hidden warnings or errors. Sometimes they are generated by the plugin. Many times they are generated by OTHER plugins or your custom WordPress theme. The first stage of debugging is to turn on the built-in WordPress debugging messages and debug log.

Troubleshooting Large scale Exports/Imports

Issue: Exports/Imports Incomplete

Multiple large-scale exports (export function is available with Power Add-on ) have been tested on the Store Locator Plus dev sites. On a relatively small server, a virtual machine with 2GB RAM running CentOS 6, we  have been able to export 10,000 locations within 15 minutes with no issues. Special characters and extended data have also exported without issue.

If you are experiencing  issues there are several things to check that can cause problems during an export:

Web Server Process Limits

Apache, and nginx  have per-process limits. This is built into the web server to prevent “runaway” processes that eat up all of the CPU and memory on the server over time. On shared servers this limit is very low and typically allows 30 seconds to 2 minutes of processing time. Large data sets can use up to 5 minutes or more of processing time. Make sure your server has a high enough limit to allow the entire data export to complete execution.

Q. We are developing a new website and want to move the content can I add the plug-in data we already have, into the new website?

A. If you are moving something like a staging/test site to a new site and want to bring everything over intact , the Store Locator Plus author strongly recommends looking into the WordPress backup tool Vault Press, or better ,  Jet Pack.   One of the features included , besides real-time incremental backups of your site with restore points, is the ability to restore the site to an alternate site.

Google Map Domains supported in SLP

Google Map Domains

The following countries are currently supported in the Store Locator Plus plugin.  These countries determine the default center starting point for location searches and determine which Google locations engine is used when searching for an address.   This influences, but does not restrict, which results are returned.   Regardless of what country you select as the default, any location in your location database can be returned by the search regardless of the country in which that location resides. This does not effect the zip codes necessarily. Some country postal codes are  unique, others are not.

Q. What is the purpose of ranking under category manager?

Category ranking is a feature when you are using the Power Add-on  (for the self managed WPSLP plugin) or the Professional or higher level  subscription for MYSLP SaaS  with the category manager. The rank is used to sort the categories which will affect the map marker that is used when a location has been assigned more than one category. Following the page ranking paradigm set by WordPress, the rank field is a simple numeric weighting for the categories. This extended data attribute for categories makes it easy to re-arrange the “weight” of categories for map marker selection without mangling category slugs. The lower the number, the higher the precedence for the map marker.

The option to set a category rank can be found under the Store Locator Plus Categories tab.