{"id":383747,"date":"2026-10-15T03:34:21","date_gmt":"2026-10-15T03:34:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/avo-ai-shopping-assistant-for-woocommerce\/"},"modified":"2026-10-15T15:41:29","modified_gmt":"2026-10-15T15:41:29","slug":"avo-ai-shopping-assistant-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/avo-ai-shopping-assistant-for-woocommerce\/","author":23582556,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.3.1","stable_tag":"1.3.1","tested":"7.1.3","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Avo \u2013 AI Shopping Assistant for WooCommerce","header_author":"Corpela Inc.","header_description":"Intelligent AI-powered shopping assistant widget for WooCommerce by Corpela Inc. Understands customer intent, recommends in-stock products, and provides direct category navigation.","assets_banners_color":"424551","last_updated":"2026-10-15 15:41:29","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/corpela.com","header_plugin_uri":"","header_author_uri":"https:\/\/corpela.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":79,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"corpela","date":"2026-10-15 03:45:08","revision":3747559},"1.1.0":{"tag":"1.1.0","author":"corpela","date":"2026-10-15 07:34:13","revision":3747793},"1.1.1":{"tag":"1.1.1","author":"corpela","date":"2026-10-15 08:03:58","revision":3747895},"1.2.0":{"tag":"1.2.0","author":"corpela","date":"2026-10-15 13:52:21","revision":3748631},"1.3.0":{"tag":"1.3.0","author":"corpela","date":"2026-10-15 15:16:45","revision":3748826},"1.3.1":{"tag":"1.3.1","author":"corpela","date":"2026-10-15 15:41:29","revision":3748861}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3747552,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3747552,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3747552,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3747552,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0","1.1.1","1.2.0","1.3.0","1.3.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Floating search pill on storefront.","2":"AI results modal showing product recommendations and collection banner.","3":"Plugin admin settings panel with Test Connection button."}},"plugin_section":[],"plugin_tags":[2353,220145,5183,47816,286],"plugin_category":[45],"plugin_contributors":[286864],"plugin_business_model":[],"class_list":["post-383747","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-ai-search","plugin_tags-product-search","plugin_tags-smart-search","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-corpela","plugin_committers-corpela"],"banners":{"banner":"https:\/\/ps.w.org\/avo-ai-shopping-assistant-for-woocommerce\/assets\/banner-772x250.png?rev=3747552","banner_2x":"https:\/\/ps.w.org\/avo-ai-shopping-assistant-for-woocommerce\/assets\/banner-1544x500.png?rev=3747552","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/avo-ai-shopping-assistant-for-woocommerce\/assets\/icon-128x128.png?rev=3747552","icon_2x":"https:\/\/ps.w.org\/avo-ai-shopping-assistant-for-woocommerce\/assets\/icon-256x256.png?rev=3747552","generated":false},"screenshots":[],"raw_content":"\n

