Store Finder
Publish a searchable list of active business locations with visitor-initiated nearby results
Pro+ Required. Store Finder reads the locations managed under ProRank SEO → Local SEO → Locations Manager.
Add Store Finder to a Page
Add the shortcode to a page, shortcode block, widget, or supported builder template:
[prorank_store_finder]The frontend loads only when the shortcode renders. Multiple instances are supported on the same page.
Shortcode Options
[prorank_store_finder
radius="25"
max_results="10"
show_filters="true"
style="modern"
primary_color="#2563eb"]| Attribute | Default | Purpose |
|---|---|---|
radius | 25 | Initial distance radius in miles after device location is used |
max_results | 10 | Maximum location cards shown |
show_filters | true | Shows radius, Open Now, Wi-Fi, parking, and EV-charging filters |
style | modern | Sets the container style identifier |
primary_color | blue | Accepts a valid three- or six-digit hex colour |
Visitor Experience
- Search by location name, address, city, region, or postal code.
- Filter by opening status and stored amenities.
- Open directions, call a location, or visit its website.
- Click the location icon to request browser permission and sort by distance.
- See opening status in the WordPress site timezone, including overnight hours.
- Switch to an on-demand map when a map provider is configured.
Privacy and Public Data
The public endpoint returns active locations only and projects an allow-list of display fields: name, public address, contact details, coordinates, hours, and amenities. Internal notes, scores, timestamps, primary flags, and import metadata are excluded.
Device coordinates remain in the visitor's browser. Store Finder does not send them to ProRank or save them in WordPress.
Map Providers
Choose the Store Finder tile provider under ProRank SEO → Local SEO → Nearest Locations. The list view remains the default and no tile request is made until a visitor selects Map.
| Provider | Setup | Recommended use |
|---|---|---|
| OpenStreetMap | No key | Development and low-volume maps that comply with the public tile policy |
| MapTiler | Browser API key + map ID | Commercial or higher-volume sites |
| Mapbox | Public pk. token + style ID | Commercial or higher-volume sites |
Restrict MapTiler and Mapbox browser credentials to your production origins. These are public browser keys and are sent directly to the selected tile provider when Map opens.
Troubleshooting
- No locations appear: confirm at least one location is active and has a non-empty name.
- Nearby results are empty: add valid latitude and longitude to each location and increase the radius.
- Open Now is incorrect: verify the WordPress site timezone and each day's opening-hours values.
- The map option is unavailable: save a supported tile provider and valid public browser credentials, then confirm the Store Finder is allowed to show maps.
- The finder stays on its loading message: rebuild Premium frontend assets and confirm
build/store-finder.jsexists.