內容簡介
Partner Map Locator 是一款輕量級的 WordPress 外掛，旨在透過互動地圖展示您的合作夥伴網絡、經銷商、零售店或公司分支。使用者可以輕鬆管理位置，並選擇不同的地圖類型來呈現。
【主要功能】
• 自訂文章類型「位置」，具備完整的管理介面
• 支援多種地圖類型：Google Maps、OpenStreetMap 或列表模式
• 可選擇顯示「我的位置」按鈕，支援瀏覽器地理定位
• 提供 CSV 匯入/匯出功能，方便管理位置資料
• 支援多個地圖在同一頁面顯示
• 可選擇性使用 Google Geocoding API 進行地理編碼
外掛標籤
開發者團隊
原文外掛簡介
Partner Map Locator is a lightweight WordPress plugin for showing your partner network, dealers, retail stores or company branches on a responsive interactive map. Locations are managed as a custom post type so they sit alongside the rest of your WordPress content.
Using the settings: you pick one map type for the whole site (Google Maps, OpenStreetMap or list-only). That controls which scripts load. You can still hide the map on a single page with the shortcode or block list-only option. Under List & map visibility, Description has separate checkboxes for the list and the popup. Under Features, List card description (max. characters) controls list excerpts (with optional “Read more”); map popups always show the full description. Under Map defaults, Map popup width sets how wide the location card is on the map.
Choose Google Maps as the map type and enter your Google Maps JavaScript API key, pick OpenStreetMap for a keyless map rendered with the bundled Leaflet library, or use the list-only mode for a map-free, filterable location list.
Features
Custom post type “Locations” with proper capabilities and admin UI
Optional category taxonomy to group locations (regions, types, brands, …)
[partner_map_locator] shortcode with optional category, height, zoom, coordinates, layout, design and map attributes
Multiple maps on the same page are fully supported
Accessible list rendering of all locations alongside the map
Optional “Show my location” button (browser geolocation, off by default)
Optional admin geocoder using the Google Geocoding API (off by default, with a clear opt-in toggle)
Server-side cache so the location query only runs once per data change
CSV import / export and a one-click import tool for locations from a previous installation
Translation ready (text domain partner-map-locator)
Map provider of your choice: Google Maps (incl. optional Map ID / Advanced Markers) or OpenStreetMap (bundled Leaflet, no account or API key needed)
Four ready-made designs (Classic, Tab view, Mixed view, Stack view) plus per-page design/layout via shortcode or block
Geolocation with radius search and “near me” out of the box
Schema.org LocalBusiness markup and WPML/Polylang compatibility
No statistics or marketing scripts are bundled; outbound traffic is limited to the selected map service and, if you turn it on, the optional geocoder
Premium version
Partner Map Locator Pro is a separate add-on that extends this plugin with:
Marker clustering on OpenStreetMap and Google Maps
Seven additional designs (Design 1–7) including the compact mini list and the Focus panel
Pocket (a compact widget for sidebars) and Table (filter bar, map band, sortable table) designs
Guided entry: Discover (search field with shortcut filters) or Guide (three questions, one tap each) as a first step in front of any design
Floating map-popup overlays (mini / normal / mini-on-pin)
Enquiry / lead form with anti-spam options
Analytics dashboard (local data, no third-party tracking)
Priority support
The free plugin is fully functional on its own and never checks licences or contacts our servers.
Privacy
The plugin does not load advertising or visitor-profiling scripts. By default the map type is set to “List only”, so no external map service is contacted until the site owner opts in by choosing a map provider under Settings → Map. With the Google Maps provider, the visitor’s browser loads the Google Maps JavaScript API and tiles from Google, which may transmit data such as the visitor’s IP address to Google. With the OpenStreetMap provider, the Leaflet library is bundled and served from your own site; only the map tiles are loaded from the configured tile server — openstreetmap.org by default, or Carto (carto.com) when one of the Light / Dark / More-colors map color schemes is selected — which transmits the visitor’s IP address to that tile provider. Use the built-in consent gate (Settings → Integration) if you need visitor consent before the map loads; it covers both providers. The browser geolocation feature, when enabled, only triggers after the visitor clicks the dedicated button and is handled entirely client-side by the browser. The optional admin geocoder, when enabled, sends address data server-side from your site to the Google Geocoding API to retrieve coordinates.
Web fonts are self-hosted by default — the optional Google fonts are bundled with the plugin and served from your own server, so no request is made to Google. Under Settings → Style → “Web font loading” an administrator may instead choose “Load from Google”, which loads the selected font from https://fonts.googleapis.com and therefore sends the visitor’s IP address to Google; this option is off by default.
External services
This plugin can connect to the third-party services listed below. Every one of them is optional and off by default: the plugin ships with the map type set to “List only”, so a fresh install loads no map tiles and contacts no external service at all. A map (and its tile service) is only loaded after the site owner explicitly selects a provider under Settings → Map; the Google API features additionally require you to enable the matching option and enter your own API key. A built-in map consent gate (Settings → Integration) can require visitor consent before any tiles load.
OpenStreetMap tile server (tile.openstreetmap.org)
Active only if the site owner selects “OpenStreetMap” as the map type (the plugin defaults to “List only”, which loads no tiles). It is the keyless map option — no account or API key is required. When a visitor then opens a page that contains the map, their browser requests the map tile images from the OpenStreetMap tile server, which transmits the visitor’s IP address (and the requested map area) to the OpenStreetMap Foundation. No other data is sent. You can avoid this by keeping the “List only” map type, or by enabling the built-in consent gate (Settings → Integration) so tiles load only after the visitor agrees.
Tile usage policy: https://operations.osmfoundation.org/policies/tiles/ — Privacy: https://wiki.osmfoundation.org/wiki/Privacy_Policy
CARTO basemap tiles (basemaps.cartocdn.com)
Used only if you pick one of the “Light”, “Dark” or “More colors” map color schemes while using the OpenStreetMap provider. The visitor’s browser then loads the map tiles from CARTO instead of OpenStreetMap, which transmits the visitor’s IP address (and the requested map area) to CARTO. The default “Classic” scheme uses OpenStreetMap tiles and does not contact CARTO.
Terms: https://carto.com/legal/ — Privacy: https://carto.com/privacy/
Google Maps JavaScript API (maps.googleapis.com)
Used only if you set the map type to “Google Maps” (Settings → Map). When a visitor opens a page with the map, their browser loads the Google Maps script and map tiles using the API key you entered, which transmits data such as the visitor’s IP address to Google. The same script is loaded in the location editor if you use the optional “Import from Google Maps” search.
Terms: https://cloud.google.com/maps-platform/terms — Privacy: https://policies.google.com/privacy
Google Places API (places.googleapis.com, maps.googleapis.com)
Used only if you enable Google ratings sync or use the Google business search / Maps-link import in the location editor, and have entered your own API key. The plugin sends, from your server, the place ID or the search text you provide (and never any visitor data) to retrieve business details such as name, address, opening hours, rating and review count. Requests are made when you save a location, when you run a search/import in the editor, or on the schedule you configure for ratings sync. In addition, if you paste a shortened Google Maps share link (e.g. maps.app.goo.gl or goo.gl) into the “Import from Google Maps link” field, the plugin follows that link server-side to Google to resolve the full map URL before extracting the location data. All of this happens in wp-admin and only with links/searches an administrator enters; no visitor data is involved.
Terms: https://cloud.google.com/maps-platform/terms — Privacy: https://policies.google.com/privacy
Google Geocoding API (maps.googleapis.com)
Used only if you enable the optional admin geocoder (Settings → General) and have entered an API key. When an administrator looks up coordinates while editing a location, the entered address is sent from your server to Google to obtain latitude/longitude. No visitor data is sent.
Terms: https://cloud.google.com/maps-platform/terms — Privacy: https://policies.google.com/privacy
Google Fonts (fonts.googleapis.com, fonts.gstatic.com)
Web fonts are self-hosted by default and no request is made to Google. Only if you change “Web font loading” to “Load from Google” (Settings → Style) does the visitor’s browser load the selected font’s stylesheet and font files from Google, which transmits the visitor’s IP address to Google.
Terms: https://developers.google.com/fonts/faq — Privacy: https://policies.google.com/privacy
Bundled libraries & source code
The plugin bundles the following third-party libraries in their official minified distribution form. The human-readable, unminified source code is publicly available in the projects’ repositories:
Leaflet 1.9.4 (BSD-2-Clause) — public/js/leaflet.js — source: https://github.com/Leaflet/Leaflet
Leaflet.markercluster (MIT) — public/js/leaflet.markercluster.js — source: https://github.com/Leaflet/Leaflet.markercluster
Lucide icons (ISC) and Heroicons (MIT) — bundled as SVG data in admin/data/icon-library.php — sources: https://github.com/lucide-icons/lucide and https://github.com/tailwindlabs/heroicons
The plugin’s own minified assets (*.min.js / *.min.css) ship alongside their readable source files in the same directories.
