Changeset 65226 for trunk/src/wp-admin/update-core.php

Timestamp:

11/03/2026 01:38:37 PM (9 days ago)

Author:

audrasjb

Message:

Upgrade/Install: Show and allow to select translation updates on the Updates screen.

This changeset introduces a way to see each available translation update on the Updates screen, and allows users to update them selectively. With this change, translation updates management is more consistent with how plugin and theme updates are managed.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11610.

Props stk_jj, Presskopp, jyria, tfrommen, audrasjb, ozgursar, im3dabasia1.
Fixes #42281.

File:

• trunk/src/wp-admin/update-core.php (modified) (6 diffs)

trunk/src/wp-admin/update-core.php

@@ -814 +814 @@
  */
 function list_translation_updates() {
-        $updates = wp_get_translation_updates();
-        if ( ! $updates ) {
+        $translation_updates = wp_get_translation_update_data();
+        if ( ! $translation_updates ) {
                 if ( 'en_US' !== get_locale() ) {
                         echo '<h2>' . __( 'Translations' ) . '</h2>';
@@ -823 +823 @@
         }
 
-        $form_action = 'update-core.php?action=do-translation-upgrade';
+        $form_action   = 'update-core.php?action=do-translation-upgrade';
+        $updates_count = count( $translation_updates );
         ?>
-        <h2><?php _e( 'Translations' ); ?></h2>
+        <h2>
+        <?php
+        printf(
+                '%s <span class="count">(%s)</span>',
+                __( 'Translations' ),
+                number_format_i18n( $updates_count )
+        );
+        ?>
+        </h2>
         <form method="post" action="<?php echo esc_url( $form_action ); ?>" name="upgrade-translations" class="upgrade">
-                <p><?php _e( 'New translations are available.' ); ?></p>
+                <p><?php _e( 'The following translation updates are available. Leave any translation updates unchecked if you want to install them later, then click &#8220;Update Translations&#8221;.' ); ?></p>
+                <p><?php _e( 'Translation updates you leave unchecked will remain available until you select them.' ); ?></p>
                 <?php wp_nonce_field( 'upgrade-translations' ); ?>
-                <p><input class="button" type="submit" value="<?php esc_attr_e( 'Update Translations' ); ?>" name="upgrade" /></p>
+                <p><input id="upgrade-translations" class="button" type="submit" value="<?php esc_attr_e( 'Update Translations' ); ?>" name="upgrade" /></p>
+                <table class="widefat updates-table" id="update-translations-table">
+                        <thead>
+                        <tr>
+                                <td class="manage-column check-column"><input type="checkbox" id="translations-select-all" /></td>
+                                <td class="manage-column"><label for="translations-select-all"><?php _e( 'Select All' ); ?></label></td>
+                        </tr>
+                        </thead>
+
+                        <tbody class="plugins">
+                        <?php foreach ( $translation_updates as $translation_update ) : ?>
+                                <?php $checkbox_id = 'checkbox_' . md5( $translation_update['id'] ); ?>
+                                <tr>
+                                        <td class="check-column">
+                                                <input type="hidden" name="translations[]" value="<?php echo esc_attr( $translation_update['id'] ); ?>" />
+                                                <input type="checkbox" name="checked[]" id="<?php echo esc_attr( $checkbox_id ); ?>" value="<?php echo esc_attr( $translation_update['id'] ); ?>" <?php checked( $translation_update['checked'] ); ?> />
+                                                <label for="<?php echo esc_attr( $checkbox_id ); ?>">
+                                                        <span class="screen-reader-text">
+                                                        <?php
+                                                        printf(
+                                                                /* translators: 1: Project name, 2: Language name or locale. */
+                                                                esc_html__( 'Select the translation update for %1$s in %2$s' ),
+                                                                esc_html( $translation_update['name'] ),
+                                                                esc_html( $translation_update['language'] )
+                                                        );
+                                                        ?>
+                                                        </span>
+                                                </label>
+                                        </td>
+                                        <td class="plugin-title"><p>
+                                                <strong><?php echo esc_html( $translation_update['name'] ); ?></strong>
+                                                <?php
+                                                printf(
+                                                        /* translators: 1: Language name or locale, 2: Version number. */
+                                                        esc_html__( '%1$s translation is available for version %2$s.' ),
+                                                        esc_html( $translation_update['language'] ),
+                                                        esc_html( $translation_update['version'] )
+                                                );
+
+                                                if ( $translation_update['deferred'] ) {
+                                                        echo ' ';
+                                                        esc_html_e( 'This translation update will remain available until you select it.' );
+                                                }
+                                                ?>
+                                        </p></td>
+                                </tr>
+                        <?php endforeach; ?>
+                        </tbody>
+
+                        <tfoot>
+                        <tr>
+                                <td class="manage-column check-column"><input type="checkbox" id="translations-select-all-2" /></td>
+                                <td class="manage-column"><label for="translations-select-all-2"><?php _e( 'Select All' ); ?></label></td>
+                        </tr>
+                        </tfoot>
+                </table>
+                <p><input id="upgrade-translations-2" class="button" type="submit" value="<?php esc_attr_e( 'Update Translations' ); ?>" name="upgrade" /></p>
         </form>
         <?php
@@ -1003 +1069 @@
 
 if ( 'en_US' !== get_locale() ) {
-        $updates_howto .= '<p>' . __( '<strong>Translations</strong> &mdash; The files translating WordPress into your language are updated for you whenever any other updates occur. But if these files are out of date, you can <strong>click the &#8220;Update Translations&#8221;</strong> button.' ) . '</p>';
+        $updates_howto .= '<p>' . __( '<strong>Translations</strong> &mdash; Translation updates are selected for installation by default. Leave any translation updates unchecked if you want to install them later, then <strong>click the &#8220;Update Translations&#8221;</strong> button. Translation updates you leave unchecked will remain available until you select them.' ) . '</p>';
 }
 
@@ -1093 +1159 @@
         }
 
+        $translation_updates_status = isset( $_GET['translation_updates'] ) ? wp_unslash( $_GET['translation_updates'] ) : '';
+        if ( is_string( $translation_updates_status ) ) {
+                $translation_updates_status = sanitize_key( $translation_updates_status );
+        } else {
+                $translation_updates_status = '';
+        }
+
+        if ( 'deferred' === $translation_updates_status ) {
+                wp_admin_notice(
+                        __( 'The unchecked translation updates will remain available until you select them.' ),
+                        array(
+                                'type' => 'success',
+                        )
+                );
+        }
+
         $last_update_check = false;
         $current           = get_site_transient( 'update_core' );
@@ -1276 +1358 @@
         check_admin_referer( 'upgrade-translations' );
 
+        // Requests without the form's update identifiers must not install all translations.
+        $translation_update_ids          = array_unique(
+                array_map(
+                        'sanitize_text_field',
+                        wp_unslash( (array) ( $_POST['translations'] ?? array() ) )
+                )
+        );
+        $selected_translation_update_ids = array_unique(
+                array_map(
+                        'sanitize_text_field',
+                        wp_unslash( (array) ( $_POST['checked'] ?? array() ) )
+                )
+        );
+
+        $selected_translation_updates = wp_process_translation_update_selection( $translation_update_ids, $selected_translation_update_ids );
+
+        if ( false === $selected_translation_updates ) {
+                wp_redirect( self_admin_url( 'update-core.php' ) );
+                exit;
+        }
+
+        if ( empty( $selected_translation_updates ) ) {
+                wp_redirect( add_query_arg( 'translation_updates', 'deferred', self_admin_url( 'update-core.php' ) ) );
+                exit;
+        }
+
         require_once ABSPATH . 'wp-admin/admin-header.php';
         require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
@@ -1285 +1393 @@
 
         $upgrader = new Language_Pack_Upgrader( new Language_Pack_Upgrader_Skin( compact( 'url', 'nonce', 'title', 'context' ) ) );
-        $result   = $upgrader->bulk_upgrade();
+        $result   = $upgrader->bulk_upgrade( array_values( $selected_translation_updates ) );
 
         wp_localize_script(