WordPress at a glance
Home All Hooks Hooks

locale filter-hook . WP 1.5.0

Allows you to change the name of the locale (en_US), which WordPress gets in too many places around its code, via the function get_locale().

Usage

add_filter( 'locale', 'filter_function_name_9802' );
function filter_function_name_9802( $locale ){
	// filter...

	return $locale;
}
$locale(string)
The locale ID. Example: en_US, ru_RU.

Examples

#1 Change the localization language

This example shows how to change the localization language in WordPress based on the language variable passed in $_GET query parameter:

add_filter( 'locale', 'set_my_locale' );
function set_my_locale( $lang ) {
	if( 'ru' == $_GET['language'] )
		return 'ru_RU';
	else
		return $lang;
}

Changelog

Since 1.5.0 Introduced.

Where the hook is called

get_locale()
locale
wp-includes/l10n.php 41
return apply_filters( 'locale', $locale );
wp-includes/l10n.php 75
return apply_filters( 'locale', $locale );

Where the hook is used (in WP core)

wp-includes/class-wp-locale-switcher.php 60
add_filter( 'locale', array( $this, 'filter_locale' ) );
No comments
    Hello, !     Log In . Register