內容簡介
Xtreme Locator Search 外掛可將 Xtreme Locator 的搜尋表單直接嵌入您的 WordPress 頁面，無需編輯佈景主題檔案或使用 iframe。它提供了多種搜尋類型，讓使用者能夠輕鬆找到附近的地點，並保持在您的網站上查看結果。
【主要功能】
• 支援多種搜尋類型
• 直接嵌入搜尋表單
• 結果顯示在您網站上
• 簡易設置與配置
• 免費計畫支援最多 15 個地點
外掛標籤
開發者團隊
原文外掛簡介
This plugin 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