Overview

Drop-in multilingual subsystem for Terra WordPress sites. Lives in its own repo — terra-hq/wp-multilang — and is cloned into functions/framework/ so the Terra Framework auto-loads it. Adds URL prefix routing (/en/, /es/, /eu/), per-field ACF translations, per-language SEO, and a per-language sitemap behind a thin layer of terra_*() template helpers.

Easy-going setup

In a hurry? Here’s the bare minimum — no thinking required.

Clone php-starter-core. Inside functions/, run git clone git@github.com:terra-hq/php-starter-core.git framework (the trailing framework renames the cloned folder).
Clone wp-multilang. Inside functions/framework/, run git clone git@github.com:terra-hq/wp-multilang.git. The Terra Framework auto-loads it.
Drop in the config. Create functions/project/config/multilang_config.php with at least two languages and a default.
Flip the switch. wp-admin → Terra → System → Multilang → Enable.
One line in header.php. Replace <html lang="en"> with <html <?php language_attributes(); ?>>.
Drop the switcher. <?php terra_multilang_switcher(); ?> anywhere in your templates — header, footer, sidebar, wherever fits.
Save permalinks. Settings → Permalinks → Save Changes.

That’s it. Anything you don’t translate falls back to the native field, so the site keeps working at your own pace.

Setup (detailed)

1. Clone php-starter-core into `functions/`

cd functions
git clone git@github.com:terra-hq/php-starter-core.git framework

The trailing framework renames the cloned folder, so the framework lands at functions/framework/ (the path the rest of the project expects). Repo: terra-hq/php-starter-core.

2. Clone `wp-multilang` into `functions/framework/`

cd functions/framework
git clone git@github.com:terra-hq/wp-multilang.git

The Terra Framework loads functions/framework/wp-multilang/load.php automatically — no extra require needed in your theme.

3. Create `functions/project/config/multilang_config.php`

<?php
return array(
    'languages' => array(
        'en' => '🇺🇸 English',     // first entry = primary language
        'es' => '🇪🇸 Español',
        // 'eu' => '🏴 Euskera',
    ),
    'default' => 'en',                // fallback when the URL has no prefix
);

Key: language code used in URLs (/es/), ACF sub-fields, and the date map.
Value: admin-visible label + switcher label.

4. Enable Multilang from the admin

wp-admin → Terra → System → Multilang tab → check Enable Multilang → Save.

5. Update `header.php`

<html lang="en" dir="ltr">
<html <?php language_attributes(); ?>>

6. Insert the language switcher

In any template (typically the footer or header):

<?php terra_multilang_switcher(); ?>

Auto-hides when there are fewer than 2 languages or when Multilang is OFF.

7. Flush rewrite rules

Settings → Permalinks → Save Changes (no need to change anything, just hit the button). This registers the per-language sitemap rewrite rules.

Knowledge Check

Test your understanding of this section

Loading questions...