=== RankHigh – AI Product Description Generator for WooCommerce ===
Contributors:       rankhighseo
Tags:               woocommerce, ai, product descriptions, openai, seo
Requires at least:  6.0
Tested up to:       7.0
Requires PHP:       8.0
Requires Plugins:   woocommerce
Stable tag:         1.0.0
WC requires at least: 7.0
WC tested up to:    9.0
License:            GPLv2 or later
License URI:        https://www.gnu.org/licenses/gpl-2.0.html

Auto-generate SEO-friendly WooCommerce product descriptions using OpenAI, Gemini, or OpenRouter. Single or bulk — 100% free.

== Description ==

**Stop writing product descriptions by hand.**

RankHigh – AI Product Description Generator for WooCommerce connects your store to OpenAI, Google Gemini, or OpenRouter and writes professional, SEO-friendly product descriptions in seconds — based on the product title, categories, attributes, and tags you already have.

This plugin is completely free. Bring your own API key from any supported provider and generate unlimited descriptions.

**Key Features**

* ✨ **One-click generation** — "Generate with AI" button inside every product edit screen
* 📦 **Bulk generator** — select dozens of products and batch-generate with a real-time progress bar
* 🎯 **SEO-aware** — automatically reads the Yoast SEO / RankMath focus keyword and weaves it into the copy
* 🌍 **8 languages** — English, Spanish, French, German, Italian, Portuguese, Dutch, Arabic
* 🎨 **5 tones** — Professional, Friendly, Luxury, Playful, Technical
* 📝 **Both fields** — generates the full description AND the WooCommerce short description
* 🤖 **3 AI providers** — OpenAI, Google Gemini, and OpenRouter (300+ models)
* ⚡ **Model choice** — GPT-4o, Gemini 2.0 Flash, Claude 3.5 Sonnet, and more
* 🔐 **HPOS compatible** — works with WooCommerce High Performance Order Storage
* 🆓 **100% free** — no limits, no license keys, no upsells

**How it Works**

1. Install and activate the plugin
2. Go to **WooCommerce → AI Descriptions → Settings** and choose your AI provider
3. Paste your API key (OpenAI, Gemini, or OpenRouter)
4. Edit any product — click **✨ Generate Description** in the sidebar
5. Preview the result and click **Apply to Product**
6. Save the product as normal

**Bulk Generation**

Go to **WooCommerce → Bulk Generate**, select as many products as you like, and hit generate. The plugin processes them in background batches (5 at a time via WP-Cron) so you never hit PHP timeouts. A live progress bar keeps you updated.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate through **Plugins → Installed Plugins**
3. Go to **WooCommerce → AI Descriptions → Settings**
4. Choose your AI provider and enter your API key
5. Start generating!

== Frequently Asked Questions ==

= Which AI providers are supported? =
OpenAI (GPT-4o, GPT-4o Mini, GPT-3.5 Turbo), Google Gemini (2.0 Flash, 1.5 Pro, 1.5 Flash), and OpenRouter (300+ models including Claude, Llama, Mistral).

= Do I need an API account? =
Yes — you need an API key from your chosen provider. New OpenAI accounts include free credits. Gemini offers a generous free tier. OpenRouter has free-tier models available.

= How much does each generation cost? =
This plugin is free. You only pay for AI API usage directly to your provider. Using GPT-4o Mini, a typical product description costs around $0.001–$0.003. Gemini 2.0 Flash is similarly priced.

= Will it overwrite my existing descriptions? =
In single-product mode you see a preview first and click "Apply" to confirm. In bulk mode, descriptions are written automatically — you are shown a warning before starting.

= Does it work with Yoast SEO / RankMath? =
Yes — the plugin reads the focus keyword from both plugins and includes it naturally in the generated copy.

= Is the plugin GDPR compliant? =
Product data (title, category, attributes) is sent to your chosen AI provider. No customer personal data is sent. Review each provider's data policy before use.

= Can I change the writing tone per product? =
Yes — there is a Tone selector directly on the product edit page that overrides the global default for that single generation.

== Screenshots ==

1. The AI Generate button inside a WooCommerce product edit page
2. Generated content preview with Apply / Regenerate actions
3. Bulk Generator with real-time progress bar
4. Settings page — provider selection, API keys, model, tone, language

== External Services ==

This plugin sends product data (title, categories, attributes, tags) to third-party AI APIs in order to generate descriptions. No customer personal data is ever transmitted. The specific service used depends on the provider you choose in Settings:

**OpenAI**
* Service URL: https://api.openai.com
* Used when: Provider is set to "OpenAI"
* Data sent: Product title, category, attributes, tags, focus keyword
* Terms of Service: https://openai.com/policies/row-terms-of-use
* Privacy Policy: https://openai.com/policies/privacy-policy

**Google Gemini**
* Service URL: https://generativelanguage.googleapis.com
* Used when: Provider is set to "Gemini"
* Data sent: Product title, category, attributes, tags, focus keyword
* Terms of Service: https://ai.google.dev/gemini-api/terms
* Privacy Policy: https://policies.google.com/privacy

**OpenRouter**
* Service URL: https://openrouter.ai
* Used when: Provider is set to "OpenRouter"
* Data sent: Product title, category, attributes, tags, focus keyword
* Terms of Service: https://openrouter.ai/terms
* Privacy Policy: https://openrouter.ai/privacy

You must supply your own API key for the chosen provider. The plugin makes no API calls unless an API key is configured and a generation is explicitly triggered by a store administrator.

== Changelog ==

= 1.0.0 =
* Initial release
* Single-product generation with preview
* Bulk generator with WP-Cron batching
* OpenAI, Google Gemini, and OpenRouter support
* 5 tones, 8 languages
* Yoast SEO and RankMath focus keyword integration
* 100% free — unlimited generations with your own API key

== Upgrade Notice ==

= 1.0.0 =
Initial release — no upgrade steps required.
