Scroll To Map

By adding the scroll_to_map class on any of the Results Layout HTML elements, WordPress Premier or MySLP Enterprise subscribers can enable the scroll to map functionality on any Store Locator Plus plugin style.    When the class has been added to an element in the results layout that element becomes clickable.  Clicking that element will scroll the map back into view and open the map marker and info bubble for the location that was clicked.

We have used this feature in the new Bennett plugin style.

To add the feature to other styles you will need to have the Premier plugin installed for WordPress.   For MySLP Enterprise users the feature is already enabled.

Go to Advanced Options (MySLP) or Store Locator Plus (WPSLP) | Settings | Results | Results Layout.

Results Layout With Scroll To Map
Results Layout With Scroll To Map

Edit the layout and add scroll_to_map to an existing class on an html element you want to trigger the scrolling feature or add class=”scroll_to_map” if the HTML element does not have a class assigned.

Learn more about other Premier / Enterprise features like the new Category Button Bar.

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.

User Interface Settings

Settings that impact how JavaScript works on your site

UI jQuery Version –

reflects the jQuery version that is currently used with  the Store Locator Plus version  you are using. The SLP jQuery versions are in compliance with the WordPress minimal version requirements.

Force Load JavaScript

This settings forces the Store Locator Plus JavaScript (slp.js) to be loaded when your WordPress Theme header is loaded. This is NOT the way to go.  It is recommended that you turn OFF “Force Load JavaScript” and instead contact your theme author. See Troubleshooting for more information
Continue reading “User Interface Settings”

Q: I am receiving error messages and something isn’t working the way it used to, what is wrong?

The most common issue is that there were updates in Store Locator Plus, WordPress, a non-Store Locator Plus plugin, or your theme that may be interacting with and breaking Store Locator Plus.

Update Your Store Locator Plus Add Ons

The first step should always be to check the Store Locator Plus versions page and make sure you are running the latest version of your Store Locator Plus plugins.   There is often a free upgrade to a newer version of a Store Locator Plus add on that works with the current release of the base plugin.
Continue reading “Q: I am receiving error messages and something isn’t working the way it used to, what is wrong?”

Q: My Map Is Not Showing Up. What did I do wrong?

You activated the Store Locator Plus base plug-in and followed all the instructions but when you visit your locator page nothing is there.

Here are some common reasons why the map will not appear:

Did you obtain a Google MAP API key?

As of June 22, 2016 Goggle requires all new domains, sites to obtain a key. There are many options based on how often your locations are queried. There are instructions in the SLP documentation site , in the SLP User Interface under INFO.
Continue reading “Q: My Map Is Not Showing Up. What did I do wrong?”

General Settings

There are settings under the General tab for Admin , User Interface, Server, and Data.

Admin

The Admin tab is where your subscription Accounts ID , Add-on packs User info , and Update Notices are 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.
2016general-admin
There is also a Locations management option  to Highlight the locations that are not geo-coded on the Panel that displays your entered locations.
Continue reading “General Settings”