Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Locator

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Locator lists your physical shops on the storefront. You add each location once in wp-admin, name, address, city, postcode, country, phone, email and opening hours, then place the [locator] shortcode on any page to print a searchable directory customers can filter by city, postcode or name.

What it is, and what it is not

Section titled “What it is, and what it is not”

Locator renders a list of cards, not a map. There is no Google Maps key, no API call and no tracking script. Every location is printed in the page HTML, so the directory is visible even with JavaScript turned off. When JavaScript runs, the search box hides and shows cards as the visitor types, filtered entirely in the browser, so nothing is sent to a third party while typing.

Free edition highlights

Section titled “Free edition highlights”
  • Store Locations live as their own post type under the WooCommerce menu, address, city, postcode, country, phone, email, opening hours, and optional latitude/longitude.
  • The [locator] shortcode prints the directory anywhere. Leave the search box off if you only list a couple of shops.
  • Client-side search over name, address, city, postcode and country. No request is sent while typing.
  • Per-card display toggles for address, opening hours and phone. The store name is always shown.
  • The result count is announced through an ARIA live region, the search field is keyboard-operable, and cards use focus-visible outlines.
  • CSS and JavaScript load only on pages where the shortcode actually rendered, and the markup avoids layout shift.
  • Storefront styles follow the visitor’s light/dark preference and honour prefers-reduced-motion.

The free edition is the full GPL product, not a trial with hidden limits.

On coordinates

Section titled “On coordinates”

Each location can store a latitude and longitude. These are not used by the free storefront, there is no map and no directions link. They are stored so a future map add-on can read them. You can leave both blank.

Editions

Section titled “Editions”
  • Free on WordPress.org, managed locations, searchable list, instant filtering, accessible cards.
  • Locator Pro (planned) for an interactive map that reads the coordinates you store here.

Next steps

Section titled “Next steps”