Make WordPress Core

Ticket #44494: 44494.3.diff

File 44494.3.diff, 2.8 KB (added by swissspidy, 5 years ago)

Updates docs

  • src/wp-includes/l10n.php

    diff --git src/wp-includes/l10n.php src/wp-includes/l10n.php
    index 915fa72701..39aa6d498e 100644
    function wp_get_pomo_file_data( $po_file ) { 
    13641364 * @since 4.0.0
    13651365 * @since 4.3.0 Introduced the `echo` argument.
    13661366 * @since 4.7.0 Introduced the `show_option_site_default` argument.
     1367 * @since 5.1.0 Introduced the `show_option_en_us` argument.
    13671368 *
    13681369 * @see get_available_languages()
    13691370 * @see wp_get_available_translations()
    function wp_get_pomo_file_data( $po_file ) { 
    13821383 *                                                  boolean equivalents. Default 1.
    13831384 *     @type bool     $show_available_translations  Whether to show available translations. Default true.
    13841385 *     @type bool     $show_option_site_default     Whether to show an option to fall back to the site's locale. Default false.
     1386 *     @type bool     $show_option_en_us            Whether to show an option for English (United States). Default true.
    13851387 * }
    13861388 * @return string HTML content
    13871389 */
    function wp_dropdown_languages( $args = array() ) { 
    13981400                        'echo'                        => 1,
    13991401                        'show_available_translations' => true,
    14001402                        'show_option_site_default'    => false,
     1403                        'show_option_en_us'           => true,
    14011404                )
    14021405        );
    14031406
    function wp_dropdown_languages( $args = array() ) { 
    14611464                );
    14621465        }
    14631466
    1464         // Always show English.
    1465         $structure[] = sprintf(
    1466                 '<option value="" lang="en" data-installed="1"%s>English (United States)</option>',
    1467                 selected( '', $parsed_args['selected'], false )
    1468         );
     1467        if ( $parsed_args['show_option_en_us'] ) {
     1468                $structure[] = sprintf(
     1469                        '<option value="" lang="en" data-installed="1"%s>English (United States)</option>',
     1470                        selected( '', $parsed_args['selected'], false )
     1471                );
     1472        }
    14691473
    14701474        // List installed languages.
    14711475        foreach ( $languages as $language ) {
  • tests/phpunit/tests/l10n.php

    diff --git tests/phpunit/tests/l10n.php tests/phpunit/tests/l10n.php
    index 5173621d2c..930108228a 100644
    class Tests_L10n extends WP_UnitTestCase { 
    124124                $this->assertContains( '<option value="ja_JP" lang="ja">日本語</option>', $actual );
    125125        }
    126126
     127        /**
     128         * @ticket 44494
     129         */
     130        function test_wp_dropdown_languages_exclude_en_us() {
     131                $args   = array(
     132                        'id'                       => 'foo',
     133                        'name'                     => 'bar',
     134                        'languages'                => array( 'de_DE' ),
     135                        'translations'             => $this->wp_dropdown_languages_filter(),
     136                        'selected'                 => 'de_DE',
     137                        'echo'                     => false,
     138                        'show_option_en_us'        => false,
     139                );
     140                $actual = wp_dropdown_languages( $args );
     141
     142                $this->assertNotContains( '<option value="" lang="en" data-installed="1">English (United States)</option>', $actual );
     143        }
     144
    127145        /**
    128146         * @ticket 38632
    129147         */