WP Store Locator

• Works without Google Maps. Run the entire store locator on OpenStreetMap with no API key, no Google account and no credit card. Prefer Google Maps, Mapbox or Stadia Maps? Pick it from a dropdown. Your locations, settings and add-ons work with every provider.
• No code needed for custom data. The Fields Manager adds your own fields to the store editor and the Section Editor places them in the results, the info window or anywhere else on the front end.
• Design your own markers. The Marker Studio lets you create marker icons that match your brand instead of picking from a fixed set.
• Draw on the map. Polygons, circles, rectangles and lines for service areas, delivery zones or sales territories.
• A modern theme and an appearance editor. A new vertical layout, plus colours, call-to-action buttons and map styles you can change without touching CSS.
• Privacy built in. Hold the map back until the visitor consents, with your own text, or hand the decision to Borlabs Cookie or Complianz.
• Faster. Location data is loaded in a single batch and settings in a single query, so a locator with hundreds of locations stays quick.

• OpenStreetMap (Leaflet): Free. No API key. Optional free vector styles from OpenFreeMap, and inline routes with a free Openrouteservice key.
• Stadia Maps: Ten polished map styles, its own geocoder and routing, and an EU endpoints switch that keeps all requests inside the European Union.
• Mapbox: Design a map in Mapbox Studio, paste the style URL and the locator uses it. Ten styles ship out of the box, including satellite and navigation.
• Google Maps: Full support, now on the current Geocoding and Routes APIs, with Advanced Markers, cluster styling and the new Autocomplete Data API.

• Search by address, postcode, city, state or country, or by store name.
• Autocomplete as the visitor types.
• Detect the visitor's location automatically, on page load or after they click the locate button.
• Radius, max results and category filters, as dropdowns or checkboxes.
• Combine categories with AND or OR logic, or pre-select a default category.
• Hide the address search and show only the category filter to turn the locator into a browsable directory.
• Sort by distance, name, address, city, postcode, state, country or ID, ascending or descending.
• Search for a whole country or state and get every location in it.
• No results in range? Show the nearest location anyway, however far.
• Keep results inside the searched country, so a border town does not return stores across the border.
• Show the number of results returned.
• Bias or restrict results to up to 15 countries.

• Address, phone, fax, email, URL, description, featured image and categories for every location.
• Structured opening hours with a live Open now / Closed badge, expandable to the full week.
• Custom hours text and a "special hours" field for holidays.
• Mark a store permanently or temporarily closed, with an automatic reopen date.
• Your own fields of any type: text, textarea, email, phone, URL, checkbox or dropdown, grouped the way you want them in the editor.
• Drag the marker to the exact spot, or type coordinates in by hand.
• A landing page for every location with clean URLs, so search engines and customers can link straight to a store.
• Admin search by name, postcode, city, state or country, and sortable custom columns.

• Vertical or horizontal layout, with results beside or below the map.
• Appearance editor for colours, dimensions, call-to-action buttons and active map styles.
• Marker Studio for custom markers, plus per-category markers and a distinct active marker.
• Numbered or lettered markers that match the results list.
• Marker clusters on every provider, with styled and colour-interpolated clusters on Google Maps.
• Section Editor to change the markup of the results list, info window, result count and online stores sections.
• Open the info window on hover or by clicking the address in the results.
• Every label and placeholder is editable, and any label can be hidden without losing the field.
• Improved accessibility, keyboard navigation and RTL support.

• Built-in consent placeholder with your own description text. No extra plugin required.
• Integrations with Borlabs Cookie and Complianz.
• Server-side geocoding on OpenStreetMap.
• EU-only endpoints on Stadia Maps.

• Store Locator and Map blocks for the block editor.
• [wpsl] for the full locator, with attributes for categories, filters, map style, markers, shapes, region and distance unit.
• [wpsl_map] for a map with one or more locations.
• [wpsl_address] and [wpsl_hours] to show the address, contact details or opening hours of a single location anywhere.

• Onboarding wizard for new installs, and automatic migration of 2.x settings.
• Home screen with a setup checklist and alerts for compatibility problems, missing keys or API errors.
• API key validation with the raw response shown, so key restrictions and billing problems are diagnosed in seconds.
• Import and export settings, reset data, clear caches and inspect geocode responses from the Tools section.
• Custom post types and taxonomies, more than 50 filters, template overrides and a helper to build your own custom-field filters.
• Compatible with WPML and Polylang.

