
FalcoSearch was formerly known as Xero Finder. Your settings, shortcodes, and developer hooks continue to work unchanged after the rename.
FalcoSearch is a falcon-fast live search and product-filter plugin built around WooCommerce. Shoppers type once and see matching products — with images, price, stock, and rating — before they finish the word. Refine results in place with instant filters for category, price, rating, on-sale, bestseller, and stock status. No page reloads. No plugin bloat. No jQuery.
Why WooCommerce stores choose FalcoSearch
- Instant product results as you type — title, SKU, price, rating, stock, on-sale, bestseller, newest.
- In-place product filters — category, price range, rating, stock, sale; combine freely.
- Lower bounce on product searches — debounced AJAX, server-side caching, conditional asset loading.
- No theme rewrite required — drop in the
[xerosf_icon]or[xerosf_input]shortcode anywhere, or use the floating modal. - Works alongside your existing theme search — FalcoSearch enhances the native WordPress search input on focus.
Universal filter builder (v1.1.0)
A React + Ant Design admin where you build filter sets for any post type (products, posts, custom CPTs). Each set is a CPT with a sanitized JSON config — author through the SPA, drop on the frontend via shortcode, block, widget, or auto-injection on matched archives.
- 12 filter types (registry keys shown in backticks) —
checkbox,radio,dropdown,buttons,swatch(color + image term meta),range_slider,minmax_inputs,rating,status_toggle(availability toggles — in_stock / on_sale / featured / downloadable / backorder),author,date_range,hierarchy(nested taxonomy tree). - 3-pane editor — sortable filter cards (
@dnd-kit, keyboard-operable), per-card config form, debounced live preview. - Per-set behaviour — instant or apply-button submission, vertical / horizontal / off-canvas layout, chips, sorting whitelist, per-term counts, hide-empty terms.
- Auto-injection — sets with matching location rules print on the right hook (
woocommerce_before_shop_loopon Woo,loop_startelsewhere) or exposedo_action('xerosf_render_filters', $set_id)for manual theme placement. - Block themes supported — WooCommerce Product Collection block queries are mutated via
query_loop_block_query_vars, so filters work on Twenty Twenty-Five and other block themes out of the box. - AJAX engine — change
pushStatefetch withX-Xerosf-Partial: 1server returns JSON of the rendered container; client swaps innerHTML, updates chips, announces result count via aria-live. Mobile drawer + floating “Filters” button below 768 px. - Self-excluding counts — Amazon-style: every term shows its count minus this filter, so siblings stay clickable. Two-tier cache (object cache + transient, 10 min), bumped via a single option flip on save_post / edited_term / Woo product props update.
- Clean URLs + SEO —
/shop/color-blue/brand-acer/style paths; non-canonical orderings 301 to the alphabetical canonical. Per-set title / H1 / meta description templates with{archive}/{filters}/{term:filter_id}/{count}tokens. Depth-1 pages indexable, depth ≥ 2 emitsnoindex,follow. Yoast and Rank Math integration when active; wp_head fallback otherwise. Core XML sitemap provider for depth-1 URLs. - Builders — Elementor widgets (Filters, Chips, Sorting) when Elementor is active; Bricks stub hook for theme adapters.
- WPML / Polylang — set title + filter labels registered for translation; term ids mapped via
wpml_object_id/pll_get_termat query time. - Multi-currency — price slider bounds + applied values flow through
xerosf_price_to_baseandxerosf_price_to_displayfilters; built-in adapters for WOOCS and CURCY. - Custom queries — any theme-side
new WP_Query(['xerosf_filterable' => $set_id])is auto-filtered. - Full-page-cache compatible — opt-in
xerosf_statecookie when filters are active for Cloudflare / Varnish / Nginx FastCGI / Rocket / W3TC / Batcache vary. - WP-CLI —
wp xerosf seed --products=10000to seed a benchmarkable Woo store.
Core search & filter features
- Real-time live search as you type
- Multiple search triggers — triple-click, Ctrl+/ (Cmd+/ on macOS), Escape, or search-input focus
- Slash command system (
/recent,/category,/price,/fav, and more — see below) - Voice search where the browser supports it
- Multiple built-in theme styles
- Responsive on every device
- Shortcodes for the search icon and the search input
- WPML & Polylang compatible
- WooCommerce product search (title, SKU, price, rating, stock)
- User favourites
- Synonym expansion
- SEO metadata search support
Advanced features
- Analytics dashboard with CSV export
- Visual search via image upload or webcam
- Dark mode toggle (
/darkand/light) - AI-powered search suggestions
- Search bookmarking and command history
- Device-aware UI optimisation
- WooCommerce rating, newest, and bestseller filters
- Author filtering and year filtering
Slash commands
General:
/recent/category {slug}/tag {slug}/date {Y/m/d}/related/fav/random/dark/light/author {name}/year {year}/bookmark/bookmarks/history/export_history
WooCommerce:
/product/on-sale/stock/price {min} {max}/rated {1-5}/newest/bestseller
Developer hooks
Tune the relevance weights, post-process the result set, or change how long analytics rows are kept:
add_filter( 'xerosf_weights', function ( $weights, $mode ) {
return $weights;
}, 10, 2 );
add_filter( 'xerosf_results', function ( $results, $post_ids, $term, $args ) {
return $results;
}, 10, 4 );
add_filter( 'xerosf_analytics_retention_days', function ( $days ) {
return 180;
} );
Theme override
Add custom CSS at:
/wp-content/themes/your-theme/wpxero-search-filter/style.css
Credits
Developed by the FalcoSearch team (formerly WPXERO).
Support
For help, please open a thread on the WordPress.org support forum:
https://wordpress.org/support/plugin/wpxero-search-filter/