determine_locale()
Gets the current site locale (site language, ex, en_US) desired for the request.
- On front-pages return the result of get_locale() function.
- On admin-pages return the result of get_user_locale() function.
- For REST (JSON) request return the result of get_user_locale() function, if GET parameter contains
?_locale=user
. - On
wp-login.php
page — you can change the locale by settingwp_lang
GET parameter, for example,?wp_lang=ru_RU
.
This new function is a wrapper for smart usage of both functions: get_locale() and get_user_locale().
Uses: get_locale(), get_user_locale()
1 time — 0.000001 sec (speed of light) | 50000 times — 0.09 sec (speed of light) | PHP 7.2.5, WP 5.0
Hooks from the function
Return
String
. The determined locale. Ex: ru_RU
.
Usage
determine_locale();
Examples
#1 What the function returns
echo determine_locale(); // display 'ru_RU', for russian site
#2 The example of translation file load
add_action( 'plugins_loaded', 'load_my_textdomain' ); function load_my_textdomain(){ $mo_file_path = dirname(__FILE__) . '/lang/'. determine_locale() . '.mo'; load_textdomain( 'mytexdomain', $mo_file_path ); }
Notes
- Global. String. $pagenow The filename of the current screen.
Changelog
Since 5.0.0 | Introduced. |