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

🚀 FREE AI translator for Polylang! One-click translation for posts, pages & WooCommerce with AI, DeepL, Google Translate.

== Description ==

**Turn your WordPress site multilingual with just one click!**

This plugin uses your own API keys to connect with top translation engines such as OpenAI (ChatGPT), DeepL Pro, Google Translate, and OpenRouter. It makes it easy to translate your site's content and metadata with a single click — directly within the WordPress admin.

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

== Key Features ==

- **Posts & Pages Translation** - Translate any content instantly
- **Custom Post Types Translation** - Works with any custom post type
- **WooCommerce Products Translation** - Product titles, descriptions, and short descriptions
- **WooCommerce Product Variations & Attributes** Sync Product Variations & Attributes
- **Advanced Custom Fields (ACF) Support** - All field types including repeaters
- **Meta Box Fields** - Complete Meta Box plugin support
- **Any Custom Fields** - Universal custom field translation
- **Categories & Tags** - Translate taxonomies
- **Custom Taxonomies** - Translate any registered custom taxonomy
- **Elementor Pages** - Full page builder support
- **Bulk Translation** - Translate hundreds of posts at once
- **Complete SEO Meta Translation** - (Yoast, Rank Math, SEOPress, All in One SEO Pack)
- **Multiple AI Services** - OpenAI, DeepL Pro, Google Translate, OpenRouter
- **Smart Language Detection** - Automatically detects source language
- **Translate Link Targets** - Automatically update post links to point to translated versions.

== FREE vs Premium ==

The **Free version** includes:

✅ Posts & Pages Translation
✅ Custom Post Types Translation
✅ WooCommerce Products Translation
✅ Unlimited Translations
✅ Multiple AI Services
✅ Language Auto-Detection
✅ Translate Link Targets

The **Premium version** includes:

✨ Everything in Free, plus:
✨ Categories, Tags & Custom Taxonomies Translation
✨ Custom Fields Translation (ACF, Meta Box, etc.)
✨ SEO Meta Translation
✨ Bulk Translation
✨ Elementor Pages Support

[Translate ACF & Custom Meta Fields in WordPress](https://www.youtube.com/watch?v=9Hx3v5b_Tbc)

[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 for "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!

[Translate ACF & Custom Meta Fields in WordPress](https://www.youtube.com/watch?v=9Hx3v5b_Tbc)

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

== Frequently Asked Questions ==

= 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.

== Changelog ==

= 2.0.2 =
* Add Translate Link Targets

= 2.0.1 =
* Fixed Bugs

= 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