enmi-conf.org: comparison wp/wp-admin/includes/template.php

equal deleted inserted replaced

-:7b1b88e27a20
+:48c4eec2b7e6
 	$params = apply_filters( 'wp_terms_checklist_args', $args, $post_id );
 	$parsed_args = wp_parse_args( $params, $defaults );
 	if ( empty( $parsed_args['walker'] ) || ! ( $parsed_args['walker'] instanceof Walker ) ) {
-		$walker = new Walker_Category_Checklist;
+		$walker = new Walker_Category_Checklist();
 	} else {
 		$walker = $parsed_args['walker'];
 	}
 	$taxonomy             = $parsed_args['taxonomy'];
 	}
 	$output = '';
 	if ( $parsed_args['checked_ontop'] ) {
-		// Post-process $categories rather than adding an exclude to the get_terms() query
+		/*
-		// to keep the query the same across all posts (for any query cache).
+		 * Post-process $categories rather than adding an exclude to the get_terms() query
+		 * to keep the query the same across all posts (for any query cache).
+		 */
 		$checked_categories = array();
 		$keys               = array_keys( $categories );
 		foreach ( $keys as $k ) {
 			if ( in_array( $categories[ $k ]->term_id, $args['selected_cats'], true ) ) {
 /**
 * Outputs a link category checklist element.
 *
 * @since 2.5.1
 *
-* @param int $link_id
+* @param int $link_id Optional. The link ID. Default 0.
 */
 function wp_link_category_checklist( $link_id = 0 ) {
 	$default = 1;
 	$checked_categories = array();
 *
 * @since 2.7.0
 *
 * @global WP_List_Table $wp_list_table
 *
-* @param int    $position
+* @param int    $position  Optional. The value of the 'position' input field. Default 1.
-* @param bool   $checkbox
+* @param bool   $checkbox  Optional. The value of the 'checkbox' input field. Default false.
-* @param string $mode
+* @param string $mode      Optional. If set to 'single', will use WP_Post_Comments_List_Table,
-* @param bool   $table_row
+*                          otherwise WP_Comments_List_Table. Default 'single'.
+* @param bool   $table_row Optional. Whether to use a table instead of a div element. Default true.
 */
 function wp_comment_reply( $position = 1, $checkbox = false, $mode = 'single', $table_row = true ) {
 	global $wp_list_table;
 	/**
 	 * Filters the in-line comment reply-to form output in the Comments
 <?php endif; ?>
 	<fieldset class="comment-reply">
 	<legend>
 		<span class="hidden" id="editlegend"><?php _e( 'Edit Comment' ); ?></span>
 		<span class="hidden" id="replyhead"><?php _e( 'Reply to Comment' ); ?></span>
-		<span class="hidden" id="addhead"><?php _e( 'Add new Comment' ); ?></span>
+		<span class="hidden" id="addhead"><?php _e( 'Add New Comment' ); ?></span>
 	</legend>
 	<div id="replycontainer">
-	<label for="replycontent" class="screen-reader-text"><?php _e( 'Comment' ); ?></label>
+	<label for="replycontent" class="screen-reader-text">
+		<?php
+		/* translators: Hidden accessibility text. */
+		_e( 'Comment' );
+		?>
+	</label>
 	<?php
 	$quicktags_settings = array( 'buttons' => 'strong,em,link,block,del,ins,img,ul,ol,li,code,close' );
 	wp_editor(
 		'',
 		'replycontent',
 				<span id="replybtn" style="display: none;"><?php _e( 'Submit Reply' ); ?></span>
 			</button>
 			<button type="button" class="cancel button"><?php _e( 'Cancel' ); ?></button>
 			<span class="waiting spinner"></span>
 		</p>
-		<div class="notice notice-error notice-alt inline hidden">
+		<?php
-			<p class="error"></p>
+		wp_admin_notice(
-		</div>
+			'<p class="error"></p>',
+			array(
+				'type'               => 'error',
+				'additional_classes' => array( 'notice-alt', 'inline', 'hidden' ),
+				'paragraph_wrap'     => false,
+			)
+		);
+		?>
 	</div>
 	<input type="hidden" name="action" id="action" value="" />
 	<input type="hidden" name="comment_ID" id="comment_ID" value="" />
 	<input type="hidden" name="comment_post_ID" id="comment_post_ID" value="" />
 /**
 * Outputs a post's public meta data in the Custom Fields meta box.
 *
 * @since 1.2.0
 *
-* @param array $meta
+* @param array[] $meta An array of meta data arrays keyed on 'meta_key' and 'meta_value'.
 */
 function list_meta( $meta ) {
 	// Exit if no meta.
 	if ( ! $meta ) {
 		echo '
 /**
 * Outputs a single row of public meta data in the Custom Fields meta box.
 *
 * @since 2.5.0
 *
-* @param array $entry
+* @param array $entry An array of meta data keyed on 'meta_key' and 'meta_value'.
-* @param int   $count
+* @param int   $count Reference to the row number.
-* @return string
+* @return string A single row of public meta data.
 */
 function _list_meta_row( $entry, &$count ) {
 	static $update_nonce = '';
 	if ( is_protected_meta( $entry['meta_key'], 'post' ) ) {
 	if ( ! $update_nonce ) {
 		$update_nonce = wp_create_nonce( 'add-meta' );
 	}
 	$r = '';
-	++ $count;
+	++$count;
 	if ( is_serialized( $entry['meta_value'] ) ) {
 		if ( is_serialized_string( $entry['meta_value'] ) ) {
 			// This is a serialized string, so we should display it.
 			$entry['meta_value'] = maybe_unserialize( $entry['meta_value'] );
 	$entry['meta_id']    = (int) $entry['meta_id'];
 	$delete_nonce = wp_create_nonce( 'delete-meta_' . $entry['meta_id'] );
 	$r .= "\n\t<tr id='meta-{$entry['meta_id']}'>";
-	$r .= "\n\t\t<td class='left'><label class='screen-reader-text' for='meta-{$entry['meta_id']}-key'>" . __( 'Key' ) . "</label><input name='meta[{$entry['meta_id']}][key]' id='meta-{$entry['meta_id']}-key' type='text' size='20' value='{$entry['meta_key']}' />";
+	$r .= "\n\t\t<td class='left'><label class='screen-reader-text' for='meta-{$entry['meta_id']}-key'>" .
+		/* translators: Hidden accessibility text. */
+		__( 'Key' ) .
+	"</label><input name='meta[{$entry['meta_id']}][key]' id='meta-{$entry['meta_id']}-key' type='text' size='20' value='{$entry['meta_key']}' />";
 	$r .= "\n\t\t<div class='submit'>";
 	$r .= get_submit_button( __( 'Delete' ), 'deletemeta small', "deletemeta[{$entry['meta_id']}]", false, array( 'data-wp-lists' => "delete:the-list:meta-{$entry['meta_id']}::_ajax_nonce=$delete_nonce" ) );
 	$r .= "\n\t\t";
 	$r .= get_submit_button( __( 'Update' ), 'updatemeta small', "meta-{$entry['meta_id']}-submit", false, array( 'data-wp-lists' => "add:the-list:meta-{$entry['meta_id']}::_ajax_nonce-add-meta=$update_nonce" ) );
 	$r .= '</div>';
 	$r .= wp_nonce_field( 'change-meta', '_ajax_nonce', false, false );
 	$r .= '</td>';
-	$r .= "\n\t\t<td><label class='screen-reader-text' for='meta-{$entry['meta_id']}-value'>" . __( 'Value' ) . "</label><textarea name='meta[{$entry['meta_id']}][value]' id='meta-{$entry['meta_id']}-value' rows='2' cols='30'>{$entry['meta_value']}</textarea></td>\n\t</tr>";
+	$r .= "\n\t\t<td><label class='screen-reader-text' for='meta-{$entry['meta_id']}-value'>" .
+		/* translators: Hidden accessibility text. */
+		__( 'Value' ) .
+	"</label><textarea name='meta[{$entry['meta_id']}][value]' id='meta-{$entry['meta_id']}-value' rows='2' cols='30'>{$entry['meta_value']}</textarea></td>\n\t</tr>";
 	return $r;
 }
 /**
 * Prints the form in the Custom Fields meta box.
 		);
 	}
 	if ( $keys ) {
 		natcasesort( $keys );
-		$meta_key_input_id = 'metakeyselect';
-	} else {
-		$meta_key_input_id = 'metakeyinput';
 	}
 	?>
 <p><strong><?php _e( 'Add New Custom Field:' ); ?></strong></p>
 <table id="newmeta">
 <thead>
 <tr>
-<th class="left"><label for="<?php echo $meta_key_input_id; ?>"><?php _ex( 'Name', 'meta name' ); ?></label></th>
+<th class="left"><label for="metakeyselect"><?php _ex( 'Name', 'meta name' ); ?></label></th>
 <th><label for="metavalue"><?php _e( 'Value' ); ?></label></th>
 </tr>
 </thead>
 <tbody>
 			}
 			echo "\n<option value='" . esc_attr( $key ) . "'>" . esc_html( $key ) . '</option>';
 		}
 		?>
 </select>
-<input class="hide-if-js" type="text" id="metakeyinput" name="metakeyinput" value="" />
+<input class="hidden" type="text" id="metakeyinput" name="metakeyinput" value="" aria-label="<?php _e( 'New custom field name' ); ?>" />
-<a href="#postcustomstuff" class="hide-if-no-js" onclick="jQuery('#metakeyinput, #metakeyselect, #enternew, #cancelnew').toggle();return false;">
+<button type="button" id="newmeta-button" class="button button-small hide-if-no-js" onclick="jQuery('#metakeyinput, #metakeyselect, #enternew, #cancelnew').toggleClass('hidden');jQuery('#metakeyinput, #metakeyselect').filter(':visible').trigger('focus');">
 <span id="enternew"><?php _e( 'Enter new' ); ?></span>
-<span id="cancelnew" class="hidden"><?php _e( 'Cancel' ); ?></span></a>
+<span id="cancelnew" class="hidden"><?php _e( 'Cancel' ); ?></span></button>
 <?php } else { ?>
 <input type="text" id="metakeyinput" name="metakeyinput" value="" />
 <?php } ?>
 </td>
-<td><textarea id="metavalue" name="metavalue" rows="2" cols="25"></textarea></td>
+<td><textarea id="metavalue" name="metavalue" rows="2" cols="25"></textarea>
+	<?php wp_nonce_field( 'add-meta', '_ajax_nonce-add-meta', false ); ?>
+</td>
 </tr>
+</tbody>
-<tr><td colspan="2">
+</table>
-<div class="submit">
+<div class="submit add-custom-field">
 	<?php
 	submit_button(
 		__( 'Add Custom Field' ),
 		'',
 		'addmeta',
 			'data-wp-lists' => 'add:the-list:newmeta',
 		)
 	);
 	?>
 </div>
-	<?php wp_nonce_field( 'add-meta', '_ajax_nonce-add-meta', false ); ?>
-</td></tr>
-</tbody>
-</table>
 	<?php
 }
 /**
 * Prints out HTML form date elements for editing post or comment publish date.
 *
 	$cur_mm = current_time( 'm' );
 	$cur_aa = current_time( 'Y' );
 	$cur_hh = current_time( 'H' );
 	$cur_mn = current_time( 'i' );
-	$month = '<label><span class="screen-reader-text">' . __( 'Month' ) . '</span><select class="form-required" ' . ( $multi ? '' : 'id="mm" ' ) . 'name="mm"' . $tab_index_attribute . ">\n";
+	$month = '<label><span class="screen-reader-text">' .
+		/* translators: Hidden accessibility text. */
+		__( 'Month' ) .
+	'</span><select class="form-required" ' . ( $multi ? '' : 'id="mm" ' ) . 'name="mm"' . $tab_index_attribute . ">\n";
 	for ( $i = 1; $i < 13; $i = $i + 1 ) {
 		$monthnum  = zeroise( $i, 2 );
 		$monthtext = $wp_locale->get_month_abbrev( $wp_locale->get_month( $i ) );
 		$month    .= "\t\t\t" . '<option value="' . $monthnum . '" data-text="' . $monthtext . '" ' . selected( $monthnum, $mm, false ) . '>';
 		/* translators: 1: Month number (01, 02, etc.), 2: Month abbreviation. */
 		$month .= sprintf( __( '%1$s-%2$s' ), $monthnum, $monthtext ) . "</option>\n";
 	}
 	$month .= '</select></label>';
-	$day    = '<label><span class="screen-reader-text">' . __( 'Day' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="jj" ' ) . 'name="jj" value="' . $jj . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
+	$day = '<label><span class="screen-reader-text">' .
-	$year   = '<label><span class="screen-reader-text">' . __( 'Year' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="aa" ' ) . 'name="aa" value="' . $aa . '" size="4" maxlength="4"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
+		/* translators: Hidden accessibility text. */
-	$hour   = '<label><span class="screen-reader-text">' . __( 'Hour' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="hh" ' ) . 'name="hh" value="' . $hh . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
+		__( 'Day' ) .
-	$minute = '<label><span class="screen-reader-text">' . __( 'Minute' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="mn" ' ) . 'name="mn" value="' . $mn . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
+	'</span><input type="text" ' . ( $multi ? '' : 'id="jj" ' ) . 'name="jj" value="' . $jj . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
+	$year = '<label><span class="screen-reader-text">' .
+		/* translators: Hidden accessibility text. */
+		__( 'Year' ) .
+	'</span><input type="text" ' . ( $multi ? '' : 'id="aa" ' ) . 'name="aa" value="' . $aa . '" size="4" maxlength="4"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
+	$hour = '<label><span class="screen-reader-text">' .
+		/* translators: Hidden accessibility text. */
+		__( 'Hour' ) .
+	'</span><input type="text" ' . ( $multi ? '' : 'id="hh" ' ) . 'name="hh" value="' . $hh . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
+	$minute = '<label><span class="screen-reader-text">' .
+		/* translators: Hidden accessibility text. */
+		__( 'Minute' ) .
+	'</span><input type="text" ' . ( $multi ? '' : 'id="mn" ' ) . 'name="mn" value="' . $mn . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>';
 	echo '<div class="timestamp-wrap">';
 	/* translators: 1: Month, 2: Day, 3: Year, 4: Hour, 5: Minute. */
 	printf( __( '%1$s %2$s, %3$s at %4$s:%5$s' ), $month, $day, $year, $hour, $minute );
 *
 * @since 1.5.0
 * @since 4.7.0 Added the `$post_type` parameter.
 *
 * @param string $default_template Optional. The template file name. Default empty.
-* @param string $post_type        Optional. Post type to get templates for. Default 'post'.
+* @param string $post_type        Optional. Post type to get templates for. Default 'page'.
 */
 function page_template_dropdown( $default_template = '', $post_type = 'page' ) {
 	$templates = get_page_templates( null, $post_type );
 	ksort( $templates );
 * @since 4.4.0 `$post` argument was added.
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param int         $default_page Optional. The default page ID to be pre-selected. Default 0.
-* @param int         $parent       Optional. The parent page ID. Default 0.
+* @param int         $parent_page  Optional. The parent page ID. Default 0.
 * @param int         $level        Optional. Page depth level. Default 0.
 * @param int|WP_Post $post         Post ID or WP_Post object.
 * @return void|false Void on success, false if the page has no children.
 */
-function parent_dropdown( $default_page = 0, $parent = 0, $level = 0, $post = null ) {
+function parent_dropdown( $default_page = 0, $parent_page = 0, $level = 0, $post = null ) {
 	global $wpdb;
 	$post  = get_post( $post );
-	$items = $wpdb->get_results( $wpdb->prepare( "SELECT ID, post_parent, post_title FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'page' ORDER BY menu_order", $parent ) );
+	$items = $wpdb->get_results(
+		$wpdb->prepare(
+			"SELECT ID, post_parent, post_title
+			FROM $wpdb->posts
+			WHERE post_parent = %d AND post_type = 'page'
+			ORDER BY menu_order",
+			$parent_page
+		)
+	);
 	if ( $items ) {
 		foreach ( $items as $item ) {
 			// A page cannot be its own parent.
 			if ( $post && $post->ID && (int) $item->ID === $post->ID ) {
 	echo $r;
 }
 /**
-* Outputs the form used by the importers to accept the data to be imported
+* Outputs the form used by the importers to accept the data to be imported.
 *
 * @since 2.0.0
 *
 * @param string $action The action attribute for the form.
 */
 	 */
 	$bytes      = apply_filters( 'import_upload_size_limit', wp_max_upload_size() );
 	$size       = size_format( $bytes );
 	$upload_dir = wp_upload_dir();
 	if ( ! empty( $upload_dir['error'] ) ) :
-		?>
+		$upload_directory_error  = '<p>' . __( 'Before you can upload your import file, you will need to fix the following error:' ) . '</p>';
-		<div class="error"><p><?php _e( 'Before you can upload your import file, you will need to fix the following error:' ); ?></p>
+		$upload_directory_error .= '<p><strong>' . $upload_dir['error'] . '</strong></p>';
-		<p><strong><?php echo $upload_dir['error']; ?></strong></p></div>
+		wp_admin_notice(
-		<?php
+			$upload_directory_error,
+			array(
+				'additional_classes' => array( 'error' ),
+				'paragraph_wrap'     => false,
+			)
+		);
 	else :
 		?>
 <form enctype="multipart/form-data" id="import-upload-form" method="post" class="wp-upload-form" action="<?php echo esc_url( wp_nonce_url( $action, 'import-upload' ) ); ?>">
 <p>
 		<?php
 * Adds a meta box to one or more screens.
 *
 * @since 2.5.0
 * @since 4.4.0 The `$screen` parameter now accepts an array of screen IDs.
 *
-* @global array $wp_meta_boxes
+* @global array $wp_meta_boxes Global meta box state.
 *
 * @param string                 $id            Meta box ID (used in the 'id' attribute for the meta box).
 * @param string                 $title         Title of the meta box.
 * @param callable               $callback      Function that fills the box with the desired content.
 *                                              The function should echo its output.
 */
 function _get_plugin_from_callback( $callback ) {
 	try {
 		if ( is_array( $callback ) ) {
 			$reflection = new ReflectionMethod( $callback[0], $callback[1] );
-		} elseif ( is_string( $callback ) && false !== strpos( $callback, '::' ) ) {
+		} elseif ( is_string( $callback ) && str_contains( $callback, '::' ) ) {
 			$reflection = new ReflectionMethod( $callback );
 		} else {
 			$reflection = new ReflectionFunction( $callback );
 		}
 	} catch ( ReflectionException $exception ) {
 		// Only show errors if the meta box was registered by a plugin.
 		$filename   = wp_normalize_path( $reflection->getFileName() );
 		$plugin_dir = wp_normalize_path( WP_PLUGIN_DIR );
-		if ( strpos( $filename, $plugin_dir ) === 0 ) {
+		if ( str_starts_with( $filename, $plugin_dir ) ) {
 			$filename = str_replace( $plugin_dir, '', $filename );
 			$filename = preg_replace( '|^/([^/]*/).*$|', '\\1', $filename );
 			$plugins = get_plugins();
 			foreach ( $plugins as $name => $plugin ) {
-				if ( strpos( $name, $filename ) === 0 ) {
+				if ( str_starts_with( $name, $filename ) ) {
 					return $plugin;
 				}
 			}
 		}
 	}
 /**
 * Meta-Box template function.
 *
 * @since 2.5.0
 *
-* @global array $wp_meta_boxes
+* @global array $wp_meta_boxes Global meta box state.
 *
 * @param string|WP_Screen $screen      The screen identifier. If you have used add_menu_page() or
 *                                      add_submenu_page() to create a new screen (and hence screen_id)
 *                                      make sure your menu slug conforms to the limits of sanitize_key()
 *                                      otherwise the 'screen' menu may not correctly render on your page.
 	$hidden = get_hidden_meta_boxes( $screen );
 	printf( '<div id="%s-sortables" class="meta-box-sortables">', esc_attr( $context ) );
-	// Grab the ones the user has manually sorted.
+	/*
-	// Pull them out of their previous context/priority and into the one the user chose.
+	 * Grab the ones the user has manually sorted.
+	 * Pull them out of their previous context/priority and into the one the user chose.
+	 */
 	$sorted = get_user_option( "meta-box-order_$page" );
 	if ( ! $already_sorted && $sorted ) {
 		foreach ( $sorted as $box_context => $ids ) {
 			foreach ( explode( ',', $ids ) as $id ) {
 							$block_compatible = $block_compatible || (bool) $box['args']['__back_compat_meta_box'];
 							unset( $box['args']['__back_compat_meta_box'] );
 						}
 					}
-					$i++;
+					++$i;
 					// get_hidden_meta_boxes() doesn't apply in the block editor.
 					$hidden_class = ( ! $screen->is_block_editor() && in_array( $box['id'], $hidden, true ) ) ? ' hide-if-js' : '';
 					echo '<div id="' . $box['id'] . '" class="postbox ' . postbox_classes( $box['id'], $page ) . $hidden_class . '" ' . '>' . "\n";
 					echo '<div class="postbox-header">';
 					echo '<h2 class="hndle">';
 					if ( 'dashboard_php_nag' === $box['id'] ) {
 						echo '<span aria-hidden="true" class="dashicons dashicons-warning"></span>';
-						echo '<span class="screen-reader-text">' . __( 'Warning:' ) . ' </span>';
+						echo '<span class="screen-reader-text">' .
+							/* translators: Hidden accessibility text. */
+							__( 'Warning:' ) .
+						' </span>';
 					}
 					echo $box['title'];
 					echo "</h2>\n";
 					if ( 'dashboard_browser_nag' !== $box['id'] ) {
 						}
 						echo '<div class="handle-actions hide-if-no-js">';
 						echo '<button type="button" class="handle-order-higher" aria-disabled="false" aria-describedby="' . $box['id'] . '-handle-order-higher-description">';
-						echo '<span class="screen-reader-text">' . __( 'Move up' ) . '</span>';
+						echo '<span class="screen-reader-text">' .
+							/* translators: Hidden accessibility text. */
+							__( 'Move up' ) .
+						'</span>';
 						echo '<span class="order-higher-indicator" aria-hidden="true"></span>';
 						echo '</button>';
 						echo '<span class="hidden" id="' . $box['id'] . '-handle-order-higher-description">' . sprintf(
 							/* translators: %s: Meta box title. */
 							__( 'Move %s box up' ),
 							$widget_title
 						) . '</span>';
 						echo '<button type="button" class="handle-order-lower" aria-disabled="false" aria-describedby="' . $box['id'] . '-handle-order-lower-description">';
-						echo '<span class="screen-reader-text">' . __( 'Move down' ) . '</span>';
+						echo '<span class="screen-reader-text">' .
+							/* translators: Hidden accessibility text. */
+							__( 'Move down' ) .
+						'</span>';
 						echo '<span class="order-lower-indicator" aria-hidden="true"></span>';
 						echo '</button>';
 						echo '<span class="hidden" id="' . $box['id'] . '-handle-order-lower-description">' . sprintf(
 							/* translators: %s: Meta box title. */
 							__( 'Move %s box down' ),
 							$widget_title
 						) . '</span>';
 						echo '<button type="button" class="handlediv" aria-expanded="true">';
 						echo '<span class="screen-reader-text">' . sprintf(
-							/* translators: %s: Meta box title. */
+							/* translators: %s: Hidden accessibility text. Meta box title. */
 							__( 'Toggle panel: %s' ),
 							$widget_title
 						) . '</span>';
 						echo '<span class="toggle-indicator" aria-hidden="true"></span>';
 						echo '</button>';
 					echo '<div class="inside">' . "\n";
 					if ( WP_DEBUG && ! $block_compatible && 'edit' === $screen->parent_base && ! $screen->is_block_editor() && ! isset( $_GET['meta-box-loader'] ) ) {
 						$plugin = _get_plugin_from_callback( $box['callback'] );
 						if ( $plugin ) {
-							?>
+							$meta_box_not_compatible_message = sprintf(
-							<div class="error inline">
+								/* translators: %s: The name of the plugin that generated this meta box. */
-								<p>
+								__( 'This meta box, from the %s plugin, is not compatible with the block editor.' ),
-									<?php
+								"<strong>{$plugin['Name']}</strong>"
-										/* translators: %s: The name of the plugin that generated this meta box. */
+							);
-										printf( __( 'This meta box, from the %s plugin, is not compatible with the block editor.' ), "<strong>{$plugin['Name']}</strong>" );
+							wp_admin_notice(
-									?>
+								$meta_box_not_compatible_message,
-								</p>
+								array(
-							</div>
+									'additional_classes' => array( 'error', 'inline' ),
-							<?php
+								)
+							);
 						}
 					}
 					call_user_func( $box['callback'], $data_object, $box );
 					echo "</div>\n";
 	}
 	echo '</div>';
 	return $i;
 }
 /**
 * Removes a meta box from one or more screens.
 *
 * @since 2.6.0
 * @since 4.4.0 The `$screen` parameter now accepts an array of screen IDs.
 *
-* @global array $wp_meta_boxes
+* @global array $wp_meta_boxes Global meta box state.
 *
 * @param string                 $id      Meta box ID (used in the 'id' attribute for the meta box).
 * @param string|array|WP_Screen $screen  The screen or screens on which the meta box is shown (such as a
 *                                        post type, 'link', or 'comment'). Accepts a single screen ID,
 *                                        WP_Screen object, or array of screen IDs.
 				foreach ( $wp_meta_boxes[ $page ][ $context ][ $priority ] as $box ) {
 					if ( false === $box || ! $box['title'] ) {
 						continue;
 					}
-					$i++;
+					++$i;
 					$hidden_class = in_array( $box['id'], $hidden, true ) ? 'hide-if-js' : '';
 					$open_class = '';
 					if ( ! $first_open && empty( $hidden_class ) ) {
 						$first_open = true;
 					}
 					?>
 					<li class="control-section accordion-section <?php echo $hidden_class; ?> <?php echo $open_class; ?> <?php echo esc_attr( $box['id'] ); ?>" id="<?php echo esc_attr( $box['id'] ); ?>">
 						<h3 class="accordion-section-title hndle" tabindex="0">
 							<?php echo esc_html( $box['title'] ); ?>
-							<span class="screen-reader-text"><?php _e( 'Press return or enter to open this section' ); ?></span>
+							<span class="screen-reader-text">
+								<?php
+								/* translators: Hidden accessibility text. */
+								_e( 'Press return or enter to open this section' );
+								?>
+							</span>
 						</h3>
 						<div class="accordion-section-content <?php postbox_classes( $box['id'], $page ); ?>">
 							<div class="inside">
 								<?php call_user_func( $box['callback'], $data_object, $box ); ?>
 							</div><!-- .inside -->
 * The $callback argument should be the name of a function that echoes out any
 * content you want to show at the top of the settings section before the actual
 * fields. It can output nothing if you want.
 *
 * @since 2.7.0
+* @since 6.1.0 Added an `$args` parameter for the section's HTML wrapper and class name.
 *
 * @global array $wp_settings_sections Storage array of all settings sections added to admin pages.
 *
 * @param string   $id       Slug-name to identify the section. Used in the 'id' attribute of tags.
 * @param string   $title    Formatted title of the section. Shown as the heading for the section.
 * @param callable $callback Function that echos out any content at the top of the section (between heading and fields).
 * @param string   $page     The slug-name of the settings page on which to show the section. Built-in pages include
 *                           'general', 'reading', 'writing', 'discussion', 'media', etc. Create your own using
 *                           add_options_page();
-*/
+* @param array    $args     {
-function add_settings_section( $id, $title, $callback, $page ) {
+*     Arguments used to create the settings section.
+*
+*     @type string $before_section HTML content to prepend to the section's HTML output.
+*                                  Receives the section's class name as `%s`. Default empty.
+*     @type string $after_section  HTML content to append to the section's HTML output. Default empty.
+*     @type string $section_class  The class name to use for the section. Default empty.
+* }
+*/
+function add_settings_section( $id, $title, $callback, $page, $args = array() ) {
 	global $wp_settings_sections;
+	$defaults = array(
+		'id'             => $id,
+		'title'          => $title,
+		'callback'       => $callback,
+		'before_section' => '',
+		'after_section'  => '',
+		'section_class'  => '',
+	);
+	$section = wp_parse_args( $args, $defaults );
 	if ( 'misc' === $page ) {
 		_deprecated_argument(
 			__FUNCTION__,
 			'3.0.0',
 			)
 		);
 		$page = 'reading';
 	}
-	$wp_settings_sections[ $page ][ $id ] = array(
+	$wp_settings_sections[ $page ][ $id ] = $section;
-		'id'       => $id,
-		'title'    => $title,
-		'callback' => $callback,
-	);
 }
 /**
 * Adds a new field to a section of a settings page.
 *
 * @param string   $page     The slug-name of the settings page on which to show the section
 *                           (general, reading, writing, ...).
 * @param string   $section  Optional. The slug-name of the section of the settings page
 *                           in which to show the box. Default 'default'.
 * @param array    $args {
-*     Optional. Extra arguments used when outputting the field.
+*     Optional. Extra arguments that get passed to the callback function.
 *
 *     @type string $label_for When supplied, the setting title will be wrapped
 *                             in a `<label>` element, its `for` attribute populated
 *                             with this value.
 *     @type string $class     CSS Class to be added to the `<tr>` element when the
 		'args'     => $args,
 	);
 }
 /**
-* Prints out all settings sections added to a particular settings page
+* Prints out all settings sections added to a particular settings page.
 *
 * Part of the Settings API. Use this in a settings page callback function
 * to output all the sections and fields that were added to that $page with
 * add_settings_section() and add_settings_field()
 *
 	if ( ! isset( $wp_settings_sections[ $page ] ) ) {
 		return;
 	}
 	foreach ( (array) $wp_settings_sections[ $page ] as $section ) {
+		if ( '' !== $section['before_section'] ) {
+			if ( '' !== $section['section_class'] ) {
+				echo wp_kses_post( sprintf( $section['before_section'], esc_attr( $section['section_class'] ) ) );
+			} else {
+				echo wp_kses_post( $section['before_section'] );
+			}
+		}
 		if ( $section['title'] ) {
 			echo "<h2>{$section['title']}</h2>\n";
 		}
 		if ( $section['callback'] ) {
 			continue;
 		}
 		echo '<table class="form-table" role="presentation">';
 		do_settings_fields( $page, $section['id'] );
 		echo '</table>';
+		if ( '' !== $section['after_section'] ) {
+			echo wp_kses_post( $section['after_section'] );
+		}
 	}
 }
 /**
 * Prints out the settings fields for a particular settings section.
 * page is first accessed.
 *
 * @since 3.0.0
 * @since 5.3.0 Added `warning` and `info` as possible values for `$type`.
 *
-* @global array $wp_settings_errors Storage array of errors registered during this pageload
+* @global array[] $wp_settings_errors Storage array of errors registered during this pageload
 *
 * @param string $setting Slug title of the setting to which this error applies.
 * @param string $code    Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
 * @param string $message The formatted message text to display to the user (will be shown inside styled
 *                        `<div>` and `<p>` tags).
 * hasn't submitted data (i.e. when they first load an options page, or in the {@see 'admin_notices'}
 * action hook).
 *
 * @since 3.0.0
 *
-* @global array $wp_settings_errors Storage array of errors registered during this pageload
+* @global array[] $wp_settings_errors Storage array of errors registered during this pageload
 *
 * @param string $setting  Optional. Slug title of a specific setting whose errors you want.
 * @param bool   $sanitize Optional. Whether to re-sanitize the setting value before returning errors.
-* @return array {
+* @return array[] {
-*     Array of settings errors.
+*     Array of settings error arrays.
 *
-*     @type string $setting Slug title of the setting to which this error applies.
+*     @type array ...$0 {
-*     @type string $code    Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
+*         Associative array of setting error data.
-*     @type string $message The formatted message text to display to the user (will be shown inside styled
+*
-*                           `<div>` and `<p>` tags).
+*         @type string $setting Slug title of the setting to which this error applies.
-*     @type string $type    Optional. Message type, controls HTML class. Possible values include 'error',
+*         @type string $code    Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
-*                           'success', 'warning', 'info'. Default 'error'.
+*         @type string $message The formatted message text to display to the user (will be shown inside styled
+*                               `<div>` and `<p>` tags).
+*         @type string $type    Optional. Message type, controls HTML class. Possible values include 'error',
+*                               'success', 'warning', 'info'. Default 'error'.
+*     }
 * }
 */
 function get_settings_errors( $setting = '', $sanitize = false ) {
 	global $wp_settings_errors;
 /**
 * Outputs the modal window used for attaching media to posts or pages in the media-listing screen.
 *
 * @since 2.7.0
 *
-* @param string $found_action
+* @param string $found_action Optional. The value of the 'found_action' input field. Default empty string.
 */
 function find_posts_div( $found_action = '' ) {
 	?>
 	<div id="find-posts" class="find-box" style="display: none;">
 		<div id="find-posts-head" class="find-box-head">
 			<?php _e( 'Attach to existing content' ); ?>
-			<button type="button" id="find-posts-close"><span class="screen-reader-text"><?php _e( 'Close media attachment panel' ); ?></span></button>
+			<button type="button" id="find-posts-close"><span class="screen-reader-text">
+				<?php
+				/* translators: Hidden accessibility text. */
+				_e( 'Close media attachment panel' );
+				?>
+			</span></button>
 		</div>
 		<div class="find-box-inside">
 			<div class="find-box-search">
 				<?php if ( $found_action ) { ?>
 					<input type="hidden" name="found_action" value="<?php echo esc_attr( $found_action ); ?>" />
 				<?php } ?>
 				<input type="hidden" name="affected" id="affected" value="" />
 				<?php wp_nonce_field( 'find-posts', '_ajax_nonce', false ); ?>
-				<label class="screen-reader-text" for="find-posts-input"><?php _e( 'Search' ); ?></label>
+				<label class="screen-reader-text" for="find-posts-input">
+					<?php
+					/* translators: Hidden accessibility text. */
+					_e( 'Search' );
+					?>
+				</label>
 				<input type="text" id="find-posts-input" name="ps" value="" />
 				<span class="spinner"></span>
 				<input type="button" id="find-posts-search" value="<?php esc_attr_e( 'Search' ); ?>" class="button" />
 				<div class="clear"></div>
 			</div>
 *
 * @since 2.7.0
 *
 * @global string    $hook_suffix
 * @global string    $admin_body_class
+* @global string    $body_id
 * @global WP_Locale $wp_locale        WordPress date and time locale object.
 *
 * @param string $title      Optional. Title of the Iframe page. Default empty.
 * @param bool   $deprecated Not used.
 */
 function iframe_header( $title = '', $deprecated = false ) {
+	global $hook_suffix, $admin_body_class, $body_id, $wp_locale;
 	show_admin_bar( false );
-	global $hook_suffix, $admin_body_class, $wp_locale;
 	$admin_body_class = preg_replace( '/[^a-z0-9_-]+/i', '-', $hook_suffix );
 	$current_screen = get_current_screen();
 	header( 'Content-Type: ' . get_option( 'html_type' ) . '; charset=' . get_option( 'blog_charset' ) );
 	}
 	?>
 </head>
 	<?php
-	/**
+	$admin_body_id = isset( $body_id ) ? 'id="' . $body_id . '" ' : '';
-	 * @global string $body_id
-	 */
-	$admin_body_id = isset( $GLOBALS['body_id'] ) ? 'id="' . $GLOBALS['body_id'] . '" ' : '';
 	/** This filter is documented in wp-admin/admin-header.php */
 	$admin_body_classes = apply_filters( 'admin_body_class', '' );
 	$admin_body_classes = ltrim( $admin_body_classes . ' ' . $admin_body_class );
 	?>
-<body <?php echo $admin_body_id; ?>class="wp-admin wp-core-ui no-js iframe <?php echo $admin_body_classes; ?>">
+<body <?php echo $admin_body_id; ?>class="wp-admin wp-core-ui no-js iframe <?php echo esc_attr( $admin_body_classes ); ?>">
 <script type="text/javascript">
 (function(){
 var c = document.body.className;
 c = c.replace(/no-js/, 'js');
 document.body.className = c;
 		$post_states_string .= ' &mdash; ';
 		foreach ( $post_states as $state ) {
 			++$i;
-			$sep = ( $i < $state_count ) ? ', ' : '';
+			$separator = ( $i < $state_count ) ? ', ' : '';
-			$post_states_string .= "<span class='post-state'>$state$sep</span>";
+			$post_states_string .= "<span class='post-state'>{$state}{$separator}</span>";
 		}
 	}
 	if ( $display ) {
 		echo $post_states_string;
 		$media_states_string .= ' &mdash; ';
 		foreach ( $media_states as $state ) {
 			++$i;
-			$sep = ( $i < $state_count ) ? ', ' : '';
+			$separator = ( $i < $state_count ) ? ', ' : '';
-			$media_states_string .= "<span class='post-state'>$state$sep</span>";
+			$media_states_string .= "<span class='post-state'>{$state}{$separator}</span>";
 		}
 	}
 	if ( $display ) {
 		echo $media_states_string;
 *
 * @since 3.1.0
 *
 * @see get_submit_button()
 *
-* @param string       $text             The text of the button (defaults to 'Save Changes')
+* @param string       $text             Optional. The text of the button. Defaults to 'Save Changes'.
 * @param string       $type             Optional. The type and CSS class(es) of the button. Core values
 *                                       include 'primary', 'small', and 'large'. Default 'primary'.
-* @param string       $name             The HTML name of the submit button. Defaults to "submit". If no
+* @param string       $name             Optional. The HTML name of the submit button. If no `id` attribute
-*                                       id attribute is given in $other_attributes below, $name will be
+*                                       is given in the `$other_attributes` parameter, `$name` will be used
-*                                       used as the button's id.
+*                                       as the button's `id`. Default 'submit'.
-* @param bool         $wrap             True if the output button should be wrapped in a paragraph tag,
+* @param bool         $wrap             Optional. True if the output button should be wrapped in a paragraph tag,
-*                                       false otherwise. Defaults to true.
+*                                       false otherwise. Default true.
-* @param array|string $other_attributes Other attributes that should be output with the button, mapping
+* @param array|string $other_attributes Optional. Other attributes that should be output with the button,
-*                                       attributes to their values, such as setting tabindex to 1, etc.
+*                                       mapping attributes to their values, e.g. `array( 'id' => 'search-submit' )`.
-*                                       These key/value attribute pairs will be output as attribute="value",
+*                                       These key/value attribute pairs will be output as `attribute="value"`,
-*                                       where attribute is the key. Other attributes can also be provided
+*                                       where attribute is the key. Attributes can also be provided as a string,
-*                                       as a string such as 'tabindex="1"', though the array format is
+*                                       e.g. `id="search-submit"`, though the array format is generally preferred.
-*                                       preferred. Default null.
+*                                       Default empty string.
 */
-function submit_button( $text = null, $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = null ) {
+function submit_button( $text = '', $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = '' ) {
 	echo get_submit_button( $text, $type, $name, $wrap, $other_attributes );
 }
 /**
 * Returns a submit button, with provided text and appropriate class.
 *
 * @since 3.1.0
 *
-* @param string       $text             Optional. The text of the button. Default 'Save Changes'.
+* @param string       $text             Optional. The text of the button. Defaults to 'Save Changes'.
 * @param string       $type             Optional. The type and CSS class(es) of the button. Core values
 *                                       include 'primary', 'small', and 'large'. Default 'primary large'.
-* @param string       $name             Optional. The HTML name of the submit button. Defaults to "submit".
+* @param string       $name             Optional. The HTML name of the submit button. If no `id` attribute
-*                                       If no id attribute is given in $other_attributes below, `$name` will
+*                                       is given in the `$other_attributes` parameter, `$name` will be used
-*                                       be used as the button's id. Default 'submit'.
+*                                       as the button's `id`. Default 'submit'.
-* @param bool         $wrap             Optional. True if the output button should be wrapped in a paragraph
+* @param bool         $wrap             Optional. True if the output button should be wrapped in a paragraph tag,
-*                                       tag, false otherwise. Default true.
+*                                       false otherwise. Default true.
 * @param array|string $other_attributes Optional. Other attributes that should be output with the button,
-*                                       mapping attributes to their values, such as `array( 'tabindex' => '1' )`.
+*                                       mapping attributes to their values, e.g. `array( 'id' => 'search-submit' )`.
-*                                       These attributes will be output as `attribute="value"`, such as
+*                                       These key/value attribute pairs will be output as `attribute="value"`,
-*                                       `tabindex="1"`. Other attributes can also be provided as a string such
+*                                       where attribute is the key. Attributes can also be provided as a string,
-*                                       as `tabindex="1"`, though the array format is typically cleaner.
+*                                       e.g. `id="search-submit"`, though the array format is generally preferred.
-*                                       Default empty.
+*                                       Default empty string.
 * @return string Submit button HTML.
 */
 function get_submit_button( $text = '', $type = 'primary large', $name = 'submit', $wrap = true, $other_attributes = '' ) {
 	if ( ! is_array( $type ) ) {
 		$type = explode( ' ', $type );
 	return $button;
 }
 /**
+* Prints out the beginning of the admin HTML header.
+*
 * @global bool $is_IE
 */
 function _wp_admin_html_begin() {
 	global $is_IE;
 	return WP_Screen::get( $hook_name );
 }
 /**
-* Output the HTML for restoring the post data from DOM storage
+* Outputs the HTML for restoring the post data from DOM storage
 *
 * @since 3.6.0
 * @access private
 */
 function _local_storage_notice() {
-	?>
+	$local_storage_message  = '<p class="local-restore">';
-	<div id="local-storage-notice" class="hidden notice is-dismissible">
+	$local_storage_message .= __( 'The backup of this post in your browser is different from the version below.' );
-	<p class="local-restore">
+	$local_storage_message .= '<button type="button" class="button restore-backup">' . __( 'Restore the backup' ) . '</button></p>';
-		<?php _e( 'The backup of this post in your browser is different from the version below.' ); ?>
+	$local_storage_message .= '<p class="help">';
-		<button type="button" class="button restore-backup"><?php _e( 'Restore the backup' ); ?></button>
+	$local_storage_message .= __( 'This will replace the current editor content with the last backup version. You can use undo and redo in the editor to get the old content back or to return to the restored version.' );
-	</p>
+	$local_storage_message .= '</p>';
-	<p class="help">
-		<?php _e( 'This will replace the current editor content with the last backup version. You can use undo and redo in the editor to get the old content back or to return to the restored version.' ); ?>
+	wp_admin_notice(
-	</p>
+		$local_storage_message,
-	</div>
+		array(
-	<?php
+			'id'                 => 'local-storage-notice',
+			'additional_classes' => array( 'hidden' ),
+			'dismissible'        => true,
+			'paragraph_wrap'     => false,
+		)
+	);
 }
 /**
 * Outputs a HTML element with a star rating for a given rating.
 *
 	$full_stars  = floor( $rating );
 	$half_stars  = ceil( $rating - $full_stars );
 	$empty_stars = 5 - $full_stars - $half_stars;
 	if ( $parsed_args['number'] ) {
-		/* translators: 1: The rating, 2: The number of ratings. */
+		/* translators: Hidden accessibility text. 1: The rating, 2: The number of ratings. */
 		$format = _n( '%1$s rating based on %2$s rating', '%1$s rating based on %2$s ratings', $parsed_args['number'] );
 		$title  = sprintf( $format, number_format_i18n( $rating, 1 ), number_format_i18n( $parsed_args['number'] ) );
 	} else {
-		/* translators: %s: The rating. */
+		/* translators: Hidden accessibility text. %s: The rating. */
 		$title = sprintf( __( '%s rating' ), number_format_i18n( $rating, 1 ) );
 	}
 	$output  = '<div class="star-rating">';
 	$output .= '<span class="screen-reader-text">' . $title . '</span>';
 *
 * @ignore
 * @since 4.2.0
 */
 function _wp_posts_page_notice() {
-	printf(
+	wp_admin_notice(
-		'<div class="notice notice-warning inline"><p>%s</p></div>',
+		__( 'You are currently editing the page that shows your latest posts.' ),
-		__( 'You are currently editing the page that shows your latest posts.' )
+		array(
+			'type'               => 'warning',
+			'additional_classes' => array( 'inline' ),
+		)
 	);
 }
 /**
 * Outputs a notice when editing the page for posts in the block editor (internal use only).

changeset 21	48c4eec2b7e6
parent 19	3d72ae0968f4
child 22	8c2e4d02f4ef