=== FukuroChat Connector === Contributors: fukurochat Tags: woocommerce, chatbot, ai, chat, ecommerce Requires at least: 5.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.0.10 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Connect your WooCommerce store to FukuroChat AI Assistant. Automatic product sync, intelligent chatbot widget, and seamless integration. == Description == FukuroChat Connector seamlessly integrates your WooCommerce store with FukuroChat AI Assistant, providing an intelligent chatbot that helps customers find products, answer questions, and improve conversions. **Main Features:** * **Automatic Product Synchronization** - Products are automatically synced with FukuroChat when created, updated, or deleted * **Intelligent AI Chatbot Widget** - Embed a customizable chat widget on your site to assist customers in real-time * **WordPress Theme Customizer Integration** - Live preview and customize widget appearance * **OAuth-Style Connection** - Secure one-click connection to your FukuroChat assistant * **Conversion Tracking** - Track orders influenced by chatbot interactions * **Smart Product Validation** - Ensures products have required fields (title, description) before sync * **Admin Notifications** - Get feedback on sync operations directly in WordPress admin * **Text Cleaning** - Automatically formats product descriptions for optimal AI processing * **Restore Support** - Products restored from trash are automatically re-synced * **Lightweight & Performant** - Minimal impact on site performance **How It Works:** 1. **Setup** - Enter your FukuroChat Assistant UUID (provided by FukuroChat) 2. **Widget** - Enable and customize the chat widget via Theme Customizer 3. **Sync** - Optionally enable automatic product synchronization with your API Secret 4. **Done** - Your AI assistant is live and knows about your products! **Automatic Synchronization:** When enabled, the plugin automatically: * **Adds** new products to FukuroChat when published * **Updates** product information when edited * **Removes** products when moved to trash or deleted * **Restores** products when recovered from trash **Product Data Synced:** * Product ID (unique identifier) * Product Title * Product Description (cleaned and formatted) * Product URL (direct link) * Product SKU * Regular Price & Sale Price * Sale Dates * Stock Status * Product Attributes * Categories * Upsells & Cross-sells * Alternative Products (custom field) **Widget Customization:** * Enable/disable widget toggle * Custom bubble text (e.g., "Chat with us") * Custom target element ID for advanced placement * Live preview in Theme Customizer before publishing == Installation == **Automatic Installation:** 1. Log in to your WordPress admin panel 2. Go to Plugins > Add New 3. Search for "FukuroChat Connector" 4. Click "Install Now" and then "Activate" **Manual Installation:** 1. Download the plugin zip file 2. Upload the `fukurochat-connector` folder to `/wp-content/plugins/` 3. Activate the plugin through the 'Plugins' menu in WordPress **Setup:** 1. Ensure WooCommerce is installed and activated 2. Go to "FukuroChat" in WordPress admin menu 3. Follow the 3-step setup wizard: * **Step 1:** Click "Connect with FukuroChat" to link your assistant * **Step 2:** Enable automatic product sync (optional) * **Step 3:** Open Theme Customizer to enable and customize the widget 4. Done! Your AI assistant is now live on your store == Frequently Asked Questions == = What is FukuroChat? = FukuroChat is an AI-powered chatbot platform that helps e-commerce businesses automate customer support, product recommendations, and sales through intelligent conversations. Learn more at [FukuroChat.com](https://www.fukurochat.com) = Do I need a FukuroChat account? = Yes, you need a FukuroChat account to get your Assistant UUID and API Secret. Sign up at [app.fukurochat.com](https://app.fukurochat.com) to get started. = Does this plugin require WooCommerce? = Yes, this plugin requires WooCommerce 3.0 or higher to be installed and activated. = How does automatic product sync work? = When enabled in Step 3, the plugin automatically syncs products with FukuroChat: * New products are added when published * Existing products are updated when edited * Products are removed when trashed or deleted * Products are restored when recovered from trash = What product information is required for sync? = Products must have a title and description to be synchronized. SKU is optional but recommended for better product tracking. The plugin will show an admin notice if any required field is missing. = Can I preview the widget before publishing? = Yes! The plugin integrates with WordPress Theme Customizer, allowing you to see a live preview of the widget on your site before publishing changes. = How do I customize the widget appearance? = Go to Appearance > Customize > FukuroChat Widget, or click "Open Theme Customizer" in Step 2 of the setup wizard. You can customize bubble text, target element, and enable/disable the widget. = Will this slow down my site? = No, the plugin is lightweight and optimized for performance. Sync operations happen in the background, and the widget loads asynchronously without blocking page load. = What happens if a product sync fails? = The plugin will show an admin notice with details about the error on the product edit page. Common issues include missing required fields or API connection problems. = Can I disable automatic sync? = Yes, you can disable automatic sync at any time in Step 3 of the plugin settings. This won't affect the widget or JSON endpoint. = Does the plugin work with product variations? = The current version syncs the main product information. Variable products are supported, but individual variations are not synced separately. == Changelog == = 1.0.10 = * CRITICAL FIX: Removed fatal error on plugin activation caused by missing add_endpoint() method * Fixed retry logic when edit_article fails - properly reconstructs JSON request * Fixed session_start() warning - now checks session status before starting * Improved ajax_toggle_sync to use update_option instead of direct SQL queries * Removed deprecated /products.json endpoint * Updated product sync requirements - SKU is now optional (only title and description required) * Enhanced error handling and logging * Code cleanup and optimization = 1.0.9 = * Batch product sync - all products sent in single API call for faster synchronization * Reduced API calls during bulk operations * Improved sync performance for large catalogs * Stock status now synced as separate field for inventory-aware responses = 1.0.8 = * Optimized product embeddings - removed price and SKU from text for cleaner semantic search * Moved structured data (price, SKU) to metadata for exact filtering * Enhanced price filtering capabilities with metadata-based queries * Improved product matching accuracy by focusing embeddings on descriptions and attributes * Reduced token usage in AI embeddings * Fixed currency symbol encoding issue (HTML entities properly decoded) = 1.0.7 = * Improved OAuth connection flow - now opens in popup window for seamless authentication * Added inline assistant creation modal in connection window for new users * Removed address bar from connection popup for cleaner user experience * Enhanced security - connection page now restricted to popup access only * Streamlined workflow - assistants can be created without leaving the connection flow = 1.0.6 = * Added customizable horizontal and vertical offset controls for widget positioning * Smart conditional display of offset fields based on selected position * Dynamic label updates in Customizer (e.g., "Distance from Right", "Distance from Bottom") * Center positions (center-left, center-right) now only show horizontal offset control * Improved widget placement precision with pixel-perfect control (0-500px range) = 1.0.5 = * Added widget position selector in Theme Customizer (bottom-right, bottom-left, center-right, center-left, top-right, top-left) * Enhanced widget customization options for better user experience = 1.0.4 = * Fixed widget injection causing layout conflicts with some themes * Improved widget script positioning for better compatibility = 1.0.3 = * Added source parameter to all API calls for better platform identification * Fixed widget rendering issue with escaped JSON quotes = 1.0.2 = * Fixed problem with main icon = 1.0.1 = * WordPress rules adjustments = 1.0 = * Initial release * 3-step setup wizard * Assistant UUID configuration with validation (36 characters, UUID format) * API Secret configuration with validation (64 characters) * WordPress Theme Customizer integration with live preview * Automatic product synchronization (create, update, delete, restore) * Smart product validation (title, description, SKU required) * Text cleaning for optimal AI processing * Admin notifications for sync operations * FukuroChat widget integration with customization options * Widget customization: bubble text, target element ID, enable/disable toggle * WooCommerce hooks integration (woocommerce_new_product, woocommerce_update_product) * WordPress trash and delete hooks (wp_trash_post, before_delete_post) * Product metadata tracking for sync status * Form-data API integration with FukuroChat * Conditional UI display based on configuration state * Cross-field validation for settings * Security: sanitization and validation of all inputs * Performance: lightweight, async widget loading, minimal database queries == Upgrade Notice == = 1.0 = Initial release of FukuroChat Connector. Seamlessly integrate your WooCommerce store with FukuroChat AI Assistant. == Screenshots == 1. **3-Step Setup Wizard** - Easy configuration process 2. **Theme Customizer Integration** - Live preview of widget before publishing == Additional Information == **Support:** For support, feature requests, or bug reports, please visit: * Website: [FukuroChat.com](https://www.fukurochat.com) * Support: [FukuroChat Support](https://app.fukurochat.com/support) **Privacy & Data:** * This plugin does not collect or store any personal user data * Product data synced with FukuroChat includes only publicly visible product information * Conversion tracking uses anonymous session data to attribute sales * Automatic sync uses secure API authentication with your API Secret * All API communications use HTTPS encryption * No tracking, analytics, or third-party data sharing beyond FukuroChat integration **Requirements:** * WordPress 5.0 or higher * WooCommerce 3.0 or higher * PHP 7.4 or higher * HTTPS recommended for secure API communication **Language:** * Currently available in English only * Translation support may be added in future versions