Changeset 44134 for trunk/src/wp-includes/l10n.php

Timestamp:

12/14/2018 01:31:27 AM (6 years ago)

Author:

jeremyfelt

Message:

REST API: Render response in user locale with ?_locale=user.

Introduces new determine_locale() function for deciding the proper locale to use for a response. Default value is get_user_locale() in the admin, and get_locale() on the frontend. Because REST API requests are considered frontend requests, ?_locale=user can be used to render the response in the user's locale.

Also updates wp-login.php?wp_lang implementation to benefit from this abstraction.

Merges [43776] from the 5.0 branch to trunk.

Props flixos90, mnelson4, swissspidy, TimothyBlynJacobs.
Fixes #44758.

Location:

trunk

Files:

• . (modified) (1 prop)
• src/wp-includes/l10n.php (modified) (6 diffs)

trunk/src/wp-includes/l10n.php

@@ -103 +103 @@
     $locale = $user->locale;
     return $locale ? $locale : get_locale();
+}
+
+/**
+ * Determine the current locale desired for the request.
+ *
+ * @since 5.0.0
+ *
+ * @global string $pagenow
+ *
+ * @return string The determined locale.
+ */
+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() && is_user_logged_in() ) {
+        $determined_locale = get_user_locale();
+    }
+
+    if ( ! empty( $_GET['wp_lang'] ) && '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 );
 }
 
@@ -686 +734 @@
 function load_default_textdomain( $locale = null ) {
     if ( null === $locale ) {
-        $locale = is_admin() ? get_user_locale() : get_locale();
+        $locale = determine_locale();
     }
 
@@ -735 +783 @@
      * @param string $domain Text domain. Unique identifier for retrieving translated strings.
      */
-    $locale = apply_filters( 'plugin_locale', is_admin() ? get_user_locale() : get_locale(), $domain );
+    $locale = apply_filters( 'plugin_locale', determine_locale(), $domain );
 
     $mofile = $domain . '-' . $locale . '.mo';
@@ -769 +817 @@
 function load_muplugin_textdomain( $domain, $mu_plugin_rel_path = '' ) {
     /** This filter is documented in wp-includes/l10n.php */
-    $locale = apply_filters( 'plugin_locale', is_admin() ? get_user_locale() : get_locale(), $domain );
+    $locale = apply_filters( 'plugin_locale', determine_locale(), $domain );
 
     $mofile = $domain . '-' . $locale . '.mo';
@@ -808 +856 @@
      * @param string $domain Text domain. Unique identifier for retrieving translated strings.
      */
-    $locale = apply_filters( 'theme_locale', is_admin() ? get_user_locale() : get_locale(), $domain );
+    $locale = apply_filters( 'theme_locale', determine_locale(), $domain );
 
     $mofile = $domain . '-' . $locale . '.mo';
@@ -942 +990 @@
     }
 
-    $locale = is_admin() ? get_user_locale() : get_locale();
+    $locale = determine_locale();
     $mofile = "{$domain}-{$locale}.mo";