內容簡介
Location Finder 外掛可輕鬆建立和管理各類商業或組織的地點，並將其以圖釘形式顯示在動態 Google 地圖上。無需 Google Maps API 金鑰，仍可作為可搜尋的目錄，提供快速直觀的搜尋體驗。
【主要功能】
• 友善的管理介面，快速新增地點
• 在 Google 地圖上顯示地點圖釘
• 支援關鍵字、類別及半徑篩選
• 自動生成可用的地點頁面
• 提供地址、電話、電子郵件等資訊
• 可選擇列表或網格佈局顯示搜尋結果
外掛標籤
開發者團隊
原文外掛簡介
Location Finder makes it easy to create and manage locations for any type of business or organization (stores, restaurants, offices, programs, nonprofits, etc.) and display them as pins on a dynamic Google Map. A Google Maps API key is optional; without one, it still works as a fully searchable directory using keyword and category filtering. Visitors get a fast, intuitive search with built-in keyword, category, and radius-based “near me” filtering. The Pro version adds filtering by any custom taxonomy, your own distance choices, and deeper control over map styling and pins.
Full documentation and setup guide: https://codexalogic.com/documentation/getting-started-with-location-finder/
Highlights
Add locations via a friendly admin interface (Custom Post Type), with Google Places autocomplete for fast, accurate address entry.
Display locations as pins on a Google Map, plus a dedicated page for each location with its own map.
Works with or without a Google Maps API key — use it as a full interactive map locator, or skip the key and run it as a keyword/category-searchable directory.
Show address, phone (US and international formats), email, website, weekly hours, a “Get Directions” link, and categories for each location, each one individually shown or hidden.
Built-in keyword search for quick filtering.
Category filtering and radius-based “near me” search, with distance choices of 10, 25, 50, and 75.
Choose a list or grid layout for search results.
Use the Location Finder block or [locfinder] shortcode, both offer the same functionality and the same set of options.
A ready-to-use Locations page is created automatically on activation, so the map works right away without building a page yourself. You can rename it, change its URL, or point the plugin at a different page in General Settings.
Built with accessibility in mind: semantic markup, screen reader announcements for search results, and support for reduced motion.
Email addresses are obfuscated in the page source to help deter automated spam harvesting, and are hidden by default until you choose to show them.
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 by any custom taxonomy you have registered for locations, beyond the built-in Categories.
* 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.
Use cases:
* Store/branch locator
* Program and service directories
* Office/campus/venue maps
* Resource finders for nonprofits and municipalities
Shortcodes
Display the search form, map, and results:
[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 location 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
