WordPress.org
Get WordPress

Make WordPress Core

Ticket #45986: 45986.4.diff

File 45986.4.diff, 5.5 KB (added by afragen, 7 years ago)

Updated @return docBlock, I hope I got this one right

  • wp-admin/includes/class-wp-plugin-install-list-table.php 

    diff --git a/wp-admin/includes/class-wp-plugin-install-list-table.php b/wp-admin/includes/class-wp-plugin-install-list-table.php
index 7cc37c056f..d13dbe2036 100644
    a b class WP_Plugin_Install_List_Table extends WP_List_Table { 
    637637                                        _e( 'This plugin doesn’t work with your versions of WordPress and PHP. ' );
    638638                                        if ( current_user_can( 'update_core' ) ) {
    639639                                                printf(
    640                                                         /* translators: 1: "Update WordPress" screen URL, 2: "Updating PHP" page URL */
     640                                                        /* translators: 1: "Update WordPress" screen URL, 2: Update PHP page URL */
    641641                                                        __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ),
    642642                                                        self_admin_url( 'update-core.php' ),
    643                                                         esc_url( __( 'https://wordpress.org/support/update-php/' ) )
     643                                                        esc_url( wp_get_update_php_url() )
    644644                                                );
     645                                                wp_update_php_annotation();
    645646                                        } else {
    646647                                                printf(
    647                                                         /* translators: %s: "Updating PHP" page URL */
     648                                                        /* translators: %s: Update PHP page URL */
    648649                                                        __( '<a href="%s">Learn more about updating PHP</a>.' ),
    649                                                         esc_url( __( 'https://wordpress.org/support/update-php/' ) )
     650                                                        esc_url( wp_get_update_php_url() )
    650651                                                );
     652                                                wp_update_php_annotation();
    651653                                        }
    652654                                } elseif ( ! $compatible_wp ) {
    653655                                        _e( 'This plugin doesn&#8217;t work with your version of WordPress. ' );
    … … class WP_Plugin_Install_List_Table extends WP_List_Table { 
    661663                                } elseif ( ! $compatible_php ) {
    662664                                        _e( 'This plugin doesn&#8217;t work with your version of PHP. ' );
    663665                                        printf(
    664                                                 /* translators: %s: "Updating PHP" page URL */
     666                                                /* translators: %s: Update PHP page URL */
    665667                                                __( '<a href="%s">Learn more about updating PHP</a>.' ),
    666                                                 esc_url( __( 'https://wordpress.org/support/update-php/' ) )
     668                                                esc_url( wp_get_update_php_url() )
    667669                                        );
     670                                        wp_update_php_annotation();
    668671                                }
    669672                                echo '</p></div>';
    670673                        }

  • wp-admin/includes/dashboard.php 

    diff --git a/wp-admin/includes/dashboard.php b/wp-admin/includes/dashboard.php
index e8a0004617..6456c4756a 100644
    a b function wp_dashboard_php_nag() { 
    16261626                $msg = __( 'WordPress has detected that your site is running on an outdated version of PHP.' );
    16271627        }
    16281628
    1629         $update_url  = wp_get_update_php_url();
    1630         $default_url = wp_get_default_update_php_url();
    1631 
    16321629        ?>
    16331630        <p><?php echo $msg; ?></p>
    16341631
    … … function wp_dashboard_php_nag() { 
    16391636                <?php
    16401637                printf(
    16411638                        '<a class="button button-primary" href="%1$s" target="_blank" rel="noopener noreferrer">%2$s <span class="screen-reader-text">%3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>',
    1642                         esc_url( $update_url ),
     1639                        esc_url( wp_get_update_php_url() ),
    16431640                        __( 'Learn more about updating PHP' ),
    16441641                        /* translators: accessibility text */
    16451642                        __( '(opens in a new tab)' )
    … … function wp_dashboard_php_nag() { 
    16481645        </p>
    16491646        <?php
    16501647
    1651         if ( $update_url !== $default_url ) {
    1652                 ?>
    1653                 <p class="description">
    1654                         <?php
    1655                         printf(
    1656                                 /* translators: %s: default Update PHP page URL */
    1657                                 __( 'This resource is provided by your web host, and is specific to your site. For more information, <a href="%s" target="_blank">see the official WordPress documentation</a>.' ),
    1658                                 esc_url( $default_url )
    1659                         );
    1660                         ?>
    1661                 </p>
    1662                 <?php
    1663         }
     1648        wp_update_php_annotation();
    16641649}
    16651650
    16661651/**

  • wp-admin/includes/plugin-install.php 

    diff --git a/wp-admin/includes/plugin-install.php b/wp-admin/includes/plugin-install.php
index c3165f2e88..646f838f87 100644
    a b function install_plugin_information() { 
    763763        if ( ! $compatible_php ) {
    764764                echo '<div class="notice notice-error notice-alt"><p>';
    765765                printf(
    766                         /* translators: "Updating PHP" page URL */
     766                        /* translators: %s: Update PHP page URL */
    767767                        __( '<strong>Error:</strong> This plugin <strong>requires a newer version of PHP</strong>, so unfortunately you cannot install it. <a href="%s" target="_blank">Click here to learn more about updating PHP</a>.' ),
    768                         esc_url( __( 'https://wordpress.org/support/update-php/' ) )
     768                        esc_url( wp_get_update_php_url() )
    769769                );
     770                wp_update_php_annotation();
    770771                echo '</p></div>';
    771772        }
    772773

  • wp-includes/functions.php 

    diff --git a/wp-includes/functions.php b/wp-includes/functions.php
index 66e1921ac7..cb6925ccc3 100644
    a b function wp_get_update_php_url() { 
    66596659function wp_get_default_update_php_url() {
    66606660        return _x( 'https://wordpress.org/support/update-php/', 'localized PHP upgrade information page' );
    66616661}
     6662
     6663/**
     6664 * Returns the default annotation for the web host altering the Update PHP page URL.
     6665 *
     6666 * This function is to be used after {@see wp_get_update_php_url()} to display a consistent
     6667 * annotation if the web host changes the default Update PHP page URL.
     6668 *
     6669 * @since 5.1.0
     6670 * @access public
     6671 *
     6672 * @return void Or default message for web host Update PHP page URL.
     6673 */
     6674function wp_update_php_annotation() {
     6675        $update_url  = wp_get_update_php_url();
     6676        $default_url = wp_get_default_update_php_url();
     6677
     6678        if ( $update_url !== $default_url ) {
     6679                echo '<p class="description">';
     6680                printf(
     6681                        /* translators: %s: default Update PHP page URL */
     6682                        __( 'This resource is provided by your web host, and is specific to your site. For more information, <a href="%s" target="_blank">see the official WordPress documentation</a>.' ),
     6683                        esc_url( $default_url )
     6684                );
     6685                echo'</p>';
     6686        }
     6687}