Ticket #45103: 45103.7.diff

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

@@ -478 +478 @@
         }
 
         /**
-         * Register a translation textdomain.
+         * Sets a translation textdomain.
          *
          * @since 5.0.0
          *

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

@@ -193 +193 @@
 }
 
 /**
- * Register translated strings for a script.
+ * Sets translated strings for a script.
  *
  * Works only if the script has already been added.
  *
  * @see WP_Scripts::set_translations()
- * @link https://core.trac.wordpress.org/ticket/45103
  * @global WP_Scripts $wp_scripts The WP_Scripts object for printing scripts.
  *
  * @since 5.0.0

src/wp-includes/l10n.php

@@ -876 +876 @@
  * @link https://core.trac.wordpress.org/ticket/45103
  * @global WP_Scripts $wp_scripts The WP_Scripts object for printing scripts.
  *
+ * @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.
@@ -889 +891 @@
         $locale = is_admin() ? get_locale() : get_user_locale();
 
         // If a path was given and the handle file exists simply return it.
-        $handle_filename = $domain . '-' . $locale . '-' . $handle . '.json';
+        $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 );
         }
@@ -908 +911 @@
 
         // If the host is the same or it's a relative URL.
         if (
-                strpos( $content_url['path'], $src_url['path'] ) === 0 &&
+                strpos( $src_url['path'], $content_url['path'] ) === 0 &&
                 ( ! isset( $src_url['host'] ) || $src_url['host'] !== $content_url['host'] )
         ) {
                 // Make the src relative the specific plugin or theme.
@@ -925 +928 @@
         ) {
                 $relative = trim( $src_url['path'], '/' );
         } else if (
-                ( strpos( $site_url['path'], $src_url['path'] ) === 0 ) &&
+                ( strpos( $src_url['path'], $site_url['path'] ) === 0 ) &&
                 ( ! isset( $src_url['host'] ) || $src_url['host'] !== $site_url['host'] )
         ) {
                 // Make the src relative to the WP root.
@@ -943 +946 @@
                 $relative = substr( $relative, 0, -7 ) . '.js';
         }
 
-        $md5_filename = $domain . '-' . $locale . '-' . md5( $relative ) . '.json';
+        $md5_filename = $file_base . '-' . md5( $relative ) . '.json';
         if ( $path && file_exists( $path . '/' . $md5_filename ) ) {
                 return file_get_contents( $path . '/' . $md5_filename );
         }

tests/phpunit/data/languages/admin-en_US-script-handle.json

@@ +1 @@
+{
+  "translation-revision-data": "+0000",
+  "generator":                 "GlotPress/2.3.0-alpha",
+  "domain":                    "messages",
+  "locale_data":               {
+    "messages": {
+      "":                                                             {
+        "domain":       "messages",
+        "plural-forms": "n != 1",
+        "lang":         "en-gb"
+      },
+      "This file is a translation for script-handle.": [
+        "This file is a translation for script-handle."
+      ]
+    }
+  }
+}

tests/phpunit/data/languages/default-en_US-813e104eb47e13dd4cc5af844c618754.json

@@ -1 @@
-{
-  "translation-revision-data": "+0000",
-  "generator":                 "GlotPress/2.3.0-alpha",
-  "domain":                    "messages",
-  "locale_data":               {
-    "messages": {
-      "":                                                             {
-        "domain":       "messages",
-        "plural-forms": "n != 1",
-        "lang":         "en-gb"
-      },
-      "This file is too big. Files must be less than %d KB in size.": [
-        "This file is too big. Files must be less than %d KB in size."
-      ],
-      "%d Theme Update":                                              [
-        "%d Theme Update",
-        "%d Theme Updates"
-      ],
-      "password strength\u0004Medium":                                [
-        "Medium"
-      ],
-      "taxonomy singular name\u0004Category":                         [
-        "Category"
-      ],
-      "post type general name\u0004Pages":                            [
-        "Pages"
-      ]
-    }
-  }
-}

tests/phpunit/data/languages/plugins/internationalized-plugin-en_US-2f86cb96a0233e7cb3b6f03ad573be0b.json

@@ +1 @@
+{
+  "translation-revision-data": "+0000",
+  "generator":                 "GlotPress/2.3.0-alpha",
+  "domain":                    "messages",
+  "locale_data":               {
+    "messages": {
+      "":                                                             {
+        "domain":       "messages",
+        "plural-forms": "n != 1",
+        "lang":         "en-gb"
+      },
+      "This is a dummy plugin.": [
+        "This is a dummy plugin."
+      ]
+    }
+  }
+}

tests/phpunit/data/languages/themes/internationalized-theme-en_US-2f86cb96a0233e7cb3b6f03ad573be0b.json

@@ +1 @@
+{
+  "translation-revision-data": "+0000",
+  "generator":                 "GlotPress/2.3.0-alpha",
+  "domain":                    "messages",
+  "locale_data":               {
+    "messages": {
+      "":                                                             {
+        "domain":       "messages",
+        "plural-forms": "n != 1",
+        "lang":         "en-gb"
+      },
+      "This is a dummy theme.": [
+        "This is a dummy theme."
+      ]
+    }
+  }
+}

tests/phpunit/tests/dependencies/scripts.php

@@ -770 +770 @@
         /**
          * @ticket 45103
          */
