Changeset 44169 for trunk/src/wp-includes/functions.wp-scripts.php

Timestamp:

12/14/2018 05:51:31 AM (6 years ago)

Author:

pento

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.

Merges [43825,43828,43859,43898] from the 5.0 branch to trunk.

Props herregroen, atimmer, omarreiss, nerrad, swissspidy, ocean90, georgestephanis.
Fixes #45103, #45256.

Location:

trunk

Files:

• . (modified) (1 prop)
• src/wp-includes/functions.wp-scripts.php (modified) (1 diff)

trunk/src/wp-includes/functions.wp-scripts.php

@@ -199 +199 @@
 
     return $wp_scripts->localize( $handle, $object_name, $l10n );
+}
+
+/**
+ * Sets translated strings for a script.
+ *
+ * Works only if the script has already been added.
+ *
+ * @see WP_Scripts::set_translations()
+ * @global WP_Scripts $wp_scripts The WP_Scripts object for printing scripts.
+ *
+ * @since 5.0.0
+ *
+ * @param string $handle Script handle the textdomain will be attached 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 successfully localized, false otherwise.
+ */
+function wp_set_script_translations( $handle, $domain, $path = null ) {
+    global $wp_scripts;
+    if ( ! ( $wp_scripts instanceof WP_Scripts ) ) {
+        _wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );
+        return false;
+    }
+
+    return $wp_scripts->set_translations( $handle, $domain, $path );
 }