Skip to content
WPPoland Documentation

Getting started

Most shops can publish a store directory in a few minutes. Install Locator, add your stores, then drop the shortcode on a page.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce active
  • PHP 8.1 or newer

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Locator from the plugin directory (when live on WordPress.org) or upload the locator folder to /wp-content/plugins/.
  3. Activate the plugin.

Add your stores

Section titled “Add your stores”

Go to WooCommerce → Store Locations and add each store:

  • Name, address, city, postcode and country.
  • Phone and email.
  • Opening hours.
  • Optional latitude/longitude for precise “Get directions” links.

Configure the directory

Section titled “Configure the directory”

Open WooCommerce → Store Locator:

  • Layout — choose List or a responsive grid.
  • Visible fields — pick which details show on each card (address, hours, phone, email, “Get directions”).

Place the shortcode

Section titled “Place the shortcode”

Add the shortcode to any page:

[locator]

Pass layout="grid" to force the grid layout on a specific page:

[locator layout="grid"]

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open the page with the shortcode — your locations should render as cards.
  2. Type a city, postcode or store name in the search box — cards filter instantly and the result count is announced.
  3. Click Get directions — the visitor’s map app opens with the store coordinates or address.
  4. Disable JavaScript — the full list should still render server-side.

Override the markup

Section titled “Override the markup”

Copy templates/locator-list.php into your-theme/locator/locator-list.php to customise the card markup.

Free vs PRO

Section titled “Free vs PRO”

The free edition covers managed locations, the searchable list/grid, instant filtering and directions links.

Locator PRO (planned) adds an interactive map, region grouping and bulk import — not basic directory access.

Need help?

Section titled “Need help?”