1. Install and activate the plugin.
2. Follow the onboarding wizard: choose a map service, add a key if the service needs one, and set a start location.
3. Add your locations under Store Locator > Add Store, or import them with the CSV Manager from the Add-on Bundle.
4. Add the Store Locator block or the [wpsl] shortcode to a page.

• CSV Manager: Bulk import, export and update locations from a CSV file.
• Search Widget: Let visitors search for the nearest store from any widget area and land on the results page.
• Statistics: See what people search for and where there is demand for a new location.

• Lifetime updates
• 12 months of technical support
• A free upgrade to WP Store Locator Pro when it launches
• A 30-day money-back guarantee

Please take a look at the documentation before making a support request.

• Getting Started
• Configure WP Store Locator
• Shortcodes
• Troubleshooting
• Customisations
• Filters

1. Upload the wp-store-locator folder to the /wp-content/plugins/ directory, or install it from the Plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Run through the onboarding wizard. Choose a map service under Store Locator > Settings > API. OpenStreetMap needs no key. For Google Maps, Mapbox or Stadia Maps, enter the key and click Validate API key.
4. Set the start location under Store Locator > Settings > Map.
5. Add your stores under Store Locator > Add Store.
6. Add the Store Locator block or the [wpsl] shortcode to a page.

• Added a content hash to lazy-loaded JS modules to prevent browsers, hosts or CDNs from serving an older copy and breaking the map or settings page.

• Fatal error "Service not found: plugin_alerts" on admin and AJAX requests when another plugin, such as MainWP Child, logs the user in during init.

• Prevent a fatal error by checking that is_plugin_active is available before calling it.
• wpsl_create_meta_filter() now calls the correct service.
• The Dimensions tab now shows the height fields of the active template.
• Results list no longer overflows its container with a custom height, plus other styling fixes.
• Custom CSS for the v2 dropdowns and search button overrides the v3 styles again.
• The radius and results dropdowns no longer disappear when "Only show the category filter?" was saved after the category filter was disabled.
• Custom v2 code reading the height from $wpsl_settings now gets the active template's height, instead of always 450.
• After upgrading from v2, an alert explains why the Google Maps server key check failed, and the Home step reads "Fix your Google Maps API key".
• Clearer instructions when Google blocks the server key due to IP/API restrictions or a disabled Geocoding API.
• The v2 "Hide the scrollbar?" option is back as "Show all results" in the horizontal template's Results height setting (Appearance → Dimensions).
• Theme CSS for multi-column search results works again; a single column renders as a normal list, as in v2.
• The Appearance preview now resizes the category dropdown to match search field width changes. Changed
• Optimized the responsive CSS.
• The vertical template's search field and filters use the search results' font size instead of the theme's body size (theme CSS can still override it).
• With "Overwrite theme styles" off, theme colors take priority over plugin defaults again, as in 2.x.
• With 2-3 result columns, the column count now follows the results list width, staying at least 260px wide per column.

