Beschrijving

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
* 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
* 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)

1. Install & Activate the plugin from WordPress admin or upload manually.
2. 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.
3. (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.
4. (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.
5. (Optional) Run a product sync from AI Vector Search -> Sync Products or with wp aivs sync-products when Supabase is connected.

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.

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

1. Dashboard notice showing new WP-CLI support and quick setup actions.
2. Settings menu entries added by AI Vector Search (Search Analytics, Supabase Status, Sync Products).
3. Search Analytics dashboard with success rate, CTR, and popular search terms.
4. Main plugin settings page with Supabase and OpenAI configuration, plus WP-CLI schema installation.
5. Status page showing store health overview and configuration summary.
6. Sync Products page with full sync, batch sync, and embeddings generation options.
7. 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 Supabase or API modes.

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 special integration for Woodmart theme’s live search feature.

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: <?php echo do_shortcode('[aivs_cart_recommendations]'); ?> 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.0 (Latest)

• 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 any selected timeframe
• New: Explicit dependency-ordered class loading replaces autoloader for better reliability
• Fix: Woodmart live search nonce handling with backwards-compatible fallbacks
• Fix: Analytics AJAX endpoints now properly handle multiple nonce sources
• Fix: Supabase client improved error handling for request failures
• Security: Enhanced URL escaping throughout admin interface with esc_url()
• Security: Improved nonce verification across all AJAX handlers
• Update: Supabase SQL schema now fully re-runnable with DROP IF EXISTS statements
• Update: Simplified RLS policies – removed problematic anon policies, keeping public read-only access
• Update: Code formatting standardized to PSR-12 throughout the codebase
• Update: Requires PHP 8.0+ (previously 7.4+)
• Dev: Better separation of concerns in JavaScript with centralized nonce handling

0.18.2

• New: Top level menu for the plugin
• New: Configurable search limit for search results
• Fix: Analytics template

0.18.0

• New: Lite Mode local TF-IDF search with configurable stopwords, synonym expansion, scheduled re-indexing, and upgrade guidance for stores that want zero external services
• New: Search enable/disable toggle so merchants can fall back to default WooCommerce search without disabling the plugin, plus Lite Mode defaults on fresh installs
• New: Fuzzy matching fallback across Lite, API, and self-hosted modes to reduce zero-result searches and surface partial matches
• Update: Analytics engine now sanitises input, caches recent results, secures CSV export with nonces, and invalidates caches on data changes for faster, safer reporting
• Fix: Lite Mode AJAX endpoints, synonym/stopword sanitisation, and uninstall cleanup ensure consistent local search behaviour and remove scheduled jobs/transients on uninstall

0.17.0

Major Architectural Improvements:
* New: Modular asset structure with separate CSS, JS, and template files
* New: Template system for better customization
* New: Optimized admin interface loading with conditional asset enqueueing
* Update: Refactored admin interface for better performance and maintainability
* Update: Enhanced error handling and user feedback systems
* Update: Improved code organization following WordPress best practices
* Fix: Better asset loading prevents conflicts with other plugins
* Dev: Easier customization and theming capabilities for developers

0.16.5.1

• Update: Updated readme with screenshots

0.16.5

• New: WP-CLI schema installation commands for reliable database setup
• New: Direct PostgreSQL connection support with encrypted credential storage
• New: Three-tier installation system: Manual copy/paste, WP-CLI commands, and Admin interface buttons
• New: Migration Runner architecture for transactional database operations with rollback support
• New: Real-time installation progress feedback in admin interface
• Update: Enhanced admin interface with PostgreSQL connection configuration field
• Update: Improved security with encrypted PostgreSQL connection string storage
• Update: Better user experience with step-by-step setup guidance
• Update: Enhanced status checking with …