Initial release. No upgrade steps required.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3556471,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3556471,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3556471,"resolution":"1","location":"assets","locale":"","width":3414,"height":2066}},"screenshots":[]},"plugin_section":[],"plugin_tags":[265304,265305,944,286,231325],"plugin_category":[45],"plugin_contributors":[174986],"plugin_business_model":[],"class_list":["post-313399","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-product-search","plugin_tags-natural-language-search","plugin_tags-search","plugin_tags-woocommerce","plugin_tags-woocommerce-ai","plugin_category-ecommerce","plugin_contributors-binsaifullah","plugin_committers-binsaifullah"],"banners":{"banner":"https:\/\/ps.w.org\/queryn\/assets\/banner-772x250.png?rev=3556471","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/queryn\/assets\/icon-256x256.png?rev=3556471","icon_2x":"https:\/\/ps.w.org\/queryn\/assets\/icon-256x256.png?rev=3556471","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/queryn\/assets\/screenshot-1.png?rev=3556471","caption":""}],"raw_content":"\n
Queryn<\/strong> transforms the way customers search your WooCommerce store. Instead of typing exact product names or SKUs, shoppers can describe exactly what they want in plain language \u2014 and Queryn's AI engine translates that into precise results in real time.<\/p>\n\n Powered by the world's leading AI providers (OpenAI, Google Gemini, and Anthropic Claude), Queryn intelligently parses natural-language queries into structured WooCommerce filters: categories, tags, product attributes, price ranges, and custom meta fields \u2014 all without touching a single line of template code.<\/p>\n\n [youtube http:\/\/www.youtube.com\/watch?v=I_QwIRryxpI]<\/p>\n\n \"Show me red running shoes under $80\"<\/strong> \u2192 Queryn automatically filters by color attribute, category, and max price.\n \"Organic coffee beans above $20\"<\/strong> \u2192 Queryn finds the right category and sets a minimum price filter.\n \"Hello World\"<\/strong> \u2192 Queryn finds your blog post titled Hello World alongside any matching products \u2014 normal search is never broken.<\/p>\n<\/blockquote>\n\n Queryn is smart about when to restrict results to products and when to search broadly:<\/p>\n\n You control exactly which post types are included in keyword searches from the Search Scope<\/strong> section on the General settings tab. WooCommerce products are always included and cannot be deselected.<\/p>\n\n The new Apply AI Search On<\/strong> setting lets you restrict when the AI engine is triggered:<\/p>\n\n Your existing WordPress search behaviour is fully preserved.<\/strong> Queryn only modifies the main search query when a valid AI provider is configured and active. If the API key is missing, the plugin is inactive, or the AI call fails, WordPress falls back to its standard search without any interference.<\/p>\n\n OpenAI<\/strong>\nThe industry standard for conversational AI. Queryn supports GPT-4o, GPT-4o Mini, and GPT-4 Turbo \u2014 choose the model that best fits your budget and accuracy needs.<\/p>\n\n Google Gemini<\/strong>\nGoogle's multimodal AI family. Queryn supports Gemini 2.5 Pro, Gemini 2.5 Flash, and Gemini 2.5 Flash Lite. Gemini 2.5 Flash offers the best balance of speed, accuracy, and cost for most stores.<\/p>\n\n Anthropic Claude<\/strong>\nAnthropic's safety-focused models deliver outstanding instruction-following and structured output. Queryn supports Claude Sonnet 4.6, Claude Haiku 4.5, and Claude Opus 4.7.<\/p>\n\n Queryn extracts the following from a shopper's search query and applies them directly to Queryn connects to the AI provider you configure. By enabling a provider, you agree to their terms of service and privacy policy:<\/p>\n\n Data sent to the provider consists solely of your store's taxonomy structure (category names, tag names, attribute values, and public meta keys) and the shopper's search query. No personal customer data, email addresses, or order information is ever transmitted.<\/p>\n\n\n WooCommerce must be installed and active.<\/strong> Queryn will display an admin notice and remain inactive if WooCommerce is not detected.<\/p>\n\n\n No. Queryn is designed to work alongside standard WordPress search without disrupting it. For keyword-only searches, results are returned across all post types you select in the Search Scope settings (posts, pages, and products by default). Only when a query contains product-specific filters (price, category, attributes, etc.) does Queryn restrict results to WooCommerce products. If no AI provider is configured or a call fails, WordPress falls back to its default search behaviour automatically.<\/p><\/dd>\n This was a known issue in version 1.0.0, fixed in 1.1.0. Earlier versions always restricted search results to WooCommerce products. After updating, keyword-only searches will include posts, pages, and any other post types you enable in Settings \u2192 Queryn \u2192 General \u2192 Search Scope<\/strong>.<\/p><\/dd>\n Yes. You need an active API key from at least one of the supported AI providers \u2014 OpenAI, Google AI Studio (for Gemini), or Anthropic. All three offer free tiers or trial credits to get started.<\/p><\/dd>\n Queryn only makes an API call on search pages, and only when a shopper performs a search. Responses are cached for one hour per unique query using WordPress transients, so repeated searches hit your database rather than the AI API.<\/p><\/dd>\n You can configure all three providers simultaneously and switch between them without losing any API keys.<\/p><\/dd>\n Yes. Queryn hooks into Only your store's taxonomy structure (category names, tag names, attribute names and values, and public custom field keys) alongside the shopper's search query. No customer accounts, email addresses, order data, or personally identifiable information is ever sent.<\/p><\/dd>\n Only one provider handles search queries at a time. However, you can pre-configure API keys for all three providers and switch the active one instantly from Settings \u2192 Queryn \u2192 General<\/strong>.<\/p><\/dd>\n Yes. In Settings \u2192 Queryn \u2192 General \u2192 Apply AI Search On<\/strong>, switch from \"All search pages\" to \"WooCommerce pages only\". When this option is active, the AI is only called when a search originates from a WooCommerce page (shop, product category, product tag). Searches from blog pages, static pages, or other non-WooCommerce areas skip the AI entirely and use standard WordPress search \u2014 so you are only charged for queries that are actually product-relevant.<\/p><\/dd>\n Yes. In Settings \u2192 Queryn \u2192 General<\/strong>, the Search Scope<\/strong> section lists all public post types registered on your site. Check the ones you want included in keyword-only searches. WooCommerce products are always included. Filter-based searches (price, category, etc.) always return products only, regardless of this setting.<\/p><\/dd>\n This was a bug in 1.0.0, fixed in 1.1.0. The AI now correctly maps \"price is X\" \/ \"costs X\" \/ \"priced at X\" to an exact price filter, and the underlying query uses a direct equality comparison rather than a range. Update to 1.1.0 and the search will work correctly.<\/p><\/dd>\n Queryn reads taxonomy names in whatever language they are stored in your database. If you use WPML or Polylang and your category\/tag names are translated, the AI will receive the translated names for the current language context.<\/p><\/dd>\nVideo Overview<\/h3>\n\n
\n
Search Scope \u2014 Products, Posts, and Pages Together<\/h4>\n\n
\n
Apply AI Search On \u2014 Control API Costs<\/h4>\n\n
\n
Why Queryn?<\/h4>\n\n
\n
Supported AI Providers<\/h4>\n\n
What Gets Filtered<\/h4>\n\n
WP_Query<\/code>:<\/p>\n\n\n
product_cat<\/code> taxonomy<\/li>\nproduct_tag<\/code> taxonomy<\/li>\npa_*<\/code> attribute taxonomies (color, size, material, etc.)<\/li>\nPrivacy & Third-Party Services<\/h4>\n\n
\n
Automatic Installation (Recommended)<\/h4>\n\n
\n
Manual Installation<\/h4>\n\n
\n
After Activation<\/h4>\n\n
\n
\n
Will Queryn break my normal WordPress search for blog posts or pages?<\/h3><\/dt>\n
My shopper searched for a blog post title and got no results \u2014 why?<\/h3><\/dt>\n
Do I need an API key?<\/h3><\/dt>\n
Will this slow down my store?<\/h3><\/dt>\n
Which AI provider should I choose?<\/h3><\/dt>\n
\n
Does it work with all WooCommerce themes?<\/h3><\/dt>\n
pre_get_posts<\/code> and modifies WP_Query<\/code> before any theme renders the results. It is fully compatible with all standard WooCommerce-aware themes including Storefront, Astra, GeneratePress, Flatsome, and block-based themes.<\/p><\/dd>\nWhat data is sent to the AI provider?<\/h3><\/dt>\n
Can I use multiple AI providers at the same time?<\/h3><\/dt>\n
Can I prevent the AI from firing on every single search to save API costs?<\/h3><\/dt>\n
Can I choose which post types appear in search results?<\/h3><\/dt>\n
Searching for an exact price like \"products priced at $15\" returns no results \u2014 is that a bug?<\/h3><\/dt>\n
Is Queryn compatible with WPML or multilingual stores?<\/h3><\/dt>\n
Where can I get an API key?<\/h3><\/dt>\n
\n
1.0.0 & 1.0.1<\/h4>\n\n
\n
Queryn\\<\/code> namespace.<\/li>\n