Ticket #44494: 44494.3.diff

src/wp-includes/l10n.php

@@ -1364 +1364 @@
  * @since 4.0.0
  * @since 4.3.0 Introduced the `echo` argument.
  * @since 4.7.0 Introduced the `show_option_site_default` argument.
+ * @since 5.1.0 Introduced the `show_option_en_us` argument.
  *
  * @see get_available_languages()
  * @see wp_get_available_translations()
@@ -1382 +1383 @@
  *                                                  boolean equivalents. Default 1.
  *     @type bool     $show_available_translations  Whether to show available translations. Default true.
  *     @type bool     $show_option_site_default     Whether to show an option to fall back to the site's locale. Default false.
+ *     @type bool     $show_option_en_us            Whether to show an option for English (United States). Default true.
  * }
  * @return string HTML content
  */
@@ -1398 +1400 @@
                         'echo'                        => 1,
                         'show_available_translations' => true,
                         'show_option_site_default'    => false,
+                        'show_option_en_us'           => true,
                 )
         );
 
@@ -1461 +1464 @@
                 );
         }
 
-        // Always show English.
-        $structure[] = sprintf(
-                '<option value="" lang="en" data-installed="1"%s>English (United States)</option>',
-                selected( '', $parsed_args['selected'], false )
-        );
+        if ( $parsed_args['show_option_en_us'] ) {
+                $structure[] = sprintf(
+                        '<option value="" lang="en" data-installed="1"%s>English (United States)</option>',
+                        selected( '', $parsed_args['selected'], false )
+                );
+        }
 
         // List installed languages.
         foreach ( $languages as $language ) {

tests/phpunit/tests/l10n.php

@@ -124 +124 @@
                 $this->assertContains( '<option value="ja_JP" lang="ja">日本語</option>', $actual );
         }
 
+        /**
+         * @ticket 44494
+         */
+        function test_wp_dropdown_languages_exclude_en_us() {
+                $args   = array(
+                        'id'                       => 'foo',
+                        'name'                     => 'bar',
+                        'languages'                => array( 'de_DE' ),
+                        'translations'             => $this->wp_dropdown_languages_filter(),
+                        'selected'                 => 'de_DE',
+                        'echo'                     => false,
+                        'show_option_en_us'        => false,
+                );
+                $actual = wp_dropdown_languages( $args );
+
+                $this->assertNotContains( '<option value="" lang="en" data-installed="1">English (United States)</option>', $actual );
+        }
+
         /**
          * @ticket 38632
          */