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

Posted by cici in Advanced, FAQ, Map, Search, Troubleshooting

JavaScript Problems:

Note: Major Updates to WordPress versions (example 5.0 , 5.5 ,5.7) may effect themes behaviors and plug-ins and cause additional errors. We strongly advise updating on a staging site or dev or  test site first instead of allowing AUTO UPDATES)

Many times we hear that an update to SLP plug-in  broke “everything”.  Upon asking  for clarification  we find out that they also updated WP and/or  other plugins or did not update their themes.   WordPress explains how to  use your browser to diagnose javascript 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 wor properly. To identify what is causing your issue use the Firebug add-on with Firefox or any Browser developer tools (see above info in the link to WordPress on 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.

IF YOU Update your WordPress environment , BE SURE TO  review  the WordPress VERSION changes  as they have changed.

Review the WordPress suggested requirements

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

2017 was  the year  WordPress was requiring   hosts to have HTTPS available. Just as JavaScript is a  necessity for smoother user experiences ,  updated PHP versions are critical for performance,  and SSL just makes sense as the next hurdle  users are going to face.   Note: Google also weighs SSL as a search engine ranking factor and have begun flagging unencrypted sites in Chrome.

Q. I paid for email support what happens next?

Posted by cici in FAQ, Support

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.
Read More “Q. I paid for email support what happens next?”

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

Posted by cici in FAQ, Map, Professional, Results, Search, Settings, View

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.

Read More “Q. What is the difference between a shortcode and locator layout settings?”

What To Buy : Rank Hide Import 10K Locations With Products Offered

Posted by lcleveland in FAQ, Support, What To Buy

Question: I would like to use your plugin to add location searching to my site. I would like to be able to rank and even possibly remove locations from the search results.  Also, each location offers different products of mine. So, if a user selects a product and a zip code I would like to show them locations that offer the product they are looking for ranked in order of my ranking system. I have many locations (10k +). Can you please let me know what add-ons I will need to accomplish my goals? I definitely need to be able to upload CSV.

Read More “What To Buy : Rank Hide Import 10K Locations With Products Offered”

Settings vs. Experience in the User Interface

Posted by cici in Advanced, FAQ, Settings

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

Troubleshooting Large scale Exports/Imports

Posted by cici in FAQ, Locations, Our Add Ons, Power Add On, Professional, Troubleshooting

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.

Read More “Troubleshooting Large scale Exports/Imports”

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?

Posted by cici in FAQ, for WordPress, Professional

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.

Read More “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?”

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

Posted by cici in FAQ, Our Add Ons, Professional, Results, Settings

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.