Configuration

Locator has two configuration areas: the store locations you add as content, and the Store Locator settings page that controls how the directory looks. The [locator] shortcode then renders it. The settings live on one screen under WooCommerce → Store Locator and are stored in a single option, locator_settings.

Store locations

Each store is a locator_store post under WooCommerce → Store Locations. Add one entry per physical shop. The Location details box holds:

• Street address, multi-line.
• City, Postcode / ZIP, Country, single-line.
• Phone, rendered on the card as a click-to-call tel: link, with non-digits stripped from the href so the dialler gets clean digits.
• Email, stored, but see the note below.
• Latitude / Longitude, optional decimal degrees, validated to range (−90…90 and −180…180) on save; anything blank, non-numeric or out of range is cleared.
• Opening hours, free text, displayed as entered (line breaks preserved).

The post title is the store name; the editor body is an optional description. Saving the box is gated behind a nonce and the manage_woocommerce capability, and every field is sanitised on save.

Fields the storefront actually renders

The card shows the name always, then, when the matching toggle is on and the store has a value, the address block (street, postcode + city, country), opening hours and phone. The email, description, featured image and coordinates are stored but not printed by the current storefront template. Email is kept for your records and for add-ons; coordinates are kept for a future map.

Store Locator settings

Open WooCommerce → Store Locator. There are two groups of settings:

Search box

On by default (show_search). When on, a search field appears above the results and visitors filter locations as they type. Filtering happens in the browser, so no data leaves the page. Turn it off if you only list a handful of stores.

Fields shown on each card

Three checkboxes, Address, Opening hours, Phone, stored under fields in the option. All three default to on. The store name is always shown and is not a toggle. A field that is enabled but empty for a given store simply does not render for that card, so a half-filled location never shows blank rows.

There is no layout setting and no grid, Locator renders a single list. There is no setting for email, directions or coordinates on this screen.

The [locator] shortcode

Place the directory on any page or post:

[locator]

The shortcode takes no attributes, it ignores anything you pass it. Presentation is controlled entirely by the settings above, applied site-wide. Locator only enqueues its CSS and JavaScript on pages where the shortcode actually rendered, so other pages stay lean.

Privacy and performance

There is nothing to configure for privacy: the directory is self-contained. No external API, no tracking, no map key. Locations render server-side, so the list works with JavaScript disabled; when JavaScript runs it only filters cards already on the page. The markup reserves its space, so it adds no layout shift.

Storage and cleanup

Settings live in the single locator_settings option. Store locations are ordinary posts of the locator_store type with their details in post meta (_locator_address, _locator_city, _locator_postcode, _locator_country, _locator_phone, _locator_email, _locator_hours, _locator_lat, _locator_lng), no custom tables.

Deleting the plugin runs the uninstall routine, which removes the locator_settings and locator_db_version options. Your store locations are left intact, they are your content. If you want them gone, delete the Store Location posts before removing the plugin.