Renamed the "Site ID (sid)" field label to "Account ID (sid)" on the Settings page. Cosmetic only \u2014 the setting itself is unchanged.<\/p>","1.8.5":"
Fixed a real bug from 1.8.4: the centering\/label-font script never actually loaded on the page (attached to a WordPress handle already printed before it ran). It now attaches correctly and loads every time.<\/p>","1.8.4":"
Custom Search Form: found and fixed the real centering cause (a page-builder flex layout, not our CSS) and made field labels follow your Font family\/size instead of the pasted code's own hardcoded, !important styling.<\/p>","1.8.3":"
Custom Search Form: the search box and results iframe now use an explicit width instead of a cap, so both actually resize per the settings and center correctly even on narrow\/custom page templates.<\/p>","1.8.2":"
Custom Search Form: the search box now stays centered like the results iframe, and the Custom search box width setting reliably resizes pasted tables\/forms that previously ignored it.<\/p>","1.8.1":"
Custom Search Form fixes: the Clear\/Reset button now respects the Button color setting, results no longer sit flush left, and a new Custom search box width setting sizes it independently of the standard search box.<\/p>","1.8.0":"
Adds an optional Custom Search Form: paste any Xtreme Locator embed snippet under Settings and deploy it with [xtreme_locator_custom_search] \u2014 results load into an in-page iframe, same as the built-in search types.<\/p>","1.7.4":"
"Advanced Search" now loads inside your site's own sandboxed iframe results page, like the regular search, instead of sending visitors to app.xtremelocator.com.<\/p>","1.7.3":"
Fixes the Button color setting not applying to the Search button\/Advanced Search link on themes that ship their own conflicting button styles.<\/p>","1.7.2":"
Removes the "Powered By XtremeLocator" credit link feature entirely (setting, code, and markup) \u2014 it no longer exists in any form.<\/p>","1.7.1":"
Updated field defaults (new installs only \u2014 existing saved settings are untouched) and confirmed compatibility with WordPress 7.1.<\/p>","1.7.0":"
Removes the hard-coded default Site ID \u2014 every site must now enter its own under Settings \u2192 Xtreme Locator. Adds account\/trial links, plus WordPress.org submission fixes (enqueued assets, uninstall cleanup, opt-in credit link, documented external services).<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3662284,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3662284,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.8.6"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"The customizable search box (Zip type shown), rendered as plain HTML with no iframe.","2":"The Settings \u2192 Xtreme Locator admin page.","3":"Search results shown on your own site in a sandboxed iframe after a visitor searches."}},"plugin_section":[],"plugin_tags":[6109,18301,8611,6102,18319],"plugin_category":[],"plugin_contributors":[90990],"plugin_business_model":[],"class_list":["post-354879","plugin","type-plugin","status-publish","hentry","plugin_tags-business-locator","plugin_tags-location-finder","plugin_tags-locator","plugin_tags-store-locator","plugin_tags-zip-code-search","plugin_contributors-williqs","plugin_committers-williqs"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/xtreme-locator-search\/assets\/icon-128x128.png?rev=3662284","icon_2x":"https:\/\/ps.w.org\/xtreme-locator-search\/assets\/icon-256x256.png?rev=3662284","generated":false},"screenshots":[],"raw_content":"\n
This plugin outputs Xtreme Locator<\/a>'s embed forms directly into your page's HTML \u2014 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.<\/p>\n\n This plugin is the WordPress integration for Xtreme Locator's location search service \u2014 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:<\/p>\n\n 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.<\/p>\n\n Four search types are supported, chosen via the 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\" \u2014 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.<\/p>\n\n 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.<\/p>\n\n Go to Settings \u2192 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 \u2014 its width, height, and whether it shows a scrollbar (auto \/ always \/ never). Any setting can also be overridden per-instance with a shortcode attribute.<\/p>\n\n Known limitations:<\/strong><\/p>\n\n 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 \u2014 it just points the visitor's browser at Xtreme Locator's service using the Site ID configured under Settings \u2192 Xtreme Locator.<\/p>\n\n Specifically:<\/p>\n\n None of these requests are made server-side by this plugin's PHP code \u2014 they're all loaded directly in the visitor's browser (iframe This service is provided by Xtreme Locator: terms of service<\/a>, privacy policy<\/a>. Start a free trial<\/a> if you don't have an account yet (free for up to 15 locations).<\/p>\n\n Shortcode (posts, pages, any block that supports shortcodes):<\/strong><\/p>\n\n Every setting on the admin settings page (see below) can also be overridden per-instance as a shortcode attribute \u2014 handy if you want different pages to use different search types, colors, or layouts:<\/p>\n\n Available attributes: Gutenberg block editor:<\/strong> add a \"Shortcode\" block and paste Classic editor:<\/strong> paste Widget areas:<\/strong> go to Appearance \u2192 Widgets and add the \"Xtreme Locator Search\" widget to any sidebar or footer widget area.<\/p>\n\n Custom search form:<\/strong> for a search form with a different field set than the four built-in types, paste an Xtreme Locator embed snippet under Settings \u2192 Xtreme Locator \u2192 Custom Search Form, then place it with:<\/p>\n\n 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.<\/p>\n\n Settings (Settings \u2192 Xtreme Locator):<\/strong><\/p>\n\n Text & Labels<\/em> \u2014 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).<\/p>\n\n Colors & Appearance<\/em> \u2014 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.<\/p>\n\n Layout<\/em> \u2014 Inline (label, field, and button side by side) or Stacked (each on its own line, full width \u2014 good for narrow sidebars\/mobile).<\/p>\n\n Custom Search Form<\/em> \u2014 Raw HTML embed code for the Results Iframe<\/em> \u2014 Iframe width (e.g. Any of these can be overridden per-instance with a matching shortcode attribute (see Usage above).<\/p>\n\n\n Yes. This plugin is the WordPress integration for Xtreme Locator's location search service; it needs a Site ID from an Xtreme Locator account to know which locations to search. Start a free trial<\/a> if you don't have one \u2014 the free plan supports up to 15 locations at no cost.<\/p><\/dd>\nRequires an Xtreme Locator account<\/h4>\n\n
\n
Search types<\/h4>\n\n
type<\/code> shortcode attribute or the site-wide default in Settings \u2192 Xtreme Locator:<\/p>\n\n\n
zip<\/code> \u2014 a single zip\/postal code field (the original default).<\/li>\nzip_distance<\/code> \u2014 zip code plus a distance\/radius field.<\/li>\ninternational<\/code> \u2014 a country dropdown plus a postal code field, powered by Xtreme Locator's own country-picker script.<\/li>\nnear_me<\/code> \u2014 a single \"Locations Near Me\" button that uses the visitor's browser location (no typing required).<\/li>\n<\/ul>\n\nResults stay on your site<\/h4>\n\n
Fully customizable<\/h4>\n\n
\n
searchByCountryJS.php<\/code>) targets fixed field IDs, so a second instance on the same page would conflict with the first.<\/li>\nsearchByCountryJS.php<\/code> or api\/search.js<\/code> 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 \u2014 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.<\/li>\n<form><\/code>\/<input><\/code>\/<select><\/code> elements a search form needs. Only paste code from a source you trust. A relative <form action=\"...\"><\/code> 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 \u2014 trim a full copied page down to just the form and its buttons before pasting for the cleanest result.<\/li>\n<\/ul>\n\nExternal Services<\/h3>\n\n
\n
https:\/\/app.xtremelocator.com\/visitor\/findLocations.php<\/code> (Zip, Zip + Distance, and International search types) or https:\/\/app.xtremelocator.com\/api\/search.php<\/code> (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.<\/li>\nhttps:\/\/app.xtremelocator.com\/visitor\/searchByCountryJS.php<\/code> as an enqueued script, which populates the country dropdown and validates postal code availability per country.<\/li>\nhttps:\/\/app.xtremelocator.com\/api\/search.js<\/code> 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.<\/li>\nhttps:\/\/app.xtremelocator.com\/visitor\/advanced.php<\/code> inside the same sandboxed iframe on your own site's results page \u2014 not a direct new-tab link to app.xtremelocator.com.<\/li>\naction<\/code> 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.<\/li>\n<\/ul>\n\nsrc<\/code> or <script src><\/code>), the same way they would be if Xtreme Locator's embed code were pasted into the page directly.<\/p>\n\nUsage<\/h3>\n\n
[xtreme_locator_search]\n<\/code><\/pre>\n\n[xtreme_locator_search type=\"zip_distance\" title=\"Find Nearest Location\" layout=\"stacked\" button=\"#c0392b\" form_width=\"320px\"]\n[xtreme_locator_search type=\"international\"]\n[xtreme_locator_search type=\"near_me\" title=\"\"]\n<\/code><\/pre>\n\nsid<\/code>, type<\/code> (\"zip\", \"zip_distance\", \"international\", or \"near_me\"), title<\/code>, zip_label<\/code>, zip_placeholder<\/code>, dist_label<\/code>, dist_placeholder<\/code>, country_label<\/code>, postal_unavailable_text<\/code>, near_me_button_text<\/code>, button_text<\/code>, advanced<\/code> (\"yes\"\/\"no\"), advanced_text<\/code>, button<\/code> (hex), button_text_color<\/code> (hex), heading_color<\/code> (hex), heading_font_size<\/code> (CSS length), text_color<\/code> (hex), background_color<\/code> (hex, blank for transparent), border_color<\/code> (hex, blank for none), border_width<\/code> (CSS length), font_family<\/code>, form_width<\/code> (CSS length), layout<\/code> (\"inline\" or \"stacked\"). Attributes that don't apply to the chosen type<\/code> are simply ignored.<\/p>\n\n[xtreme_locator_search]<\/code>.<\/p>\n\n[xtreme_locator_search]<\/code> directly into the content.<\/p>\n\n[xtreme_locator_custom_search]\n<\/code><\/pre>\n\n[xtreme_locator_custom_search]<\/code> shortcode (see above), plus its own Custom search box width (independent of \"Form width\" above).<\/p>\n\n100%<\/code>, 960px<\/code>, 90vw<\/code>), Iframe height (e.g. 900px<\/code>, 80vh<\/code> \u2014 increase this if results feel cramped), Scrollbar (Auto \/ Always \/ Never). Also used by the custom search form's results iframe.<\/p>\n\n\n
[xtreme_locator_search]<\/code> to any page or post, or add the \"Xtreme Locator Search\" widget to a sidebar.<\/li>\n\n
Do I need an Xtreme Locator account?<\/h3><\/dt>\n
Is there a free plan?<\/h3><\/dt>\n