Map display options

Map Display

The Experience add-on for the WP Store Locator Plus or the MySLP/Professional Plan  allows you to customize the way your Map  is displayed and behaves.

With the WPSLP Experience add-on installed and activated  go to Settings/Map.

  • Show Map (default)
  • Hide map until search
  • Image until search
  • Do not autozoom

Appearance

Additional options  are available to change your  Map layout and appearance    with the WPSLP Experience Add-on.   If you do not have the Add-on or a corresponding MySLP plan,  the  optional settings will  NOT appear.   (Note: There is a sidebar menu with MySLP/Professional under Store Locator Plus. See Adjust Locator styling for more information)

The additional options with the above mentioned plans or add-ons allows you to  hide the map , change the map layout, change the map bubble display, and/or  hide the map info bubble.  The Plugin Style under View (WPSLP) may supersede these settings. Choose one that  will compliment your theme or utilizes the add-on features available to you.

Q. Why am I seeing a message that I do not have sufficient permissions when I am trying to manage my locations?

You Do Not Have Sufficient Permissions

If you are getting the message “you do not have sufficient permissions to access this page” when trying to access the “Manage Locations” or “Map Settings” page, but “Add Locations ” is working it is because another plugin is interfering with the submenu management module in WordPress. You will likely find that any plugin that has a separate sidebar menu with multiple entries underneath will only work on the first entry. There is little we can do to remedy the situation without risking breaking other plugins. We suggest deactivating other plugins, one-at-a-time, until you find the plugin causing problems then ask them to rewrite their menu and submenu process and admin panel filters to ensure the basic menu system remains intact.

Gray map or blank map and/or search does not work

JavaScript Problems

Many times we hear that an update to SLP broke “everything” Upon asking  for clarification  we find out that they also updated WP and/or  other plugins or that they didn’t update other plugins to work with the current version of WP.  WordPress explains how to  use your browser to diagnose javasciprt error

Issues with the JavaScript part of the plugin usually manifest themselves by showing the search form but either a blank map, a map that is all gray, or a map that appears but search does not work. To identify what is causing your issue use the Firebug add-on with Firefox or any Browser developer tools (see above how to diagnose with browser).

The WordPress Store Locator Plus map rendering is managed by the slp.js JavaScript file.  It sets up the communication with the built-in WordPress AJAX handler, admin-ajax.   Your server must be setup to allow the built-in WordPress AJAX handler to execute.  Additionally, ANY PLUGIN or THEME that is breaking javascript will break SLP functionality. This is rarely an issue with the SLP plugin.

Common errors or issues:

The PHP JavaScript connector did not load

We have come across this error on several installations. The short answer to this problem is that something in the WordPress installation prevented the Store Locator Plus JavaScript component from loading. This means that the map system cannot communicate with Google. This prevents the map from appearing and search results from working properly on your locations page.

Here are some issues we’ve come across that cause this to happen:

    • PHP version is < 5.3, this generates an error message that you will not see in the browser. Any error message will prevent the JavaScript PHP file from loading. SLP will not work with versions lower then PHP 5.3.
    • PHP Error Reporting Enabled, if PHP error reporting is enabled and ANY PLUGIN has bugs, uses deprecated WordPress functions, or uses deprecated PHP functions they will generate an error message. This error message can be hidden in the browser if the error happens in something that is creating page header information. This will also break the page loading process and prevent the JavaScript PHP from loading.
    • Plugin Errors, any plugin that does not load properly and does ANYTHING with page header output will break and thus cause a domino effect prevent the Store Locator Plus PHP JavaScript component from loading.

In many cases the cause of the maps not loading is because our PHP JavaScript file could not load. We can often detect this and pop-up the “PHP JavaScript connector did not load” warning. However we cannot catch all errors. Why good Javascript is critical.

One of the best tools for searching for errors in the HTML page headers is to use Firefox with the Firebug plugin or any browser developer tool. Turn on the console and check the responses tab under console for any errors. We have resolved many client installation and map problems with this plugin. More often than not we are finding errors in other plugins, themes, or server/site  configuration settings.

