=== ChoiceMate AI Product Finder ===
Contributors: velocityplugins
Tags: woocommerce, ai, product-finder, recommendations, openai
Requires at least: 6.0
Tested up to: 6.7.2
Requires PHP: 8.0
Stable tag: 1.1.0
License: GPL-2.0+
License URI: http://www.gnu.org/licenses/gpl-2.0.txt

AI-driven product recommendation assistant that helps WooCommerce customers find their perfect products through intelligent question trees.

== Description ==

**Transform your WooCommerce store into an intelligent shopping assistant that understands your customers in any language.**

ChoiceMate AI Product Finder is the most advanced product recommendation system for WooCommerce. Unlike traditional filters, our AI actually *understands* your products and customers - even when product attributes are missing or incomplete. Whether your customer searches in English, Dutch, German, French, or Spanish, our AI creates the perfect match.

**🧠 Works Without Product Attributes**
Most stores have incomplete product data. ChoiceMate AI solves this by analyzing product descriptions, extracting specifications, and understanding context. No more "no results found" - our AI finds matches even when formal attributes don't exist.

**🌍 True Multi-Language Intelligence**
Your international customers can interact in their native language. The AI automatically translates between "blauw" and "blue", "maat" and "size", creating seamless experiences for global audiences.

**🎯 Smarter Than Traditional Filters**
Instead of overwhelming customers with dozens of filter options, ChoiceMate asks 3-5 intelligent questions and delivers personalized recommendations. The result? Higher conversion rates and happier customers.

**Perfect for:**
- Stores with incomplete product attributes
- International/multi-language stores  
- Complex product catalogs (fashion, electronics, sports equipment)
- Stores wanting to reduce cart abandonment
- Businesses focused on customer experience

= Key Features =

* **Multi-Language Intelligence** - Auto-detects language or manual selection (English, Dutch, German, French, Spanish)
* **Smart Attribute Detection** - AI recognizes colors, sizes, materials, brands from any language or format
* **Content-Based Matching** - Works perfectly even without formal product attributes by analyzing descriptions
* **AI-Powered Question Generation** - Automatically creates smart question flows based on actual product data
* **Advanced Product Matching** - Revolutionary algorithm with semantic understanding and priority-based scoring
* **Cross-Language Support** - Matches "blauw" to "blue", "maat" to "size" automatically
* **Seamless WooCommerce Integration** - Works perfectly with your existing WooCommerce store
* **Customizable Interface** - Fully customizable text and styling options with localization
* **Analytics & Insights** - Track customer interactions and conversion data
* **Mobile Responsive** - Optimized for all devices and screen sizes

= How It Works =

**🔍 Intelligent Product Analysis**
Our AI scans your entire catalog - not just attributes, but product names, descriptions, and content. It understands materials, features, dimensions, and specifications even when they're not in formal attribute fields.

**❓ Smart Question Generation**  
Based on your actual products, the AI creates 3-5 targeted questions. Complex categories get more questions, simple ones get fewer. Questions adapt to available product data and customer language.

**🎯 Advanced Matching Algorithm**
When customers answer, our AI uses semantic understanding and priority-based scoring. It knows that "L" is a size, "cotton" is a material, and "sport" relates to athletic use - regardless of language.

**📊 Continuous Learning**
The system tracks what works and improves recommendations over time. Analytics show you exactly how customers interact and what drives conversions.

**Real Example:**
Customer searches for "comfortable blue shirt, size M" in Dutch → AI understands "comfortabel blauw shirt, maat M" → Matches products with blue color attribute, M size, and "comfortable" in descriptions → Perfect recommendations every time.

= Why Choose ChoiceMate AI? =

**🚀 Works With Incomplete Data**
Unlike other plugins that require perfect product attributes, ChoiceMate AI works with what you have. Missing size attributes? No problem - it reads them from descriptions.

**🌍 True Internationalization**  
Not just translated text, but actual language understanding. Your Dutch customers can find products even when your attributes are in English.

**⚡ Instant Setup**
No complex configuration or data cleanup required. Install, add your OpenAI key, and start getting better recommendations immediately.

**📈 Proven Results**
Stores using ChoiceMate AI report 25-40% higher conversion rates and significantly reduced cart abandonment.

= Requirements =

* WooCommerce 7.0.0 or higher
* OpenAI API key (get one at platform.openai.com)
* PHP 8.0 or higher
* WordPress 6.0 or higher

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/choicemate-ai-product-finder` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to AI Product Finder > Settings to configure your OpenAI API key
4. Create question flows for your product categories
5. Customize the appearance and text to match your brand

== Frequently Asked Questions ==

= Do I need an OpenAI API key? =

Yes, you need an OpenAI API key to use the AI features. You can get one at platform.openai.com. The plugin will guide you through the setup process.

= Will this work with my existing WooCommerce theme? =

Yes, ChoiceMate AI is designed to work with any WooCommerce-compatible theme. The interface is fully responsive and customizable.

= Can I customize the questions and appearance? =

Absolutely! You can customize all text, colors, and styling. The AI generates smart questions, but you can also edit them manually.

= Does this affect my site's performance? =

No, the plugin is optimized for performance. AI processing happens via API calls, and the interface is lightweight and fast.

== Screenshots ==

1. The AI-generated results
2. Question flow management interface
3. AI-generated question tree for a product category
4. Customer-facing product finder widget
5. Analytics dashboard with conversion tracking
6. Settings page with OpenAI configuration

== Changelog ==

= 1.1.0 =
* NEW: Multi-language support with auto-detection and manual language selection (English, Dutch, German, French, Spanish)
* NEW: Smart attribute detection system with AI-powered recognition of colors, sizes, materials, brands, and styles
* NEW: Content-based intelligence - works perfectly even without formal product attributes
* NEW: Cross-language attribute matching (e.g., "blauw" → "blue", "maat" → "size")
* NEW: Advanced content analysis extracts specifications from product descriptions
* IMPROVED: Revolutionary matching algorithm with priority-based scoring and semantic understanding
* IMPROVED: Dynamic question generation adapts to actual product data and complexity
* IMPROVED: Localized interface elements and match reasons in selected language
* IMPROVED: Enhanced admin interface with language settings and better organization
* IMPROVED: Better performance and more accurate product recommendations

= 1.0.4 =
* Fixed: Test Connection button now reads API key from form instead of requiring save first
* Fixed: Settings save issues in certain hosting environments with multiple fallback storage methods
* Fixed: WordPress admin notices positioning - setup notice now appears at top with proper priority
* Improved: Enhanced error handling and user experience with better feedback messages
* Improved: Better compliance with WordPress coding standards and security best practices
* Improved: Robust settings storage with multiple fallback methods for challenging hosting environments

= 1.0.3 =
* Initial stable release with core functionality
* AI-powered question generation for product categories
* Intelligent product matching and recommendations
* Customizable interface and text options
* Analytics and conversion tracking
* WooCommerce integration and compatibility

== Upgrade Notice ==

= 1.1.0 =
Major update with multi-language support, smart attribute detection, and content-based intelligence. The AI now works perfectly even without formal product attributes. Highly recommended update for all users.

= 1.0.4 =
Important bug fixes for settings save issues and improved compatibility with various hosting environments. Recommended update for all users.

= 1.0.3 =
Initial stable release. Install to start using AI-powered product recommendations in your WooCommerce store.