A WordPress plugin that translates post content and ACF fields using OpenAI's GPT models. Perfect for migrating and translating entire websites from one language to another. Could be easily modified to also bulk review all content per post type.
This plugin provides a powerful admin interface to translate all content on your WordPress site - including post titles, content, ACF fields, and SEO metadata - with a single click. It's designed for bulk translation of existing sites, especially when setting up new multilingual sites based on existing content.
Sometimes for new sites, we just need to use some "force" to get the translations done quickly and efficiently. This plugin can be used to review or translate all content on a new site from existing content, making it ideal for:
- Creating a new language version of an existing site
- Bulk translating legacy content
- Migrating sites to different language markets
- Quick translation reviews and content audits
- ✅ Batch Processing: Translate hundreds of posts with automatic batching
- 🎯 Smart Translation: Preserves HTML, shortcodes, and formatting
- 🔧 ACF Support: Deep translation of ACF fields including repeaters, flexible content, and groups
- 🔍 SEO Integration: Translates meta titles and descriptions from Yoast SEO, Rank Math, and All in One SEO
- 🎨 Regex Filtering: Target specific ACF fields using regex patterns
- 🔒 Safe Testing: Dry-run mode to preview changes before committing
- ⚡ No Timeout Issues: Chunked batch processing prevents timeouts
- 📝 Real-time Logging: Watch the translation progress in real-time
- Post titles and slugs
- Post content (Classic Editor)
- ACF text fields
- ACF textarea fields
- ACF WYSIWYG fields
- ACF repeater fields (nested)
- ACF flexible content (nested)
- ACF group fields (nested)
- SEO meta titles (Yoast, Rank Math, All in One SEO)
- SEO meta descriptions (Yoast, Rank Math, All in One SEO)
- WordPress 5.0+
- PHP 7.4+
- OpenAI API key (GPT-4 or GPT-4o-mini recommended)
- Advanced Custom Fields (for ACF translation)
- Clone or download this repository
- Upload to your WordPress
wp-content/plugins/directory - Activate the plugin through the 'Plugins' menu in WordPress
- Navigate to AI Translator in the WordPress admin menu
- OpenAI API Key: Enter your OpenAI API key in the settings
- Model: The plugin uses
gpt-4o-miniby default (cost-effective and fast) - Source Language: Select the current language of your site content
- Target Language: Select the language you want to translate to
- Finnish (Suomi)
- Swedish (Svenska)
- English (US)
- English (UK)
- German (Deutsch)
- French (Français)
- Spanish (Español)
- Italian (Italiano)
- Norwegian (Norsk)
- Danish (Dansk)
- Go to AI Translator in the WordPress admin
- Click Test API Connection to verify your API key
- Select the post types you want to translate
- Enable Dry run for the first test
- Click Run and watch the live log
- Once satisfied, disable dry run and run for real
ACF Fields Filter
Use regex patterns to target specific ACF fields:
/.*/- Translate all fields (default)/(title|description)/i- Only translate fields with "title" or "description" in the name/^content_/- Only fields starting with "content_"
Batching
- Posts per batch: Number of posts to process at once (default: 25)
- Offset: Start from a specific post number (useful for resuming)
Overwrite Mode (Default)
- Replaces original content with translations
- Updates post titles, slugs, and content directly
⚠️ Make a backup first!
Dry Run Mode
- Previews what would be translated
- No changes are written to the database
- Perfect for testing
- The plugin queries posts based on your selected post types
- For each post, it translates:
- Post title → generates new slug automatically
- Post content (preserving HTML/shortcodes)
- All ACF fields matching your regex filter
- SEO meta fields (if SEO plugin detected)
- Translations are sent to OpenAI with context-aware prompts
- HTML structure and formatting are preserved
- Results are logged in real-time
- Progress is batched to avoid timeouts
Using gpt-4o-mini (default):
- Input: ~$0.15 per 1M tokens
- Output: ~$0.60 per 1M tokens
Example: Translating 100 posts with ~500 words each typically costs under $2.
API Connection Failed
- Verify your OpenAI API key is correct
- Check your API key has sufficient credits
- Ensure your server can reach api.openai.com
Translations Look Wrong
- Try using
gpt-4instead ofgpt-4o-mini(better quality, higher cost) - Check your source/target language settings
- Review the ACF field filter regex
Timeouts
- Reduce the batch size (try 10-15 posts)
- Increase your PHP
max_execution_time - Process in smaller chunks using the offset parameter
Empty Translations
- Check the live log for API errors
- Verify the original content isn't empty
- Test with dry run first
- API keys are stored securely in the WordPress database
- Only administrators can access the plugin
- All AJAX requests are nonce-protected
- Input is sanitized and validated
Built with ❤️ by client.studio
Pull requests are welcome! For major changes, please open an issue first.
This plugin is provided as-is without warranty. Use at your own risk. Always backup your database before running bulk translations.
- Initial release
- Batch translation support
- ACF nested field support
- SEO plugin integration
- Real-time logging
- Dry run mode