The PHP JavaScript page header is a critical part of a working Store Locator Plus installation. Since it loads very late in the page creation process it is susceptible to failures from almost anything else you may be loading on the page or your WordPress site. The the map is not loading and you are receiving this message get some page debugging/tracking tools like Firebug and isolate any plugins that are generating coding/output errors.

Update your WordPress environment and  review  the WordPress changes.

Review the suggested new and improved requirements as of 4.9. 

  • Update PhP to 7 or higher
  • Update MySQL to 5.6 or higher
  • Site move to HTTPS 

2017 is going to be the year that you’re going to see features in WordPress which require hosts to have HTTPS available. Just as JavaScript is a  necessity for smoother user experiences and  updated PHP versions are critical for performance, SSL just makes sense as the next hurdle our users are going to face.  Google also weighs SSL as a search engine ranking factor and have begun flagging unencrypted sites in Chrome.

Search and results not loading

AJAX Blocked

It is common for web hosts and system administrators to disable the built-in WordPress AJAX processing.   Store Locator Plus requires AJAX to be enabled.   This typically manifests itself with the AJAX call to the admin-ajax.php script not executing.

You can test this by directly surfing to the admin-ajax script on your server with a URL similar to this:

/wp-admin/admin-ajax.php?action=csl_ajax_onload&addressInput=&ignore_radius=1

This should return a JSON response showing curly braces that start with {“success”:true,…

If it comes back with nothing, or a warning/error about being blocked, your AJAX security is not set properly.  Check you web server log files and talk to your system admin for assistance on configuring access to WordPress AJAX scripts.

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.

 

Q. I paid for email support what happens next?

A.   For an  email support order:

      • If you pay and order support on Monday morning before 9 A.M EST , someone in customer support will answer you on, or before Wednesday no later than Thursday of the same week.  If you want to speed things up,  you may follow up with  an email to support letting them know you have submitted an order for support and provide your Plugin environmnet information and a brief explanation of your issue.
      • If you order and Pay for support on a Friday, realize that we are on the east coast.   If the support request comes in at 4 PM EST (which is 1PM Pacific time), do not count that Fri,Sat/Sun. The clock would start ticking Monday for a 3 Biz day email query and an acknowledgement of your paid support or a reply , if you have already provided the info concerning your issue, a reply would be forthcoming on or before Wed the following week.

      Q. Where can I find an earlier version of the Core SLP plugin?

      A. If you need to download an earlier version of the  WordPress StoreLocator Plus developer plugin, go to the WP developers plugin directory.  Select the version you need , download.

      You should always back up your site before updating to avoid issues that can occur , especially if you have not been updating your site on a regular basis.  We recommend JetPack.

       

      You may also want to check out this article:

      Downgrading Store Locator Plus

       

      Q. Where can I find the Store Locator Plus for WordPress versions and updates?

      A. The latest update to the base plugin normally appears in your WordPress site Plugin menu for auto update.  The latest  version of the core SLP plugin  is always  available to download for free  from the WordPress Store Locator Plus plugin directory.  You will also find the system requirements,  changelog, description of the product, and other links in the WordPress Store Locator Plus directory.  To check your version against what is currently available  please see the site home page under Support/Versions

      Q. What is the difference between a shortcode and locator layout settings?

      A.    A shortcode is a WordPress-specific code that lets you do nifty things with very little effort.  Shortcodes can embed files or create objects that would normally require lots of complicated, ugly code in just one line.   In other words, a Shortcode = shortcut.

      What To Buy: Filter By Brand

      Question

      We need to filter our locations by brand.  Does your plugin or an extension to your plugin have this feature?

      Assigning Brands To Locations

      Power is the right choice for doing that. The Power add-on allows for simple categories or complex parent/child relationships between categories. Locations can be assigned to one or more categories. Your users can then search for locations based on those categories.

      Add a category for each brand you offer and your users will be able to filter locations showing only those that offer specific brands.