Getting Started

Translate and Transfer allows you to automatically translate WordPress posts using AI (Claude or OpenAI) and transfer them to multiple WordPress sites with a single click.

What You Can Do

• Translate posts to 100+ languages
• Transfer posts to unlimited WordPress sites
• Use Claude AI or OpenAI for translations
• Maintain style consistency with training articles
• Background processing (translations happen in the background)
• Preserve HTML formatting and featured images
• Custom terminology with wordbooks

Requirements

• WordPress 5.0+
• PHP 7.4+
• REST API enabled on target WordPress sites
• Claude API key OR OpenAI API key

Installation

System Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• REST API enabled (enabled by default)

Step-by-Step Installation

1. Go to WordPress Admin → Plugins → Add New
2. Click "Upload Plugin"
3. Choose the plugin ZIP file
4. Click "Install Now"
5. Click "Activate Plugin"

License Setup

You need a valid license to use the plugin. Different plans provide different features and limits.

Get Your License

1. Visit our pricing page
2. Choose a plan (Free, Pro, or Agency)
3. You'll receive a license key via email - You can also find it anytime in your Profile → Licenses section.

Activate License

1. Go to Settings → Translate and Transfer
2. Go to the "License" tab
3. Paste your license key in the field
4. Click "Activate License"
5. You'll see a success message when activated

License Plans

API Configuration

Free & Pro Plan - Use Your Own API Key

On the Free plan, you provide your own API keys from Claude or OpenAI.

Step 1: Get Claude API Key

1. Go to Anthropic Console
2. Sign up or log in
3. Click "API Keys"
4. Click "Create New API Key"
5. Copy the key

Step 2: Get OpenAI API Key

1. Go to OpenAI Platform
2. Sign up or log in
3. Click "API Keys"
4. Create a new secret key
5. Copy the key

Step 3: Add API Key to Plugin

1. Go to Settings → Translate and Transfer → API Settings
2. Select your preferred AI provider (Claude or ChatGPT)
3. Paste your API key
4. Click "Save API Settings"

Agency Plans - No Setup Needed

You don't need to provide API keys. We manage the shared API for you! Just activate your license and start translating.

            
✓ No API setup required
✓ Start translating immediately
✓ No rate limiting concerns
✓ Tokens included in your plan
            

Target Sites Setup

Target sites are the WordPress installations where you want to send your translated posts.

What You Need

• WordPress 5.0 or higher on target site
• REST API enabled (enabled by default)
• Either: Application Password (Recommended) OR Basic Auth Helper Plugin

Choose Your Authentication Method

Select one of the two options below, depending on your WordPress version:

Option 1: Application Password (WordPress 5.6+) - Recommended

Application passwords are more secure than storing actual passwords.

Step 1a: Create Application Password