• Added support for Mapbox, Stadia and OpenStreetMap (Leaflet)
• A new modern theme
• Support for name searches
• Create your own markers in the Marker Studio
• Draw polygons, circles, rectangles and lines on the map
• Fields manager that allows you to manage custom data fields
• Appearance editor that allows you to customize the theme / CTA buttons / active map styles (custom colors, icons, etc.)
• Template section editor that allows you to customize the code of different template sections
• Show the current open / closed status
• Make the current opening status expandable
• Select different template locations where the contact details, opening hours and post content are displayed
• Option to select an active store marker
• Option to set a category marker
• New cluster marker styles for Google Maps
• Added the option to show the number of returned results
• Option to define the search results order (ascending / descending) and sort by (address / id / distance / city / state / country)
• Optionally only show the category filter
• Default category filter selection
• If the search input is a country or state, then return all results
• If no results are found, then show the nearest location ignoring the used search radius
• Option to exclude locations from nearby countries in the search results (a search for a border town no longer shows locations across the border, even if they fall inside the search radius)
• Select the returned geolocation address format (zip, city/town, full address)
• Choose to run the geolocation attempt on page load or when the user clicks the auto-locate button
• Set the placeholder for the search field
• Option to open the info window by hovering over the corresponding marker
• Clicking on the address details in the search results opens the info window on the map
• Option to set a store permanently or temporarily closed (optionally automatically reopen)
• Option to set the opening hours to a custom text, and a "special hours" input field
• Built-in GDPR support
• An Alerts section on the settings page that shows compatibility warnings and other relevant messages
• Data management tool that allows you to delete all locations / categories and reset the plugin to default settings
• Import / export settings tool
• When "Add New Store" is clicked and no valid API key exists for Google Maps or Mapbox, a warning is shown that an API key is required, unless the coordinates are entered manually
• New shortcode options for [wpsl]: 'exclude_category', 'category_parent_id', 'category_filter', 'radius_filter', 'results_filter', 'map_style', 'map_id', 'active_marker', 'marker_clusters', 'shapes', 'city', 'state', 'country' and 'distance_unit'
• New shortcode options for [wpsl_map]: 'map_id', 'store_marker', 'active_marker', 'marker_clusters', 'shapes', 'city', 'state' and 'country'
• New 'current_status' and 'expand_status' attributes for the [wpsl_hours] shortcode, so the open / closed status and its expandable week can be set per shortcode instead of only globally
• New 'contact_details' attribute for the [wpsl_address] shortcode. Shows or hides the Phone/Fax/Email/Url block in one go, so a single shortcode can disagree with the contact details location setting without needing four attributes. The individual 'phone', 'fax', 'email' and 'url' attributes still win where they are named.
• New 'bold_contact_details' attribute for the [wpsl_address] shortcode. Wraps the Phone/Fax/Email/Url labels in <strong> (default true) so single store pages match the search results list. Set to false to restore the v2 unbolded output, or override via the 'wpsl_address_shortcode_defaults' filter.
• Added per-label show/hide toggles for the search-bar labels, so you can hide a label on the front-end without losing its text or the field itself.
• A wpsl_create_meta_filter() function allowing developers to create custom dropdowns / checkbox lists based on the passed custom meta key.
• A 'wpsl_sortable_columns' filter to make custom columns sortable in the admin area
• A 'wpsl_skip_required_check' filter to disable all required checks
• A 'wpsl_force_direction_coordinates' filter to use the coordinates instead of the address details as the destination in the Google Maps direction links Changed
• Modernized the decade-old codebase
• Migrated to v4 of the Google Geocoding API
• Migrated from the DirectionsService to the new Google Routes API, which has to be enabled in your Google Cloud project
• New users now go through an onboarding process
• Overall improved accessibility / keyboard navigation
• Improved support for RTL languages
• The data for the returned locations is now loaded in a single batch instead of one location at a time. The post data, custom fields, categories and featured images are all primed up front, which keeps the number of database queries flat when the search results or a [wpsl_map] contain many locations.
• The settings are read in one query per request instead of one per option group, and only the two groups needed on every page load are autoloaded.
• The CSV Manager, Statistics and Search Widget add-ons require version 2.0 or later. Older versions are automatically disabled until you update them.
• The new vertical theme's store locator container defaults to 450px high
• The default markers are now SVG files instead of PNG. PNG is still supported.
• Extended the admin search with support for zip, city, state and country searches
• Google Maps API key related errors are captured and shown to the user, explaining how to fix them
• Check for the partial match param in the Geocode API response for Google Maps, and warn the user if this happens
• Renamed the "below_map" (Show the store list below the map) template to "horizontal"
• The 'more info' section now always shows when it's enabled, so it's no longer required to have contact details filled out
• The start day of the week for the hours respects the WordPress settings
• If the label tag is left empty on the settings page, then don't render the label tag in the search bar
• Set the correct alt text on the preload image
• The tabs in the admin area fail gracefully, so they remain accessible if a JS error occurs
• The shortcode warning that shows up when it's used outside of a store page is now only shown to logged-in users
• Make the directions use the start / location markers instead of the default ones
• If the auto location option is enabled but no SSL is available, the exclamation mark next to it appears red, with popup text explaining the issue
• The 'zoom_controls' attribute was removed from the [wpsl_map] shortcode. Zoom controls now follow the map provider's default behaviour.
• The 'phone', 'fax', 'email' and 'url' attributes of the [wpsl_address] shortcode now follow the contact details location setting, instead of always being enabled.
• Removed support for the InfoBox library to style the pop-ups (no updates for many years). Popups are now styled according to the map provider's default styles.