determine_locale()

Determine the current locale desired for the request.

Contents

Description Description

Return Return

(string) The determined locale.

Top ↑

Source Source

File: wp-includes/l10n.php

116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
function determine_locale() {
    /**
     * Filters the locale for the current request prior to the default determination process.
     *
     * Using this filter allows to override the default logic, effectively short-circuiting the function.
     *
     * @since 5.0.0
     *
     * @param string|null The locale to return and short-circuit, or null as default.
     */
    $determined_locale = apply_filters( 'pre_determine_locale', null );
    if ( ! empty( $determined_locale ) && is_string( $determined_locale ) ) {
        return $determined_locale;
    }
 
    $determined_locale = get_locale();
 
    if ( is_admin() ) {
        $determined_locale = get_user_locale();
    }
 
    if ( isset( $_GET['_locale'] ) && 'user' === $_GET['_locale'] && wp_is_json_request() ) {
        $determined_locale = get_user_locale();
    }
 
    if ( ! empty( $_GET['wp_lang'] ) && ! empty( $GLOBALS['pagenow'] ) && 'wp-login.php' === $GLOBALS['pagenow'] ) {
        $determined_locale = sanitize_text_field( $_GET['wp_lang'] );
    }
 
    /**
     * Filters the locale for the current request.
     *
     * @since 5.0.0
     *
     * @param string $locale The locale.
     */
    return apply_filters( 'determine_locale', $determined_locale );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
5.0.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/load.php: wp_is_json_request()

Checks whether current request is a JSON request, or is expecting a JSON response.
wp-includes/l10n.php: pre_determine_locale

Filters the locale for the current request prior to the default determination process.
wp-includes/l10n.php: determine_locale

Filters the locale for the current request.
wp-includes/l10n.php: get_user_locale()

Retrieves the locale of a user.
wp-includes/l10n.php: get_locale()

Retrieves the current locale.
wp-includes/formatting.php: sanitize_text_field()

Sanitizes a string from user input or from the database.
wp-includes/load.php: is_admin()

Determines whether the current request is for an administrative interface page.
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.
Show 3 more uses Hide more uses

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/l10n.php: load_script_textdomain()

Loads the script translated strings.
wp-includes/l10n.php: _get_path_to_translation_from_lang_dir()

Gets the path to a translation file in the languages directory for the current locale.
wp-includes/class-wp-locale-switcher.php: WP_Locale_Switcher::switch_to_locale()

Switches the translations according to the given locale.
wp-includes/class-wp-locale-switcher.php: WP_Locale_Switcher::__construct()

Constructor.
wp-includes/l10n.php: load_default_textdomain()

Load default translated strings based on locale.
wp-includes/l10n.php: load_plugin_textdomain()

Loads a plugin’s translated strings.
wp-includes/l10n.php: load_muplugin_textdomain()

Load the translated strings for a plugin residing in the mu-plugins directory.
wp-includes/l10n.php: load_theme_textdomain()

Load the theme’s translated strings.
wp-includes/general-template.php: get_bloginfo()

Retrieves information about the current site.
wp-includes/script-loader.php: wp_default_scripts()

Register all WordPress scripts.
Show 5 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

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