The base Store Locator Plus plugin and add ons are updated on a regular basis. Often the updates include security and bug fixes or fundamental changes that are designed to improve performance by reducing the memory and/or disk request load when your visitors are interacting with the map.
The most common reason your legacy add on stopped working is because it is no longer supported with the latest version of Store Locator Plus or vice versa
MySLP Professional and Enterprise level services allow for locations to be categorized. Each category for a location can have its own map marker associated with the category. These markers are then displayed on the map to mark the location. (This also applies for those customers using the WordPress SLP plug-in with the Power add-on or Premier)
However, some locations may belong to more than one category. In this case the map marker that is selected to be displayed on the map is determined by the RANK assigned to the category. If multiple categories have the same rank, or no rank, then the first category by alphabetical listing will be the one selected as the “main” category for rendering the map marker.
Filtering Locations By Category
What happens when a user decides to filter the list of categories? Only locations that are within the selected category are shown.
If the location only belongs to ONE category, as is the case for the “#1 Food Store” in our example above, the choice is easy. Show the category map marker.
But what should be displayed if a location belongs to several categories, as is the case for our “24 Seven #1” location shown in the example above?
Prior to our mid-September 2020 release of Store Locator Plus® (or the Power 5.5.7 add on for our legacy WordPress plugin users), the marker for the “24 Seven #1” location would be the highest ranked category, which is the convenience store marker.
With the mid-September 2020 release, however, this behavior has changed. The map marker displayed will be the one that matches the filter the user selected.
Multiple Location Categories
What about Store Locator Plus® interfaces that allow users to select more than one category, such as interfaces that allow checkbox selections for categories? Markers will be chosen from the markers for the selected categories only. If a location matches 2 or more of the categories, the highest ranked OF THOSE SELECTED will be displayed on the map.
This is different from earlier versions of Store Locator Plus® where it would always display the highest ranked category map marker, even if it was not part of the checked list of categories.
If you have git version control setup and you have connected it to phpStorm properly you can make commits and push them up to origin directly from within phpStorm. This video shows how to view which files were updated, what changed in the files, select them to be commited to the codebase and pushing them up to the repository.
The Store Locator Plus® WordPress plugin self-checks all add ons to ensure they are a compatible release. If SLP has any breaking changes all known add ons that do not support the new code architecture will be automatically disabled. While this is also true for the SaaS product, it is not an issue for those users as we manage the entire application environment to ensure all the add on features are compatible with the main locator code.
In the attached video we show how to change the Store Locator Plus main version number as well as how to disable the Janitor plugin as the current release is no longer supported.
To change the SLP product version we update the readme.txt file and store-locator-le.php file.
To disable the Janitor plugin we change a property in the SLPlus class that indicates the minimum require version of SLP Janitor is 99.99.99 for SLP 5.5 or higher.
phpStorm – an IDE for editing code, controlling Vagrant installs and sometimes even code commits (overlaps with SourceTree which has a better visual branch manager). If you buy this get the individual/personal use license.
With built-in custom CSS rules now standard for most WordPress themes, version 5.4+ of Store Locator Plus® has dropped legacy CSS styles. Up to version 5.4 users could place a CSS file in the Store Locator Plus® plugin CSS directory and then use the Settings | View | Plugin Style to select that CSS file in place of the default “A Gallery Style”.
Adding The Style With Experience Add On
Copy the CSS from one of the legacy CSS stylesheets listed below an paste it into the Settings | View | Custom CSS box. This requires the WordPress Experience Add on.
Adding The Style With WP Themes
Custom CSS support is built into WordPress core and themes only need to tell WordPress they support that option to enable the functionality. Many modern themes now include this option. Go to Appearance | Customize | Additonal CSS and paste the CSS there.
Users of our MySLP SaaS offering don’t have to worry about this sort of thing. The built-in style gallery will suffice for most sites and those that need custom CSS can use the built-in CSS tools provided by platforms like Wix, Weebly, Squarespace, and more.
The Wix embed code presentation leaves a bit to be desired when it comes to formatting. When you drop an embed block into a Wix page it will often add far too little padding, is not centered, and does not default to a big enough height to display a list of locations.
Getting Started With The Embed Format
When using Wix we find it easier to format the MySLP embed code by using the advanced editor.
Start by adding an Embed , HTML block into the page. Wix will drop this in a random semi-centered location on the page. Drag it down to an available space on the page.
It is best to set the embed block to be 100% the width of the content. The gutters should be marked with a dashed line to show the left/right main content width. Stay between the gutters.
Set a default height tall enough to show the listing. An embed box height of 800 is a good start.
Click on the embed box and look for Enter Code on the top-left corner of the box.
Enter the embed code and related <style>..</style> section as noted below.
Example Embedded MySLP Directory Code
You can add custom CSS rules to WordPress to style your directories and location maps without having to wait for a custom Store Locator Plus® style or a theme that supports full CSS rules. WordPress has a built-in CSS customization tool that applies to all pages on the site.
You can use this custom CSS tool to do things like format the MySLP SaaS, or WPSLP plugin, directory listings.
How To Add Custom Rules
Login to your site as a site administrator.
Click on the Customize menu entry in the admin toolbar.
Click on Additional CSS in the sidebar.
Enter a fully qualified CSS rule.
Our software-as-a-service platform, MySLP, runs on many different web builders and mobile frameworks. If you are using MySLP you cannot easily create pages that contain the [slp_directory] shortcode used in the Store Locator Plus WordPress plugins. There is another way to do this with our SaaS offering.
The Embed Code
Embed Code For Directories
When displaying a directory, you normally do not want the location search and map to appear. You can use the data-presentation attribute with your script to tell MySLP what type of location presentation you would like to show on your site.
Here is a full script example from our test server — you can see where we added data-presentation=”directory” to the standard embed script.