=== PolyTranslate AI for Polylang ===
Contributors: almhdy  
Tags: polylang, multilingual, translation, woocommerce, ai translation
Requires at least: 5.5
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv3
License URI: https://opensource.org/licenses/GPL-3.0

🚀 Save 99% on AI translations! Auto-translate posts, WooCommerce, ACF fields & SEO metadata with OpenAI/DeepL.

== Description ==

**Save Thousands on Translation Costs!** PolyTranslate AI for Polylang is the most cost-effective way to create multilingual WordPress websites.

This powerful plugin transforms your WordPress site into a multilingual powerhouse using cutting-edge AI translation technology. Connect with OpenAI (ChatGPT), DeepL Pro, Google Translate, and OpenRouter using your own API keys for maximum cost control and privacy.

**Why Choose PolyTranslate AI?**

✅ **Massive Cost Savings** - Use your own API keys, pay wholesale AI rates
✅ **Complete Translation Solution** - Posts, pages, products, custom fields, SEO metadata
✅ **Advanced Custom Fields Support** - Full ACF, Meta Box, and custom fields translation
✅ **Professional Quality** - AI-powered translations that sound natural
✅ **Time-Efficient** - Translate entire sites in minutes, not weeks
✅ **Privacy-First** - Your content never touches our servers
✅ **WooCommerce Ready** - Perfect for multilingual e-commerce stores

**Perfect for:**
- E-commerce stores expanding globally
- Blogs and news sites going multilingual  
- Corporate websites needing multiple languages
- Agencies managing client multilingual sites
- Anyone tired of expensive translation services

**This plugin is not affiliated with the developers of Polylang.**