Avo<\/strong> transforms your WooCommerce store into an intelligent shopping destination. It places a sleek floating search pill at the bottom of your storefront (e.g., \"What are you shopping for today? \u2192\"<\/em>).<\/p>\n\n

When a shopper asks a natural question like \"I need a Casio watch for my wife\"<\/em>, Avo connects to OpenRouter AI to extract buyer intent (brand, gender target, categories, price budget), queries your local WooCommerce catalog, and displays instant matching product cards inside a modern popup modal\u2014complete with one-click collection redirects!<\/p>\n\n

Key Features<\/h3>\n\n
    \n
  • Floating Search Pill<\/strong>: Pinned at the bottom-center of your storefront with a modern frosted glass aesthetic.<\/li>\n
  • Natural Language Intent Parsing<\/strong>: Powered by OpenRouter AI (google\/gemini-2.0-flash-001<\/code>, openai\/gpt-4o-mini<\/code>, anthropic\/claude-3.5-haiku<\/code>).<\/li>\n
  • Direct WooCommerce DB Querying<\/strong>: Queries real-time inventory and pricing directly from your store database.<\/li>\n
  • Instant Category Link Banner<\/strong>: One-click \"Explore Collection: View all Women's Casio Watches \u2192\"<\/em> button.<\/li>\n
  • AJAX Add to Cart<\/strong>: Allows shoppers to add items directly to their cart from the results modal without page reloads.<\/li>\n
  • Merchant Analytics & Demand Insights<\/strong>: Track top searched queries, uncover zero-result demand gaps, and attribute sales conversions.<\/li>\n
  • Customizable Admin Settings<\/strong>: Change AI model, placeholder text, accent color, and test API connectivity with one click.<\/li>\n
  • Rate-Limiting Protection<\/strong>: Server-side nonce check and IP rate-limiting to prevent unauthorized use of your OpenRouter API credits.<\/li>\n<\/ul>\n\n

    Third-Party Services<\/h3>\n\n

    This plugin relies on the OpenRouter API<\/strong> to perform natural language intent recognition and generate conversational shopping recommendations.<\/p>\n\n

      \n
    • Service Provider<\/strong>: OpenRouter, LLC (https:\/\/openrouter.ai)<\/li>\n
    • Terms of Service<\/strong>: https:\/\/openrouter.ai\/terms<\/li>\n
    • Privacy Policy<\/strong>: https:\/\/openrouter.ai\/privacy<\/li>\n
    • What Data is Transmitted<\/strong>: When a customer performs a search via the assistant widget, their search text query and the store's public taxonomy names (category and attribute names) are sent to OpenRouter via a secure HTTPS server-to-server request. No customer personal identifiable information (PII) or customer account credentials are ever transmitted.<\/li>\n<\/ul>\n\n\n
        \n
      1. Upload the plugin folder to the \/wp-content\/plugins\/<\/code> directory, or install directly through Plugins > Add New > Upload Plugin<\/strong>.<\/li>\n
      2. Activate the plugin through the Plugins<\/strong> menu in WordPress.<\/li>\n
      3. Ensure WooCommerce is installed and active with published products in your catalog.<\/li>\n
      4. Navigate to Avo Assistant<\/strong> in your WordPress admin menu (or click the Settings<\/strong> shortcut on the Plugins screen).<\/li>\n
      5. Enter your OpenRouter API Key<\/strong> (obtainable from https:\/\/openrouter.ai\/keys). You can choose any model including the free openrouter\/free<\/code> tier.<\/li>\n
      6. Click Test Connection<\/strong> to confirm connectivity.<\/li>\n
      7. Customize optional storefront display settings (placeholder text, accent color, max recommended products) and click Save All Changes<\/strong>. The search pill will immediately appear on your storefront.<\/li>\n<\/ol>\n\n\n
        \n

        Do I need an OpenRouter account?<\/h3><\/dt>\n

        Yes. Store owners must have an active OpenRouter account and API key. You can use the free openrouter\/free<\/code> model tier or low-cost models. Get your key at https:\/\/openrouter.ai.<\/p><\/dd>\n

        Which AI model is recommended?<\/h3><\/dt>\n

        You can use openrouter\/free<\/code> to run completely free without consuming API credits, or google\/gemini-2.0-flash-001<\/code> \/ openai\/gpt-4o-mini<\/code> for near-instant (1-2s) response times and minimal cost.<\/p><\/dd>\n

        Is my API key exposed to visitors?<\/h3><\/dt>\n

        No. The OpenRouter API key is stored securely in WordPress database settings and all API calls are made server-side through the WordPress REST API with nonces.<\/p><\/dd>\n

        Can I place the search widget manually with a shortcode?<\/h3><\/dt>\n

        Yes! You can place the search bar anywhere using the shortcode [avoaisha_search]<\/code> in your pages, header, footer, or block templates.<\/p><\/dd>\n\n<\/dl>\n\n\n

        1.3.1<\/h4>\n\n
          \n
        • Fixed: Critical search continuity bug resolved. Implemented zero-failure catalog keyword fallback when OpenRouter API key is unconfigured, credit quota is exhausted, or temporary network interruptions occur.<\/li>\n
        • Improved: Standardized database queries in Analytics engine with persistent caching (wp_cache_*<\/code>) and strict WordPress table prefix compliance, resolving Plugin Check warnings.<\/li>\n<\/ul>\n\n

          1.3.0<\/h4>\n\n
            \n
          • New: Added Merchant Analytics & Insights Dashboard (Tab 5 in Settings) featuring real-time KPI metric cards (Total AI Searches, Conversions, Conversion Rate %, and Missed Demand).<\/li>\n
          • New: Added Missed Sales Opportunities table showing zero-result searches to help store owners identify what customers want to buy that isn't currently stocked.<\/li>\n
          • New: Added Top Searched Terms table tracking popular customer queries and direct Add-to-Cart conversions.<\/li>\n
          • New: Added date range filtering (Last 7 Days, Last 30 Days, Last 90 Days, All Time) with one-click reset logs action.<\/li>\n
          • Improved: Refined administrative dashboard layout with responsive 2-column grid and optimized spacing across all setting sections.<\/li>\n
          • Improved: GDPR-compliant lightweight analytics storage using custom indexed SQL table with zero customer PII and automated daily log pruning.<\/li>\n
          • Fixed: Corrected container spacing, button alignment, and toggle switch margins in the settings panel.<\/li>\n<\/ul>\n\n

            1.2.0<\/h4>\n\n
              \n
            • Feature: Redesigned admin settings with a modern tabbed navigation interface (API & Model, Widget Design, Mobile Rules, Store Behavior).<\/li>\n
            • Feature: Added one-click sample prompt preset templates for instant setup across different store niches.<\/li>\n
            • Feature: Added one-click copy shortcode action in the settings screen.<\/li>\n
            • Enhancement: Added persistent active tab memory so settings saves retain your active tab.<\/li>\n<\/ul>\n\n

              1.1.1<\/h4>\n\n
                \n
              • Feature: Added admin setting to hide the floating search assistant on single product pages.<\/li>\n
              • Performance: Conditionally skip loading frontend styles and scripts on product pages when hidden.<\/li>\n<\/ul>\n\n

                1.1.0<\/h4>\n\n
                  \n
                • Feature: Smart auto-detection of theme mobile footer navigation bars (Storefront, WoodMart, Flatsome, Astra, Botiga, sticky add-to-cart bars) with dynamic automatic elevation so footer menus are never hidden.<\/li>\n
                • Feature: Added automatic page-level exclusion toggle to hide floating search widget on Cart and Checkout pages to avoid obstructing checkout buttons.<\/li>\n
                • Feature: Added customizable mobile bottom offset setting in plugin admin settings.<\/li>\n
                • Enhancement: Added iOS safe-area-inset support for iPhone bottom gesture bars.<\/li>\n<\/ul>\n\n

                  1.0.0<\/h4>\n\n
                    \n
                  • Initial release on WordPress.org directory.<\/li>\n
                  • Floating search pill widget with frosted glass design.<\/li>\n
                  • OpenRouter API intent extraction engine.<\/li>\n
                  • Real-time WooCommerce product querying and category matching.<\/li>\n
                  • Instant AJAX Add to Cart support in modal.<\/li>\n<\/ul>","raw_excerpt":"AI shopping assistant and smart product search for WooCommerce. Understands buyer intent, recommends in-stock products, and boosts store sales.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/383747","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=383747"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/corpela"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=383747"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=383747"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=383747"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=383747"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=383747"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=383747"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}