{"id":352853,"date":"2026-08-16T17:48:48","date_gmt":"2026-08-16T17:48:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/commervia-ai-search-for-woocommerce\/"},"modified":"2026-08-21T08:43:01","modified_gmt":"2026-08-21T08:43:01","slug":"commervia-ai-search","status":"publish","type":"plugin","link":"https:\/\/ru.wordpress.org\/plugins\/commervia-ai-search\/","author":23539316,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.13","stable_tag":"1.0.13","tested":"7.1","requires":"7.0","requires_php":"7.4","requires_plugins":null,"header_name":"Commervia AI Search for WooCommerce","header_author":"Commervia AI","header_description":"Relevance-weighted AJAX product search for WooCommerce with optional OpenAI query interpretation.","assets_banners_color":"6f71a1","last_updated":"2026-08-21 08:43:01","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/commervia.ai\/ai-search.html","header_author_uri":"https:\/\/commervia.ai\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":147,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.13":{"tag":"1.0.13","author":"commervia","date":"2026-08-21 08:43:01"},"1.0.4":{"tag":"1.0.4","author":"commervia","date":"2026-08-16 17:48:23"},"1.0.5":{"tag":"1.0.5","author":"commervia","date":"2026-08-16 18:54:12"},"1.0.6":{"tag":"1.0.6","author":"commervia","date":"2026-08-19 07:44:34"}},"upgrade_notice":{"1.0.13":"<p>Adds clearer AI-refinement feedback, recommendation reasons, improved visual-search preview\/camera support and storefront wording updates.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3656877,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3656877,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3656877,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3656877,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.13","1.0.4","1.0.5","1.0.6"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3656877,"resolution":"1","location":"assets","locale":"","width":543,"height":508},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3656877,"resolution":"2","location":"assets","locale":"","width":538,"height":576},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3656877,"resolution":"3","location":"assets","locale":"","width":1204,"height":527},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3656877,"resolution":"4","location":"assets","locale":"","width":1200,"height":481},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3656877,"resolution":"5","location":"assets","locale":"","width":1198,"height":503}},"screenshots":{"1":"Real storefront instant results panel while the customer searches in natural language.","2":"Real quick product view with price, availability and matching interpretation.","3":"Real administration screen with the core search behavior settings."}},"plugin_section":[],"plugin_tags":[220145,2109,31038,5183,286],"plugin_category":[45],"plugin_contributors":[276002],"plugin_business_model":[],"class_list":["post-352853","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-search","plugin_tags-ajax-search","plugin_tags-image-search","plugin_tags-product-search","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-commervia","plugin_committers-commervia"],"banners":{"banner":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/banner-772x250.png?rev=3656877","banner_2x":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/banner-1544x500.png?rev=3656877","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/icon-128x128.png?rev=3656877","icon_2x":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/icon-256x256.png?rev=3656877","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/screenshot-1.png?rev=3656877","caption":"Real storefront instant results panel while the customer searches in natural language."},{"src":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/screenshot-2.png?rev=3656877","caption":"Real quick product view with price, availability and matching interpretation."},{"src":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/screenshot-3.png?rev=3656877","caption":"Real administration screen with the core search behavior settings."},{"src":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/screenshot-4.png?rev=3656877","caption":""},{"src":"https:\/\/ps.w.org\/commervia-ai-search\/assets\/screenshot-5.png?rev=3656877","caption":""}],"raw_content":"<!--section=description-->\n<p>Commervia AI Search for WooCommerce improves product discovery with a hybrid local-first search engine, instant AJAX results, search by image and relevance-weighted matching across your WooCommerce catalog.<\/p>\n\n<p>Simple and structured product searches are resolved immediately against a dedicated normalized local index. Natural-language searches can show useful local results first and, when the administrator has enabled AI interpretation and configured a compatible provider in WordPress, optionally receive a second semantic interpretation that can refine or reorder the result set.<\/p>\n\n<p>From version 1.0.6, <strong>image search and administrator-selected custom meta-key search are included directly in the free WordPress.org plugin<\/strong>. No separate Search Pro add-on or Commervia license is required.<\/p>\n\n<h4>Search features<\/h4>\n\n<ul>\n<li>Hybrid local-first search: common product queries do not wait for AI interpretation.<\/li>\n<li>Instant AJAX product results while shoppers type.<\/li>\n<li>Search by image using a camera\/file button or drag and drop, with the uploaded reference image kept visible above the results.<\/li>\n<li>Strict visual product-type relevance so secondary traits do not admit unrelated products.<\/li>\n<li>Administrator-selected custom product meta keys can participate in matching and relevance.<\/li>\n<li>Dedicated normalized product index for titles, categories, tags, attributes, SKU, EAN\/barcode values and selected custom product fields.<\/li>\n<li>Three text-query levels: direct, enriched and semantic.<\/li>\n<li>Local previews can be refined by optional AI interpretation only when the query benefits from it. AI-interpreted text results include a short grounded reason explaining why each product matches.<\/li>\n<li>Normalization for common spacing, plural and hyphen variations such as <code>powerbank<\/code>, <code>power bank<\/code> and plurals.<\/li>\n<li>Candidate preselection limits full relevance scoring to the strongest local matches.<\/li>\n<li>Adaptive debounce and cancellation of superseded browser requests.<\/li>\n<li>Separate browser caches for local previews and final enriched results.<\/li>\n<li>Relevance weighting for product titles, SKU and EAN\/barcode values.<\/li>\n<li>Matching across categories, tags, attributes, descriptions and configured product meta keys.<\/li>\n<li>Exact, highly relevant and relevant result labels.<\/li>\n<li>Quick product details directly from the search results.<\/li>\n<li>A link to view the complete matching result set; pressing Enter does not submit the enhanced search.<\/li>\n<li>Automatic enhancement of WooCommerce product-search forms.<\/li>\n<li>Support for the WooCommerce Product Search block.<\/li>\n<li>Mobile-aware positioning for search forms near the top or bottom of the viewport.<\/li>\n<li>Configurable minimum characters, delay, result limits, cache duration and accent color.<\/li>\n<li>Optional custom selectors for themes or search forms with non-standard markup.<\/li>\n<\/ul>\n\n<h4>Optional AI features<\/h4>\n\n<p>The text search remains fully functional without an AI provider.<\/p>\n\n<p>From version 1.0.6, Commervia AI Search uses the AI Client built into WordPress 7.0 instead of connecting directly to a specific AI provider. The site owner chooses and configures a compatible provider centrally in <strong>Settings &gt; Connectors<\/strong>. Commervia does not store provider API keys.<\/p>\n\n<p>When an administrator explicitly enables AI query interpretation and consents to the external processing, the AI Client is used only when a text query benefits from semantic interpretation. Direct searches such as <code>powerbank<\/code>, <code>cafetera<\/code> or <code>bater\u00eda externa<\/code> can remain entirely local. Product matching and selection still take place locally in WordPress.<\/p>\n\n<p>Image search uses the same WordPress AI Client and requires a configured provider\/model that supports image input (vision). It has a separate enable switch and separate administrator consent because a resized copy of the uploaded reference image is sent temporarily through WordPress to the configured AI provider for interpretation. The image is not sent to Commervia and is not stored by this plugin. The configured AI provider may apply its own usage charges.<\/p>\n\n<h4>Commervia AI<\/h4>\n\n<p>The settings screen contains a contextual link to Commervia AI, the broader WooCommerce suite from the same developer. This promotion is limited to the plugin's own settings page. It does not create global admin notices, transmit store data to Commervia, create an account or change the functionality included in this free plugin.<\/p>\n\n<h3>External services<\/h3>\n\n<p>Commervia AI Search does not integrate directly with a specific AI provider. Optional semantic and image interpretation use the <strong>WordPress AI Client<\/strong> introduced in WordPress 7.0. The site owner separately chooses and configures an AI provider in <strong>Settings &gt; Connectors<\/strong>. WordPress routes the request to a compatible configured provider and manages that provider's credentials.<\/p>\n\n<h4>Semantic text interpretation<\/h4>\n\n<p>This is used only after an administrator:<\/p>\n\n<ol>\n<li>configures a compatible AI provider in WordPress;<\/li>\n<li>enables AI query interpretation; and<\/li>\n<li>explicitly consents to external processing of search text.<\/li>\n<\/ol>\n\n<p>Data passed through the WordPress AI Client for semantic text interpretation:<\/p>\n\n<ul>\n<li>the text entered in the product search;<\/li>\n<li>the site\/search language; and<\/li>\n<li>instructions\/technical parameters required to request a structured search interpretation.<\/li>\n<\/ul>\n\n<h4>Image search<\/h4>\n\n<p>This is used only after an administrator:<\/p>\n\n<ol>\n<li>configures a compatible vision-capable AI provider in WordPress;<\/li>\n<li>enables image search; and<\/li>\n<li>explicitly consents to external processing of uploaded search images.<\/li>\n<\/ol>\n\n<p>Data passed through the WordPress AI Client for image search:<\/p>\n\n<ul>\n<li>a resized JPEG representation of the uploaded product reference image;<\/li>\n<li>optional search text entered with the image;<\/li>\n<li>the site\/search language; and<\/li>\n<li>instructions\/technical parameters required to request a structured search interpretation.<\/li>\n<\/ul>\n\n<p>The temporary local image prepared for the request is deleted after it is read. The image is not sent to Commervia. The complete product catalog, WooCommerce orders and customer data are not sent to the AI provider. The provider response is used to extract product type, aliases, attributes and filters; final product selection runs locally in WordPress.<\/p>\n\n<p>WordPress AI Client documentation: https:\/\/developer.wordpress.org\/reference\/functions\/wp_ai_client_prompt\/<\/p>\n\n<p>The terms, privacy policy and possible usage charges that apply to AI requests depend on the AI provider that the site owner independently installs\/configures in WordPress. Site owners should review the provider's own documentation before enabling these optional features.<\/p>\n\n<p>The Commervia AI promotional links in the plugin settings contact <code>commervia.ai<\/code> only when an administrator deliberately clicks them. Merely viewing the settings screen does not contact Commervia.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>The plugin stores its settings and a normalized product-search index in the WordPress database. The local index contains product search fields, including administrator-selected custom product meta values, and does not contain orders or customer data. Provider credentials are not stored by Commervia AI Search; they are managed by WordPress Connectors. Search responses may be stored temporarily in WordPress transients to improve performance. A functional language preference is stored for up to one year in browser local storage and the <code>commervia_ai_search_language<\/code> cookie. The plugin adds no telemetry or remote tracking.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce.<\/li>\n<li>Install and activate Commervia AI Search for WooCommerce.<\/li>\n<li>Go to <strong>WooCommerce &gt; AI Search<\/strong>.<\/li>\n<li>Configure the search behavior and save the settings.<\/li>\n<li>Optional: add custom product meta keys that should participate in search.<\/li>\n<li>Optional: configure a compatible AI provider in <strong>Settings &gt; Connectors<\/strong>, then explicitly enable\/consent to the AI features you want to use.<\/li>\n<li>Test text and image searches on the storefront.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20an%20ai%20provider%20required%3F\"><h3>Is an AI provider required?<\/h3><\/dt>\n<dd><p>No for normal text search. The relevance-weighted local search works without AI. Semantic interpretation is optional. Search by image requires a compatible vision-capable AI provider configured in WordPress under <strong>Settings &gt; Connectors<\/strong> because the uploaded reference image must be interpreted by an external AI service.<\/p><\/dd>\n<dt id=\"is%20image%20search%20included%20for%20free%3F\"><h3>Is image search included for free?<\/h3><\/dt>\n<dd><p>Yes. From version 1.0.6, image search is included directly in the WordPress.org plugin. There is no separate license check or paid add-on requirement.<\/p><\/dd>\n<dt id=\"can%20i%20search%20my%20own%20custom%20product%20fields%3F\"><h3>Can I search my own custom product fields?<\/h3><\/dt>\n<dd><p>Yes. In <strong>WooCommerce &gt; AI Search<\/strong>, you can configure up to 50 product meta keys. Their values are added to the local search index and can influence matching and relevance. SKU and the standard EAN fields already supported by the plugin do not need to be added again.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20send%20my%20product%20catalog%20to%20the%20ai%20provider%3F\"><h3>Does the plugin send my product catalog to the AI provider?<\/h3><\/dt>\n<dd><p>No. Product matching stays inside WordPress. For optional semantic text interpretation, only the shopper's search text, language and technical request parameters are sent through the WordPress AI Client. For image search, the resized reference image and optional search text are sent temporarily to the configured AI provider after explicit administrator consent.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20send%20data%20to%20commervia%3F\"><h3>Does the plugin send data to Commervia?<\/h3><\/dt>\n<dd><p>No telemetry or store data is sent to Commervia by this plugin. Links to the Commervia AI website or demo are contacted only when an administrator deliberately clicks them.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20expire%3F\"><h3>Does the plugin expire?<\/h3><\/dt>\n<dd><p>No. All functionality included in this WordPress.org plugin remains available permanently.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20woocommerce%20product%20search%20forms%3F\"><h3>Does it work with WooCommerce product search forms?<\/h3><\/dt>\n<dd><p>Yes. It can automatically enhance standard WooCommerce product-search forms and the Product Search block. An additional CSS selector can also be configured for custom theme search forms.<\/p><\/dd>\n<dt id=\"how%20are%20translations%20handled%3F\"><h3>How are translations handled?<\/h3><\/dt>\n<dd><p>The plugin source is fully internationalized and ready for community translations through translate.wordpress.org.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20together%20with%20commervia%20ai%3F\"><h3>Can I use this together with Commervia AI?<\/h3><\/dt>\n<dd><p>Commervia AI already contains a broader search module. When the complete plugin is active, Commervia AI Search avoids loading a duplicate storefront search interface.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.13<\/h4>\n\n<ul>\n<li>Added recommendation reasons for AI-interpreted natural-language search results.<\/li>\n<li>Added an AI-optimization loading state that blurs and disables provisional local results while semantic refinement is running.<\/li>\n<li>Added persistent uploaded-image previews and separate mobile actions for choosing an image or using the camera.<\/li>\n<li>Fixed Enter\/form submission so full results open only from the View all results button.<\/li>\n<li>Fixed visual-search token-limit handling and stale-result\/image-preview issues.<\/li>\n<li>Simplified shopper-facing image-search consent and error messages.<\/li>\n<li>Tested up to WordPress 7.1 and WooCommerce 11.0.1.<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Migrated optional AI interpretation and image analysis to the provider-agnostic WordPress AI Client introduced in WordPress 7.0.<\/li>\n<li>Provider credentials are now managed centrally by WordPress under Settings &gt; Connectors and are no longer stored by Commervia AI Search.<\/li>\n<li>Included search by image directly in the free WordPress.org plugin.<\/li>\n<li>Included administrator-configurable custom product meta-key search directly in the free plugin.<\/li>\n<li>Removed all runtime dependency on a separate Search Pro license or add-on for these search features.<\/li>\n<li>Added migration of existing Search Pro custom meta-key settings when available; AI\/image consent is requested again for the new WordPress AI Client provider flow.<\/li>\n<li>Added compatibility protection to prevent duplicate search hooks while the retired Search Pro add-on is still active during migration.<\/li>\n<li>Improved visual-search relevance with strict main-product-type admission and secondary-attribute ranking.<\/li>\n<li>Replaced the former Search Pro promotion with a contextual Commervia AI suite card limited to the plugin's own settings screen.<\/li>\n<li>Updated privacy and external-service documentation for image search.<\/li>\n<li>Tested with WooCommerce 11.0.<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Added a hybrid local-first search pipeline with direct, enriched and semantic query levels.<\/li>\n<li>Added a dedicated normalized local product index for faster candidate lookup.<\/li>\n<li>Simple product searches can now return without waiting for an AI interpretation request.<\/li>\n<li>Natural-language searches can show local results first and be refined when optional AI interpretation arrives.<\/li>\n<li>Added normalization for spacing, plurals and common product-name variations such as <code>powerbank<\/code> \/ <code>power bank<\/code>.<\/li>\n<li>Added structured specification matching for values such as capacity, power, dimensions and storage.<\/li>\n<li>Limited full relevance scoring to the strongest indexed candidates when possible.<\/li>\n<li>Added adaptive debounce, immediate cancellation of superseded requests and separate local\/final browser caches.<\/li>\n<li>Tested with WooCommerce 11.0.<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Hardened request rate limiting so client-controlled cookies cannot create new rate-limit buckets.<\/li>\n<li>Clarified the separation between the fully functional free plugin and separately distributed add-ons.<\/li>\n<li>Added generic extension hooks without bundling add-on search implementations in the WordPress.org package.<\/li>\n<li>Tested with WooCommerce 11.0.<\/li>\n<\/ul>","raw_excerpt":"Fast hybrid WooCommerce search with instant results, image search, custom product fields and optional AI via the WordPress AI Client.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/352853","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=352853"}],"author":[{"embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/commervia"}],"wp:attachment":[{"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=352853"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=352853"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=352853"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=352853"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=352853"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ru.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=352853"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}