FAQ
Does it require WooCommerce?
Section titled “Does it require WooCommerce?”Yes. Locator registers under the WooCommerce menu, lists WooCommerce as a required plugin, and its screens and post type are capability-gated to manage_woocommerce.
Does it show a map?
Section titled “Does it show a map?”No. Locator renders a searchable list of cards, not a map, so it needs no map key and no external service. You can still store latitude and longitude per location; the free storefront ignores them, but they are kept for a future map add-on.
Do I need a map API key?
Section titled “Do I need a map API key?”No. The directory works without any key or external API. No request is sent while a visitor types, filtering is entirely in the browser.
Is there a grid layout, or a layout shortcode option?
Section titled “Is there a grid layout, or a layout shortcode option?”No. Locator renders a single list and the [locator] shortcode takes no attributes. Presentation is set on the WooCommerce → Store Locator screen and applies site-wide.
Which details show on each card?
Section titled “Which details show on each card?”The store name always shows. You can toggle Address, Opening hours and Phone in WooCommerce → Store Locator → Fields shown on each card. Each toggled field only appears when that store has a value. Email, the description and the featured image are stored but not printed on the card.
How does the search work?
Section titled “How does the search work?”The shortcode filters the cards already on the page as the shopper types, matching against name, address, city, postcode and country. It is case-insensitive, debounced, and runs entirely in the browser, so it is instant and private.
Does the directory work without JavaScript?
Section titled “Does the directory work without JavaScript?”Yes. Every location renders server-side, so the full list shows with JavaScript disabled. The instant search box is added on top when JavaScript is available, nothing is hidden behind it.
Can I override the template in my theme?
Section titled “Can I override the template in my theme?”No. The storefront template is loaded only from inside the plugin, so a copy placed in your theme is not used. Restyle the directory with CSS by targeting its .locator__* classes from your theme stylesheet.
Why is a phone number on the card not showing?
Section titled “Why is a phone number on the card not showing?”The Phone field must be toggled on and the store must have a phone value. The visible number keeps your formatting; the click-to-call link uses a digits-and-+ version of it.
Will it slow my pages down?
Section titled “Will it slow my pages down?”No. Locator enqueues its CSS and JavaScript only on pages where the shortcode rendered, uses plain JavaScript with no jQuery, and reserves card space so it adds no layout shift.
What happens when I delete the plugin?
Section titled “What happens when I delete the plugin?”Uninstalling removes the locator_settings and locator_db_version options. Your store locations stay, they are your content. Delete the Store Location posts first if you want them removed too.