=== CopySpell AI ===
Contributors: actusanima
Donate link: https://copyspell.ai
Tags: woocommerce, ai, product descriptions, free ai, content generation
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 2.0.6
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The only WooCommerce AI plugin that works 100% FREE. No paid subscriptions. Just free API keys + Smart AI Routing™ = unlimited product descriptions.

== Description ==

= 🎉 Premium Quality AI Content - Zero AI Subscription Fees =

**Create stunning, professional product content from minimal input.**
CopySpell AI uses an advanced prompting engine that transforms even simple text into polished, high-converting product descriptions, titles, and SEO-optimized copy.

And the best part? **No AI subscription required.** CopySpell AI delivers premium results while working entirely on **free API** tiers from Google AI Studio, Groq, OpenRouter, and more.

Simply get your **free API keys** (takes 2 minutes), and our exclusive **Smart AI Routing™** technology handles everything else. No credit card. No subscriptions. No limits on what you can create.

= How Is This Possible? =

Our **Smart AI Routing™** technology is the secret. When you make a request:

1. CopySpell AI intelligently routes your request through multiple free AI models
2. If one model hits its free-tier limit, it automatically switches to the next available model
3. The system keeps trying until it delivers a quality response
4. You get premium AI-generated content without paying a cent for AI services

**Result:** Reliable, high-quality content generation using only free API tiers.

You can always use your paid API keys for access to more models.


= ✨ Advanced Prompting Engine =

CopySpell AI doesn't just send your product data to an AI and hope for the best. Behind every generation is our **sophisticated prompting engine** – a professional-grade system that transforms your preferences into expertly crafted instructions.


Our server collects your product data and preferences (audience, tone, priorities, keywords) and constructs **premium prompts** with rich, detailed descriptions that help AI models truly understand your intent:

* **50+ Audience Types** – Each with psychological profiles, buying behaviors, and communication preferences
* **20+ Writing Tones** – From "luxurious and exclusive" to "playful and energetic" – each precisely defined
* **Marketing Frameworks** – AIDA, PAS, Benefit-driven – implemented with proven copywriting principles
* **Content Priorities** – SEO optimization, emotional appeal, technical accuracy – each with specific instructions

**The Result:** Compelling, conversion-focused content that:

* Highlights product benefits, not just features
* Incorporates your target SEO keywords naturally
* Matches your brand's unique voice and tone
* Speaks directly to your target audience
* Formats beautifully with headers, bullet points, and emphasis

This isn't simple prompt templating – it's a professional system developed through extensive testing. The AI understands e-commerce psychology and writes copy that **actually sells**.

= 🎯 Intelligent Refinement Suggestions =

Want to customize the generated content? CopySpell AI offers **AI-powered refinement suggestions** that are remarkably intelligent and to-the-point:

* Get specific suggestions to improve your content
* One-click refinements like *"Add a question to engage the reader about their current hydration habits and how [our product] can improve them."*
* The AI analyzes your content and suggests exactly what could make it better
* Iterate until your description is perfect

This isn't generic "regenerate" functionality – these are **contextual, intelligent suggestions** that understand what your content needs.

= Key Features =

**🆓 Free AI – Smart AI Routing™**
Our proprietary technology automatically rotates through available AI models to ensure you always get a response. When one model hits rate limits, the system seamlessly switches to another. No paid subscriptions required – ever.

**✍️ Single Product Editor**
Generate content directly from the WooCommerce product edit screen. One-click generation for product descriptions, excerpts, and titles with instant preview.

**🎯 Advanced Customization**
Fine-tune your content with:

* **Target Audience Selection** – Gen Z, Millennials, Professionals, Parents, and 50+ audience types
* **Writing Tone** – Informative, Persuasive, Playful, Luxurious, Technical, and more
* **Content Priorities**
* **Marketing Frameworks**
* **Content Length**
* **Multi-language Support**

**📱 Complete Marketing Content Suite**
Go beyond product descriptions. Generate ready-to-publish marketing materials:

*Social Media Posts:*