**Requirements:** This plugin works with Polylang. Make sure you have [Polylang](https://wordpress.org/plugins/polylang/) installed.

== 🆓 Free Features ==

**Core Translation Features:**
- Translate WordPress **posts** and **pages** instantly
- Translate **WooCommerce Products** (title, description, short description)
- Translate **custom post types** (any CPT registered in WordPress)
- **Multiple AI Engines** - Choose between OpenAI, DeepL, Google Translate, OpenRouter
- **Language Auto-Detection** - Smart source language detection
- **One-Click Translation** - Translate directly from edit screens

**Cost Control:**
- Use your **own API keys** - no markup, no hidden fees
- **Transparent pricing** - see exactly what each translation costs
- **Pay-as-you-use** - no monthly subscriptions or minimum commitments

== 🔥 Premium Features ==

**Advanced Content Translation:**
- **Advanced Custom Fields (ACF)** - Text, textarea, wysiwyg, and more field types
- **Meta Box Fields** - Complete Meta Box plugin support
- **Custom Fields & Meta** - Any custom field or post meta
- **Taxonomies** - Categories, tags, and custom taxonomies
- **Elementor Pages** - Full Elementor widget and content translation
- **Bulk Translation** - Translate hundreds of posts with one click

**SEO & Marketing:**
- **Complete SEO Meta Translation** for:
  - **Yoast SEO**
  - **Rank Math**
  - **SEOPress**
  - **All in One SEO Pack**

**WooCommerce Advanced:**
- **Product Variations** - Translate variable product options
- **Product Categories** - Complete taxonomy translation
- **Product Attributes** - Custom attributes and values
- **WooCommerce SEO** - Product meta for better search rankings

[youtube https://www.youtube.com/watch?v=9Hx3v5b_Tbc]

== External Services ==

PolyTranslate AI connects to third-party translation APIs when you trigger translations. **You control your data and costs** by providing your own API keys:

1. **OpenAI (ChatGPT/GPT-4)**  
   - **Purpose**: Premium AI translations with context understanding
   - **Data Sent**: Content to translate, language codes, your API key
   - **Privacy**: Direct connection - we never see your content
   - **Links**: [Terms](https://openai.com/policies/terms-of-use) | [Privacy](https://openai.com/policies/privacy-policy)

2. **DeepL Pro**  
   - **Purpose**: Industry-leading neural machine translation
   - **Data Sent**: Text content, language pairs, your API key  
   - **Privacy**: Secure API connection, no data retention
   - **Links**: [Terms](https://www.deepl.com/pro-license/) | [Privacy](https://www.deepl.com/privacy/)

3. **Google Translate API**  
   - **Purpose**: Fast, reliable translations via Google Cloud
   - **Data Sent**: Content, language codes, your API credentials
   - **Privacy**: Enterprise-grade security and privacy
   - **Links**: [Terms](https://policies.google.com/terms) | [Privacy](https://policies.google.com/privacy)

4. **OpenRouter.ai**  
   - **Purpose**: Access to multiple AI models through one API
   - **Data Sent**: Translation requests, language pairs, your API key
   - **Privacy**: No data storage, secure transmission
   - **Links**: [Terms](https://openrouter.ai/terms) | [Privacy](https://openrouter.ai/privacy)

**Security Promise**: Your API keys are encrypted and stored locally in your WordPress database. Plugin updates never transmit your keys or content to our servers.

== Installation ==

**Quick Start (2 minutes):**

1. **Install Plugin**
   - Search "PolyTranslate AI" in WordPress admin → Plugins → Add New
   - Or upload manually to `/wp-content/plugins/polytranslate-ai/`
   - Activate the plugin

2. **Configure API Keys**
   - Go to **PolyTranslate AI → Settings**  
   - Add your API key for OpenAI, DeepL, Google, or OpenRouter

3. **Start Translating**
   - Edit any post/page/product
   - Click the **Translate** button
   - Select target languages
   - Watch the magic happen!

[youtube https://www.youtube.com/watch?v=9Hx3v5b_Tbc] 

== Frequently Asked Questions ==

= How much money can I actually save? =
Typical savings range from 95-99% compared to professional translation services. A medium-sized business website (20,000 words) would cost $2,000-6,000 with traditional services, but only **~$0.01–$0.02** with PolyTranslate AI using your own API keys.

= Is this plugin completely free? =
The core plugin is free with powerful translation features. Premium features (ACF fields, bulk translation, advanced SEO support) require a license, but you'll still save thousands compared to traditional translation methods.

= Do I need technical skills to set this up? =
No! The setup takes 2 minutes. Just get an API key from OpenAI or DeepL, paste it in the settings, and start translating.

= Can I translate Advanced Custom Fields? =
Yes! The premium version fully supports ACF fields including text, textarea, WYSIWYG, repeater fields, and more. Also supports Meta Box and other custom field plugins.

= Which translation service gives the best results? =
**For Quality**: DeepL Pro > Google Translate
**For Cost**: Google Gemini 2.5 Flash-Lite (~$0.0003/word) > Google Translate (~$0.0005/word) > GPT-3.5 Turbo (~$0.002/word) > DeepL Pro (~$0.005/word)
**Best Value**: Google Gemini 2.5 Flash-Lite offers excellent quality at very competitive costs. You can switch between services anytime to find your perfect balance.

= Is my content secure? =
Absolutely. Your content goes directly from your site to your chosen AI service using your API keys. We never see, store, or have access to your content or API keys.

= Can I translate WooCommerce stores? =
Yes! Both free and premium versions support WooCommerce. Premium adds product variations, categories, attributes, and advanced WooCommerce SEO meta translation.

= Does it work with page builders? =
Premium version supports Elementor fully. Gutenberg works out of the box. Other page builders work for basic content - contact us for specific compatibility questions.

= What if I'm not satisfied? =
We offer a 7-day money-back guarantee on premium licenses. Plus, you can try all free features without any commitment.

= Is this affiliated with Polylang? =
No, this is an independent plugin that extends Polylang's functionality. Polylang handles language management, we handle the AI translation part.

== Screenshots ==

1. API Settings.
2. Translation Settings.
3. Single Translation.
4. Bulk Translation.

== Upgrade Notice ==

= 2.0.0 =
🎉 Major Update! Added Advanced Custom Fields (ACF) support, Meta Box integration, and custom fields translation in Premium version. Save even more with expanded translation capabilities!

== Changelog ==

= 2.0.0 =
* 🚀 **NEW**: Advanced Custom Fields (ACF) complete integration - translate all ACF field types
* 🚀 **NEW**: Meta Box plugin support - translate Meta Box custom fields  
* 🚀 **NEW**: Universal custom fields translation - works with any custom field plugin
* 🚀 **NEW**: Enhanced bulk translation with progress indicators
* ⚡ **IMPROVED**: Faster translation processing for large content
* ⚡ **IMPROVED**: Better error handling and user feedback
* 🔧 **FIXED**: Minor UI improvements and bug fixes

= 1.1.0 =
* NEW: Added compatibility for translating Elementor pages
* IMPROVED: Enhanced WooCommerce product translation  
* FIXED: Various stability improvements

= 1.0.0 =
* 🎉 Initial release with OpenAI, DeepL, Google Translate, and OpenRouter support
* ✅ Free translation for posts, pages, and WooCommerce products
* ✅ Premium features for taxonomies and SEO plugin integration