=== WalkRay AI - Product Listing Optimizer ===
Plugin URI: https://walkray.com/
Contributors: taoye003
Tags: woocommerce, ai, seo, product description, deepseek
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.2.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered WooCommerce product listing generator. One-click SEO descriptions, Schema, ALT text, readability audits. DeepSeek & OpenAI.

== Description ==

WalkRay AI supercharges your WooCommerce store with AI-powered product listing tools. Stop spending hours on product content — let AI handle descriptions, SEO audits, Schema, and ALT text in seconds.

= Features =

* **One-Click AI Generation** Generate complete product listings (short description, full description, SEO title, Meta description, tags) with a single click.
* **SEO Audit & Readability Scoring** AI scores your product content 0-100. Checks sentence length, paragraph density, keyword usage, and readability with specific fix suggestions.
* **JSON-LD Schema Generator** One-click Product Schema markup for Google Rich Results (price, stock, rating).
* **ALT Text Generator** AI scans product images and generates descriptive, SEO-friendly ALT text for Google Images ranking.
* **Multi-API Support** Choose between DeepSeek (domestic China, no VPN), OpenAI, or custom API endpoint.
* **Multi-Language** Generate in 6+ languages: English, Chinese, German, Japanese, French, Spanish.
* **Clean Sidebar UI** Non-intrusive meta box on the product edit page with tabbed results.
* **Usage Tracking** Built-in monthly usage meter. 5 free generations per month.

= Free Plan =

* 5 AI generations per month
* DeepSeek / OpenAI / Custom API
* Product description generation
* SEO Audit (1/month)
* ALT text and Schema generation

= WalkRay Pro ($39/year) =

Upgrade at [walkray.com](https://walkray.com/) for:
* Unlimited generations
* 10+ languages
* AI keyword research
* Competitor analysis
* Bulk generation
* Priority email support

== Installation ==

1. Upload the `walkray-listing-ai` folder to `/wp-content/plugins/`.
2. Activate the plugin through the "Plugins" menu.
3. Go to **WalkRay AI Settings**, choose your API provider (DeepSeek/OpenAI/Custom), enter your API key.
4. Edit any WooCommerce product and start generating!

= API Keys =

* **DeepSeek** (no VPN needed in China): Register at [platform.deepseek.com](https://platform.deepseek.com/api_keys) ~$0.14/1M tokens
* **OpenAI**: Register at [platform.openai.com](https://platform.openai.com/api-keys)

== Frequently Asked Questions ==

= Do I need an API key? =

Yes. You bring your own API key (DeepSeek or OpenAI). Your key is stored securely in your WordPress database and never shared.

= Which is cheaper, DeepSeek or OpenAI? =

DeepSeek is significantly cheaper (~$0.14/1M tokens vs $0.15-$0.60 for OpenAI). For Chinese users, DeepSeek also doesn't require VPN.

= What happens when I reach the free limit? =

Your usage resets on the first of each month. Upgrade to WalkRay Pro for unlimited generations.

== Screenshots ==

1. The WalkRay AI meta box with Generate, Audit, Schema, and ALT buttons.
2. AI-generated product listing with tabbed results and Insert buttons.
3. SEO Audit results showing score and improvement suggestions.
4. Settings page with API provider selector (DeepSeek/OpenAI/Custom).

== Changelog ==

= 1.2.10 =
* FIX: Optimize SEO button not responding due to missing JS cache entries
* FIX: WALKRAY_VERSION mismatch with plugin header

= 1.2.0 =
* NEW: SEO Rewrite engine - AI rewrites existing descriptions for Yoast green-light compliance
* NEW: Optimize SEO button on product edit page
* IMPROVED: Enhanced prompt engineering with 9 Yoast SEO rules (sentence length, transition words, active voice, internal links)
* IMPROVED: Primary keyword placement in first paragraph
* IMPROVED: Automatic H2/H3 subheading with keyphrase

= 1.1.0 =
* NEW: SEO Audit & Readability scoring engine (0-100 score with fix suggestions)
* NEW: JSON-LD Product Schema generator
* NEW: ALT text generator for product images
* NEW: API Provider selector DeepSeek, OpenAI, or Custom endpoint
* NEW: DeepSeek native support (domestic China, no VPN required)
* IMPROVED: Better prompt engineering for shorter sentences and paragraphs
* IMPROVED: Tabbed results UI with Insert buttons per field

= 1.0.0 =
* Initial release
* AI-powered product description generation
* GPT-4o and GPT-4o Mini support
* Monthly usage tracking
* Pro upgrade prompts

== Upgrade Notice ==

= 1.2.10 =
* FIX: Optimize SEO button not responding due to missing JS cache entries
* FIX: WALKRAY_VERSION mismatch with plugin header

= 1.2.0 =
SEO Rewrite engine, Yoast green-light optimization, improved prompt engineering.

= 1.1.0 =
Major update! Now with SEO Audit, Schema generator, ALT text, and DeepSeek support.

= 1.0.0 =
Initial release.

== Third-Party Services ==

This plugin connects to external AI API services to generate product descriptions.

**OpenAI**
* API Endpoint: https://api.openai.com/v1/chat/completions
* Terms of Service: https://openai.com/policies/terms-of-use
* Privacy Policy: https://openai.com/policies/privacy-policy

**DeepSeek**
* API Endpoint: https://api.deepseek.com/v1/chat/completions
* Terms of Service: https://platform.deepseek.com/policies/terms
* Privacy Policy: https://platform.deepseek.com/policies/privacy