內容簡介
AI Vector Search 外掛透過智慧型 AI 技術，提升 WooCommerce 商店的搜尋體驗，能理解顧客真正的需求，提供快速且相關的搜尋結果，從而增加轉換率和顧客滿意度。
【主要功能】
• 智慧搜尋技術
• 語意理解與模糊匹配
• 自動完成建議功能
• 三種搜尋模式選擇
• 支援大量查詢的擴展性
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
Stop losing customers to poor search results. AI Vector Search transforms your WooCommerce store’s search experience with intelligent, AI-powered technology that understands what your customers are really looking for – not just matching keywords.
Whether you run a small boutique or manage thousands of products, this plugin delivers lightning-fast, highly relevant search results that increase conversions and improve customer satisfaction.
🚀 Why AI Vector Search?
Traditional WooCommerce search fails when customers use different words, misspellings, or partial product codes. Our plugin solves this with three powerful search modes you can choose based on your needs:
Lite Mode (Default – Free Forever)
Works instantly after installation with zero configuration. Uses advanced TF-IDF algorithms with synonym expansion and stopword filtering. Perfect for stores under 1,000 products or budget-conscious merchants. No external services, APIs, or monthly costs required.
Self-Hosted Supabase Mode
Unlock enterprise-grade search on your own infrastructure. Get PostgreSQL full-text search combined with optional AI semantic understanding via OpenAI embeddings. Your data stays in your Supabase project – you maintain complete control. Includes partial SKU/EAN/UPC/ISBN matching, hybrid search strategies, and scales to millions of queries. Free tier supports 50,000 queries/month.
Managed API Service Mode
Let us handle everything. Simply activate with your license key and we manage the entire stack – Supabase hosting, OpenAI integration, infrastructure updates, scaling, and maintenance. You focus on your store, we handle the complex search infrastructure.
✨ Powerful Features That Drive Sales
Intelligent Search Technology:
* Semantic Understanding – AI knows “running shoes” and “jogging sneakers” mean the same thing
* Fuzzy Matching – Handles typos and misspellings gracefully
* Autocomplete Suggestions – Show matching products, suggested search phrases, and category links while customers type
* Partial Query Matching – Finds relevant products even when shoppers type incomplete multi-word searches
* SKU & Product Code Search – Find products instantly by partial EAN, UPC, ISBN, or SKU
* Hybrid Search – Combines full-text, semantic, and code-based search for best results
* Lightning Fast – Search happens on optimized PostgreSQL infrastructure, not your WordPress server
AI-Powered Recommendations:
* Similar Products – Automatically suggest related items on product pages using AI similarity
* Smart Cart Upsells – Show intelligent recommendations based on what’s already in the cart
* Multiple Display Options – Use shortcodes, Gutenberg blocks, or Elementor widgets anywhere on your site
* Category-Aware – Recommendations understand product relationships and categories
Search Analytics Dashboard:
* Track search volume, success rates, and click-through rates
* Identify popular search terms to optimize inventory
* Get alerted when customers search for products you don’t stock yet
* Export analytics data for deeper analysis
* Make data-driven merchandising decisions
Professional Setup & Management:
* WP-CLI Commands – Professional schema installation, testing, and product sync via command line
* Auto-Sync – Products automatically sync when saved or updated
* Batch Processing – Handle large catalogs efficiently with intelligent batching
* Selective Field Sync – Refresh cost, price, and stock fields across synced products without re-syncing the full catalog
* Health Monitoring – Built-in status checks and diagnostics
* Encrypted Security – API keys stored with enterprise-grade encryption and master key support
Seamless Integrations:
* Woodmart Theme – Native integration with Woodmart’s live search
* Elementor – Drag-and-drop cart recommendations widget
* Gutenberg – Native blocks for easy content integration
* Developer Friendly – Comprehensive hooks and filters for customization
🎯 Perfect For
Stores frustrated with default WooCommerce search limitations
Large catalogs (1,000+ products) needing better discovery
Stores with complex product variations and attributes
Multi-language or international stores
Merchants wanting to increase average order value with smart recommendations
Developers seeking modern, scalable search infrastructure
🔒 Security & Transparency
Your Data, Your Control:
All API keys are encrypted in your WordPress database. Self-hosted mode keeps your product data in your own Supabase project. The Managed API mode processes your data securely in isolated environments. All communications use HTTPS/TLS encryption.
Transparent Pricing:
* Lite Mode: Free forever, runs locally
* Self-Hosted Supabase: Free tier includes 50,000 queries/month. Optional OpenAI embeddings cost ~$0.05-$1.00 per 1,000 products (one-time setup cost only)
* Managed API Service: Subscription-based pricing includes all infrastructure costs
No Data Lock-In:
You always maintain access to your product data. Switch modes or export your data anytime.
🏆 What Makes This Different?
Unlike other search plugins that require expensive third-party subscriptions or complex setups, AI Vector Search gives you complete flexibility. Start free with Lite Mode, upgrade to self-hosted infrastructure when you grow, or let us manage everything with the API service. You choose the approach that fits your business model and budget.
Built by developers for developers, with comprehensive documentation, WP-CLI support, and extensibility via WordPress hooks and filters.
📦 Installation
Quick Start (5 Minutes)
Install & Activate the plugin from WordPress admin or upload manually.
Use Lite Mode instantly – search works locally out of the box. Visit AI Vector Search -> Settings to adjust Lite stopwords, synonyms, or index limits if you need to tune results.
(Optional) Connect Supabase for self-hosted search:
Create a free account at supabase.com and start a new project.
Copy your project URL and service key into the plugin settings.
Run the built-in schema installer from the admin UI or WP-CLI.
(Optional) Enable Semantic Search with OpenAI:
Add your OpenAI API key to generate embeddings (self-hosted or API modes).
Choose the search mode that fits your catalog and budget.
(Optional) Run a product sync from AI Vector Search -> Sync Products or with wp aivs sync-products when using Self-Hosted Supabase or Managed API mode.
(Optional) Enable Search Autocomplete in settings to show product suggestions, matching terms, and categories in frontend search dropdowns.
(Optional) Run a field-only sync from AI Vector Search -> Sync Products when you need to refresh prices, stock, or cost values without a full catalog sync.
Command Line Tools (WP-CLI)
Speed up setup and maintenance with new WP-CLI commands (requires the PostgreSQL client and, for schema installs, the encrypted connection string saved in settings):
* wp aivs install-schema – install or update the Supabase schema from your WordPress server.
* wp aivs check-schema – verify tables, functions, and extensions are present.
* wp aivs test-connection – confirm credentials before running migrations.
* wp aivs sync-products – batch sync products after catalog changes.
The Sync Products screen now supports browser-driven full catalog sync in configurable batches, with live progress feedback to avoid admin page timeouts on larger stores. It also includes field-only batch sync for cost_price, regular_price, sale_price, stock_quantity, and stock_status.
You can also trigger schema installation from the admin UI; both paths use the encrypted PostgreSQL connection string you store under Settings AI Supabase.
Getting Your API Keys
Supabase:
1. Visit app.supabase.com
2. Go to Project Settings → API
3. Copy your project URL and service role key
OpenAI (Optional for Semantic Search):
1. Visit platform.openai.com/api-keys
2. Create a new API key
3. Ensure billing is set up for embedding API usage
📸 Screenshots
Dashboard notice showing new WP-CLI support and quick setup actions.
Settings menu entries added by AI Vector Search (Search Analytics, Supabase Status, Sync Products).
Search Analytics dashboard with success rate, CTR, and popular search terms.
Main plugin settings page with Supabase and OpenAI configuration, plus toggles for live search integration and search autocomplete.
Status page showing store health overview and configuration summary.
Sync Products page with browser-driven batch progress, full sync controls, field-only sync actions, and embeddings generation options.
Frontend autocomplete dropdown showing product matches, suggested terms, category links, and a view-all-results action.
Setup guide for manual and WP-CLI installation, including PostgreSQL connection and OpenAI configuration.
❓ Frequently Asked Questions
What are the connection modes?
Lite mode runs locally and is enabled by default. Switch to self-hosted Supabase when you want scalable vector search on your own infrastructure, or activate the managed API service with your license key when you prefer a fully hosted stack. You can change modes in Settings AI Supabase and the plugin will guide you through any extra steps (keys, schema install, or product sync).
When should I use each connection mode?
Lite Mode – Best for: small stores (<1000 products), budget-conscious merchants, or testing the plugin
Self-Hosted Supabase – Best for: full control, larger catalogs, semantic search, international stores
Can I switch connection modes later?
Yes! You can switch between Lite, Self-Hosted, and Managed API modes at any time from Settings. Your search analytics are preserved, but you’ll need to re-sync products when switching to Self-Hosted Supabase or Managed API mode.
Is OpenAI required?
No! The plugin works great with just Supabase for fast keyword search. OpenAI is only needed for semantic (AI) search and enhanced recommendations. You can start with keyword search and add semantic features later.
How much does it cost to run?
Supabase: Free tier includes 50,000 monthly queries – perfect for most stores. Paid plans start at $25/month for high-traffic sites.
OpenAI: One-time embedding cost of ~$0.05-$1.00 per 1,000 products. After initial setup, ongoing costs are minimal (only for new products).
Will this slow down my site?
No! Search queries run on Supabase’s fast PostgreSQL infrastructure, not your WordPress server. This often makes search faster than default WooCommerce.
Does it work with my theme?
Yes! The plugin uses standard WordPress and WooCommerce hooks. It includes live search support for Woodmart and standard WooCommerce product search forms, including optional autocomplete dropdowns.
What does Search Autocomplete add?
When enabled, the frontend search dropdown can show matching products, suggested search phrases, and product categories after just 2 characters. The markup is theme-overridable by copying templates/search-autocomplete.php to your-theme/aivesese/search-autocomplete.php.
Can I customize the search behavior?
Absolutely! The plugin is built with developer hooks and filters. Need custom field indexing or search logic? Check our Premium setup service for advanced customization.
What happens to my data if I uninstall?
Your product data remains in your Supabase project – you have full control. The WordPress plugin only removes its settings and stops syncing. You can delete data from Supabase manually if desired.
Is it GDPR compliant?
The plugin only syncs product data (names, descriptions, prices, etc.) – no personal customer information. When semantic search is enabled, product text is processed by OpenAI according to their privacy policy.
Can I use this on multiple stores?
Yes! Each store gets its own unique Store ID, allowing multiple WooCommerce sites to use the same Supabase project while keeping data separate.
How do I display cart recommendations?
You can show AI-powered recommendations based on cart contents using:
* Shortcode: [aivs_cart_recommendations] – Add anywhere in your content
* Gutenberg Block: Search for “Cart Recommendations” in the block editor
* Elementor Widget: Available in Elementor’s widget panel
* Template Function: for theme files
⚡ Technical Requirements
WordPress: 6.0 or higher
PHP: 8.0 or higher (8.1+ recommended)
WooCommerce: 5.0 or higher
Supabase Account: Free tier sufficient for most stores
OpenAI API Key: Optional, only for semantic search
🔐 Privacy & Data Usage
What Data is Synced?
Product names, descriptions, and short descriptions
SKUs, GTINs (EAN/UPC/ISBN), and brand information
Categories, tags, and custom attributes
Prices (regular, sale, cost) and stock status
Product images (URLs only) and ratings
What Data is NOT Synced?
Customer information
Order details
Personal data
Payment information
Third-Party Services
Supabase: Product data stored in your own Supabase project
OpenAI: Product text processed for embeddings when semantic search is enabled
All communication uses HTTPS. You maintain full control over your API keys and can revoke access at any time.
🛠️ Support & Professional Services
Community Support
Plugin documentation and FAQ
WordPress.org support forums
GitHub issues (for technical bugs)
Premium Setup Service by ZZZ Solutions
Complete Setup: We install and configure everything for you
Custom Field Mapping: Index specific product attributes and meta fields
Advanced Search Tuning: Optimize search relevance for your catalog
Multi-language Support: Configure search for international stores
Custom Recommendations: Tailored recommendation algorithms
Performance Optimization: Fine-tune for large catalogs
Contact ZZZ Solutions for professional setup and customization.
📝 Changelog
1.0.2 (Latest)
New: Frontend search autocomplete for standard WooCommerce search forms and Woodmart live search, with product suggestions, matching search terms, category links, and template overrides
New: Partial-query fallback improves results for incomplete multi-word searches by combining token-level full-text, fuzzy, and SKU matching
New: Sync Products page now supports field-only batch sync for Cost of Goods, regular price, sale price, stock quantity, and stock status
Update: Cost sync now detects WooCommerce native COGS plus additional common cost-price meta keys, with variation-aware averaging for variable products
Update: Managed API pricing in the admin UI now shows the 19 EUR/month discounted plan through June 1
Update: Supabase margin is now stored as a percentage with null guards, with upgrade SQL included for existing databases
Compatibility: Search requests now start at 2 characters for faster autocomplete and partial-match discovery
1.0.1
New: Browser-driven full catalog sync now runs in AJAX batches with live progress feedback to avoid admin timeouts on large stores
New: Sync Products page now supports Managed API mode with mode-aware headings, validation, and synced-count reporting
Update: Sync overview now counts only searchable WooCommerce products and uses a shared connection manager for destination status
Update: Product sync truncates oversized name, description, short description, and SKU fields before API sync to prevent payload errors
Compatibility: Tested up to WordPress 6.9.1 and WooCommerce 10.5.3
1.0.0
Milestone: Official stable release with production-ready feature set
New: Three flexible connection modes – Lite (local), Self-Hosted (Supabase), and Managed API Service
New: Complete WP-CLI command suite for professional database management and setup
New: Cart recommendations with shortcode, Gutenberg block, and Elementor widget support
New: Search Analytics dashboard with detailed insights, CTR tracking, and zero-result alerts
New: Advanced encryption system with master key support for secure credential storage
New: Lite Mode TF-IDF engine with synonym expansion and stopword filtering for zero-dependency search
Security: Enhanced nonce verification and URL escaping throughout admin interface
Security: Encrypted PostgreSQL connection string storage with enterprise-grade protection
Performance: Optimized admin interface with modular asset loading and template system
Performance: Improved Supabase schema with re-runnable migrations and simplified RLS policies
Compatibility: PHP 8.0+ required, tested up to WordPress 6.9 and WooCommerce 10.4.2
Developer: Better code organization following PSR-12 standards and WordPress best practices
Developer: Comprehensive hooks and filters for customization and extensibility
0.18.3
New: Cart recommendations shortcode, block, and Elementor widget for flexible placement
New: Admin tool to update product sold_count in Supabase for …
