Location Finder – Store Locator & Resource Directory

Location Finder lets you build searchable store locators, business directories, and resource directories—with or without Google Maps. List stores, services, programs, or online resources. Listings do not need a physical address when used as a directory.

Visitors can search by keyword, filter by category, and browse results in a list or grid layout. Enable Google Maps to add an interactive map, address search, and radius-based “near me” filtering.

Choose which details appear for each listing, including images, descriptions, addresses, contact information, and hours. Add your locator or directory to a page using the Location Finder block or the [locfinder] shortcode.

The free version includes keyword and category search, list and grid layouts, and optional Google Maps features. Location Finder Pro adds custom taxonomy filtering, custom radius choices, distance display, result templates, and advanced map styling.

Full documentation and setup guide: https://codexalogic.com/documentation/getting-started-with-location-finder/

Highlights

• Create store locators, business directories, service listings, and resource directories.
• Run a searchable directory with or without Google Maps.
• Search by keyword and filter by category.
• Display results in a list or grid layout.
• Enable Google Maps for interactive map pins, address search, radius filtering, and autocomplete when adding addresses.
• Show or hide listing details, including images, descriptions, addresses, phone numbers, email addresses, websites, and hours.
• Give each listing its own detail page.
• Embed your directory with the Location Finder block or [locfinder] shortcode.
• Use the automatically created Locations page or choose your own.
• Built with accessibility in mind: semantic markup, screen reader announcements for search results, and support for reduced motion.
• Translation-ready (i18n).

Pro features (optional upgrade):
* Set your own distance choices for radius search, in place of the built-in 10, 25, 50, and 75.
* Filter listings by any registered taxonomy, beyond Location Categories, so visitors can narrow results by service area, amenity, or other custom terms.
* Distance display on each result for geolocated or radius searches.
* A custom HTML template for result cards, with dynamic tokens for every location field.
* Custom map styling (JSON), custom pin icons, and per-category pin colors and icons.
* Show an “Open Now” or “Closed Now” badge based on each listing’s hours and your site’s timezone.

Use cases:
* Store/branch locator
* Program and service directories
* Office/campus/venue maps
* Resource finders for nonprofits and municipalities

Shortcodes

Display the search form and results, with an optional map:

[locfinder]

Every shortcode attribute is optional and falls back to your Location Finder settings when left out, so [locfinder] alone works right out of the box. Attributes let you override those settings for a single instance, including which search fields appear, sort order, results layout, and which listing details are shown, for example:

[locfinder show_hours=”0″ grid_cols=”2″]

The Location Finder block offers the same options directly in the block editor sidebar.

External Services

This plugin uses the Google Maps JavaScript API to display an interactive map, geocode addresses, and power address autocomplete in the location editor. A Google Maps API key is required only for those features; without one, Location Finder still works as a searchable directory, using keyword and category search against your saved location data, with no connection to Google at all. Add your own Google Maps API key in the plugin settings whenever you want the map or address-lookup features.

When a Google Maps API key is configured and a page containing a map is loaded, the plugin loads a script from https://maps.googleapis.com and sends the data needed to render that map and resolve address-based searches. This includes the location addresses and coordinates you have saved, any address a visitor types into the search field, and, only when a visitor uses the “Use my location” button and grants their browser’s permission prompt, that visitor’s coordinates (used to look up a readable address to show in the search field).

No data is sent to Google unless a Google Maps API key is configured and either a map is displayed or an address-based search or lookup is performed. The plugin does not send data to codexalogic.com or to any service other than Google Maps.

Google Maps Platform Terms of Service: https://cloud.google.com/maps-platform/terms
Google Privacy Policy: https://policies.google.com/privacy

Source Code

The full source code, including the unminified JavaScript and the build tooling used to generate the compiled assets in build/, is publicly available at:
https://github.com/CodexaLogic/locfinder

To build the assets yourself: run npm install followed by npm run build (see package.json for the full script list).

Third-party libraries bundled in build/:

• @googlemaps/markerclusterer, version 2.6.2, Apache-2.0 licensed. Source: https://github.com/googlemaps/js-markerclusterer