Changeset 43825 for branches/5.0/src/wp-includes/class.wp-scripts.php

Timestamp:

10/25/2018 01:59:51 PM (6 years ago)

Author:

herregroen

Message:

I18N: Add JavaScript translation support.

Adds the wp_set_script_translations function which registers translations for a JavaScript file. This function takes a handle, domain and optionally a path and ensures JavaScript translation files are loaded if they exist.

Props atimmer, omarreiss, nerrad, swissspidy, ocean90.
Fixes #45103.

File:

• branches/5.0/src/wp-includes/class.wp-scripts.php (modified) (1 diff)

branches/5.0/src/wp-includes/class.wp-scripts.php

@@ -479 +479 @@
 
     /**
+     * Register a translation textdomain.
+     *
+     * @since 5.0.0
+     *
+     * @param string $handle Name of the script to register a translation domain to.
+     * @param string $domain The textdomain.
+     * @param string $path   Optional. The full file path to the directory containing translation files.
+     *
+     * @return bool True if the textdomain was registered, false if not.
+     */
+    public function set_translations( $handle, $domain, $path = null ) {
+        if ( ! isset( $this->registered[ $handle ] ) ) {
+            return false;
+        }
+
+        $json_translations = load_script_textdomain( $handle, $domain, $path );
+
+        if ( ! $json_translations ) {
+            return false;
+        }
+
+        /** @var \_WP_Dependency $obj */
+        $obj = $this->registered[ $handle ];
+        $obj->deps[] = 'wp-i18n';
+
+        return $this->add_inline_script(
+            $handle,
+            '(function( translations ){' .
+                'wp.i18n.setLocaleData( translations.locale_data, "' . $domain . '" );' .
+            '})(' . $json_translations . ');',
+            'before'
+        );
+    }
+
+    /**
      * Determines script dependencies.
      *