There are some fantastic multilingual plugins for WordPress, however for one client project I needed something far more flexible, as this particular client needed to cater for several countries that each spoke several languages.

In short the client needed to be able to have a multisite instance that had a country and language set as default, and the ability to override the country and language on each page / post.

Building a Multilingual Plugin

If enough people bug me to do it, I may consider releasing the whole thing as a standalone plugin, however the heart of the multilingual plugin I build relies on the locale WordPress filter, and the heart of the plugin resides in the following code snippet:

 * Redefine the sites Locale (site langauge)
 * In this example we try to get the country and the langauge from the page meta,
 * if that doesnt exist we fallback to the country and langauge set in the customizer,
 * which in turn fall back to gb and en.
function wholesomecode_example_redefine_locale( $locale ) {

    $country = get_post_meta( get_the_id(), '_wholesomecode_example_global_country_override', true );
    $lang    = get_post_meta( get_the_id(), '_wholesomecode_example_global_language_override', true );

    if ( ( empty( $lang ) || ! ( is_page() || is_single() || is_singular() ) ) ) {
        $country = get_theme_mod( 'wholesomecode_example_multilingual_country', 'gb' );
        $lang    = get_theme_mod( 'wholesomecode_example_multilingual_language', 'en' );

    if ( 'default' !== $country ) {
        $locale = $lang . '_' . strtoupper( $country );
    } else {
        $locale = $lang . '-' . $country;

    return $locale;

add_filter( 'locale', 'wholesomecode_example_redefine_locale', 10 );

Tada! Your locale is now set, and your multilingual site should now be switching languages based on your page/site meta.

Wait! My WordPress Core Default Translations Are Not Working!

This is an issue I came across, and couldn’t for the life of me figure it out. My theme translated perfectly after I had added the relevant .mo and .po files, however WordPress core default translations (such as the ‘Leave a Reply’ message in the comments template) were not translating.

It turns out the solution was pretty simple! Although I had catered for custom domain translations, I had forgot to put one simple bit of code into my theme: load_default_textdomain().

 * Load default text domain
 * If default WordPress Core translations don't work, add this to your
 * `functions.php` file.

If I have shaved a couple of hours off of your debugging with that ‘one weird tip’, you are welcome!

Next Steps

Check out the guides section for some more WordPress tips.

Previous ArticleNext Article

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.