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

Timestamp:

04/30/2024 08:37:25 AM (7 months ago)

Author:

swissspidy

Message:

I18N: Actually add all the files for [58061], not just the test fixtures.

Improve support for using only PHP translation files.

This builds on top of the PHP translation file support added in WordPress 6.5, improving the behavior for projects using solely .l10n.php translation files and no .mo. and .po files.

Updates wp_get_installed_translations(), which is used when updating language packs and when uninstalling plugins/themes (to remove the translations again), to look for PHP translation files and read metadata from them. Additionally, the file lookup is now cached thanks to using WP_Textdomain_Registry.

Updates Language_Pack_Upgrader::check_package() to allow language packs that only contain PHP translation files. While WordPress.org continues to serve .mo and .po files, third-party services might want to only use the PHP file format.

See #60554.

File:

• trunk/src/wp-includes/l10n.php (modified) (4 diffs)

trunk/src/wp-includes/l10n.php

@@ -1506 +1506 @@
  * @since 3.7.0
  *
+ * @global WP_Textdomain_Registry $wp_textdomain_registry WordPress Textdomain Registry.
+ *
  * @param string $type What to search for. Accepts 'plugins', 'themes', 'core'.
  * @return array Array of language data.
  */
 function wp_get_installed_translations( $type ) {
+    global $wp_textdomain_registry;
+
     if ( 'themes' !== $type && 'plugins' !== $type && 'core' !== $type ) {
         return array();
     }
 
-    $dir = 'core' === $type ? '' : "/$type";
-
-    if ( ! is_dir( WP_LANG_DIR ) ) {
+    $dir = 'core' === $type ? WP_LANG_DIR : WP_LANG_DIR . "/$type";
+
+    if ( ! is_dir( $dir ) ) {
         return array();
     }
 
-    if ( $dir && ! is_dir( WP_LANG_DIR . $dir ) ) {
-        return array();
-    }
-
-    $files = scandir( WP_LANG_DIR . $dir );
+    $files = $wp_textdomain_registry->get_language_files_from_path( $dir );
     if ( ! $files ) {
         return array();
@@ -1532 +1532 @@
 
     foreach ( $files as $file ) {
-        if ( '.' === $file[0] || is_dir( WP_LANG_DIR . "$dir/$file" ) ) {
-            continue;
-        }
-        if ( ! str_ends_with( $file, '.po' ) ) {
-            continue;
-        }
-        if ( ! preg_match( '/(?:(.+)-)?([a-z]{2,3}(?:_[A-Z]{2})?(?:_[a-z0-9]+)?).po/', $file, $match ) ) {
-            continue;
-        }
-        if ( ! in_array( substr( $file, 0, -3 ) . '.mo', $files, true ) ) {
+        if ( ! preg_match( '/(?:(.+)-)?([a-z]{2,3}(?:_[A-Z]{2})?(?:_[a-z0-9]+)?)\.(?:mo|l10n\.php)/', basename( $file ), $match ) ) {
             continue;
         }
@@ -1549 +1540 @@
             $textdomain = 'default';
         }
-        $language_data[ $textdomain ][ $language ] = wp_get_pomo_file_data( WP_LANG_DIR . "$dir/$file" );
+
+        if ( str_ends_with( $file, '.mo' ) ) {
+            $pofile = substr_replace( $file, '.po', - strlen( '.mo' ) );
+
+            if ( ! file_exists( $pofile ) ) {
+                continue;
+            }
+
+            $language_data[ $textdomain ][ $language ] = wp_get_pomo_file_data( $pofile );
+        } else {
+            $pofile = substr_replace( $file, '.po', - strlen( '.l10n.php' ) );
+
+            // If both a PO and a PHP file exist, prefer the PO file.
+            if ( file_exists( $pofile ) ) {
+                continue;
+            }
+
+            $language_data[ $textdomain ][ $language ] = wp_get_l10n_php_file_data( $file );
+        }
     }
     return $language_data;
@@ -1577 +1586 @@
     }
     return $headers;
+}
+
+/**
+ * Extracts headers from a PHP translation file.
+ *
+ * @since 6.6.0
+ *
+ * @param string $php_file Path to a `.l10n.php` file.
+ * @return string[] Array of file header values keyed by header name.
+ */
+function wp_get_l10n_php_file_data( $php_file ) {
+    $data = (array) include $php_file;
+
+    unset( $data['messages'] );
+    $headers = array(
+        'POT-Creation-Date'  => 'pot-creation-date',
+        'PO-Revision-Date'   => 'po-revision-date',
+        'Project-Id-Version' => 'project-id-version',
+        'X-Generator'        => 'x-generator',
+    );
+
+    $result = array(
+        'POT-Creation-Date'  => '',
+        'PO-Revision-Date'   => '',
+        'Project-Id-Version' => '',
+        'X-Generator'        => '',
+    );
+
+    foreach ( $headers as $po_header => $php_header ) {
+        if ( isset( $data[ $php_header ] ) ) {
+            $result[ $po_header ] = $data[ $php_header ];
+        }
+    }
+
+    return $result;
 }