=== FalcoSearch – Live Search & Product Filter for WooCommerce === Contributors: wpxero Tags: woocommerce search, ajax search, live search, product filter, woocommerce filter Requires at least: 5.2 Tested up to: 7.1 Requires PHP: 7.4 Stable tag: 1.2.0 WC requires at least: 8.0 WC tested up to: 10.8 Elementor tested up to: 4.1.2 Elementor Pro tested up to: 4.1.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Live AJAX search and a visual product filter builder for WooCommerce and any post type. Fast, SEO-friendly, no jQuery. == Description == **FalcoSearch is a WordPress plugin that adds instant live search and AJAX product filters to a WooCommerce store or any WordPress site.** Visitors see matching products and posts while they type, then narrow a shop or archive page by category, price, rating, availability and more — without a page reload. It combines two tools that are usually separate plugins: 1. **Live search** — a search box that shows results as the visitor types. 2. **Filter builder** — a drag-and-drop editor for product and post filters, with SEO-friendly filter URLs. FalcoSearch was formerly called **Xero Finder**. Settings, shortcodes and developer hooks are unchanged. = What you can do with FalcoSearch = * Add an instant product search to a WooCommerce store, with prices and sale badges in the results * Add faceted product filters — category, price, color, size, brand, rating, stock — beside your shop grid * Let shoppers combine filters and see results update without a page reload * Give filtered pages clean, indexable URLs such as `/shop/color-blue/` * Filter and search blog posts or any custom post type, not only products * See what visitors search for, and which searches find nothing = Set up in minutes = 1. **Activate.** On a store, products are searchable straight away. 2. **Search:** press `Ctrl + /` (`Cmd + /` on Mac) on your site, or add the `[xerosf_icon]` shortcode. 3. **Filters:** click **New Filter Set → Set up shop filters for me**. FalcoSearch builds filters from your own categories, prices and product attributes and shows them on your shop pages. No code, no template edits. Everything can be changed afterwards in a visual editor. = At a glance = * **Works with:** WooCommerce products, posts, pages and any public custom post type * **Page builders and themes:** classic themes, block themes (WooCommerce Product Collection block), Elementor, and the block editor * **Languages:** translation-ready; WPML and Polylang supported * **Front end:** vanilla JavaScript, no jQuery, assets load only where needed * **Data:** stored in your own WordPress database * **Requires:** WordPress 5.2+, PHP 7.4+. WooCommerce is optional. = Live search = A search window opens over the page and lists results as the visitor types. * **Instant results** with thumbnail, highlighted match, post type and date * **WooCommerce details** in each product result: price, sale badge, out-of-stock badge * **Four ways to open it:** a shortcode button or input, your theme's existing search field, `Ctrl + /` (`Cmd + /` on Mac), or a triple-click * **Three layouts:** modal, full screen, top bar * **Choose what is searched:** titles only, titles and excerpts, or titles, excerpts and content * **Search more fields:** ACF fields and Yoast SEO / Rank Math focus keywords and descriptions * **Smarter matching:** synonyms, word-by-word fallback when a phrase finds nothing, and operators such as `"exact phrase"` and `-exclude` * **Voice search** in browsers that support speech recognition (Chrome, Edge, Safari) * **Quick-search suggestions** you define, shown before the visitor types * **Favorites and recent searches**, kept in the visitor's own browser * **Keyboard friendly:** arrow keys move through results, Enter searches, Escape closes * **Cross-site search:** include results from other sites running FalcoSearch = Product and post filters = Build a set of filters in the editor, then show it on your shop, category, search or archive pages. * **12 filter types:** checkbox list, radio buttons, dropdown, buttons, color and image swatches, range slider, min / max inputs, star rating, availability toggles (in stock, on sale, featured, downloadable, backorder), author, date range, category tree * **One-click setup:** a ready-made filter set built from your store's categories, prices and attributes * **Add filters by what they filter** — Price, Category, Brand, Color, Rating — already configured * **Visual editor:** drag to reorder, rename, switch how a filter is displayed, see a live preview * **Store currency** is used on price filters automatically * **AJAX filtering:** results, counts, active-filter chips and pagination update in place * **Live counts:** each option shows how many results it would give * **Sidebar layout:** on WooCommerce archives a vertical filter set sits beside the product grid; horizontal and off-canvas layouts are also available * **Mobile drawer:** on phones the filters open full screen from a floating "Filters" button * **Instant or "Apply" mode,** sorting dropdown, collapsible groups, "show more", search within long lists * **Placement:** automatic on matching archives, or with a shortcode, a block or an Elementor widget * **Works without JavaScript** for checkbox, radio, dropdown, rating, date and min / max filters * **Any post type:** works for blog posts and custom post types, not only products = SEO for filtered pages = * **Clean filter URLs** such as `/shop/color-blue/brand-acer/`, with redirects to one canonical order * **Title, H1 and meta description templates** per filter set * **Indexing control:** choose how many taxonomy filters deep a page may be indexed; pages filtered by price, stock, rating, date or sort order are `noindex,follow` * **Canonical tags** and an **XML sitemap** provider for indexable filter pages * Works with **Yoast SEO** and **Rank Math**, and on its own when neither is installed = Search analytics = * Total searches, unique terms and average results per search * **Zero-result searches** — what visitors looked for and did not find * Top keywords and search volume over time * CSV export and a configurable retention period = Also included = * **Related posts** shortcode, with optional automatic placement on single posts * **404 rescue:** redirect a missing URL to the closest matching post * **Slash commands** (optional) for power users — see below * **Multi-currency** price filters (WOOCS and CURCY adapters, plus filters for other plugins) * **Full-page-cache friendly:** search works on cached pages; optional cache-vary cookie for filtered pages * **WP-CLI:** `wp xerosf seed --products=1000` creates sample products for testing = Shortcodes = Search: * `[xerosf_icon text="Search"]` — button that opens the search * `[xerosf_input placeholder="Search…"]` — input that opens the search * `[wpxero_search type="button" label="Search"]` — the same, with a `type` of `button` or `input` Filters (replace `123` with the filter set ID shown in **FalcoSearch → Filter Sets**). The same three are available as blocks — Filters, Chips and Sorting — and as Elementor widgets: * `[xerosf_filters set="123"]` — the filter set * `[xerosf_chips set="123"]` — active-filter chips * `[xerosf_sorting set="123"]` — sorting dropdown Related content: * `[wpxero_related_posts count="5" show_thumbnail="true" show_excerpt="false"]` * `[wpxero_related_ai count="5"]` — an alternative related-posts list with weighted ranking = Slash commands = Turn on **Enable slash commands** in the settings, then type `/` in the search box. * `/recent` — latest posts * `/related` — posts related to the current page * `/category {slug}`, `/tag {slug}` — posts in a category or tag * `/categories`, `/tags` — list categories or tags * `/date {YYYY}`, `/date {YYYY/MM}`, `/date {YYYY/MM/DD}` — posts by date * `/id {number}` — go to a post by ID * `/random` — open a random post * `/fav`, `/fav_clear` — show or clear favorites * `/history`, `/history_clear` — show or clear recent searches * `/price {min} {max}`, `/rated {1-5}` — apply the price or rating filter on a page that has one * `/clear`, `/reset`, `/help` = For developers = Theme placement: do_action( 'xerosf_render_filters', 123 ); Filter any custom query with a filter set: new WP_Query( [ 'post_type' => 'product', 'xerosf_filterable' => 123 ] ); JavaScript API: WPXeroSearch.open(); WPXeroSearch.close(); WPXeroSearch.search( 'hoodie' ); Commonly used hooks: * `xerosf_weights` — relevance weight of title, excerpt, content, taxonomy and meta matches * `xerosf_results` — change the result list before it is returned * `wpxero_search_result_item` — change a single result row * `xerosf_search_meta_keys` — add post meta keys to search * `wpxero_search_synonym_map` — supply synonyms from code * `wpxero_search_should_load_assets` — control where search assets load * `xerosf_expose_coupons` — allow the public coupon endpoint (off by default) * `xerosf_woo_sidebar_layout` — turn off the sidebar layout on WooCommerce archives * `xerosf_replace_woo_ordering` — keep the WooCommerce ordering dropdown next to a filter set's own sorting * `xerosf_register_filter_type` — register a custom filter type * `wpxero_search_analytics_record` — action fired for every search, for your own analytics * `xerosf_price_to_base`, `xerosf_price_to_display` — currency conversion for price filters * `xerosf_analytics_retention_days` — how long analytics rows are kept REST API namespace: `wpxero/search/v1`. == Installation == = Install = 1. In WordPress, go to **Plugins → Add New** and search for "FalcoSearch". 2. Click **Install Now**, then **Activate**. Or upload the `wpxero-search-filter` folder to `/wp-content/plugins/` and activate it. = Set up live search = 1. Open **FalcoSearch** in the admin menu. 2. Under **General**, tick the post types to search (tick **Products** for a store). 3. Pick a search mode and a style, then **Save changes**. 4. Open your site and press `Ctrl + /` (`Cmd + /` on Mac), or add `[xerosf_icon]` to a page, header or widget. = Set up filters = 1. Go to **FalcoSearch → Filter Sets** and click **New Filter Set**. 2. Choose **Set up shop filters for me**. FalcoSearch creates filters for your categories, prices, product attributes, rating and availability, and shows them on your shop pages. 3. Open your shop to see them. Back in the editor you can reorder, rename, remove or add filters — click **Add Filter** and pick what to filter by. 4. To place a set yourself, open **Where it shows** and copy the shortcode. 5. If you use clean filter URLs, open **Settings → Permalinks** and click **Save Changes** once. == Frequently Asked Questions == = What is FalcoSearch? = FalcoSearch is a free WordPress plugin that adds live AJAX search and product filters to a site. Visitors get results while typing, and can filter WooCommerce products or any post type by category, price, rating, stock and other attributes without reloading the page. = Is FalcoSearch free? = Yes. FalcoSearch is free and open source (GPLv2 or later). Every feature described on this page is included in the free plugin. = What do I need to run FalcoSearch? = WordPress 5.2 or newer and PHP 7.4 or newer. WooCommerce is optional and only needed for product search and product filters. No other plugin or external service is required. = How long does setup take? = A few minutes. Search works after activation. For filters, choose **Set up shop filters for me** and FalcoSearch creates a filter set from your categories, prices and product attributes and places it on your shop pages. = Does FalcoSearch work with WooCommerce? = Yes. Enable **Products** in the search settings and results show the product image, price, sale badge and stock status. The filter builder supports product categories, tags, attributes, price, rating, and availability such as in stock and on sale. = Does it work without WooCommerce? = Yes. WooCommerce is optional. Live search and filters work for posts, pages and any public custom post type. WooCommerce-only options, such as price sorting and availability toggles, appear only when WooCommerce is active. = How do I add a search box to my site? = Add the shortcode `[xerosf_icon]` for a search button or `[xerosf_input]` for a search field, in any page, widget or template. FalcoSearch can also open from your theme's existing search field, from `Ctrl + /`, or from a triple-click — each can be switched on or off under **Triggers**. = How do I add product filters to my shop page? = Go to **FalcoSearch → Filter Sets**, click **New Filter Set** and choose **Set up shop filters for me**. The filters appear in a sidebar on your shop, category and tag pages. To place a set yourself, use `[xerosf_filters set="ID"]` or the FalcoSearch Filters widget in Elementor. = What is the difference between live search and product filters? = Live search finds items by keyword: the visitor types and matching products or posts appear instantly. Product filters (also called faceted search or layered navigation) narrow a list the visitor is already looking at — for example a shop page — by category, price, color, size, brand, rating or stock. FalcoSearch includes both, and they can be used together or separately. = Does it replace the default WordPress search? = No. FalcoSearch adds a live search window on top of your site and can open it from your theme's existing search field. Your normal search results page keeps working, and filter sets can be shown on it. = Can I use only the search, or only the filters? = Yes. The two parts are independent. Turn off the search triggers to use filters alone, or simply create no filter sets to use search alone. Scripts and styles load only for the part that is in use. = Can I filter products by price, color, size or brand? = Yes. Use a range slider or min / max inputs for price, and checkboxes, buttons, dropdowns or swatches for any product attribute or taxonomy such as color, size or brand. Swatch colors and images are set on each term's edit screen. = Do the filter counts update as shoppers filter? = Yes. Each option shows how many results it would give with the current selection, options that would give nothing can be hidden, and counts refresh after every change. = Are filtered pages good for SEO? = Yes. Filter sets can use clean URLs such as `/shop/color-blue/`, with their own title, H1 and meta description templates, canonical tags and sitemap entries. You choose how many taxonomy filters deep a page may be indexed. Pages filtered by price, stock, rating, date or sort order are marked `noindex,follow` to avoid duplicate content. = Does it work with Elementor and block themes? = Yes. FalcoSearch adds Filters, Chips and Sorting widgets to Elementor. On block themes it filters the WooCommerce Product Collection block. Classic themes are supported through WooCommerce and WordPress template hooks. = Is it compatible with caching plugins? = Yes. Live search works on pages served from a full-page cache. For filtered pages that share a URL, an optional cookie lets Cloudflare, Varnish, Nginx, WP Rocket, W3 Total Cache and Batcache keep separate cached copies. = Does FalcoSearch slow down my site? = It is built to stay light. The front end uses vanilla JavaScript with no jQuery, scripts load only on pages that need them, voice search and slash commands load on first use, and search results and filter counts are cached. = Is FalcoSearch translation ready and multilingual? = Yes. All interface text is translatable (text domain `wpxero-search-filter`). With WPML or Polylang, filter labels can be translated and filters use the terms of the current language. = Does it support multiple currencies? = Yes. Price filters convert between the shop's base currency and the visitor's currency. WOOCS and CURCY are supported out of the box; other currency plugins can connect through two filters. = What data does FalcoSearch collect? Is it GDPR friendly? = FalcoSearch does not send data to any third-party service. If you turn on search analytics, each search term, its result count, the time, and the WordPress user ID of a logged-in user are saved in your own database for the retention period you choose (90 days by default). Favorites and recent searches stay in the visitor's browser. The only outgoing requests are to the cross-site search endpoints you add yourself, if any. = Where can I see what visitors search for? = Turn on analytics in the settings, then open **FalcoSearch → Analytics**. It shows total searches, top keywords, searches with no results, volume over time, and offers a CSV export. = Can I change how results are ranked? = Yes. Developers can adjust the weight of title, excerpt, content, taxonomy and meta matches with the `xerosf_weights` filter, and reorder or edit results with `xerosf_results`. = Do I need to do anything after updating to 1.2.0? = Usually not — settings, shortcodes, hooks and filter sets are kept. Check three settings that are now applied exactly as set: **Show excerpt in results** (off by default), **Search mode** ("Title only" now searches titles only) and **Enable slash commands** (off by default). On WooCommerce archives, vertical filter sets now appear as a sidebar beside the products. = Do filters work if JavaScript is disabled? = Partly. Checkbox, radio, dropdown, rating, date and min / max filters submit as a normal form and reload the page. Range sliders, buttons and swatches need JavaScript. = I used Xero Finder. Is this the same plugin? = Yes. FalcoSearch is the new name of Xero Finder. The plugin slug, settings, shortcodes and hooks are the same, so updating does not require any changes. = How do I remove all plugin data? = Turn on **Remove all data on uninstall** under **Privacy & data**, then delete the plugin. This removes the settings, filter sets, cached data and the analytics table. With the option off, deleting the plugin keeps your data. == Screenshots == 1. Live search — products and posts appear as the visitor types, with image, price, sale badge and highlighted matches. 2. Product filters in a sidebar beside the shop grid — price slider, categories, ratings and availability with live counts. 3. Filters applied without a page reload — active-filter chips, updated counts and a shareable URL. 4. Visual filter builder — reorder 12 filter types, configure each one and see a live preview. 5. Search analytics — total searches, zero-result searches, top keywords and volume over time (sample data). 6. Slash commands — type `/` to jump to recent posts, categories, tags, dates and favorites. 7. Search settings — choose what is searched, how the search opens and how results look. 8. Mobile — filters open in a full-screen drawer with touch-sized controls. == Changelog == = 1.2.0 - 2026-10-05 = **Easier setup** * New: one-click **Set up shop filters for me** builds a filter set from your own categories, prices, product attributes, rating and availability, and shows it on your shop pages. * New: add filters by what they filter — Price, Category, Brand, Color, Rating, Availability, Date, Author — already configured. * New: switch how a filter is displayed (checkbox list, dropdown, buttons, swatches) without re-creating it. * Improved: plain-language filter settings; technical options moved under **Advanced**. * Improved: price filters use the store's currency symbol and position automatically. * Improved: on a store, products are searchable from first activation, and the plugin opens its setup screen once. **Improved: filters** * Vertical filter sets on WooCommerce archives show as a sidebar beside the product grid, and as a full-screen drawer on phones. * Counts, active-filter chips, pagination and the WooCommerce result total all refresh after each change. * One sorting control: the WooCommerce ordering dropdown is replaced where a filter set shows its own. * Pages filtered by price, availability, rating, date, sort order or page number are `noindex,follow`, with a single robots meta tag. * Checkbox, radio, dropdown, rating, date and min / max filters work without JavaScript. **Improved: live search** * Settings that previously had no effect now work: search mode, synonyms, fallback matching, search operators, ACF fields, SEO metadata, excerpts, server and browser cache, cross-site search. * Product results show price, sale badge and stock status. * Better keyboard support: Enter searches, arrow keys move through results, Escape closes, focus returns to where you were. * New setting to place related posts automatically on single posts. * Interface text is fully translatable. **Fixed** * Live search stopped working on pages served from a full-page cache. * Search shortcodes showed a button that did not open the search. * Search analytics recorded 0 results for every search. * Dates in results showed "Invalid Date" in some languages and date formats. * The settings page reported success when saving had failed. * Range slider applied a filter when untouched; min / max and date inputs were disabled; range, rating and date chips could not be removed; the browser Back button did not restore filters. * Filters disappeared on pages with no results, and options with no matches showed site-wide counts. * Disabled, draft and trashed filter sets were still displayed. * Admin screens: layout on wide screens, the Filter Sets table, and form fields. **Security** * The public search endpoint could be asked to search post types that are not enabled for search. * The public coupon endpoint listed store coupon codes. It now returns nothing unless a site opts in with the `xerosf_expose_coupons` filter. * Password-protected posts are excluded from search; non-public post types and taxonomies can no longer be read through the search API. * Result limits are capped on public endpoints. * Spreadsheet-formula injection in the analytics CSV export. **Upgrade notes** * Excerpts in search results follow **Show excerpt in results** (off by default), and slash commands follow **Enable slash commands** (off by default). Turn them on if you rely on them. * **Search mode: Title only** now searches titles only. Choose **Title, excerpt and content** to match content as well. * Vertical filter sets on WooCommerce archives are now a sidebar. Opt out with the `xerosf_woo_sidebar_layout` filter. * Product filter sets with automatic placement no longer attach to the blog search page; add a **Search results** location if you want that. * Settings, shortcodes, hooks and REST endpoints from 1.1.0 are unchanged. = 1.1.0 - 2026-08-27 = **New: filter builder** * Filter Sets — a visual editor under **FalcoSearch → Filter Sets** for building product and post filters, with drag-to-reorder and a live preview. * 12 filter types: checkbox list, radio buttons, dropdown, buttons, swatches, range slider, min / max inputs, rating, availability toggles, author, date range, category tree. * AJAX filtering on classic and block themes, including the WooCommerce Product Collection block. * Live counts per option, with a cache that clears when products or terms change. * Clean filter URLs such as `/shop/color-blue/brand-acer/`, with title, H1 and description templates, canonical tags, indexing rules and sitemap entries. Works with Yoast SEO and Rank Math. * Shortcodes `[xerosf_filters]`, `[xerosf_chips]`, `[xerosf_sorting]`, with matching blocks and Elementor widgets. * WPML and Polylang support; multi-currency price filters (WOOCS, CURCY). * Color and image swatches set on each term's edit screen. * For developers: `xerosf_filterable` query argument, REST endpoints for filter sets, `wp xerosf seed` WP-CLI command, optional cache-vary cookie for full-page caches. **New: search analytics** * Analytics page under **FalcoSearch → Analytics** — total searches, zero-result searches, top keywords and a CSV export. * Searches are stored in your own database while **Enable analytics** is on, for a retention period you choose (90 days by default). * For developers: `wpxero_search_analytics_record` action and `xerosf_analytics_retention_days` filter. **Improved: admin** * Rebuilt search settings page with grouped sections and a sticky save bar. * Onboarding panel for new installs. * The Dashboard page is replaced by the Analytics page. **Compatibility** * Tested with WordPress 7.1, WooCommerce 10.8 and Elementor 4.1. * Declared compatibility with WooCommerce HPOS (High-Performance Order Storage) and Cart / Checkout Blocks. **Fixed** * Search could fail on stores with percent-discount coupons that have no description. * Filtered archives returned a 404 on `/page/2/` when a filter left fewer results than one page. * Elementor Filters, Chips and Sorting widgets did not register on Elementor 4. = 1.0.5 - 2026-06-11 = **Rebrand & quality release** * Rebranded: Xero Finder is now FalcoSearch. * Security hardening — nonces, capability checks, sanitisation of all request input, full output escaping, prepared queries everywhere. * Performance — conditional asset loading (search assets no longer load on pages without the search UI), expensive queries cached with transients, paginated analytics queries. * Added: uninstall cleanup with an opt-in **Remove all data on uninstall** setting (default off). * Improved: full internationalisation pass and a fresh `.pot` file. * Overhauled readme and documentation. * Backward compatibility: slug `wpxero-search-filter`, text domain `wpxero-search-filter`, option key `wpxero_search_settings`, shortcodes `[xerosf_icon]` / `[xerosf_input]`, and filter hooks `xerosf_weights` / `xerosf_results` / `xerosf_analytics_retention_days` are all unchanged. = 1.0.4 - 2026-05-06 = **Compatibility** * Declared support for WordPress 7.0 (`Tested up to: 7.0`). = 1.0.3 - 2026-01-17 = **Bug Fixes** * Fixed: Resolved CSS styling issues affecting fullscreen search modal display. **Improvements** * Enhanced: Search functionality with improved accuracy and response time. * Refined: Settings panel reorganised by priority for better user workflow. * Optimised: Admin interface performance for faster page loads. = 1.0.1 - 2026-01-10 = **Bug Fixes** * Fixed: Frontend search results not displaying correctly under certain conditions. * Resolved: AJAX response handling for search queries. = 1.0.0 - 2026-01-01 = **Initial Release** * Introduced real-time live search functionality. * Added slash command system with 20+ commands. * Implemented WooCommerce product search integration. * Added voice search capability (browser-dependent). * Included advanced analytics dashboard. * Added visual search via image upload and webcam. * Implemented dark/light mode toggle. * Added AI-powered search suggestions. * Included favorites and bookmarking system. * Added WPML and Polylang compatibility. * Implemented synonym expansion and SEO metadata search. == Upgrade Notice == = 1.2.0 = Security and reliability release: fixes a search data-exposure issue, search on cached pages and several filter bugs, and adds one-click shop filter setup. After updating, check the excerpt, search mode and slash-command settings. = 1.1.0 = Adds the filter builder (12 filter types, clean filter URLs, Elementor, WPML and multi-currency support), search analytics with CSV export and a rebuilt admin. Re-save Permalinks once after updating. = 1.0.5 = Rebrand to FalcoSearch (formerly Xero Finder) plus security and performance hardening. Safe upgrade: slug, settings, shortcodes, and hooks are unchanged. = 1.0.4 = **Recommended update** — Version 1.0.4 is tested with WordPress 7.0. Update when you upgrade core. = 1.0.2 = **Recommended Update** — Enhanced dashboard UI with improved layout, better visual hierarchy, redesigned settings page for superior user experience, and optimised admin interface performance. = 1.0.1 = **Important Bug Fix Release** — Resolves critical frontend search display issues and improves AJAX response handling. Update immediately to ensure optimal search functionality. = 1.0.0 = **Initial Stable Release** — Welcome to FalcoSearch (formerly Xero Finder). Transform your WordPress search with instant results, AI-powered suggestions, WooCommerce integration, and 20+ slash commands. == Support == Questions and bug reports: https://wordpress.org/support/plugin/wpxero-search-filter/ == Credits == Developed by WPXERO — https://wpxero.com/plugins/wpxero-search-filter