* Facebook posts with engagement hooks
* Instagram captions with hashtag suggestions
* LinkedIn professional content
* Twitter/X threads and tweets

*Advertisement Copy:*

* Facebook & Instagram Ads
* Google Search & Display Ads
* YouTube video ad scripts
* TikTok and Pinterest Ads

*Email & Blog:*

* Email newsletter content
* Blog post drafts
* Product announcement emails

Each marketing piece is **tailored to the platform** – Instagram content feels different from LinkedIn, and ad copy follows platform-specific best practices.

**🚀 True Background Bulk Processing**
Process your entire product catalog without lifting a finger. CopySpell AI uses WordPress Action Scheduler to run bulk generation **completely in the background**:

* Start a bulk job and close your browser – it keeps running
* Your website stays fast – processing happens asynchronously
* Process hundreds of products overnight
* Select products by category, tags, date range, or custom criteria

**📊 Job Management Dashboard**
Full visibility into your bulk operations:

* Real-time progress tracking
* View completed, running, and queued jobs
* Detailed error reporting
* Review and approve content before publishing

**📝 Content History & Revisions**
Never lose your work! CopySpell AI maintains a **complete history of all generated content**:

* Every generation is saved automatically
* Compare different versions
* Publish any previous revision with one click
* Track how your content evolves over time
* Perfect for A/B testing different approaches



= How It Works =

1. **Get Free API Keys** – Takes 2 minutes at Google AI Studio, OpenRouter, or Groq Console
2. **Configure** – Add your keys and set your brand preferences
3. **Generate** – One product or thousands – Smart AI Routing™ handles it all
4. **Refine** – Use intelligent suggestions to perfect your content
5. **Publish** – Review, approve, and publish with confidence

= Perfect For =

* **Budget-conscious store owners** who don't want AI subscription fees
* **Large catalogs** needing hundreds or thousands of descriptions
* **Dropshipping businesses** requiring quick, quality content
* **Marketing agencies** managing multiple e-commerce clients
* **Anyone** who wants professional copy without the cost

= Free & Pro Plugin Versions =

**✦ CopySpell AI Free:**

* 50 credits per month for AI generation requests
* Full access to Smart AI Routing™ technology
* Works with free API keys from several providers
* Perfect for small stores or evaluating the plugin

**✦ CopySpell AI Pro:**

* Unlimited credits – no limits
* Priority support
* Ideal for large catalogs, agencies, and power users

*- Both versions work beautifully with free AI API tiers – you never need a paid AI subscription!*
*- If you want access to specific AI models, and faster response times, you can use your paid API keys.*

= Requirements =

* WordPress 5.8 or higher
* WooCommerce 5.0 or higher
* PHP 7.4 or higher
* Free or paid API key from AI provider

== Installation ==

= Automatic Installation =

1. Go to **Plugins > Add New** in your WordPress admin
2. Search for "CopySpell AI"
3. Click **Install Now** and then **Activate**
4. Navigate to **CopySpell AI** in your admin menu to configure

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins > Add New > Upload Plugin**
3. Select the ZIP file and click **Install Now**
4. Activate the plugin
5. Go to **CopySpell AI** settings to configure your API keys

= Configuration =

