1 · Overview & Database Architecture
EasyLang is a lightweight, zero-bloat multilingual solution engineered specifically for modern WordPress performance. Designed from the ground up as a fast, clean alternative to legacy multilingual plugins like WPML and Polylang, EasyLang delivers complete localization without monthly language fees, runtime performance degradation, or bloated database schemas.
Core Architectural Principles
- Zero wp_options Bloat: Rather than dumping thousands of transient strings and language flags into the single autoloaded
wp_optionstable, EasyLang utilizes dedicated, indexed custom database tables. - Minimal Frontend Overhead: There is virtually zero runtime JavaScript loaded on your public pages beyond the lightweight, CSS-driven language switcher component.
- Universal Compatibility: Works seamlessly with the Gutenberg Block Editor, Classic Editor, and all major page builders (Elementor, Divi, Beaver Builder, Bricks, Oxygen, and WPBakery).
- WPML Compatibility Layer: Ships with a drop-in API shim that replicates standard WPML functions (
icl_translate,icl_get_languages), enabling existing third-party plugins to work seamlessly without rewriting code.
Dedicated Database Schema
| Database Table | Primary Purpose | Key Indexed Fields |
|---|---|---|
| wp_easylang_languages | Stores active locales, flag iconography, direction (LTR/RTL), and default status. | code, locale, is_default, active |
| wp_easylang_translations | Maps posts, pages, categories, tags, and custom post types across languages. | trid, element_id, element_type, language_code |
| wp_easylang_strings | Indexes theme strings, plugin textdomains, widgets, and custom text fragments. | context, name, string_hash |
| wp_easylang_memory (Pro) | Persistent Translation Memory store providing fuzzy matching suggestions. | source_hash, source_lang, target_lang |
| wp_easylang_glossary (Pro) | Protected terminology dictionary preventing unauthorized translation of brand names. | term, source_lang, target_lang |
| wp_easylang_jobs (Pro) | Team translation assignments, deadlines, workflow statuses, and notes. | post_id, translator_id, status, deadline |
2 · Installation, Language Setup & URL Routing
00:00 Introduction & Zero-Bloat Concept01:30 Language Setup & URL Routing Modes03:40 Side-by-Side Dual-Pane Translation Editor05:55 String Translation & Theme Localization07:30 Language Switcher Styling & Block09:15 AI Machine Translation Engines (DeepL / OpenAI)Deploying EasyLang takes less than two minutes. The plugin ships with over 60 preconfigured languages with official locales, native language spellings, and flag icons.
Configuring Languages
- Navigate to EasyLang → Languages in your WordPress admin.
- Select your site's default primary language (e.g. English,
en_US). - Add secondary translation languages from the searchable catalog. Each language automatically configures:
- ISO 639-1 Language Code (e.g.
fr,de,es). - Regional Locale Code (e.g.
fr_FR,de_DE). - Text Direction: Left-to-Right (LTR) or Right-to-Left (RTL).
- Vector SVG Flag Icon and Emoji representation.
- ISO 639-1 Language Code (e.g.
- Rearrange language order using drag-and-drop to define the default presentation sequence in switchers.
Three URL Routing Modes
EasyLang allows site owners to select the URL rewrite structure best aligned with their international SEO strategy:
| Structure | Example URL | Best Use Case |
|---|---|---|
| Subdirectory Prefix (Default) | https://example.com/de/about/ | Recommended for 95% of sites. Consolidates domain authority while giving clear geographic structure. |
| Subdomain Architecture | https://de.example.com/about/ | Ideal for large regional branches requiring independent server hosting or regional caching rules. |
| Query Parameter | https://example.com/about/?lang=de | Simple fallback for restricted hosting environments where URL rewrites or .htaccess modifications are prohibited. |
Browser Language Auto-Detection
When enabled in EasyLang → Settings, visitors are automatically redirected to their preferred language on their first visit based on their HTTP Accept-Language request header. A non-intrusive cookie (easylang_lang) stores user preference for 365 days, ensuring subsequent navigations remain in the chosen language.
3 · Content Translation & Side-by-Side Editor
Translating pages, posts, and custom content in EasyLang is intuitive and designed to avoid cognitive fatigue.
The Side-by-Side Translation Editor
Clicking the translation icon next to any post opens EasyLang's custom editor view:
- Dual-Column Synchronized Layout: The left panel displays the original source article with formatting and media references intact, while the right panel provides the active editing canvas for your translated copy.
- Synchronized Scrolling: Scrolling through the source content automatically keeps the translation canvas aligned with the active paragraph.
- Per-Language Slug Editing: Translate page URLs directly in the editor header (e.g.
/contact/becomes/fr/contactez-nous/). - Live Word & Character Counters: Instant metrics verifying translated copy length against source text.
Focus Mode (Distraction-Free Translation)
For intensive translation sprints, clicking Focus Mode collapses WordPress admin menus and toolbars into a full-screen dual-pane workspace, maximizing vertical screen space for translators.
Stale Content Notification Engine
When an author updates the original source post (e.g. changing pricing numbers or adding technical paragraphs), EasyLang automatically flags all associated translations with a warning badge in the post list: Source Updated. This ensures editors immediately know which foreign-language versions require review.
Taxonomy Translation
Categories, tags, and custom hierarchical taxonomies (such as portfolio categories or product attributes) can be localized from EasyLang → Taxonomies, complete with translatable category names, slugs, and archive descriptions.
4 · String Translation, Menus & Formats
Not all translatable text lives in posts or pages. Button labels, footer copyrights, form placeholders, widget titles, and theme options must also be translated. EasyLang handles this through its high-performance String Translation center.
String Scanner & Context Categorization
Navigate to EasyLang → Strings to view and search translatable text fragments:
- Automatic Textdomain Scanning: Scans active themes and plugins to extract
__(),_e(),_x(), and_n()gettext calls. - Context Grouping: Filter strings by textdomain or origin context (e.g.
theme,woocommerce,admin,widgets). - Inline Translation: Click any string to edit its translation across all configured languages instantly.
Menu Translation
EasyLang enables distinct navigation menus per language:
- Automatic Menu Duplication: Generate a translated menu structure with one click.
- Custom Link Localization: Target language-specific external landing pages or local URLs per menu item.
- Independent Menu Organization: Reorder items, add language-specific submenu trees, or omit pages in specific locales.
Industry-Standard Import & Export
Collaborate with external translation agencies or Computer-Assisted Translation (CAT) tools using standard file exchanges:
5 · Language Switcher Customization & Placement
The language switcher is the primary gateway for international visitors. EasyLang provides three responsive presentation styles with extensive customization controls.
Presentation Styles
- Dropdown Menu: Compact selector ideal for header utility bars and mobile navigation overlays. Displays current language flag and expands on click/hover.
- Horizontal Inline List: Minimalist inline list showing flags and language codes (e.g.
EN | DE | FR), perfectly suited for footer bars. - Floating Action Button: Fixed bottom-corner bubble that stays visible during scrolling and opens a stylish language selection drawer.
Placement Methods
- Gutenberg Block: Search for the
EasyLang Switcherblock in the WordPress block inserter. - Page Builder Widgets: Dedicated drag-and-drop elements available in Elementor, Divi, and Beaver Builder.
- Shortcode: Place
[easylang_switcher]anywhere in post content or widget areas. - PHP Template Tag: Embed directly into custom theme templates:
<?php if ( function_exists( 'easylang_switcher' ) ) { easylang_switcher([ 'style' => 'dropdown', 'flags' => true ]); } ?>
Visual Styling Controls
Configure switcher appearance under EasyLang → Settings → Switcher: display SVG vector flags, emoji flags, or text only; toggle native language spellings (e.g. Deutsch vs German); customize text colors, background cards, hover accents, and corner rounding.
6 · Multilingual SEO, Hreflang & Sitemaps
International search engine optimization requires precision markup to ensure Google, Bing, and Yandex index the correct regional URL without triggering duplicate content penalties.
Automated Hreflang Link Injection
EasyLang automatically generates compliant <link rel="alternate" hreflang="..." href="..."> tags into the document <head> on every page, post, and category:
<link rel="alternate" hreflang="en" href="https://example.com/about/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/about/" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/a-propos/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/about/" />
OpenGraph & Social Graph Locales
Social media crawlers (Facebook, LinkedIn, X/Twitter) receive customized locale tags:
og:localeset to the active page language (e.g.de_DE).og:locale:alternategenerated for all sibling language versions.
Sitemap Integration
EasyLang integrates directly with top WordPress SEO plugins (Yoast SEO, Rank Math, and All in One SEO), injecting multilingual alternate links into generated XML sitemaps automatically so search engine bots discover all translation variants in a single crawl.
Per-Language SEO Meta (Pro)
With EasyLang Pro, editors can customize unique SEO meta titles, meta descriptions, focus keyphrases, and social share cards for each language version directly inside the post editor.
7 · AI Auto-Translation Engines (Pro)
EasyLang Pro integrates enterprise artificial intelligence translation engines, allowing you to translate individual articles or your entire catalog with a single click.
8 Integrated Translation Providers
| Provider | API Compatibility | Strengths |
|---|---|---|
| DeepL API | Free & Pro API keys | Unrivaled natural fluency for European languages; formal/informal tone control. |
| Google Cloud Translation | v2 Basic & v3 Advanced | Massive global coverage spanning 130+ languages including rare dialects. |
| OpenAI (GPT-4o / GPT-4) | Chat Completions API | Context-aware localization, transcreation, and idiomatic marketing copy. |
| Microsoft Azure Translator | Cognitive Services API | Enterprise compliance, custom dictionaries, and high-volume throughput. |
| LibreTranslate | Self-hosted & Cloud instances | 100% open-source, private self-hosted translation without external API calls. |
| MyMemory / Yandex / Lingva | Public & Commercial endpoints | Alternative failover providers and community translation memory lookups. |
Single-Click & Batch Queuing
- One-Click Post Translation: Click Auto-Translate with DeepL in the editor toolbar to localize all headings, paragraphs, and lists instantly.
- Bulk Translation Queue: Select multiple posts from the WordPress admin list and dispatch a background translation job. An asynchronous queue runner processes articles in batches without triggering PHP memory exhaustion or server timeouts.
- Automatic On-Publish Translation: Configure EasyLang Pro to automatically trigger translations whenever a new post is published in the default language.
8 · Live Visual Front-End Editor (Pro)
Translating complex page-builder layouts inside backend forms can be tedious. The EasyLang Pro Live Visual Editor lets you translate your live website directly on the front end.
Click-to-Translate Workflow
- Navigate to any front-end page while logged in as an administrator or translator.
- Click Translate Page in the top WordPress admin bar.
- EasyLang activates an interactive editing overlay. Hovering over text highlights translatable elements with an editable outline.
- Clicking any element opens the floating translation dock. You can:
- Review the original source phrase.
- Type your translated copy with instant live rendering on the actual page canvas.
- Click AI Suggest to pull translations from DeepL or OpenAI on the fly.
- Accept matching suggestions from your Translation Memory.
- Click Save to commit changes immediately to the database without reloading the page.
Page Builder Compatibility
The visual editor parses raw text nodes and builder JSON schemas seamlessly across all major page builders: Elementor, Divi, Beaver Builder, Bricks, Oxygen, and WPBakery.
9 · Translation Memory & Glossary Manager (Pro)
Consistency in corporate terminology is critical for international brands. EasyLang Pro includes enterprise-grade Computer-Assisted Translation (CAT) tools built directly into WordPress.
Translation Memory (TM)
Every translation saved on your website is automatically indexed in your local Translation Memory database:
- Fuzzy Matching Engine: When an editor translates a new page containing sentences similar to previously translated text, EasyLang suggests past translations with a percentage match score (e.g. 85% Match).
- Threshold Controls: Set minimum matching similarity criteria (default: 75%) under EasyLang → Memory.
- TMX Import & Export: Export your translation memory in industry-standard TMX (Translation Memory eXchange) format for sharing with professional translation agencies or importing into SDL Trados, MemoQ, or Phrase.
Glossary & Brand Terminology Manager
Ensure sensitive company names, trademarks, and technical jargon are never mangled by AI auto-translation:
- Do-Not-Translate Rules: Protect brand names (e.g. WebPies, EasyLang, Cloudflare R2) so AI engines leave them untranslated.
- Enforced Terminology Pairs: Define mandatory translations (e.g. Workspace → Arbeitsbereich).
- Placeholder Injection: During AI translation calls, glossary terms are temporarily replaced with unique tokens to preserve exact casing and syntax before being restored in the final translated text.
10 · WooCommerce Multilingual, Media & Team Workflow (Pro)
For international e-commerce stores and multi-author editorial teams, EasyLang Pro provides dedicated store localization and workflow management tools.
WooCommerce Multilingual
- Product Translation: Localize product titles, long descriptions, short excerpts, and custom purchase notes.
- Attributes & Variations: Translate variable attributes (e.g. Size: Small/Medium/Large → Taille: Petit/Moyen/Grand).
- Checkout & Cart Localization: Cart buttons, checkout notices, and privacy disclosures automatically align with customer locale.
- Transactional Customer Emails: Order confirmations, shipping alerts, and invoice emails are dispatched in the language the customer selected at checkout.
Media Translation
Different cultures and languages often require different visual assets. EasyLang Pro allows you to serve localized images, downloadable PDFs, or promotional banners per language:
- Assign language-specific replacement images to any media attachment ID.
- Localize image alt text, captions, and title metadata independently for each language.
Team Translation Workflow & Job Board
Manage in-house and freelance translators directly from WordPress:
- Assign Translation Jobs: Select posts, assign them to registered translator accounts, specify target languages, and set hard deadlines.
- Automated Email Notifications: Translators receive email alerts with direct links when jobs are assigned, approaching deadlines, or overdue.
- Role-Based Access: Translators only see assignments assigned to their account, preventing unauthorized edits to other site sections.
- Status Tracking: Track progress through clear workflow stages: Pending → Assigned → In Progress → Review → Published.
Developer REST API & WP-CLI
# Scan strings via WP-CLI
wp easylang scan --textdomain=my-theme
# Export translations to XLIFF via CLI
wp easylang export --format=xliff --lang=fr --output=fr-translations.xlf
# Query active languages via REST API
GET /wp-json/easylang/v1/languages HTTP/1.1
Host: example.com