{"id":336262,"date":"2026-07-07T18:41:41","date_gmt":"2026-07-07T18:41:41","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/filterorbit-advanced-product-filters-for-woocommerce\/"},"modified":"2026-09-29T20:55:57","modified_gmt":"2026-09-29T20:55:57","slug":"filterorbit-product-filters","status":"publish","type":"plugin","link":"https:\/\/id.wordpress.org\/plugins\/filterorbit-product-filters\/","author":17676349,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.3","stable_tag":"1.0.3","tested":"7.1.2","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"FilterOrbit: Advanced Product Filters for WooCommerce","header_author":"sakibbd08","header_description":"Advanced zero-request product filters for WooCommerce with AI, visual discovery, and a React-powered filter designer.","assets_banners_color":"999b9d","last_updated":"2026-09-29 20:55:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/pluginpros.co","header_author_uri":"https:\/\/profiles.wordpress.org\/sakibbd08\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":288,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"sakibbd08","date":"2026-07-07 18:41:21","revision":3599486},"1.0.2":{"tag":"1.0.2","author":"sakibbd08","date":"2026-09-29 18:25:33","revision":3719614},"1.0.3":{"tag":"1.0.3","author":"sakibbd08","date":"2026-09-29 20:55:57","revision":3719832}},"upgrade_notice":{"1.0.3":"<p>Adds a product quick view with add to cart and fixes AI natural-language search with Google Gemini. If you use Gemini, re-save FilterOrbit &gt; AI Settings with gemini-3.8-flash.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3599491,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3599491,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1","1.0.2","1.0.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3719832,"resolution":"1","location":"assets","locale":"","width":1192,"height":927},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3719832,"resolution":"2","location":"assets","locale":"","width":1192,"height":927},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3719614,"resolution":"3","location":"assets","locale":"","width":1362,"height":840},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3719614,"resolution":"4","location":"assets","locale":"","width":1252,"height":832},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3719832,"resolution":"5","location":"assets","locale":"","width":1192,"height":927}},"screenshots":{"1":"Storefront: filter sidebar with category checkboxes and price histogram, AI search bar, and product cards with add-to-cart buttons.","2":"AI natural-language search: \"shirts under 20\" ticks the Shirts category and sets the price range automatically.","3":"Filter Designer: drag and drop filters into columns and set column widths.","4":"Settings: enable AI search, visual discovery, personalisation, product counts, and client-side caching.","5":"Product quick view: image slider, price, stock status, scrollable description, quantity, and add to cart without leaving the page."}},"plugin_section":[],"plugin_tags":[5861,37961,267787,6033,37974],"plugin_category":[45],"plugin_contributors":[269283],"plugin_business_model":[],"class_list":["post-336262","plugin","type-plugin","status-publish","hentry","plugin_tags-ajax-filter","plugin_tags-ajax-product-filter","plugin_tags-layered-navigation","plugin_tags-product-filter","plugin_tags-woocommerce-filter","plugin_category-ecommerce","plugin_contributors-sakibbd08","plugin_committers-sakibbd08"],"banners":{"banner":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/banner-772x250.png?rev=3599491","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/icon-256x256.png?rev=3599491","icon_2x":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/icon-256x256.png?rev=3599491","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/screenshot-1.png?rev=3719832","caption":"Storefront: filter sidebar with category checkboxes and price histogram, AI search bar, and product cards with add-to-cart buttons."},{"src":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/screenshot-2.png?rev=3719832","caption":"AI natural-language search: \"shirts under 20\" ticks the Shirts category and sets the price range automatically."},{"src":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/screenshot-3.png?rev=3719614","caption":"Filter Designer: drag and drop filters into columns and set column widths."},{"src":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/screenshot-4.png?rev=3719614","caption":"Settings: enable AI search, visual discovery, personalisation, product counts, and client-side caching."},{"src":"https:\/\/ps.w.org\/filterorbit-product-filters\/assets\/screenshot-5.png?rev=3719832","caption":"Product quick view: image slider, price, stock status, scrollable description, quantity, and add to cart without leaving the page."}],"raw_content":"<!--section=description-->\n<p>FilterOrbit adds a powerful, instant-filtering sidebar to your WooCommerce store. All filtering runs client-side on a pre-cached product array \u2014 no page reloads, no AJAX round-trips.<\/p>\n\n<p><strong>Features<\/strong><\/p>\n\n<ul>\n<li>Zero-request filtering \u2014 filters run entirely in the browser on a cached product array.<\/li>\n<li>AI natural language search \u2014 type plain-English queries to filter products.<\/li>\n<li>Visual discovery \u2014 image swatch grid for colour and style filtering.<\/li>\n<li>Predictive personalisation \u2014 quick picks based on browsing session.<\/li>\n<li>Range histogram \u2014 price slider with distribution bars.<\/li>\n<li>Drag-and-drop filter designer \u2014 build your sidebar layout in the admin.<\/li>\n<li>Per-filter colour settings \u2014 customise pill colours, slider colours, and card tints independently.<\/li>\n<li>WooCommerce attribute support \u2014 automatically discovers global and custom product variation attributes.<\/li>\n<li>Multi-category \/ multi-tag \u2014 products with multiple categories and tags match all their values.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>FilterOrbit includes an optional AI natural-language search feature. When enabled and configured, the plugin sends product search queries and product data to third-party AI services. This feature is <strong>opt-in<\/strong> \u2014 it only activates if you enter an API key in the AI Settings screen. No data is sent without your explicit configuration.<\/p>\n\n<p><strong>OpenAI<\/strong><\/p>\n\n<ul>\n<li>What it is: A third-party AI platform (https:\/\/openai.com).<\/li>\n<li>What it is used for: Processing natural-language search queries and optionally generating product embeddings for semantic search (RAG).<\/li>\n<li>What data is sent: The user's search query text, and (when indexing is enabled) product titles, descriptions, categories, tags, and attributes.<\/li>\n<li>When data is sent: Only when a visitor submits a natural-language search and AI is enabled and configured with a valid API key.<\/li>\n<li>Terms of service: https:\/\/openai.com\/policies\/terms-of-use<\/li>\n<li>Privacy policy: https:\/\/openai.com\/policies\/privacy-policy<\/li>\n<\/ul>\n\n<p><strong>Google Gemini<\/strong><\/p>\n\n<ul>\n<li>What it is: A third-party AI platform provided by Google (https:\/\/ai.google.dev).<\/li>\n<li>What it is used for: An alternative AI provider for natural-language query processing and product embeddings.<\/li>\n<li>What data is sent: The user's search query text, and (when indexing is enabled) product titles, descriptions, categories, tags, and attributes.<\/li>\n<li>When data is sent: Only when a visitor submits a natural-language search and AI is enabled and configured with a valid Gemini API key.<\/li>\n<li>Terms of service: https:\/\/ai.google.dev\/gemini-api\/terms<\/li>\n<li>Privacy policy: https:\/\/policies.google.com\/privacy<\/li>\n<\/ul>\n\n<p>If you do not enter any API keys in the AI Settings screen, no data is ever transmitted to these services.<\/p>\n\n<h3>Source code<\/h3>\n\n<p>The compiled JavaScript assets (<code>assets\/admin\/filter-orbit-admin.js<\/code> and <code>assets\/frontend\/filter-orbit.js<\/code>) are built from human-readable React\/TypeScript source files. The full source code is publicly available at:<\/p>\n\n<p>https:\/\/github.com\/sakib08\/FilterOrbit<\/p>\n\n<p>Build instructions (requires Node.js 18+):<\/p>\n\n<ol>\n<li><code>npm install<\/code><\/li>\n<li><code>npm run build<\/code><\/li>\n<\/ol>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>filterorbit-product-filters<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> screen in WordPress.<\/li>\n<li>Go to <strong>FilterOrbit<\/strong> in the admin menu and design your filter layout.<\/li>\n<li>Add the shortcode <code>[filter_orbit]<\/code> to any page, or enable the automatic shop sidebar in settings.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20require%20woocommerce%3F\"><h3>Does it require WooCommerce?<\/h3><\/dt>\n<dd><p>Yes. FilterOrbit requires WooCommerce to be active.<\/p><\/dd>\n<dt id=\"does%20filtering%20require%20ajax%20calls%3F\"><h3>Does filtering require AJAX calls?<\/h3><\/dt>\n<dd><p>No. All product data is pre-loaded on page render and filtering runs entirely in the browser with zero network requests. You get the instant, no-reload experience of an AJAX product filter without the server round-trips. The only request FilterOrbit makes is the optional AI natural-language search, and only when you have configured an AI provider.<\/p><\/dd>\n<dt id=\"how%20do%20i%20add%20the%20filters%20to%20my%20shop%3F\"><h3>How do I add the filters to my shop?<\/h3><\/dt>\n<dd><p>Add the shortcode <code>[filter_orbit]<\/code> to any page, post, or block (use the Shortcode block in the block editor). The layout you save in <strong>FilterOrbit &gt; Filter Designer<\/strong> is what visitors see.<\/p><\/dd>\n<dt id=\"which%20filters%20are%20available%3F\"><h3>Which filters are available?<\/h3><\/dt>\n<dd><p>Product category, product tag, price (range slider with histogram), and every global or custom WooCommerce attribute, including variation attributes such as colour and size. Each filter can be shown as a checkbox list, pills, a range slider, or a visual discovery swatch grid.<\/p><\/dd>\n<dt id=\"how%20do%20i%20set%20up%20ai%20natural-language%20search%3F\"><h3>How do I set up AI natural-language search?<\/h3><\/dt>\n<dd><p>Go to <strong>FilterOrbit &gt; AI Settings<\/strong>, choose OpenAI or Google Gemini, paste your API key, pick a model, and enable the AI Natural Language Filter in <strong>FilterOrbit &gt; Settings<\/strong>. Shoppers can then type queries like \"blue shirts under $30\" and the matching filters are applied automatically. If the AI provider is unreachable, FilterOrbit falls back to a built-in keyword parser.<\/p><\/dd>\n<dt id=\"is%20the%20ai%20search%20free%3F\"><h3>Is the AI search free?<\/h3><\/dt>\n<dd><p>The feature is included in the plugin at no cost. You pay your AI provider directly for API usage; Google Gemini offers a free tier that is enough for most small stores.<\/p><\/dd>\n<dt id=\"will%20it%20work%20with%20my%20theme%3F\"><h3>Will it work with my theme?<\/h3><\/dt>\n<dd><p>FilterOrbit renders inside its own scoped container with prefixed CSS classes, so it does not conflict with theme styles. It works with both block themes and classic themes.<\/p><\/dd>\n<dt id=\"how%20many%20products%20can%20it%20handle%3F\"><h3>How many products can it handle?<\/h3><\/dt>\n<dd><p>FilterOrbit pre-loads up to 100 published products on the page so filtering is instant. It is designed for small and medium catalogs where instant, no-reload layered navigation matters most.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20text%20shown%20to%20shoppers%3F\"><h3>Can I change the text shown to shoppers?<\/h3><\/dt>\n<dd><p>Yes. <strong>FilterOrbit &gt; Language<\/strong> lets you edit every front-end label, placeholder, and message. The plugin is also translation-ready using the <code>filterorbit-product-filters<\/code> text domain.<\/p><\/dd>\n<dt id=\"can%20i%20customise%20the%20colours%3F\"><h3>Can I customise the colours?<\/h3><\/dt>\n<dd><p>Yes. Each filter block has independent colour settings in the Block Settings panel of the filter designer. Slider filters, pill\/category filters, and layout blocks each expose the colour controls that are relevant to them.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>New: Product quick view modal with image slider, price, stock status, scrollable description, variation selection, quantity, and add to cart.<\/li>\n<li>New: Add to cart \/ Select options button on every product card.<\/li>\n<li>New: Product card and quick view labels are editable in FilterOrbit &gt; Language.<\/li>\n<li>New: AI Settings are now free for everyone.<\/li>\n<li>Fix: AI natural-language search now works with Google Gemini (requests run server-side through a new REST endpoint).<\/li>\n<li>Fix: Retired Gemini models no longer break AI search; the plugin automatically falls back to a working model.<\/li>\n<li>Fix: AI search results no longer disappear because the whole sentence was also used as a keyword search.<\/li>\n<li>Fix: Pressing Enter in the AI search box submits the search on all themes.<\/li>\n<li>Tweak: Cleaner AI search bar without the section heading, title, and icon badge; the send button no longer has a background.<\/li>\n<li>Tweak: Updated Gemini model list (gemini-3.8-flash is the new default).<\/li>\n<li>Tweak: Tested up to WordPress 7.1.2.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>UI update<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Advanced zero-request product filters for WooCommerce with AI search, visual discovery, and a React filter designer.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/336262","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=336262"}],"author":[{"embeddable":true,"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sakibbd08"}],"wp:attachment":[{"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=336262"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=336262"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=336262"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=336262"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=336262"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/id.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=336262"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}