-        public function test_wp_set_script_translation() {
+        public function test_wp_set_script_translations() {
                 wp_register_script( 'wp-i18n', '/wp-includes/js/dist/wp-i18n.js', array(), null );
                 wp_enqueue_script( 'test-example', '/wp-includes/js/script.js', array(), null );
                 wp_set_script_translations( 'test-example', 'default',  DIR_TESTDATA . '/languages/' );
@@ -778 +778 @@
                 $expected  = "<script type='text/javascript' src='/wp-includes/js/dist/wp-i18n.js'></script>";
                 $expected .= "\n<script type='text/javascript'>\n(function( translations ){" .
                             "wp.i18n.setLocaleData( translations.locale_data, \"default\" );" .
-                        "})(" . file_get_contents( DIR_TESTDATA . '/languages/default-en_US-813e104eb47e13dd4cc5af844c618754.json') . ");\n</script>\n";
+                        "})(" . file_get_contents( DIR_TESTDATA . '/languages/en_US-813e104eb47e13dd4cc5af844c618754.json' ) . ");\n</script>\n";
                 $expected .= "<script type='text/javascript' src='/wp-includes/js/script.js'></script>\n";
 
                 $this->assertEquals( $expected, get_echo( 'wp_print_scripts' ) );
@@ -785 +785 @@
         }
 
         /**
+         * @ticket 45103
+         */
+        public function test_wp_set_script_translations_for_plugin() {
+                wp_register_script( 'wp-i18n', '/wp-includes/js/dist/wp-i18n.js', array(), null );
+                wp_enqueue_script( 'plugin-example', '/wp-content/plugins/my-plugin/js/script.js', array(), null );
+                wp_set_script_translations( 'plugin-example', 'internationalized-plugin',  DIR_TESTDATA . '/languages/plugins/' );
+
+                $expected  = "<script type='text/javascript' src='/wp-includes/js/dist/wp-i18n.js'></script>";
+                $expected .= "\n<script type='text/javascript'>\n(function( translations ){" .
+                             "wp.i18n.setLocaleData( translations.locale_data, \"internationalized-plugin\" );" .
+                             "})(" . file_get_contents( DIR_TESTDATA . '/languages/plugins/internationalized-plugin-en_US-2f86cb96a0233e7cb3b6f03ad573be0b.json' ) . ");\n</script>\n";
+                $expected .= "<script type='text/javascript' src='/wp-content/plugins/my-plugin/js/script.js'></script>\n";
+
+                $this->assertEquals( $expected, get_echo( 'wp_print_scripts' ) );
+        }
+
+        /**
+         * @ticket 45103
+         */
+        public function test_wp_set_script_translations_for_theme() {
+                wp_register_script( 'wp-i18n', '/wp-includes/js/dist/wp-i18n.js', array(), null );
+                wp_enqueue_script( 'theme-example', '/wp-content/themes/my-theme/js/script.js', array(), null );
+                wp_set_script_translations( 'theme-example', 'internationalized-theme',  DIR_TESTDATA . '/languages/themes/' );
+
+                $expected  = "<script type='text/javascript' src='/wp-includes/js/dist/wp-i18n.js'></script>";
+                $expected .= "\n<script type='text/javascript'>\n(function( translations ){" .
+                             "wp.i18n.setLocaleData( translations.locale_data, \"internationalized-theme\" );" .
+                             "})(" . file_get_contents( DIR_TESTDATA . '/languages/themes/internationalized-theme-en_US-2f86cb96a0233e7cb3b6f03ad573be0b.json' ) . ");\n</script>\n";
+                $expected .= "<script type='text/javascript' src='/wp-content/themes/my-theme/js/script.js'></script>\n";
+
+                $this->assertEquals( $expected, get_echo( 'wp_print_scripts' ) );
+        }
+
+        /**
+         * @ticket 45103
+         */
+        public function test_wp_set_script_translations_with_handle_file() {
+                wp_register_script( 'wp-i18n', '/wp-includes/js/dist/wp-i18n.js', array(), null );
+                wp_enqueue_script( 'script-handle', '/wp-admin/js/script.js', array(), null );
+                wp_set_script_translations( 'script-handle', 'admin',  DIR_TESTDATA . '/languages/' );
+
+                $expected  = "<script type='text/javascript' src='/wp-includes/js/dist/wp-i18n.js'></script>";
+                $expected .= "\n<script type='text/javascript'>\n(function( translations ){" .
+                             "wp.i18n.setLocaleData( translations.locale_data, \"admin\" );" .
+                             "})(" . file_get_contents( DIR_TESTDATA . '/languages/admin-en_US-script-handle.json' ) . ");\n</script>\n";
+                $expected .= "<script type='text/javascript' src='/wp-admin/js/script.js'></script>\n";
+
+                $this->assertEquals( $expected, get_echo( 'wp_print_scripts' ) );
+        }
+
+        /**
+         * @ticket 45103
+         */
+        public function test_wp_set_script_translations_i18n_dependency() {
+                global $wp_scripts;
+
+                wp_register_script( 'wp-i18n', '/wp-includes/js/dist/wp-i18n.js', array(), null );
+                wp_enqueue_script( 'test-example', '/wp-includes/js/script.js', array(), null );
+                wp_set_script_translations( 'test-example', 'default',  DIR_TESTDATA . '/languages/' );
+
+                $script = $wp_scripts->registered[ 'test-example' ];
+
+                $this->assertContains( 'wp-i18n', $script->deps );
+        }
+
+        /**
+         * @ticket 45103
+         */
+        public function test_wp_set_script_translations_when_translation_file_does_not_exist() {
+                wp_register_script( 'wp-i18n', '/wp-includes/js/dist/wp-i18n.js', array(), null );
+                wp_enqueue_script( 'test-example', '/wp-admin/js/script.js', array(), null );
+                wp_set_script_translations( 'test-example', 'admin',  DIR_TESTDATA . '/languages/' );
+
+                $expected = "<script type='text/javascript' src='/wp-admin/js/script.js'></script>\n";
+
+                $this->assertEquals( $expected, get_echo( 'wp_print_scripts' ) );
+        }
+
+        /**
+         * @ticket 45103
+         */
+        public function test_wp_set_script_translations_before_enqueue() {
+                $this->expected_doing_it_wrong = array_merge( $this->expected_doing_it_wrong, array( 'wp_set_script_translations' ) );
+                wp_register_script( 'wp-i18n', '/wp-includes/js/dist/wp-i18n.js', array(), null );
+                wp_register_script( 'test-example', '/wp-admin/js/script.js', array(), null );
+                wp_set_script_translations( 'test-example', 'admin',  DIR_TESTDATA . '/languages/' );
+        }
+
+        /**
          * Testing `wp_enqueue_code_editor` with file path.
          *
          * @ticket 41871