Translation-ready (i18n).<\/li>\n<\/ul>\n\nPro features (optional upgrade):\n* Set your own distance choices for radius search, in place of the built-in 10, 25, 50, and 75.\n* Filter by any custom taxonomy you have registered for locations, beyond the built-in Categories.\n* Distance display on each result for geolocated or radius searches.\n* A custom HTML template for result cards, with dynamic tokens for every location field.\n* Custom map styling (JSON), custom pin icons, and per-category pin colors and icons.<\/p>\n\n
Use cases:\n* Store\/branch locator\n* Program and service directories\n* Office\/campus\/venue maps\n* Resource finders for nonprofits and municipalities<\/p>\n\n
Shortcodes<\/h3>\n\n
Display the search form, map, and results:<\/p>\n\n
[locfinder]<\/p>\n\n
Every shortcode attribute is optional and falls back to your Location Finder settings when left out, so [locfinder]<\/code> 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 location details are shown, for example:<\/p>\n\n[locfinder show_hours=\"0\" grid_cols=\"2\"]<\/p>\n\n
The Location Finder block offers the same options directly in the block editor sidebar.<\/p>\n\n
External Services<\/h3>\n\n
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.<\/p>\n\n
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).<\/p>\n\n
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.<\/p>\n\n
Google Maps Platform Terms of Service: https:\/\/cloud.google.com\/maps-platform\/terms\nGoogle Privacy Policy: https:\/\/policies.google.com\/privacy<\/p>\n\n
Source Code<\/h3>\n\n
The full source code, including the unminified JavaScript and the build tooling used to generate the compiled assets in build\/<\/code>, is publicly available at:\nhttps:\/\/github.com\/CodexaLogic\/locfinder<\/p>\n\nTo build the assets yourself: run npm install<\/code> followed by npm run build<\/code> (see package.json<\/code> for the full script list).<\/p>\n\nThird-party libraries bundled in build\/<\/code>:<\/p>\n\n\n- @googlemaps\/markerclusterer, version 2.6.2, Apache-2.0 licensed. Source: https:\/\/github.com\/googlemaps\/js-markerclusterer<\/li>\n<\/ul>\n\n\n
\n- Upload the
locfinder<\/code> folder to the \/wp-content\/plugins\/<\/code> directory.<\/li>\n- Activate the plugin through the Plugins menu in WordPress.<\/li>\n
- Add your Google Maps API key in Location Finder > General Settings, if you want to display an interactive map. This step is optional \u2014 the plugin works as a searchable directory without one.<\/li>\n
- Add locations via Locations in the WordPress admin.<\/li>\n
- Visit the Locations page created automatically on activation, or embed the map anywhere using the
[locfinder]<\/code> shortcode or the Location Finder block.<\/li>\n<\/ol>\n\n\n\nDo I need a Google Maps API key?<\/h3><\/dt>\nOnly if you want to display the interactive map. Without one, Location Finder still works as a full-featured directory, with keyword and category search and results in a list or grid layout, just without the map itself. You can get a free API key from the Google Cloud Console any time you want to add it.<\/p><\/dd>\n
Will this work for any kind of business or organization?<\/h3><\/dt>\nYes. The Location post type works for shops, restaurants, offices, programs, and other businesses or organizations with an address or coordinates.<\/p><\/dd>\n
What information can I display for each location?<\/h3><\/dt>\nAddress, phone number, email, website, weekly hours, a \"Get Directions\" link, and categories. Each field can be shown or hidden independently, globally in settings or per shortcode\/block instance.<\/p><\/dd>\n
Does the plugin support international phone numbers?<\/h3><\/dt>\nYes. Enter a US number as usual, or enter an international number with a leading + and country code (e.g. +44 20 7123 4567).<\/p><\/dd>\n
Is my visitors' privacy protected when I show an email address?<\/h3><\/dt>\nEmail addresses are encoded in the page's HTML source so they aren't easily collected by automated spam scrapers, while still displaying and working normally as a clickable link for visitors. Email display is also hidden by default until you turn it on.<\/p><\/dd>\n
Does each location get its own page?<\/h3><\/dt>\nYes. Every location has its own page with its own map, address, contact details, and hours, in addition to appearing in search results.<\/p><\/dd>\n
Can I use a block instead of a shortcode?<\/h3><\/dt>\nYes. The Location Finder block is available in the block editor and offers the same configuration options as the shortcode, through the block's own settings panel.<\/p><\/dd>\n
Can I customize the map style or pin icons?<\/h3><\/dt>\nPin color can be customized in the plugin settings. The Pro version adds custom pin icons, custom map styling, and per-category pin colors and icons.<\/p><\/dd>\n
Does the plugin create anything when I activate it?<\/h3><\/dt>\nYes. Location Finder creates a single page titled \"Locations\" containing the [locfinder]<\/code> shortcode, so you have a working locator immediately. You are free to rename it, change its slug, or delete it. To use a different page instead, choose one under Location Finder > General Settings > Locations Page. The plugin never recreates the page once you have set it, and it does not modify any of your other pages.<\/p><\/dd>\nCan I use different categories on different pages?<\/h3><\/dt>\nYes. Each shortcode or block instance can target its own taxonomy, and pin colors are matched per instance to whichever taxonomy that instance is filtering on, so two maps on different pages can use different category sets and different pin colors.<\/p><\/dd>\n
Does it support categories or filtering?<\/h3><\/dt>\nThe free version includes keyword search, filtering by the built-in Categories taxonomy, and radius-based \"near me\" search with distance choices of 10, 25, 50, and 75. The Pro version adds filtering by any custom taxonomy you register for locations, and lets you set your own distance choices.<\/p><\/dd>\n
What happens on uninstall?<\/h3><\/dt>\nBy default, nothing is removed. Your plugin settings and all location data are kept. You don't lose anything if you deactivate and later reinstall. (The plugin does always remove the Location-editing permissions it granted to Administrators and Editors, since those have no purpose without the plugin.) If you check \"Delete Data on Uninstall\" on the Tools settings page, uninstalling the plugin will permanently remove all locations, plugin settings, and cached data. This cannot be undone.<\/p><\/dd>\n
Is it translation ready?<\/h3><\/dt>\nYes. Use the locfinder<\/code> text domain and place translation files in the \/languages<\/code> folder.<\/p><\/dd>\n\n<\/dl>\n\n\n1.0.1<\/h4>\n\n\n- Fix: Location Details block is properly recognized by the block editor, preventing it from being flagged as invalid content and accidentally removed from the Single Location template.<\/li>\n
- Fix: Results Columns setting disables when Layout is set to List, matching the existing Grid Columns behavior.<\/li>\n
- Fix: Map width is no longer applied when Results Position is set to below the map.<\/li>\n
- Improvement: Category dropdown shows parent and child categories as a nested, indented list.<\/li>\n
- Improvement: Keyword and Address search fields use placeholder text inside the input instead of a separate visible label, with the label kept for screen reader accessibility.<\/li>\n
- Improvement: Result card thumbnails are larger and card spacing is slightly increased.<\/li>\n
- Docs: Clarified that a Google Maps API key is optional. Search and directory features work fully without one.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release.<\/li>\n<\/ul>","raw_excerpt":"Display locations on an interactive Google Map, with keyword, category, and radius "near me" search and results in a list or grid layout.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/362351","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=362351"}],"author":[{"embeddable":true,"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/codexalogic"}],"wp:attachment":[{"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=362351"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=362351"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=362351"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=362351"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=362351"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=362351"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}