Merge branch 'trunk' into add/visual-regression-tests-admin-reskin

Author: josephfusco

src/wp-admin/css/common.css

@@ -129,7 +129,9 @@
 	padding: 0;
 	position: absolute;
 	width: 1px;
-	word-wrap: normal !important; /* many screen reader and browser combinations announce broken words as they would appear visually */
+	/* Many screen reader and browser combinations announce broken words as they would appear visually. */
+	word-wrap: normal !important;
+	word-break: normal !important;
 }
 
 .button .screen-reader-text {

src/wp-admin/css/customize-controls.css

@@ -2686,7 +2686,9 @@ body.adding-widget .add-new-widget:before,
 	padding: 0;
 	position: absolute;
 	width: 1px;
+	/* Many screen reader and browser combinations announce broken words as they would appear visually. */
 	word-wrap: normal !important;
+	word-break: normal !important;
 }
 
 #available-widgets .customize-section-title button,

src/wp-admin/css/install.css

@@ -356,7 +356,9 @@ body.language-chooser {
 	padding: 0;
 	position: absolute;
 	width: 1px;
+	/* Many screen reader and browser combinations announce broken words as they would appear visually. */
 	word-wrap: normal !important;
+	word-break: normal !important;
 }
 
 .spinner {

src/wp-admin/css/login.css

@@ -413,7 +413,9 @@ body.interim-login {
 	padding: 0;
 	position: absolute;
 	width: 1px;
-	word-wrap: normal !important; /* many screen reader and browser combinations announce broken words as they would appear visually */
+	/* Many screen reader and browser combinations announce broken words as they would appear visually. */
+	word-wrap: normal !important;
+	word-break: normal !important;
 }
 
 /* Hide the Edge "reveal password" native button */

src/wp-admin/edit-comments.php

@@ -319,13 +319,13 @@
 	|| isset( $_REQUEST['unspammed'] )
 	|| isset( $_REQUEST['same'] )
 ) {
-	$approved  = isset( $_REQUEST['approved'] ) ? (int) $_REQUEST['approved'] : 0;
-	$deleted   = isset( $_REQUEST['deleted'] ) ? (int) $_REQUEST['deleted'] : 0;
-	$trashed   = isset( $_REQUEST['trashed'] ) ? (int) $_REQUEST['trashed'] : 0;
-	$untrashed = isset( $_REQUEST['untrashed'] ) ? (int) $_REQUEST['untrashed'] : 0;
-	$spammed   = isset( $_REQUEST['spammed'] ) ? (int) $_REQUEST['spammed'] : 0;
-	$unspammed = isset( $_REQUEST['unspammed'] ) ? (int) $_REQUEST['unspammed'] : 0;
-	$same      = isset( $_REQUEST['same'] ) ? (int) $_REQUEST['same'] : 0;
+	$approved  = (int) ( $_REQUEST['approved'] ?? 0 );
+	$deleted   = (int) ( $_REQUEST['deleted'] ?? 0 );
+	$trashed   = (int) ( $_REQUEST['trashed'] ?? 0 );
+	$untrashed = (int) ( $_REQUEST['untrashed'] ?? 0 );
+	$spammed   = (int) ( $_REQUEST['spammed'] ?? 0 );
+	$unspammed = (int) ( $_REQUEST['unspammed'] ?? 0 );
+	$same      = (int) ( $_REQUEST['same'] ?? 0 );
 
 	if ( $approved > 0 || $deleted > 0 || $trashed > 0 || $untrashed > 0 || $spammed > 0 || $unspammed > 0 || $same > 0 ) {
 		if ( $approved > 0 ) {

src/wp-admin/includes/ajax-actions.php

@@ -1241,7 +1241,7 @@ function wp_ajax_get_tagcloud() {
  *
  * @since 3.1.0
  *
- * @global int $post_id
+ * @global int $post_id Post ID.
  *
  * @param string $action Action to perform.
  */
@@ -2353,9 +2353,9 @@ function wp_ajax_widgets_order() {
  *
  * @since 3.1.0
  *
- * @global array $wp_registered_widgets
- * @global array $wp_registered_widget_controls
- * @global array $wp_registered_widget_updates
+ * @global array $wp_registered_widgets         Registered widgets.
+ * @global array $wp_registered_widget_controls Registered widget controls.
+ * @global array $wp_registered_widget_updates  Registered widget updates.
  */
 function wp_ajax_save_widget() {
 	global $wp_registered_widgets, $wp_registered_widget_controls, $wp_registered_widget_updates;
@@ -2462,7 +2462,7 @@ function wp_ajax_save_widget() {
  *
  * @since 3.9.0
  *
- * @global WP_Customize_Manager $wp_customize
+ * @global WP_Customize_Manager $wp_customize Customizer manager object.
  */
 function wp_ajax_update_widget() {
 	global $wp_customize;
@@ -3588,7 +3588,7 @@ function wp_ajax_get_revision_diffs() {
  *
  * @since 3.8.0
  *
- * @global array $_wp_admin_css_colors
+ * @global array $_wp_admin_css_colors Registered admin CSS color schemes.
  */
 function wp_ajax_save_user_color_scheme() {
 	global $_wp_admin_css_colors;
@@ -3617,8 +3617,8 @@ function wp_ajax_save_user_color_scheme() {
  *
  * @since 3.9.0
  *
- * @global array $themes_allowedtags
- * @global array $theme_field_defaults
+ * @global array $themes_allowedtags   Allowed HTML tags for theme descriptions.
+ * @global array $theme_field_defaults Default theme fields.
  */
 function wp_ajax_query_themes() {
 	global $themes_allowedtags, $theme_field_defaults;
@@ -3750,8 +3750,8 @@ function wp_ajax_query_themes() {
  *
  * @global WP_Post    $post          Global post object.
  * @global WP_Embed   $wp_embed      WordPress Embed object.
- * @global WP_Scripts $wp_scripts
- * @global int        $content_width
+ * @global WP_Scripts $wp_scripts    Script dependencies object.
+ * @global int        $content_width Shared post content width.
  */
 function wp_ajax_parse_embed() {
 	global $post, $wp_embed, $content_width;
@@ -3891,7 +3891,7 @@ function wp_ajax_parse_embed() {
  * @since 4.0.0
  *
  * @global WP_Post    $post       Global post object.
- * @global WP_Scripts $wp_scripts
+ * @global WP_Scripts $wp_scripts Script dependencies object.
  */
 function wp_ajax_parse_media_shortcode() {
 	global $post, $wp_scripts;

src/wp-admin/includes/class-core-upgrader.php

@@ -48,7 +48,7 @@ public function upgrade_strings() {
 	 * @since 2.8.0
 	 *
 	 * @global WP_Filesystem_Base $wp_filesystem                WordPress filesystem subclass.
-	 * @global callable           $_wp_filesystem_direct_method
+	 * @global callable           $_wp_filesystem_direct_method Filesystem direct method callback.
 	 *
 	 * @param object $current Response object for whether WordPress is current.
 	 * @param array  $args {

src/wp-admin/includes/class-custom-image-header.php

@@ -268,7 +268,7 @@ public function take_action() {
 	 *
 	 * @since 3.0.0
 	 *
-	 * @global array $_wp_default_headers
+	 * @global array $_wp_default_headers Default headers registered for themes.
 	 */
 	public function process_default_headers() {
 		global $_wp_default_headers;

src/wp-admin/includes/class-theme-upgrader.php

@@ -746,7 +746,7 @@ public function current_after( $response, $theme ) {
 	 *
 	 * @since 2.8.0
 	 *
-	 * @global WP_Filesystem_Base $wp_filesystem Subclass
+	 * @global WP_Filesystem_Base $wp_filesystem Filesystem subclass.
 	 *
 	 * @param bool   $removed
 	 * @param string $local_destination

src/wp-admin/includes/class-walker-nav-menu-checklist.php

@@ -64,8 +64,8 @@ public function end_lvl( &$output, $depth = 0, $args = null ) {
 	 * @since 5.9.0 Renamed `$item` to `$data_object` and `$id` to `$current_object_id`
 	 *              to match parent class for PHP 8 named parameter support.
 	 *
-	 * @global int        $_nav_menu_placeholder
-	 * @global int|string $nav_menu_selected_id
+	 * @global int        $_nav_menu_placeholder A placeholder for the nav menu item ID.
+	 * @global int|string $nav_menu_selected_id  The ID of the selected nav menu.
 	 *
 	 * @param string   $output            Used to append additional content (passed by reference).
 	 * @param WP_Post  $data_object       Menu item data object.