About this plugin
Launch a store locator or directory of services and resources on your site in minutes. Help visitors find what they need with keyword search, category filters, and list or grid layouts.
Google Maps is optional. Enable it to add an interactive map, address search, and radius filtering.
Choose which details appear in 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.
These core features are included in the free version. Location Finder Pro adds custom taxonomy filtering, custom radius options, distance display, customizable result templates, and advanced map styling.
com/documentation/getting-started-with-location-finder/
Highlights
- Create store locators, business directories, service listings, and resource directories.
- Name your directory: Locations, Stores, Programs, Services, and more, or a name of your own choosing.
- 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 directory 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).
Location Finder Pro
- 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 result layout: choose which details each result shows, in any order, with your own text.
- 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 and Branch Locator
Help customers find nearby stores, branches, dealers, or service centers. Display addresses, business hours, contact information, and directions in one place.
Program and Service Directories
Organize programs and services into a searchable directory. Help visitors explore available support, filter by category, and find nearby services when location search is enabled.
Office, Campus, or Venue Maps
Map offices, campus buildings, or venues and provide addresses, contact details, and directions to help visitors plan their trip.
Resource Directory for Nonprofits and Municipalities
Connect community members with public services, assistance programs, and local resources. Include physical locations and online resources, with category filters to help visitors find the support they need.
Examples
- Store locator: https://nexus.uptownthemes.com/location-finder
- Resource directory: https://charity.uptownthemes.com/community-resource-directory
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.
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. com or to any service other than Google Maps.
com/maps-platform/terms
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:
com/CodexaLogic/locfinder
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