[WordPress] 外掛分享： Dealer/Store Locator – Xtreme Locator

內容簡介

Dealer/Store Locator - Xtreme Locator 是一款 WordPress 外掛，能夠輕鬆嵌入 Xtreme Locator 的經銷商和商店搜尋功能。使用者只需透過簡碼或小工具即可在網站上顯示搜尋框，無需編輯佈景主題檔案，提供便捷的地點搜尋體驗。

【主要功能】
• 支援多種搜尋類型
• 直接嵌入 Xtreme Locator 表單
• 結果顯示在本網站上
• 免費方案支援最多 15 個地點
• 簡單設置，只需輸入 Site ID

外掛標籤

開發者團隊

原文外掛簡介

A WordPress dealer locator / store locator plugin powered by Xtreme Locator. It outputs Xtreme Locator’s embed forms directly into your page’s HTML — the same markup Xtreme Locator normally distributes for direct embedding, packaged as a WordPress shortcode and widget so it can be dropped in anywhere without editing theme files or using an iframe on the search box itself.
Requires an Xtreme Locator account
This plugin is the WordPress integration for Xtreme Locator’s location search service — it does not include location data or search logic of its own. You’ll need a Site ID from an Xtreme Locator account to configure it:

New to Xtreme Locator? Start a free trial. Xtreme Locator’s free plan supports up to 15 locations at no cost, so smaller businesses can use this plugin without paying anything.
Already have an account? Enter your Site ID under Settings → Xtreme Locator after installing.

Until a Site ID is entered, the plugin shows a short setup reminder to site admins only; regular visitors simply won’t see the search box.
Search types
Four search types are supported, chosen via the type shortcode attribute or the site-wide default in Settings → Xtreme Locator:

zip — a single zip/postal code field (the original default).
zip_distance — zip code plus a distance/radius field.
international — a country dropdown plus a postal code field, powered by Xtreme Locator’s own country-picker script.
near_me — a single “Locations Near Me” button that uses the visitor’s browser location (no typing required).

Results stay on your site
When a visitor searches, they are NOT sent to app.xtremelocator.com. Instead the plugin loads a page on your own WordPress site (same domain, wrapped in your theme’s header/footer) that shows the results inside a sandboxed iframe pointed at Xtreme Locator. The address bar stays on your site the whole time, and the results content (including any script Xtreme Locator uses for a map or dynamic list) runs isolated inside that iframe rather than directly inside your page. This applies to all four search types, including “Near Me” — Xtreme Locator’s own code normally opens that one in a new tab on their domain, but this plugin routes it through the same in-site results page as the others. The optional “Advanced Search” link uses the same in-site iframe pattern too.
A “Results not showing? Open in a new tab” link is included under the iframe as a fallback, in case a visitor’s browser or an ad-blocker interferes with the embedded frame.
Fully customizable
Go to Settings → Xtreme Locator to customize the search box’s text (heading, field labels/placeholders for each search type, button/link text), colors and appearance (button, heading, text, background, border, font, width), layout (inline vs. stacked), and to control the results iframe — its width, height, and whether it shows a scrollbar (auto / always / never). Any setting can also be overridden per-instance with a shortcode attribute.
Known limitations:

Only one “International” search box can be placed per page. Xtreme Locator’s country-picker script (searchByCountryJS.php) targets fixed field IDs, so a second instance on the same page would conflict with the first.
I wasn’t able to inspect Xtreme Locator’s searchByCountryJS.php or api/search.js scripts directly (they didn’t return readable source through my tools), so the International and Near Me search types are implemented based on the embed code you provided plus reasonable assumptions about how those scripts behave. Please test both after installing — in particular, confirm the International search box still submits to your own site rather than being redirected elsewhere by Xtreme Locator’s script, and that the Near Me results page renders a proper results page inside the iframe rather than raw data.
The “Postal code search not available for this country” message (see below) assumes Xtreme Locator’s script disables or read-onlys the postal code field when a country doesn’t support postal code search — that’s the standard pattern for this kind of widget, but since I can’t inspect their script directly, please verify it actually shows for an unsupported country after installing. If their script signals unavailability a different way, let me know what you observe and I can adjust the detection.
The Custom Search Form field (Settings → Xtreme Locator → Custom Search Form) is stored and displayed as entered — it is not filtered through WordPress’s usual HTML sanitization, since that would strip the