Select one or more tags, then press “Search Plugins”

Find Plugin with any / all of the selected criteria
Search Plugin

Xtreme Locator Search Wordpress Plugin - Rating, Reviews, Demo & Download

Xtreme Locator Search Wordpress Plugin - Rating, Reviews, Demo & Download
No ratings yet
Free
Follow for free plugins, new theme releases and theme news

Plugin Description

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 <form>/<input>/<select> elements a search form needs. Only paste code from a source you trust. A relative <form action="..."> is automatically resolved against app.xtremelocator.com and results are routed into an iframe instead of navigating away, but surrounding markup (labels, layout, a stray “Back” link, etc.) is left exactly as pasted — trim a full copied page down to just the form and its buttons before pasting for the cleanest result.

External Services

This plugin is a WordPress front end for Xtreme Locator’s location search service and connects to Xtreme Locator’s servers (app.xtremelocator.com) to function. No location data is stored or processed by this plugin itself — it just points the visitor’s browser at Xtreme Locator’s service using the Site ID configured under Settings Xtreme Locator.

Specifically:

  • Search form submission and results. When a visitor submits a search, their browser loads an iframe pointed at https://app.xtremelocator.com/visitor/findLocations.php (Zip, Zip + Distance, and International search types) or https://app.xtremelocator.com/api/search.php (Near Me proximity search), passing the search terms they entered (zip/postal code, distance, country, or coordinates) and the site’s configured Site ID as query parameters. Xtreme Locator returns the results HTML, which is displayed inside the iframe on your own site.
  • Country picker (International search type only). Loads https://app.xtremelocator.com/visitor/searchByCountryJS.php as an enqueued script, which populates the country dropdown and validates postal code availability per country.
  • Browser geolocation (Near Me search type only). Loads https://app.xtremelocator.com/api/search.js as an enqueued script, which requests the visitor’s location via their browser’s Geolocation API (with the browser’s own permission prompt) and returns coordinates used to build the results URL above.
  • Advanced Search link (optional, off by default). Like the main search, this loads https://app.xtremelocator.com/visitor/advanced.php inside the same sandboxed iframe on your own site’s results page — not a direct new-tab link to app.xtremelocator.com.
  • Custom search form (optional — only if you’ve pasted code under Settings Xtreme Locator Custom Search Form). Submits to whichever Xtreme Locator URL is in the pasted form’s action attribute (an app.xtremelocator.com address in Xtreme Locator’s own embed code), with whatever fields that form collects, loaded into an iframe next to the form.

None of these requests are made server-side by this plugin’s PHP code — they’re all loaded directly in the visitor’s browser (iframe src or <script src>), the same way they would be if Xtreme Locator’s embed code were pasted into the page directly.

This service is provided by Xtreme Locator: terms of service, privacy policy. Start a free trial if you don’t have an account yet (free for up to 15 locations).

Usage

Shortcode (posts, pages, any block that supports shortcodes):

[xtreme_locator_search]

Every setting on the admin settings page (see below) can also be overridden per-instance as a shortcode attribute — handy if you want different pages to use different search types, colors, or layouts:

[xtreme_locator_search type="zip_distance" title="Find Nearest Location" layout="stacked" button="#c0392b" form_width="320px"]
[xtreme_locator_search type="international"]
[xtreme_locator_search type="near_me" title=""]

Available attributes: sid, type (“zip”, “zip_distance”, “international”, or “near_me”), title, zip_label, zip_placeholder, dist_label, dist_placeholder, country_label, postal_unavailable_text, near_me_button_text, button_text, advanced (“yes”/”no”), advanced_text, button (hex), button_text_color (hex), heading_color (hex), heading_font_size (CSS length), text_color (hex), background_color (hex, blank for transparent), border_color (hex, blank for none), border_width (CSS length), font_family, form_width (CSS length), layout (“inline” or “stacked”). Attributes that don’t apply to the chosen type are simply ignored.

Gutenberg block editor: add a “Shortcode” block and paste [xtreme_locator_search].

Classic editor: paste [xtreme_locator_search] directly into the content.

Widget areas: go to Appearance Widgets and add the “Xtreme Locator Search” widget to any sidebar or footer widget area.

Custom search form: for a search form with a different field set than the four built-in types, paste an Xtreme Locator embed snippet under Settings Xtreme Locator Custom Search Form, then place it with:

[xtreme_locator_custom_search]

The pasted form’s fields, labels, and layout are yours to define; the plugin still applies your font, form width, and button color settings, and still keeps results on your own site (loaded into an iframe next to the form instead of navigating away). See the field description under Settings for what to paste and what’s handled automatically.

Settings (Settings Xtreme Locator):

Text & Labels — Site ID, default Search type, Heading, Zip/Postal Code field label & placeholder, Distance field label & placeholder, Country field label, Postal code unavailable message, “Near Me” button text, Search button text, Advanced Search link (on/off + text).

Colors & Appearance — Button color, Button text color, Heading color, Heading font size, Label/text color, Background color (blank = transparent), Border color (blank = none) + width, Font family, Form width.

Layout — Inline (label, field, and button side by side) or Stacked (each on its own line, full width — good for narrow sidebars/mobile).

Custom Search Form — Raw HTML embed code for the [xtreme_locator_custom_search] shortcode (see above), plus its own Custom search box width (independent of “Form width” above).

Results Iframe — Iframe width (e.g. 100%, 960px, 90vw), Iframe height (e.g. 900px, 80vh — increase this if results feel cramped), Scrollbar (Auto / Always / Never). Also used by the custom search form’s results iframe.

Any of these can be overridden per-instance with a matching shortcode attribute (see Usage above).

Screenshots

No screenshots provided

Similar Plugins:

Xtreme Locator Dealer Locator Plugin Rating Widget: Post Rating, 5 Star Rating, Reviews, Thumbs Up & Down, Reaction Dokan With WP Store Locator – Provide Store Locator To All The Vendors Of Dokan With Wp Store Locator

Reviews & Comments