1. **Get Your API Keys**
   * Google Gemini: Visit [Google AI Studio](https://aistudio.google.com/) to get a free API key
   * Groq: Visit [Groq Console](https://console.groq.com/) for a free API key

2. **Enter API Keys**
   * Go to CopySpell AI > Settings
   * Add your API keys in the respective fields
   * Click "Validate" to verify each key

3. **Set Your Preferences**
   * Configure your default brand tone
   * Set preferred content length
   * Choose your target audience defaults

4. **Start Generating**
   * Go to any WooCommerce product edit page and click "CopySpell AI"
   * Or use Bulk Generation to process multiple products at once

== Frequently Asked Questions ==

= Is this really free? No hidden costs? =

**Yes!** CopySpell AI can work with free API keys from Google and Groq. There are no premium tiers, no monthly subscriptions. Our Smart AI Routing™ technology maximizes your free API usage by intelligently switching between models.

= How is CopySpell AI different from other AI plugins? =

Other plugins require paid AI subscriptions (ChatGPT Plus, Claude Pro, etc.) or charge you per generation. CopySpell AI is the **only plugin** that works entirely on free API tiers thanks to our Smart AI Routing™ technology. Plus, we offer intelligent refinement suggestions, marketing tools, full content history, and true background bulk processing.

= What is Smart AI Routing™? =

It's our proprietary technology that automatically routes your requests through multiple free AI models. If Google Gemini hits its rate limit, it tries Groq. If that's busy, it tries another model. The system keeps cycling until you get a quality response – all using free tiers.

= Do I need to pay for AI services? =

**No!** Get free API keys from:
* **Google AI Studio** (aistudio.google.com) – Free Gemini API access
* **Groq Console** (console.groq.com) – Free access to multiple fast models

Both take about 2 minutes to set up. No credit card required.

= How many products can I process? =

**Unlimited.** Bulk processing runs in the background using WordPress Action Scheduler. Start a job with 10,000 products, close your browser, and come back later – it keeps running. The system processes in batches to respect API rate limits while maximizing throughput.

= Will bulk processing slow down my website? =

**Not at all.** Background processing is completely asynchronous. Your site visitors won't notice any slowdown. You can even close your browser and the job continues running on your server.

= Can I keep different versions of generated content? =

**Yes!** CopySpell AI automatically saves a complete history of all generated content. Compare versions, restore previous revisions, or track how your descriptions evolved over time. Perfect for A/B testing different approaches.

= What are refinement suggestions? =

After generating content, CopySpell AI offers intelligent, contextual suggestions to improve it. These aren't generic options – the AI analyzes your specific content and suggests targeted improvements like "emphasize the eco-friendly aspect" or "add more urgency." One click applies the refinement.

= Can I generate marketing content too? =

**Absolutely!** Generate platform-specific content for:
* Social media (Facebook, Instagram, LinkedIn, Twitter)
* Advertisements (Facebook Ads, Google Ads, YouTube, TikTok)
* Email newsletters and blog posts

Each piece is tailored to the platform's best practices and audience expectations.

= What languages are supported? =

Generate content in 30+ languages including English, Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean, Arabic, Greek, and many more.

= How does the AI know about my products? =

CopySpell AI reads your product's existing data – title, current description, attributes, categories, tags, price, and images. It uses this information to generate relevant, accurate content. You can also add custom keywords and features.

= Is my data secure? =

**Yes.** Here's exactly what happens:
1. Your API keys are encrypted before storage in your WordPress database
2. When you generate content, your product data is sent to our server
3. Our server calls the AI providers using YOUR keys and returns the response
4. **We do not store any of your product data** – it's processed and immediately discarded
5. We only keep basic logs (domain name, timestamp) for troubleshooting – no content, no personal data

= What happens if all AI models are rate-limited? =

Smart AI Routing™ tries multiple models in sequence. In the rare case all models are temporarily rate-limited, the system waits and retries. For bulk processing, failed items are automatically retried in the next batch.




== Screenshots ==

1. **Smart AI Routing™ in Action** – Automatic model switching ensures you always get a response using free tiers
2. **Bulk Generation** – Select products by category, tags, or custom filters for background processing
3. **AI Settings Panel** – Configure target audience, tone, content length, and marketing framework
4. **Intelligent Refinement** – Context-aware suggestions to perfect your generated content
5. **Product Editor** – One-click AI generation directly from the WooCommerce product edit screen
6. **Marketing Suite** – Generate social posts, ads, emails tailored to each platform
7. **Content History** – Browse, compare, and restore any previous content version
8. **Job Monitor** – Track bulk processing progress in real-time
9. **API Configuration** – Securely store and validate your free API keys



== Changelog ==

= 2.0.4 =
* Added new API providers manager
* refactor and cleanup

= 2.0.3 =
* Added a new Addons Manager
* Database refactor

= 2.0.2 =
* Refactor settings panel
* Minor Fixes

= 2.0.1 =
* Add model selection on Marketing
* Add domain verification
* Minor fixes

= 2.0 =
* Major release with enhanced bulk processing
* Added marketing content generator
* Added History & Revisions
* Improved AI model sequence management
* Enhanced error handling and timeout protection

= 1.4 =
* Fixed client hanging when server restarts during active calls
* Added request timeout protection with AbortController
* Comprehensive error handling for network failures
* Reusable fetch utilities with timeout and retry logic
* User-friendly error messages for connection issues
* Server health check functionality

= 1.3 =
* Added Marketing content generation
* Refactored analysis & analysis UI
* Improved prompts system
* Updated CopySpell button in admin

= 1.2 =
* Updated AI model sequences
* Updated Groq models
* Updated Google AI models
* Improved WordPress font enqueueing
* Enhanced license & API key warnings
* Code cleanup and optimization

= 1.1 =
* Updated Google models
* Added license subscriptions system

= 1.0 =
* Initial release
* Single product AI generation
* Bulk processing with Action Scheduler
* Google Gemini and Groq support
* Customizable prompts and settings
* Multi-language support

== Upgrade Notice ==

= 2.0 =
Major update with marketing content generator and improved reliability. Backup recommended before upgrading.

= 1.4 =
Important stability improvements. Fixes potential hanging issues during AI generation.

== Additional Information ==

= Support =

For support, feature requests, or bug reports, please visit:
* [CopySpell AI Website](https://copyspell.ai)
* [Support Forum](https://wordpress.org/support/plugin/copyspell-ai/)

= Documentation =

Full documentation is available at [copyspell.ai/user-guide](https://copyspell.ai/user-guide)

= Privacy Policy =

* [CopySpell AI Privacy Policy](https://copyspell.ai/privacy-policy/)
* [CopySpell AI Terms of Service](https://copyspell.ai/terms-of-service/)

CopySpell AI is designed with your privacy in mind. Here's exactly how your data is handled:

**How It Works:**
When you generate content, your product data is sent to our proxy server at copyspell.actusanima.com. Our server then calls the AI providers using your API keys and returns the response to you.

**We Do Not Store Your Data.**

* **Your product data:** Processed in memory and immediately discarded.
* **Your API keys:** NOT stored on our server. They are encrypted in YOUR WordPress database and only transmitted during API calls.
* **Server logs:** We keep basic logs containing only the calling domain name and timestamp for troubleshooting purposes. No content, no personal data, no product information.

**Why a Proxy Server?**
The proxy architecture enables our Smart AI Routing™ technology to work efficiently and allows us to maintain and update AI model sequences without requiring plugin updates.


== External services ==

= AI Service (copyspell.actusanima.com) =
When you first activate the plugin, it sends your domain and site name and your admin email to our server, so you get a unique signature for your free credits.
The plugin connects to our API to generate your AI content. It sends your provider's API keys, your product data and your preferences to our API. Our Smart AI Routing system, routes your data to the AI providers, using your API keys to generate your content.
Our server only saves your domain name and the type of your call for logging purposes. No personal data, product info or api keys are collected or stored by the plugin developer.


= License Service (license.actusanima.com) =
The plugin optionally communicates with the developer’s secure license server at https://license.actusanima.com to handle license keys for paid users. It sends your site's domain and the license key you entered, to activate/validate/deactivate a paid license.


Service provider:
- **Actus Anima (Plugin Developer)**
* [CopySpell AI Privacy Policy](https://copyspell.ai/privacy-policy/)
* [CopySpell AI Terms of Service](https://copyspell.ai/terms-of-service/)



= Third Party Services =
Our plugin optionally connects directly to AI providers, when you enter an API key. It sends a call with your key to confirm it's valid. The following AI providers are supported:
* Google AI
* Open AI
* Groq
* Open Router
* Github
* Naga AI






= Source Code =
The source code of CopySpell AI is available on Github:
[CopySpell AI on Github](https://github.com/actusworks/copyspell-ai-public)




= Credits =

Developed by [Actus Anima](https://actus.works)

**Smart AI Routing™** is a trademark of Actus Anima.