=== Visualwebs AI Cloud Suite ===
Contributors: Visualwebs  
Tags: AI, Chatbot, Machine Learning, Security, ChatGPT
Requires at least: 6.2  
Tested up to: 7.0  
Requires PHP: 7.4  
Stable tag: 5.7.4
License: GPLv2 or later  
License URI: https://visualwebs.eu/terms-and-conditions/  
AI-powered chatbot, semantic search, and machine learning for WordPress with enterprise-grade security.

== Description ==
[youtube https://www.youtube.com/watch?v=Re8vKz1c3CI]
Visualwebs AI Cloud Suite adds AI chatbot, semantic search, analytics widgets, and SmartPricing to WordPress and WooCommerce.

It also supports SOS Inventory sync (Pro/Enterprise) and private API-key protected endpoints for secure integrations.

Free account available: Start with limited usage and upgrade when needed.

Full documentation: [https://visualwebs.eu/docs/plugin/ai-cloud-suite/](https://visualwebs.eu/docs/plugin/ai-cloud-suite/)

== Features ==
- AI chatbot for customer support and product discovery.
- Semantic search for better on-site results.
- Analytics and forecasting widgets.
- SmartPricing AI for WooCommerce.
- Secure integration token support for predictions import.
- SOS Inventory stock and order synchronization (Pro/Enterprise).
- Private feed/API endpoints protected with `X-Store-API-Key`.

== Installation ==
1. Upload the `visualwebs-ml` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Install and activate required plugins: **Redux Framework** and **WooCommerce**.
4. Open **AI Cloud Suite > Settings** and enter your API key.
5. Optional (SmartPricing): Generate an Integration Token in **AI Cloud Suite > Integration Token** and paste it in your SaaS Dashboard.

== Frequently Asked Questions ==
= Do I need the Redux Framework plugin? =
Yes. Redux Framework is required for plugin settings.

= Is it free? =
Yes. You can start with a free account (limited usage) and upgrade later.

= Which plans include SOS inventory stock + order sync? =
SOS Inventory stock and order sync are available on **Pro** and **Enterprise** plans.

== Trial ==
You can try Visualwebs AI Cloud Suite with a free account before subscribing.  
Get your trial [here](https://visualwebs.eu/product/ai-cloud-suite/)

== Demo ==
We offer an online demo for all platforms on our product page. Please [visit this link](https://visualwebs.eu/product/ai-cloud-suite/)

= Does this plugin work with WooCommerce? =
Yes. The plugin integrates with WooCommerce for product, pricing, and feed features.

= How do I manage the semantic search queue? =
You can manage the semantic search queue under **AI Cloud Suite > Semantic Queue** in the WordPress admin panel.

= Are there any web API endpoints available to build a custom app? =
Yes. REST API endpoints are available. See full docs:
[https://visualwebs.eu/docs/plugin/ai-cloud-suite/](https://visualwebs.eu/docs/plugin/ai-cloud-suite/)

= What is the Integration Token and how do I use it? =
The Integration Token is used by SaaS to send SmartPricing predictions to your WordPress store.
Generate it in **AI Cloud Suite > Integration Token** and paste it into your SaaS Dashboard.

= How do I generate feeds manually? =
Use **AI Cloud Suite > Feed Generation** in WP Admin.
For automation and CLI workflows, see:
[https://visualwebs.eu/docs/plugin/ai-cloud-suite/](https://visualwebs.eu/docs/plugin/ai-cloud-suite/)

= How do I access feed data via REST API? =
Feed endpoints are available via REST API and require `X-Store-API-Key` authentication.
See endpoint list and examples in docs:
[https://visualwebs.eu/docs/plugin/ai-cloud-suite/](https://visualwebs.eu/docs/plugin/ai-cloud-suite/)

= Are the feed endpoints secure? =
Yes. Feed endpoints are private and require `X-Store-API-Key` authentication.

== Screenshots ==
1. **SaaS Login**: The centralized cloud service login page
2. **Dashboard Overview**: A dashboard with a summary of machine learning tools.
3. **Bestsellers predictions**: Forecast top-selling products from historical sales data.
4. **Machine Learning Widgets**: Predictive analytics in your dashboard.
5. **Sales forecast**: Predict future sales trends and projected revenue.
6. **Customer registration forecast**: Estimate upcoming customer signups over time.
7. **Sentiment Analysis**: Analyze user sentiment using AI-powered tools.
8. **Spam Analysis**: Detect and classify spam content with machine learning.
9. **Single Semantic Search Item Management**: Manage individual chatbot knowledge items. You can edit, lock, or attach documents (PDF, DOC, or text files) to each item.
10. **Chatbot Integration**: A customizable chatbot embedded on your site.
11. **Chatbot Conversations**: Review chatbot conversation history and generated responses.
12. **SmartPricing AI**: Enable automatic price updates, set system-wide auto-replacement of prices, and configure minimum/maximum profit margins.
13. **Events log**: Track integration and workflow events processed by the plugin.
14. **SOS Inventory stock sync**: Monitor stock synchronization between WooCommerce and SOS Inventory.
15. **SOS Inventory sales sync**: Track sales order synchronization and status updates with SOS Inventory.

== Changelog ==
= 5.7.4 =
* Improved: Simplified the public readme by removing the dedicated WP-CLI commands section and keeping advanced automation guidance in external documentation.

= 5.7.3 =
* Added: Product, page, and blog feeds now export SEO contract fields for SaaS ingestion (`seo_title`, `seo_description`, `seo_slug`, `seo_canonical`, `seo_robots`, `seo_keywords`) with compatibility for Yoast, Rank Math, and AIOSEO metadata.
* Added: Feed image payloads now include image alt metadata (with attachment and fallback resolution) across product, page, and blog feeds for SEO quality checks.
* Improved: Registered Yoast SEO meta keys as REST-writable to support programmatic SEO metadata updates via WordPress REST API.

= 5.7.2 =
* Improved: Product feed now normalizes `stock_qty` when WooCommerce stock management is disabled, emitting `0` instead of `null` for a deterministic numeric contract.

= 5.7.1 =
* Fixed: Page feed now syncs only WordPress pages, preventing duplicate posts from appearing in semantic search.
* Fixed: Shopify page feed now includes only pages, leaving blog articles to the blog sync pipeline.

= 5.6.7 =
* Fixed: Resolved Composer autoload fatal error caused by missing packaged dependencies in vendor.
* Improved: Release packaging now includes required Composer libraries (phpoffice, smalot, symfony polyfills).

= 5.7.0 =
* Added: Blog feed generation for SaaS sync with WP-CLI, cron scheduling, and authenticated REST access.
* Added: `wp visualwebs-ml generate-blog-feed` command and `wp visualwebs-ml generate-all-feeds` now includes blog.
* Improved: Blog feed contract now exports `blog_items` for the SaaS worker and Shopify GraphQL parity.

= 5.6.6 =
* Improved: Updated screenshot descriptions for the marketplace listing and completed missing captions.
* Improved: Corrected screenshot numbering/order in readme documentation.

= 5.6.5 =
* Improved: Packaging-only release to keep SVN tag history clean after 5.6.4 tag maintenance cleanup.

= 5.6.4 =
* Improved: Updated the demo YouTube video link in plugin description.
* Improved: Prepared release packaging with stable tag 5.6.4.

= 5.6.3 =
* Improved: Updated plugin metadata for WordPress 7.0 compatibility.
* Improved: Prepared release packaging with stable tag 5.6.3.

= 5.6.2 =
* Improved: Documentation wording for SOS Inventory integration (existing feature) covering stock and order sync.
* Improved: Bumped stable tag to 5.6.2 for release packaging.

= 5.6.1 =
* Added: Clarified free account availability in plugin documentation and installation/FAQ sections.
* Added: SOS inventory integration support for stock sync and order sync workflows (available on Pro and Enterprise plans).

= 5.6.0 =
* Added: `created_at` field added to page feed (posts and pages) for consistent feed contract across all commerce platforms.

= 5.5.9 =
* Fix: Added centralized WooCommerce workflow-event deduplication so bursty hooks for the same entity emit a single SaaS event within a 5-second dedupe window.
* Fix: Added the missing translators comment for the HTTP status error message shown by the SaaS connection test.
* Improved: Normalized declared WordPress compatibility to 6.9.

= 5.5.8 =
* Added: Configuration UI now includes a "Test Connection" button to validate SaaS access with API key and Store ID before saving.
* Improved: Declared compatibility updated to WordPress 6.9.

= 5.5.7 =
* Improved: Feed Generation admin page now shows a warning when service is disabled and prevents manual feed runs until re-enabled.
* Improved: Dashboard configuration summary now displays explicit Visualwebs ML Services status (Enabled/Disabled).

= 5.5.6 =
* Improved: Unified feed generation guards so all feeds skip when Visualwebs ML services are disabled.
* Improved: Product, page, and insights feeds now follow the same global service-enabled check strategy as sales feed.

= 5.5.5 =
* Fix: Added explicit translator-comment handling for placeholder i18n strings in unified REST endpoints
* Fix: Resolved WordPress coding standards checker errors (MissingTranslatorsComment)

= 5.5.4 =
* Refactor: Unified REST API routes under a single endpoints controller
* Security: Centralized shared check_permissions token validation for SaaS REST endpoints
* Improved: Reduced duplicated REST route and permission logic in main plugin class

= 5.5.3 =
* Improved: Removed unused methods and dead code from vendor helpers and model classes

= 5.5.2 =
* 🔒 Security: Feed REST API endpoints now require X-Store-API-Key authentication (CRITICAL)
* 🔒 Security: All feed endpoints are private by default - prevents unauthorized data discovery
* 🔒 Security: Product, sales, pages, and insights feeds protected against scraping and public access
* New: WP-CLI commands for feed generation automation - perfect for CI/CD pipelines and scheduled tasks
* New: `wp visualwebs-ml generate-product-feed` command - generates product catalog feed for semantic search
* New: `wp visualwebs-ml generate-page-feed` command - generates content feed for chatbot knowledge base
* New: `wp visualwebs-ml generate-sales-feed` command - generates sales data for SmartPricing AI training
* New: `wp visualwebs-ml generate-insights-feed` command - generates KPI feed for SaaS dashboard
* New: `wp visualwebs-ml generate-all-feeds` command for bulk generation of all feeds at once
* Improved: Feed generation system now accessible via three methods: CLI, admin buttons, and automated cron jobs
* Improved: Better integration with system cron when DISABLE_WP_CRON is enabled
* Documentation: Added comprehensive WP-CLI Commands section with usage examples
* Documentation: Added FAQ section for feed generation, REST API endpoints, and security

= 5.5.1 =
* New: SmartPricing import REST API endpoint (/wp-json/visualwebs-ml/v1/pricing/import)
* New: Integration token support for SaaS predictions import
* New: SmartPricing helper class for price application logic
* Fix: Platform compatibility with SaaS worker (X-Store-Token header)
* Fix: Full feature parity with Magento module restored
* Improved: Elementor shortcode rendering in product and page feeds
* Improved: Optimized feed generation methods to avoid data duplication (cleaner JSON structure)
* Improved: Removed unused Composer dependencies reducing plugin size by 77k+ lines

= 5.5.0 =
* Major Update: Migrated to SaaS architecture (matches Magento module functionality)
* New: n8n workflow integration with event system (order events, customer events, product events)
* New: Product feed generator with hourly cron job for semantic search sync
* New: Page feed generator with daily cron job
* New: Sales feed generator for SmartPricing AI training data
* New: Insights feed generator (`insights_feed.json`) for dashboard widgets
* New: Manual feed generation buttons in admin panel
* New: Chatbot admin/backend integration with secure admin endpoint (capability + nonce)
* Security: GDPR-compliant payload anonymization for workflows
* Improved: Simplified admin interface (dashboard + settings + feed generation)
* Deprecated: Database table access methods (use SaaS API instead)
* Deprecated: Semantic search and dynamic pricing queue grid classes (use SaaS dashboard)
* Performance: Removed legacy cron jobs and unused local processing paths

= 5.4.3 =
* Added English/Spanish translation support for widgets and dashboard.
= 5.4.2 =
* Improved: Simplified chatbot security to ensure compatibility with caching plugins and language translators. Security checks are now handled by our remote service, which uses a license-based rate limiter for protection.
= 5.4.1 =
* New feature: Track SmartPricing AI training results together with prediction jobs for improved monitoring and transparency.
= 5.4.0 =
* New feature: AI-powered dynamic pricing to help you set the best product sale price and maximize WooCommerce profits.
* New feature: Bulk append products, categories, or pages for faster AI processing and management.
* New feature: Attach PDF, DOC, or text files to each semantic search item. Uploaded files are added to the chatbot's knowledge base.
= 5.3.0 =
* Removed the minimum data requirement for Spam and Sentiment Analysis widgets. These can now display results even with just one review, without needing to train a model.
= 5.2.0 =
* Initial release.

== License ==
This plugin is licensed under the GPLv2 or later. See the [GNU General Public License](https://www.gnu.org/licenses/gpl-2.0.html) for details.

== Documentation ==
[Documentation](https://visualwebs.eu/docs/plugin/ai-cloud-suite/)

== Upgrade Notice ==
= 5.7.4 =
Readme simplification update: removed the dedicated WP-CLI section from the public listing and moved advanced command documentation to our docs site.

= 5.7.3 =
SEO feed update: Product, page, and blog feeds now include SEO fields and image alt metadata, with Yoast/Rank Math/AIOSEO compatibility improvements. Recommended update for stores using SEO-driven content sync.

= 5.7.2 =
Feed contract update: Product `stock_qty` is now normalized to `0` when WooCommerce stock management is disabled.

= 5.6.6 =
Documentation update: refreshed screenshot captions and fixed screenshot numbering in the plugin listing.

= 5.6.5 =
Packaging-only release: no functional changes, published to keep release history clean after 5.6.4 tag cleanup.

= 5.6.4 =
Maintenance release: updated the demo YouTube link in plugin description and bumped release version.

= 5.6.3 =
Metadata release: updated compatibility to WordPress 7.0 and bumped the release version.

= 5.6.2 =
Documentation-only release: clarified SOS Inventory wording and prepared minimum version bump for publishing.

= 5.6.1 =
Documentation and integration update: clarified free account availability and added SOS inventory stock + order sync support for Pro and Enterprise plans.

= 5.5.7 =
Admin UX update: Feed Generation now warns when service is disabled, and Dashboard shows explicit service status in configuration summary.

= 5.5.6 =
Unified feed generation guards: all feed generators now skip execution when AI Cloud services are disabled.

= 5.5.5 =
Minor quality release to resolve WordPress i18n checker warnings in REST endpoint strings.

= 5.5.4 =
Internal REST API refactor and centralized endpoint permission checks.

= 5.5.3 =
Code cleanup: removed unused methods. No functional changes.

= 5.5.2 =
CRITICAL SECURITY UPDATE: Feed REST API endpoints now require authentication. Update immediately to protect your store data from unauthorized access.

= 5.5.0 =
Disable plugin and re-enable to install the new smartpricing AI feature