Editing Categories and Location Import/Export

During the month of June we have been working on several patches for both Store Locator Plus® SaaS platform and WordPress plugin users. We have also performed multiple tweaks to improve performance including leveraging some PHP 8 specific performance tweaks.

SaaS User Editing Categories

All SaaS users received an updated earlier this week patching the category edit functionality. Buried deep in the new settings history tracker was an issue that prevented categories from being edited and saved after they were created. 

Since our SaaS platform still runs most of the core features through the old-school WordPress core code it inherits a lot of garbage including the very outdated category editor (we are hoping to replace that someday with a modern React style editor). Part of the garbage that is inherited with that 15-year-old janky interface is the fact that the only way to add extended attributes to categories, like our custom map markers and icons, is to store the extra metadata in the WordPress options table. It just so happens that is the MAIN settings storage area.

We missed that when adding our settings history feature to the SaaS plugin. Thus, any time a user saved their category updates for their locations the WordPress engine would fire the “hey, we just saved some settings” trigger. Our code was expecting actual settings not category data and didn’t handle it well.

That has been patched and is already deployed for all SaaS users.

Read more: Editing Categories and Location Import/Export

Location Import/Export

Users that have installed the Power add for WordPress may have issues importing and exporting locations. After a week of tracking down this issue, which only happens on SOME WordPress sites, we have found that the WordPress user settings for administrators can be corrupted. This causes the admin interface to not load properly. That causes the JavaScript for the Power add on (and likely lots of other plugins, not just ours) to not be loaded.

This is NOT corruption caused by our plugin code. We are not sure what triggers it, but in some case a WordPress install will start thinking it is a “multisite” install and attaches either the network_admin or user_admin attribute to a logged in user session. When that happens the “do this when an administrator is on the Store Locator Plus® admin pages” does not fire. 

What did we do to fix this? In our test installations where we could reproduce the problem we went to our administrator user profile , changed the website URL (you can change ANY data — might be a good time to update your passwords) and saved. After we re-saved our user profile with a new website URL or password everything came back as expected.

How did the user admin meta get out-of-whack? We may never know.

Bottom line, if you location imports or exports are broken try re-saving your user profile in WordPress.

This issue does NOT impact SaaS users.

Post image by Lance Cleveland

Location Category Markers Update

Store Locator Plus® was updated with a small, but important, change to how location map markers are displayed when users are interacting with the category selector.   Users of the Professional level offering have the ability to create location categories.   Locations can belong to more than one category, for instance a location can be both a “Retail” location and a “Service” location.    Some locations will be only “Retail”.

Category Map Markers

Each location category can also be assigned a unique map marker.   All yellow map markers are retail, and blue markers are for service.     For those locations where they offer both retail and service , Store Locator Plus® would always display the yellow map marker based on the default “marker is the first category, chosen by alphabetical order”.

While there are some caveats to this general rule, there were some confusing results.    If you created a map with a category filter that allowed users to pick “either retail” or “service” locations and the user selected “service” they could see a map with both yellow and blue markers.    How is that happening when all service locations are supposed to be showing blue markers?

The answer — those dual-purpose locations that are in both the retail and service category.   Prior to the late-September update, the marker for the location would ALWAYS pick from the “highest ranked” category which would default to “retail” by the alphabetical rule noted above.    All locations that were service only would be displayed alongside a handful or retail-and-service locations.

Multiple Categories Marker Change

In the late-September update that went online today, IF a user is filtering the list of locations by a SINGLE category, the map marker that is displayed will be filtered as well — in essence filtering out the yellow “retail” marker if the user has elected “show only service location” with the blue marker.     With this update only blue markers will appear.

For another description of how this works along with an “explainer” video, check out our Categorical Location Markers article on the documentation site.

Still using the legacy WordPress plugins?   This feature is part of the Power 5.5.7 release.