apply_filters( 'locale', string $locale )

Filters the locale ID of the WordPress installation.

Contents

Parameters

$locale

(string) The locale ID.

Top ↑

Source

File: wp-includes/l10n.php

View on Trac

Top ↑

Top ↑

Changelog

Changelog
Version Description
1.5.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
    Contributed by surrealwebs —

    You can leverage this hook to force the language of your admin dashboard, however, you need to call it from a plugin and not from your theme, by the time WordPress gets to loading your theme it’s too late.

    <?php
/*
Plugin Name: English Only Admin
Plugin URI: http://your-domain.com
Description: Force English (en_US) in the WordPress Admin
Version: 1.0
Author: You
Author URI: http://your-domain.com
Text Domain: englishonlyadmin
*/

// prevent direct access
if ( ! defined( 'WPINC' ) ) {
    die;
}

if ( ! function_exists( 'uniquePrefix_force_english_only_admin' ) ) {
    /**
     * Override locale for admin to force English (en_US).
     *
     * @param string $locale Current locale.
     *
     * @return string English (en_US) locale if in Admin, configured locale otherwise.
     */
    function uniquePrefix_force_english_only_admin( $locale ) {
        // detect when we are in the admin dashboard and force english
        if ( is_admin() ) {
            $locale = 'en_US';
        }

        return $locale;
    }

    add_filter( 'locale', 'uniquePrefix_force_english_only_admin', 1, 1 );
}

    Expand full source codeCollapse full source code

  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Steven Lin —

    Example migrated from Codex:

    An example of changing the locale language based on the $_GET parameter of the URL.

    <?php
add_filter( 'locale', 'set_my_locale' );

function set_my_locale( $lang ) {
   if ( 'gl' == $_GET['language'] ) {
      // set to Greenlandic
      return 'ka_GL';
   } else {
      // return original language
      return $lang;
   }
}
?>

    Expand full source codeCollapse full source code

You must log in before being able to contribute a note or feedback.