=== Quickify AI for WooCommerce ===
Contributors: hadom
Tags: woocommerce, ai, product description, openai, claude
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered WooCommerce toolkit that generates product descriptions, short descriptions, and SEO meta — in one click.

== Description ==

**Stop writing product descriptions manually.** Quickify AI generates SEO-optimized descriptions, short descriptions, and meta fields for your entire WooCommerce catalog — powered by Anthropic Claude or OpenAI GPT.

Whether you have 10 products or 10,000, Quickify AI saves you hours of writing. Just click "Generate" and get a professional, ready-to-publish description in seconds.

= Why Quickify AI? =

* **Vision AI** — the plugin analyzes your product images and writes descriptions based on what it sees (colors, materials, details)
* **SEO built-in** — auto-generates meta title (60 chars) and meta description (155 chars) for Yoast SEO and Rank Math
* **Bulk Generator** — generate descriptions for hundreds of products in one session with real-time progress tracking
* **Review before publishing** — preview, edit, regenerate, or accept each description before it goes live
* **History & Rollback** — keeps last 5 versions per product, restore any with one click

= Full Feature List =

* One-click AI description generation from product editor
* Vision API — AI analyzes product images (Basic and Detailed modes)
* Short description generation
* SEO meta title and description (Yoast SEO & Rank Math)
* Bulk Generator page with filters, progress bar, and inline editing
* AI Status column in products list
* Per-product vision mode override
* Gutenberg sidebar panel + Classic Editor metabox
* WP-CLI commands: generate, bulk, status, reset, test
* Two AI providers: Anthropic Claude and OpenAI GPT
* 15 output languages, 5 writing tones
* Customizable prompt template with 8 placeholders
* API keys encrypted at rest (AES-256-CBC)
* HPOS compatible, variable product support

= How It Works =

1. Install the plugin and enter your API key in Quickify AI > Settings.
2. Open any product. Find the "AI Description Generator" metabox in the sidebar.
3. Check the options you want (short description, SEO meta) and click "Generate Description".
4. Preview the result. Edit if needed, then click "Accept" to apply.
5. Or use the Bulk Generator to process your entire catalog at once.

== Installation ==

1. Upload the `quickify-ai` folder to `/wp-content/plugins/`.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Go to WooCommerce > Quickify AI and enter your API key.
4. Choose your preferred language, tone, and description length.
5. Open any product and click "Generate Description" in the sidebar metabox.

**Requirements:**

* WordPress 6.0 or higher
* WooCommerce 7.0 or higher
* PHP 7.4 or higher
* An API key from Anthropic or OpenAI

== Frequently Asked Questions ==

= Do I need my own API key? =

Yes. You need an active API key from either Anthropic (for Claude) or OpenAI (for GPT). The plugin does not include any API credits. You can get your key from [console.anthropic.com](https://console.anthropic.com/settings/keys) or [platform.openai.com](https://platform.openai.com/api-keys).

= How much does the API cost? =

Each product description costs approximately $0.003–$0.01 depending on the provider, model, and description length. Generating 1,000 descriptions would cost roughly $3–$10 total.

= Which languages are supported? =

The plugin supports 15 languages: English, Ukrainian, Russian, German, French, Spanish, Italian, Portuguese, Polish, Dutch, Czech, Turkish, Japanese, Chinese, and Korean.

= Does it work with variable products? =

Yes. For variable products, the plugin automatically collects all variation data (attributes and prices) and includes them in the prompt so the AI can write a comprehensive description covering all options.

= Which AI provider should I choose? =

Both providers produce high-quality descriptions. Anthropic Claude tends to follow instructions more precisely, while OpenAI GPT is widely used and well-documented. Try both with the "Test Connection" button and see which output you prefer.

= Are my API keys stored securely? =

Yes. All API keys are encrypted using AES-256-CBC before being stored in the database. They are never exposed in HTML source or JavaScript.

= Can I customize the prompt? =

Yes. Go to WooCommerce > Quickify AI > Generation Settings. You can edit the prompt template using placeholders like {title}, {categories}, {attributes}, {price}, {sku}, {language}, {tone}, and {length}.

= Does it support Vision (image analysis)? =

Yes. Enable Vision API in settings to let AI analyze product images. Choose Basic (general visual overview) or Detailed (full analysis of colors, materials, textures, accessories). You can also override the vision mode per product.

= Does it work with Gutenberg? =

Yes. The plugin provides a full-featured sidebar panel in the block editor with all the same features as the Classic Editor metabox.

= Does it integrate with SEO plugins? =

Yes. When enabled, it auto-generates SEO meta title (max 60 chars) and meta description (max 155 chars) and saves them to Yoast SEO or Rank Math.

= Are there WP-CLI commands? =

Yes. Available commands: wp qfai generate, wp qfai bulk, wp qfai status, wp qfai reset, wp qfai test.

== Screenshots ==

1. Settings page — choose your AI provider, configure language, tone, vision mode, and prompt template.
2. Product editor metabox — one-click generation with options for short description and SEO meta.
3. Generation result — full description, SEO meta title with character count, and meta description with Accept/Regenerate/Edit actions.
4. Bulk Generator — select products, configure generation settings, and process your entire catalog at once.
5. Frontend result — AI-generated description and short description displayed on the product page.

== Changelog ==

= 1.1.0 =
* Vision API — analyze product images for richer descriptions (off/basic/detailed modes).
* Per-product vision mode override in product editor.
* Gutenberg sidebar panel — full feature parity with Classic Editor.
* Yoast SEO and Rank Math integration — auto-generate meta title and description.
* Short description generation with checkbox control.
* History and rollback — keep last 5 generations, restore with one click.
* WP-CLI commands: generate, bulk, status, reset, test.
* Image optimization — auto-resize large images before sending to API.
* Vision image hash caching — skip redundant image analysis.
* Improved error handling and fallback for vision requests.

= 1.0.0 =
* Initial release.
* Single product description generation via Anthropic Claude or OpenAI GPT.
* Settings page with encrypted API key storage.
* Product editor sidebar metabox with preview workflow.
* Customizable prompt template with 8 placeholders.
* 15 output languages and 5 writing tones.
* Variable product support with variation details.
* HPOS (High-Performance Order Storage) compatibility.
* Clean uninstall removing all plugin data.

== External services ==

This plugin connects to external AI services to generate product content.
The plugin sends product data (title, categories, attributes, price)
to the selected AI provider when you click "Generate" or run bulk generation.

= Anthropic (Claude API) =
Used when "Anthropic (Claude)" is selected as AI provider.
* Service URL: https://api.anthropic.com/v1/messages
* Terms of Service: https://www.anthropic.com/terms
* Privacy Policy: https://www.anthropic.com/privacy

= OpenAI (GPT API) =
Used when "OpenAI (GPT)" is selected as AI provider.
* Service URL: https://api.openai.com/v1/chat/completions
* Terms of Use: https://openai.com/terms/
* Privacy Policy: https://openai.com/privacy/

No data is sent to any external service without the user explicitly
configuring an API key and triggering a generation action.