1. On the target WordPress site(where translations are published), go to Users → Your Profile
2. Scroll down to "Application Passwords"
3. Enter a name (e.g., "Translate and Transfer")
4. Click "Generate Password"
5. Copy the generated password (you won't see it again!)

Step 1b: Add Target Site to Plugin (Application Password)

1. Go to Settings → Translate and Transfer → Target Sites (where translations are published)
2. Click "Add Another Site" (or fill in the first site)
3. Fill in these fields:

Configuration Fields

• Name: Display name (e.g., "Norwegian Blog")
• URL: Full site URL (e.g., https://myblog.no)
• Username: Admin username from target site (where translations are published)
• Password: Application password you generated above
• Auth Type: Choose "Application Password"
• Target Language: Language to translate to (e.g., Norwegian)

Option 2: Basic Auth Helper Plugin (WordPress 5.0-5.5)

Use this option if your target site (where translations are published) doesn't support Application Passwords or you're on WordPress 5.0-5.5.

Step 2a: Install Basic Auth Helper Plugin on Target Site (where translations are published)

1. On the target WordPress site (where translations are published): Go to Plugins → Add New
2. Click "Upload Plugin"
3. Download and choose the Basic Auth Helper Plugin
4. Click "Install Now"
5. Click "Activate Plugin"
6. You'll see a notice: "✓ Translate and Transfer - Basic Auth Enabled"

Step 2b: Add Target Site (where translations are published) to Plugin (Basic Auth)

1. Go to Settings → Translate and Transfer → Target Sites
2. Click "Add Another Site" (or fill in the first site)
3. Fill in these fields:

Configuration Fields

• Name: Display name (e.g., "Spanish Blog")
• URL: Full site URL (e.g., https://miblog.es)
• Username: Admin username from target site
• Password: WordPress password (actual password, not application password)
• Auth Type: Choose "Basic Auth"
• Target Language: Language to translate to (e.g., Spanish)

Advanced Options (Optional - Both Methods)

These options work the same way for both Application Password and Basic Auth methods:

Training Articles

Paste 1-3 example articles in the target language to help AI maintain your writing style:

Example Norwegian article here...
This helps the AI understand your tone and style.

Wordbook

Custom terminology to maintain consistency. Format: Original Term = Translation

API = API
Dashboard = Oversiktspanel
Featured Image = Fremhevet bilde
Blog Post = Blogginnlegg

Step 3: Save & Test

1. Click "Save Sites Configuration" at the bottom
2. Go to your Posts section
3. Edit or create a test post
4. Scroll down to "Translate & Transfer to Sites" metabox
5. Select your target site from the dropdown
6. Click "Translate & Transfer"
7. Wait for the success message

Troubleshooting

Connection Error with Application Password

Problem: "Failed to connect to target site"

• Verify you're on WordPress 5.6 or higher
• Check the application password was created successfully
• Make sure the password was copied correctly (no extra spaces)
• Verify target site URL is correct (include https://)
• Check that REST API is enabled on target site

Connection Error with Basic Auth Plugin

Problem: "Invalid username or password"

• Verify the Basic Auth Plugin is installed and activated on target site
• Check you're using the correct WordPress username (not email)
• Verify the password is correct
• Make sure Auth Type is set to "Basic Auth" (not "Application Password")
• Check target site URL is correct (include https://)

Plugin Not Showing Success Message

Problem: After installing Basic Auth Plugin, no notice appears

• Plugin is installed and working (notice just dismisses after viewing)
• You can dismiss notices by clicking the X
• To re-enable notice: WordPress settings → scroll down
• You don't need to see the notice - the plugin works without it

Tips

• Start with one target site and add more as you get comfortable
• Use Application Password if your WordPress version supports it (5.6+) - it's more secure
• Use Basic Auth Plugin for older WordPress versions or if App Passwords don't work
• Always use HTTPS when using Basic Auth - never use HTTP
• Save the generated application password somewhere safe - you can't see it again
• You can delete unused app passwords anytime from User Profile

How to Use

Translate and Transfer a Post

1. Go to Posts in WordPress admin
2. Edit or create a new post
3. Scroll down to "Translate & Transfer to Sites" metabox
4. Select a target site from the dropdown
5. Click "Translate & Transfer"
6. Wait for confirmation message

What Happens Next

• ⏳ Translation job is queued
• 🔄 Post is translated to target language
• 📤 Translated post is transferred to target site
• 📸 Featured image is uploaded (if it exists)
• 🎨 Inline images are processed and transferred
• ✅ Job completes - notification shows new post ID

After Transfer

The translated post appears as a Draft on the target site. You can:

• Review the translation
• Make edits if needed
• Publish when ready

Key Features

Background Processing

Translations happen in the background. You don't have to wait - continue working while the plugin translates your post.

Multi-Language Support

Supports 100+ languages through Claude and OpenAI. Translate your content to any language.

HTML Preservation

All HTML formatting is preserved during translation. Bold text remains bold, lists remain lists, paragraphs stay intact.

Image Transfer

• Featured images automatically uploaded to target site
• Inline images in content are transferred
• Image links updated with new URLs

Style Consistency

Provide training articles to help the AI understand your writing style. The plugin learns from examples.

Custom Terminology

Use wordbooks to ensure brand names and technical terms are translated consistently.

Multiple Sites

Translate one post to multiple sites in different languages. Add as many target sites as you need (depending on plan).

Smart Token Management

Large posts are automatically split into chunks to optimize API usage and reduce costs.

Troubleshooting

Translation Not Starting

Problem: Button doesn't work or nothing happens

Solution:

• Check license is active (Settings → License tab)
• Verify API key is configured (Settings → API Settings)
• Make sure you haven't reached your daily/monthly limit
• Check browser console for errors (Press F12)

API Connection Error

Problem: Error says "Failed to connect to API"

Solution:

• Verify your API key is correct (copy and paste again)
• Check server can reach external APIs (firewall/security)
• Try again in a few moments (API might be down)
• Check Claude status or OpenAI status

Post Not on Target Site

Problem: Translation completed but post doesn't appear

Solution:

• Check target site Drafts (posts are drafts by default)
• Verify target site URL is correct
• Test credentials by logging into target site manually
• Check REST API is enabled: visit https://targetsite.com/wp-json/

Images Not Transferring

Problem: Images don't appear on target site

Solution:

• Check target site Media Library for uploaded images
• Verify target site has storage space available
• Check permissions (target site admin)
• External images aren't transferred by design

Daily Limit Reached

Problem: Error says "Daily limit reached" (Free plan)

Solution:

• Wait until next day (limit resets at midnight)
• Upgrade to Pro or Agency plan for more translations

Poor Translation Quality

Problem: Translation isn't good quality

Solution:

• Add training articles in target language (shows AI your style)
• Add wordbook with important terms
• Write source posts clearly (AI translates clearer text better)
• Use Claude model if available
• Review and edit before publishing

Frequently Asked Questions

Need Help?

If you have questions or encounter issues:

• Check this documentation page above
• Contact support