Plugin Overview

Voxfor WP Translate is a powerful, free WordPress multilingual plugin that makes your website accessible to a global audience. Powered by DeepL API, it provides professional-quality translations while maintaining full control over your content and exceptional performance.

Key Features

Supported Languages (33+)

English, French, German, Spanish, Italian, Portuguese, Russian, Japanese, Chinese, Korean, Arabic, Hebrew, Swedish, Norwegian, Danish, Finnish, Dutch, Polish, Turkish, Czech, Slovak, Slovenian, Hungarian, Romanian, Bulgarian, Greek, Estonian, Latvian, Lithuanian, Thai, Vietnamese, Indonesian, Ukrainian

Installation Guide

System Requirements

Installation Steps

1. Download: Get the plugin from your purchase location or WordPress.org
2. Upload: Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Install: Select the zip file and click "Install Now"
4. Activate: Click "Activate Plugin" after installation
5. Configure: Navigate to "WP Translate" in your WordPress admin sidebar
6. API Key: Add your DeepL API key in Settings
7. Select Languages: Choose the languages you want to support

Getting a DeepL API Key

1. Visit https://www.deepl.com/pro-api
2. Sign up for a DeepL API account (free tier available)
3. Copy your API key from the account dashboard
4. Paste it in WP Translate → Settings → API Settings

Quick Start Guide

Get Started in 5 Minutes

1. Configure Settings:

   Go to WP Translate → Settings

   • Add your DeepL API key
   • Select target languages (e.g., French, German, Spanish)
   • Choose default language (English by default)
2. Enable Features:
   • ✅ Enable automatic translation
   • ✅ Enable hreflang tags for SEO
   • ✅ Enable image ALT text translation
   • ✅ Enable visual editor
3. Add Language Switcher:

   Go to WP Translate → Settings and make sure "Enable floating language switcher" is enabled.

4. Translate Content:

   Use WP Translate → Translate where user can translate complete website in one go, or user can also translate individual page, post, product etc..

5. Test Your Site:

   Visit your homepage and switch languages using the language switcher. URLs will show language prefixes (e.g., /fr/, /de/).

Performance Features

Voxfor WP Translate is engineered for maximum performance with multiple layers of optimization:

1. Translation Memory System

2. WordPress Object Cache Integration

// Automatic object cache support for:
- Redis
- Memcached
- APCu
- WP Object Cache Pro

// Configurable cache TTL (default: 3600 seconds)
// Negative result caching to prevent repeated lookups
// Automatic cache invalidation on translation updates

3. Cache Plugin Compatibility

4. CDN & Server Cache Support

• Varnish: Automatic PURGE requests with language awareness
• Nginx FastCGI Cache: Custom purge hooks
• Cloudflare: Proper Vary headers for language-based caching
• CDN77, KeyCDN, BunnyCDN: Full compatibility

5. Optimized Database Queries

// Indexed columns for fast lookups
- source_hash (SHA-256 or UUID)
- language_code
- context
- post_id

// Optimized query patterns
- Single query for batch translations
- Prepared statements for security
- Efficient JOIN operations

6. Smart Translation Queue

7. Lazy Loading & On-Demand Translation

• Images with ALT text translation loaded lazily
• Menu items translated only when rendered
• Widget content translated on-demand
• Footer/header content cached separately

Performance Benchmarks

Translation System

How It Works

1. Content Detection: Plugin scans post content, titles, excerpts, menus, widgets
2. Memory Check: Checks translation memory for existing translation
3. API Translation: If not found, sends to DeepL API
4. Storage: Saves translation to local database
5. Delivery: Serves cached translation on subsequent requests

Translation Contexts

Bulk Translation

Translate multiple posts/pages at once via WP Translate → Translate

• Select content type (Posts, Pages, Products, etc.)
• Choose target languages
• Monitor progress in real-time
• Cancel or pause at any time

Translation Memory Management

Access via WP Translate → Translation Memory

• Search translations by text, language, or context
• Filter by content type (page, post, product, header, footer)
• Edit translations individually
• Lock translations to prevent auto-updates
• Mark translations for review
• Export/import translations (JSON/CSV)
• Clear cache for specific translations

Glossary Terms

Define terms that must always be translated consistently:

