Ticket #45425: 45425.diff

src/wp-includes/l10n.php

@@ -895 +895 @@
         $file_base       = $domain === 'default' ? $locale : $domain . '-' . $locale;
         $handle_filename = $file_base . '-' . $handle . '.json';
         if ( $path && file_exists( $path . '/' . $handle_filename ) ) {
-                return file_get_contents( $path . '/' . $handle_filename );
+                return load_script_translation( $path . '/' . $handle_filename, $handle, $domain );
         }
 
         $obj = $wp_scripts->registered[ $handle ];
@@ -935 +935 @@
 
         // If the source is not from WP.
         if ( false === $relative ) {
-                return false;
+                return load_script_translation( false, $handle, $domain );
         }
 
         // Translations are always based on the unminified filename.
@@ -945 +945 @@
 
         $md5_filename = $file_base . '-' . md5( $relative ) . '.json';
         if ( $path && file_exists( $path . '/' . $md5_filename ) ) {
-                return file_get_contents( $path . '/' . $md5_filename );
+                return load_script_translation( $path . '/' . $md5_filename, $handle, $domain );
         }
         if ( file_exists( $languages_path . '/' . $md5_filename ) ) {
-                return file_get_contents( $languages_path . '/' . $md5_filename );
+                return load_script_translation( $languages_path . '/' . $md5_filename, $handle, $domain );
         }
 
-        return false;
+        return load_script_translation( false, $handle, $domain );
+}
+
+/**
+ * Load the translated strings for the given script handle and textdomain.
+ *
+ * @since 5.0.0
+ *
+ * @param string|false $file   Path to the translation file to load. False if there isn't one.
+ * @param string       $handle Name of the script to register a translation domain to.
+ * @param string       $domain The textdomain.
+ * @return string|false The JSON-encoded translated strings for the given script handle and textdomain. False if there are none.
+ */
+function load_script_translation( $file, $handle, $domain ) {
+        /**
+         * Pre-filters script translations for the given file, script handle and text domain.
+         *
+         * Returning a non-null value allows to override the default logic, effectively short-circuiting the function.
+         *
+         * @since 5.0.0
+         *
+         * @param string|false $translations JSON-encoded translation data. Default null.
+         * @param string|false $file         Path to the translation file to load. False if there isn't one.
+         * @param string       $handle       Name of the script to register a translation domain to.
+         * @param string       $domain       The textdomain.
+         */
+        $translations = apply_filters( 'pre_load_script_translation', null, $file, $handle, $domain );
+
+        if ( null !== $translations ) {
+                return $translations;
+        }
+
+        /**
+         * Filters the file path for loading script translations for the given script handle and textdomain.
+         *
+         * @since 5.0.0
+         *
+         * @param string|false $file   Path to the translation file to load. False if there isn't one.
+         * @param string       $handle Name of the script to register a translation domain to.
+         * @param string       $domain The textdomain.
+         */
+        $file = apply_filters( 'load_script_textdomain_file', $file, $handle, $domain );
+
+        if ( ! $file || ! is_readable( $file ) ) {
+                return false;
+        }
+
+        $translations = file_get_contents( $file );
+
+        /**
+         * Filters script translations for the given file, script handle and text domain.
+         *
+         * @since 5.0.0
+         *
+         * @param string $translations JSON-encoded translation data
+         * @param string $file         Path to the translation file that was loaded.
+         * @param string $handle       Name of the script to register a translation domain to.
+         * @param string $domain       The textdomain.
+         */
+        return apply_filters( 'load_script_translation', $translations, $file, $handle, $domain );
 }
 
 /**