Skip to content
WPPoland Documentation

Locator

Locator adds a searchable store directory to WooCommerce. Add each physical store — name, address, phone, opening hours and optional coordinates — as a managed location, then drop the [locator] shortcode on any page to render a clean, accessible list shoppers can filter by city, postcode or name.

Why stores pick Locator

Section titled “Why stores pick Locator”

Locator is a self-contained, privacy-friendly directory: no external API, no tracking and no map key required. Every location renders server-side, so the list works even with JavaScript disabled; when JavaScript is available, the search box filters cards instantly in the browser.

Highlights

Section titled “Highlights”
  • Managed store locations as a dedicated post type under WooCommerce — address, city, postcode, country, phone, email, opening hours and optional latitude/longitude.
  • [locator] shortcode renders a searchable, accessible directory.
  • Instant client-side filtering by city, postcode or store name — no data leaves the page.
  • List or responsive grid layout, switchable in settings or via layout="grid".
  • Choose visible fields per card — address, hours, phone, email and a “Get directions” link.
  • “Get directions” links open the visitor’s map app using coordinates or the postal address.
  • Accessible by design — ARIA live region for result counts, keyboard friendly, focus-visible styles, screen-reader text.
  • Core Web Vitals friendly — no layout shift; assets load only on pages with the shortcode.
  • Theme-overridable templates and dark-mode-aware admin and storefront styles.

How the directory works

Section titled “How the directory works”

Each store is a location post under WooCommerce. The [locator] shortcode renders every published location server-side as a list or grid. When JavaScript runs, the search box filters the cards in place and announces the new result count through an ARIA live region. Nothing is sent to a third party.

Editions

Section titled “Editions”
  • Free on WordPress.org — managed locations, searchable list/grid, instant filtering, directions links.
  • Pro (planned) for an interactive map, region grouping and bulk import.

Next steps

Section titled “Next steps”