// Example glossary entries
Company Name: VoxFor → VoxFor (no translation)
Product Name: SuperWidget → SuperWidget (preserve)
Technical Term: API → API (keep original)

Exclusion Rules

Exclude specific content from translation:

• HTML elements (by class or ID)
• Specific text strings
• WooCommerce checkout (auto-excluded for safety)

SEO Features

1. Hreflang Tags

Automatically generated in the <head> section:

<link rel="alternate" hreflang="en" href="https://example.com/" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />

2. Canonical URLs

Language-specific canonical URLs prevent duplicate content:

• Each language version has its own canonical URL
• Integrates with Yoast SEO, RankMath, All in One SEO
• Automatic URL structure: /fr/page-name/

3. Image ALT Text Translation

4. Language-Specific Sitemaps

Automatic sitemap generation with language alternates:

• Separate sitemaps per language
• Hreflang annotations in sitemap
• Integration with XML Sitemaps plugins
• Automatic submission to search engines

5. Translated Slugs (Optional)

Enable slug translation for fully localized URLs:

// English: /services/web-design/
// French: /fr/services/conception-web/
// German: /de/dienstleistungen/webdesign/

6. Open Graph & Twitter Cards

<meta property="og:locale" content="fr_FR" />
<meta property="og:locale:alternate" content="en_US" />
<meta property="og:locale:alternate" content="de_DE" />

8. SEO Plugin Integration

Language Switcher

Widget Styles

Method 2: Shortcode

// Basic usage
[voxfor_language_switcher]

// With style parameter
[voxfor_language_switcher style="dropdown"]

Method 3: PHP Function

<?php
// In your theme template
if ( function_exists( 'voxfor_language_switcher' ) ) {
    voxfor_language_switcher( array(
        'style' => 'dropdown',
        'show_flags' => true,
        'show_names' => true
    ) );
}
?>

Customization Options

Theme & Plugin Integrations

WooCommerce

• Product names and descriptions
• Product categories and tags
• Product attributes
• Product short descriptions
• Cart and checkout pages (excluded for safety)
• Shop, account, and thank you pages

Elementor

• Elementor widget content translation
• Header and footer builders
• Global widgets
• Template library
• Dynamic content fields
• Popup builder

Advanced Custom Fields (ACF)

• Text fields
• Textarea fields
• WYSIWYG editors
• Repeater fields
• Flexible content
• Group fields

Theme Compatibility

Works with all properly coded WordPress themes. Automatic detection and compatibility layer for:

• Astra
• GeneratePress
• OceanWP
• Neve
• Kadence
• Hello Elementor
• Twenty Twenty-Four
• And many more...

Cache & Performance Compatibility

Automatic Cache Detection

The plugin automatically detects and configures compatibility with your caching setup:

Cache Plugin Support

Object Cache Support

Enable object caching in Settings → Performance for even better performance:

• Redis: Full support with automatic configuration
• Memcached: Full support with automatic configuration
• APCu: Full support with automatic configuration
• WP Object Cache Pro: Tested and compatible

CDN Configuration

For CDN users, ensure your CDN respects these headers:

Vary: Cookie, Accept-Language
X-Voxfor-ML-Language: [current-lang]

Clear Cache Options

Clear cache after translation updates:

• Automatic: Cache cleared automatically when translations update
• Manual: Go to WP Translate → Tools → Clear Cache
• Selective: Clear cache for specific pages or posts
• Global: Clear all translation caches site-wide

Performance Tips

Troubleshooting

Common Issues & Solutions

Debug Mode

Enable debug mode for detailed logging:

// Add to wp-config.php
define( 'VOXFOR_ML_DEBUG', true );

// View logs in:
// WP Translate → Tools → Debug Logs

Database Check

Verify database tables exist:

1. Go to WP Translate → Tools → Diagnostics
2. Click "Check Database Tables"
3. If tables missing, click "Recreate Tables"

Getting Support

1. Check browser console for JavaScript errors
2. Enable WordPress debug mode
3. Check server error logs
4. Gather diagnostics: Tools → System Info
5. Contact support with diagnostic information

Support Resources:

• Documentation: https://voxfor.com/docs/multilanguage
• GitHub Issues: https://github.com/voxfor/multilanguage
• WordPress Forum: WordPress.org Support

Frequently Asked Questions

Technical Requirements