Support page links (Contact\/FAQ), smarter catalog search with synonym\/plural variants, configurable chat text size, and improved variable-product cards and add-to-cart on paginated results.<\/p>","0.2.2":"
Optional email alert when the chat is auto-hidden after an Anthropic billing\/credit error. Minimum WooCommerce 8.2.0 and PHP 8.0.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3630277,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3630277,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500-it.png":{"filename":"banner-1544x500-it.png","revision":3632455,"resolution":"1544x500","location":"assets","locale":"it","width":1544,"height":500},"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3632473,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250-it.png":{"filename":"banner-772x250-it.png","revision":3632455,"resolution":"772x250","location":"assets","locale":"it","width":772,"height":250},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3632473,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"kinedio\/chat":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"kinedio\/chat","version":"0.3.0","title":"Kinedio Chat","category":"woocommerce","icon":"format-chat","description":"AI shopping assistant: customers chat to search products, get recommendations and add items to the cart.","keywords":["chat","ai","assistant","woocommerce","agent"],"textdomain":"kinedio-personal-shopper","supports":{"html":false,"customClassName":false,"align":["wide","full"]},"attributes":{"title":{"type":"string","default":""},"title_fullscreen":{"type":"string","default":""},"title_heading":{"type":"number","default":3},"button_text":{"type":"string","default":""},"welcome_message":{"type":"string","default":""},"placeholder":{"type":"string","default":""}},"editorScript":"kinedio-chat-block-editor","editorStyle":"kinedio-chat-block-editor"}},"tagged_versions":["0.3.0"],"block_files":[],"assets_screenshots":{"screenshot-1-it.png":{"filename":"screenshot-1-it.png","revision":3630277,"resolution":"1","location":"assets","locale":"it","width":1700,"height":1636},"screenshot-1.png":{"filename":"screenshot-1.png","revision":3630277,"resolution":"1","location":"assets","locale":"","width":1700,"height":1636},"screenshot-2-it.png":{"filename":"screenshot-2-it.png","revision":3630277,"resolution":"2","location":"assets","locale":"it","width":1700,"height":925},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3630277,"resolution":"2","location":"assets","locale":"","width":1700,"height":925},"screenshot-3-it.png":{"filename":"screenshot-3-it.png","revision":3630277,"resolution":"3","location":"assets","locale":"it","width":1700,"height":925},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3630277,"resolution":"3","location":"assets","locale":"","width":1700,"height":925},"screenshot-4-it.png":{"filename":"screenshot-4-it.png","revision":3630277,"resolution":"4","location":"assets","locale":"it","width":1700,"height":2663},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3630277,"resolution":"4","location":"assets","locale":"","width":1700,"height":2663},"screenshot-5-it.png":{"filename":"screenshot-5-it.png","revision":3630277,"resolution":"5","location":"assets","locale":"it","width":1700,"height":2663},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3630277,"resolution":"5","location":"assets","locale":"","width":1700,"height":2663}},"screenshots":{"1":"The chat assistant answering a product question and showing product cards on the storefront.","2":"The floating chat widget opened on a product page.","3":"Admin settings: Anthropic API key and performance tier (model) selection.","4":"Admin settings: appearance options (colors and corner radius).","5":"Admin diagnostics: per-turn token usage, timings and estimated cost."}},"plugin_section":[],"plugin_tags":[2353,5707,2364,247874,286],"plugin_category":[41,45],"plugin_contributors":[274071],"plugin_business_model":[],"class_list":["post-338585","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-shopping-assistant","plugin_tags-woocommerce","plugin_category-communication","plugin_category-ecommerce","plugin_contributors-ececchettini","plugin_committers-ececchettini"],"banners":{"banner":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/banner-772x250.png?rev=3632473","banner_2x":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/banner-1544x500.png?rev=3632473","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/icon-128x128.jpg?rev=3630277","icon_2x":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/icon-256x256.jpg?rev=3630277","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/screenshot-1.png?rev=3630277","caption":"The chat assistant answering a product question and showing product cards on the storefront."},{"src":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/screenshot-2.png?rev=3630277","caption":"The floating chat widget opened on a product page."},{"src":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/screenshot-3.png?rev=3630277","caption":"Admin settings: Anthropic API key and performance tier (model) selection."},{"src":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/screenshot-4.png?rev=3630277","caption":"Admin settings: appearance options (colors and corner radius)."},{"src":"https:\/\/ps.w.org\/kinedio-personal-shopper\/assets\/screenshot-5.png?rev=3630277","caption":"Admin diagnostics: per-turn token usage, timings and estimated cost."}],"raw_content":"\n
Kinedio Personal Shopper for WooCommerce adds a conversational shopping assistant to your storefront. Customers can ask questions in natural language to search your catalog, get product recommendations, view product details and add items to their cart, all from a single chat box.<\/p>\n\n
The assistant is powered by Anthropic's Claude models. When a customer sends a message, the plugin runs a server-side \"agent loop\": the model decides which actions to take and your WordPress site executes them through a controlled set of tools (catalog search, product lookup, cart operations and so on). All cart and catalog operations run on your server under your control; the model only receives the data needed to answer the request.<\/p>\n\n
Key features<\/strong><\/p>\n\n Important:<\/strong> this plugin requires an Anthropic API key, which you provide. Usage of the Anthropic API is billed by Anthropic according to their pricing. See the External services<\/em> section below.<\/p>\n\n This plugin connects to the Anthropic API (Claude) to generate the chat assistant's replies. This is required for the plugin to function: without a valid Anthropic API key the chat will not respond.<\/p>\n\n What service is used<\/strong>\nAnthropic Claude API \u2014 endpoint When data is sent<\/strong>\nA request is sent to Anthropic each time a customer submits a message in the chat (and during the internal agent loop that follows, until the assistant produces its final reply).<\/p>\n\n What data is sent<\/strong>\n* The customer's chat message(s) and the ongoing conversation for the current session.\n* Context needed to answer the request, which may include: product information from your catalog (names, descriptions, prices, attributes, taxonomy\/term names) and the current contents of the visitor's WooCommerce session cart.\n* A system prompt and tool definitions generated by the plugin.<\/p>\n\n No WordPress user account credentials and no WooCommerce order data are sent. The Anthropic API key you enter is stored in your site's database (encrypted with AES-256-GCM when the PHP OpenSSL extension is available, which is the case on virtually all hosts) and is sent only to Anthropic to authenticate the request.<\/p>\n\n Please make sure your store's privacy policy informs visitors that chat messages are processed by Anthropic, and avoid entering personal or sensitive information into the chat.<\/p>\n\n Anthropic's terms and policies:\n* Terms of Service: https:\/\/www.anthropic.com\/legal\/consumer-terms\n* Commercial Terms of Service: https:\/\/www.anthropic.com\/legal\/commercial-terms\n* Privacy Policy: https:\/\/www.anthropic.com\/legal\/privacy<\/p>\n\n Yes. You need an Anthropic API key, which you can create at https:\/\/console.anthropic.com\/. Calls to the Anthropic API are billed by Anthropic according to their pricing.<\/p><\/dd>\n Yes. WooCommerce 8.2.0 or later must be installed and active. The plugin declares WooCommerce as a required plugin and will not run without it.<\/p><\/dd>\n All attributes are optional:<\/p>\n\n Example: Yes. Chat messages and the catalog\/cart context needed to answer them are sent to the Anthropic API. See the External services<\/em> section for details on what is sent and when.<\/p><\/dd>\n The key is stored in your site's database with autoloading disabled. When the PHP OpenSSL extension is available (virtually all hosts) it is encrypted at rest with AES-256-GCM, using a key derived from your WordPress salts. Note that rotating those salts (e.g. The plugin has two independent, separately toggled features on the Diagnostics<\/strong> tab:<\/p>\n\n In both cases the shopper's chat message is never stored<\/strong>, free-text tool arguments\/results are redacted (replaced by a length marker), and visitor IP addresses are not written to the logs<\/strong>. What is recorded is operational only: timings, token usage, iteration counts, tool names, outcome, product IDs (and, in turn logs, product titles\/links of the cards shown and the WordPress Yes. Enable catalog-only mode<\/strong> in the settings. The cart tools (add to cart, modify, clear, checkout prompts) are disabled, and the assistant guides shoppers to the product page or to contact the store instead of trying to sell online.<\/p><\/dd>\n Yes. The plugin is translation ready and exposes a On uninstall, sensitive data is always removed: your Anthropic API key, rate-limit caches, taxonomy snapshot transients, and the diagnostics table.\nDiagnostics settings (enable toggle, retention days, max rows, turn logging toggle) are also removed on uninstall to avoid stale diagnostic state after reinstall.\nYour other settings (assistant voice, colors, floating widget options, etc.) are kept by default so you can reinstall without reconfiguring everything. To delete all plugin settings on uninstall, enable \"Delete settings on uninstall\" under Kinedio Chat \u2192 AI Configuration before removing the plugin.<\/p><\/dd>\n Yes. Developers can use the Yes. The storefront chat does not rely on \n
[kinedio_chat]<\/code> shortcode, with optional attributes to customize the title and texts (see the FAQ for the full list).<\/li>\nkinedio_i18n_provider<\/code> filter lets WPML\/Polylang integrations supply translations.<\/li>\nExternal services<\/h3>\n\n
https:\/\/api.anthropic.com\/v1\/messages<\/code>.<\/p>\n\nCredits<\/h3>\n\n
\n
\n
wp-content\/plugins\/<\/code>, or install it from the Plugins screen, then activate Kinedio Personal Shopper for WooCommerce<\/strong>.<\/li>\n[kinedio_chat]<\/code> shortcode. Optionally enable the floating chat widget from the Usage tab.<\/li>\n<\/ol>\n\n\n\n
Do I need an account or API key?<\/h3><\/dt>\n
Is WooCommerce required?<\/h3><\/dt>\n
Which attributes does the [kinedio_chat] shortcode accept?<\/h3><\/dt>\n
\n
title<\/code> \u2014 heading shown above the chat (no heading is shown when empty).<\/li>\ntitle_heading<\/code> \u2014 heading level for the title, 1\u20136 (default 3).<\/li>\ntitle_fullscreen<\/code> \u2014 alternative title used in fullscreen mode (falls back to title<\/code>).<\/li>\nwelcome_message<\/code> \u2014 first message shown by the assistant.<\/li>\nplaceholder<\/code> \u2014 placeholder text of the message input field.<\/li>\nbutton_text<\/code> \u2014 label of the send button (default \"Send\").<\/li>\n<\/ul>\n\n[kinedio_chat title=\"Ask our assistant\" title_heading=\"2\" welcome_message=\"Hi! How can I help you today?\"]<\/code><\/p><\/dd>\nIs any data sent to a third party?<\/h3><\/dt>\n
Where is my API key stored?<\/h3><\/dt>\n
AUTH_KEY<\/code>, SECURE_AUTH_KEY<\/code> in wp-config.php<\/code>) invalidates the encryption and you will need to re-enter the key. On the rare host without OpenSSL, the key is stored as sanitized plain text.<\/p><\/dd>\nWhat does the plugin log, and is any personal data stored?<\/h3><\/dt>\n
\n
kinedio_turn_logging<\/code>): writes operational entries to the WooCommerce logs (WooCommerce \u2192 Status \u2192 Logs) and, only if WP_DEBUG_LOG<\/code> is on, to wp-content\/debug.log<\/code>.<\/li>\nkinedio_diagnostics_enabled<\/code>): stores per-turn metrics in a dedicated database table for the in-admin dashboard.<\/li>\n<\/ol>\n\nuser_id<\/code> for logged-in users). To stop all logging, turn both<\/strong> toggles off. Note: the rate limiter uses the visitor's IP in memory only<\/strong> (as a transient key for guests) to enforce request limits; it is never written to any log.<\/p><\/dd>\nCan I use it on a catalog-only store that does not sell online?<\/h3><\/dt>\n
Does it support multilingual sites?<\/h3><\/dt>\n
kinedio_i18n_provider<\/code> filter so WPML\/Polylang integrations can supply translated strings.<\/p><\/dd>\nWhat happens when I uninstall the plugin?<\/h3><\/dt>\n
Can developers customize the chat error message?<\/h3><\/dt>\n
kinedio_chat_user_error_message<\/code> filter to customize the shopper-facing error text. The filter must return plain text only (no HTML).<\/p><\/dd>\nIs the plugin compatible with a strict Content Security Policy (CSP)?<\/h3><\/dt>\n
unsafe-eval<\/code>, inline event handlers (onclick<\/code>, etc.), or browser calls to external APIs: JavaScript is loaded from your site via WordPress enqueue, chat requests go to admin-ajax.php<\/code> on the same origin, and Anthropic is contacted server-side only. If you use a strict CSP site-wide, you typically only need to allow scripts and styles from your own domain (often with CSP nonces, as WordPress core and security plugins do). You do not need to add https:\/\/api.anthropic.com<\/code> to connect-src<\/code> for this plugin. Example baseline for pages with the chat: script-src 'self' 'nonce-\u2026'; style-src 'self' 'nonce-\u2026'; connect-src 'self'; object-src 'none'<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n\n0.3.0<\/h4>\n\n
\n
em<\/code> units for consistent scaling.<\/li>\nsearch_term_groups<\/code>) in one tool call when an exact query returns no results, reducing unnecessary AI retries.<\/li>\nprice_asc<\/code> \/ price_desc<\/code>).<\/li>\nTested up to<\/code> confirmed at 7.0 (verified on 7.0.1); WC tested up to<\/code> raised to 10.9.4.<\/li>\n<\/ul>\n\n0.2.2<\/h4>\n\n
\n
WC tested up to<\/code> remains 10.8.1. WordPress Tested up to<\/code> confirmed at 7.0. Minimum PHP raised to 8.0 (code uses static closures, incompatible with PHP 7.4); tested on PHP 8.2.<\/li>\n<\/ul>\n\n0.2.1<\/h4>\n\n
\n
Requires Plugins<\/code> header (WordPress 6.5+); the runtime activation\/admin checks remain as a fallback. Added WC requires at least<\/code> \/ WC tested up to<\/code> headers.<\/li>\n0.1.9<\/h4>\n\n
\n
wp-config.php<\/code> (e.g. AUTH_KEY<\/code>, SECURE_AUTH_KEY<\/code>) invalidates decryption \u2014 re-enter the key under WooCommerce \u2192 Kinedio Chat.<\/li>\n<\/ul>\n\n0.1.0<\/h4>\n\n
\n