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

equal deleted inserted replaced

-:48c4eec2b7e6
+:8c2e4d02f4ef
 *
 * @since 1.5.0
 * @since 5.5.0 A return value was added.
 * @since 5.5.0 The `$args` parameter was added.
 *
-* @param string $name The name of the specialized header.
+* @param string|null $name The name of the specialized header. Default null.
-* @param array  $args Optional. Additional arguments passed to the header template.
+* @param array       $args Optional. Additional arguments passed to the header template.
-*                     Default empty array.
+*                          Default empty array.
 * @return void|false Void on success, false if the template does not exist.
 */
 function get_header( $name = null, $args = array() ) {
 	/**
 	 * Fires before the header template file is loaded.
 *
 * @since 1.5.0
 * @since 5.5.0 A return value was added.
 * @since 5.5.0 The `$args` parameter was added.
 *
-* @param string $name The name of the specialized footer.
+* @param string|null $name The name of the specialized footer. Default null.
-* @param array  $args Optional. Additional arguments passed to the footer template.
+* @param array       $args Optional. Additional arguments passed to the footer template.
-*                     Default empty array.
+*                          Default empty array.
 * @return void|false Void on success, false if the template does not exist.
 */
 function get_footer( $name = null, $args = array() ) {
 	/**
 	 * Fires before the footer template file is loaded.
 *
 * @since 1.5.0
 * @since 5.5.0 A return value was added.
 * @since 5.5.0 The `$args` parameter was added.
 *
-* @param string $name The name of the specialized sidebar.
+* @param string|null $name The name of the specialized sidebar. Default null.
-* @param array  $args Optional. Additional arguments passed to the sidebar template.
+* @param array       $args Optional. Additional arguments passed to the sidebar template.
-*                     Default empty array.
+*                          Default empty array.
 * @return void|false Void on success, false if the template does not exist.
 */
 function get_sidebar( $name = null, $args = array() ) {
 	/**
 	 * Fires before the sidebar template file is loaded.
 * @since 3.0.0
 * @since 5.5.0 A return value was added.
 * @since 5.5.0 The `$args` parameter was added.
 *
 * @param string      $slug The slug name for the generic template.
-* @param string|null $name Optional. The name of the specialized template.
+* @param string|null $name Optional. The name of the specialized template. Default null.
 * @param array       $args Optional. Additional arguments passed to the template.
 *                          Default empty array.
 * @return void|false Void on success, false if the template does not exist.
 */
 function get_template_part( $slug, $name = null, $args = array() ) {
 	 *
 	 * @since 3.0.0
 	 * @since 5.5.0 The `$args` parameter was added.
 	 *
 	 * @param string      $slug The slug name for the generic template.
-	 * @param string|null $name The name of the specialized template or null if
+	 * @param string|null $name The name of the specialized template
-	 *                          there is none.
+	 *                          or null if there is none.
 	 * @param array       $args Additional arguments passed to the template.
 	 */
 	do_action( "get_template_part_{$slug}", $slug, $name, $args );
 	$templates = array();
 	 *
 	 * @since 5.2.0
 	 * @since 5.5.0 The `$args` parameter was added.
 	 *
 	 * @param string   $slug      The slug name for the generic template.
-	 * @param string   $name      The name of the specialized template or an empty
+	 * @param string   $name      The name of the specialized template
-	 *                            string if there is none.
+	 *                            or an empty string if there is none.
 	 * @param string[] $templates Array of template files to search for, in order.
 	 * @param array    $args      Additional arguments passed to the template.
 	 */
 	do_action( 'get_template_part', $slug, $name, $templates, $args );
 				$html = sprintf(
 					'<span class="custom-logo-link">%1$s</span>',
 					$image
 				);
 			} else {
-				$aria_current = is_front_page() && ! is_paged() ? ' aria-current="page"' : '';
+				$aria_current = ! is_paged() && ( is_front_page() || is_home() && ( (int) get_option( 'page_for_posts' ) !== get_queried_object_id() ) ) ? ' aria-current="page"' : '';
 				$html = sprintf(
 					'<a href="%1$s" class="custom-logo-link" rel="home"%2$s>%3$s</a>',
 					esc_url( home_url( '/' ) ),
 					$aria_current,
 }
 /**
 * Displays title tag with content.
 *
-* @ignore
 * @since 4.1.0
 * @since 4.4.0 Improved title output replaced `wp_title()`.
 * @access private
 */
 function _wp_render_title_tag() {
 * @param string $url      URL to archive.
 * @param string $text     Archive text description.
 * @param string $format   Optional. Can be 'link', 'option', 'html', or custom. Default 'html'.
 * @param string $before   Optional. Content to prepend to the description. Default empty.
 * @param string $after    Optional. Content to append to the description. Default empty.
-* @param bool   $selected Optional. Set to true if the current page is the selected archive page.
+* @param bool   $selected Optional. Set to true if the current page is the selected archive page. Default false.
 * @return string HTML link content for archive.
 */
 function get_archives_link( $url, $text, $format = 'html', $before = '', $after = '', $selected = false ) {
 	$text         = wptexturize( $text );
 	$url          = esc_url( $url );
 		}
 		$arc_w_last = '';
 		if ( $results ) {
 			$after = $parsed_args['after'];
 			foreach ( (array) $results as $result ) {
-				if ( $result->week != $arc_w_last ) {
+				if ( $result->week !== $arc_w_last ) {
 					$arc_year       = $result->yr;
 					$arc_w_last     = $result->week;
 					$arc_week       = get_weekstartend( $result->yyyymmdd, get_option( 'start_of_week' ) );
 					$arc_week_start = date_i18n( get_option( 'date_format' ), $arc_week['start'] );
 					$arc_week_end   = date_i18n( get_option( 'date_format' ), $arc_week['end'] );
 *
 * The calendar is cached, which will be retrieved, if it exists. If there are
 * no posts for the month, then it will not be displayed.
 *
 * @since 1.0.0
+* @since 6.8.0 Added the `$args` parameter, with backward compatibility
+*              for the replaced `$initial` and `$display` parameters.
 *
 * @global wpdb      $wpdb      WordPress database abstraction object.
 * @global int       $m
 * @global int       $monthnum
 * @global int       $year
 * @global WP_Locale $wp_locale WordPress date and time locale object.
 * @global array     $posts
 *
-* @param bool $initial Optional. Whether to use initial calendar names. Default true.
+* @param array $args {
-* @param bool $display Optional. Whether to display the calendar output. Default true.
+*     Optional. Arguments for the `get_calendar` function.
+*
+*     @type bool   $initial   Whether to use initial calendar names. Default true.
+*     @type bool   $display   Whether to display the calendar output. Default true.
+*     @type string $post_type Optional. Post type. Default 'post'.
+* }
 * @return void|string Void if `$display` argument is true, calendar HTML if `$display` is false.
 */
-function get_calendar( $initial = true, $display = true ) {
+function get_calendar( $args = array() ) {
 	global $wpdb, $m, $monthnum, $year, $wp_locale, $posts;
-	$key   = md5( $m . $monthnum . $year );
+	$defaults = array(
+		'initial'   => true,
+		'display'   => true,
+		'post_type' => 'post',
+	);
+	$original_args = func_get_args();
+	$args          = array();
+	if ( ! empty( $original_args ) ) {
+		if ( ! is_array( $original_args[0] ) ) {
+			if ( isset( $original_args[0] ) && is_bool( $original_args[0] ) ) {
+				$defaults['initial'] = $original_args[0];
+			}
+			if ( isset( $original_args[1] ) && is_bool( $original_args[1] ) ) {
+				$defaults['display'] = $original_args[1];
+			}
+		} else {
+			$args = $original_args[0];
+		}
+	}
+	/**
+	 * Filter the `get_calendar` function arguments before they are used.
+	 *
+	 * @since 6.8.0
+	 *
+	 * @param array $args {
+	 *     Optional. Arguments for the `get_calendar` function.
+	 *
+	 *     @type bool   $initial   Whether to use initial calendar names. Default true.
+	 *     @type bool   $display   Whether to display the calendar output. Default true.
+	 *     @type string $post_type Optional. Post type. Default 'post'.
+	 * }
+	 * @return array The arguments for the `get_calendar` function.
+	 */
+	$args = apply_filters( 'get_calendar_args', wp_parse_args( $args, $defaults ) );
+	if ( ! post_type_exists( $args['post_type'] ) ) {
+		$args['post_type'] = 'post';
+	}
+	$w = 0;
+	if ( isset( $_GET['w'] ) ) {
+		$w = (int) $_GET['w'];
+	}
+	/*
+	 * Normalize the cache key.
+	 *
+	 * The following ensures the same cache key is used for the same parameter
+	 * and parameter equivalents. This prevents `post_type > post, initial > true`
+	 * from generating a different key from the same values in the reverse order.
+	 *
+	 * `display` is excluded from the cache key as the cache contains the same
+	 * HTML regardless of this function's need to echo or return the output.
+	 *
+	 * The global values contain data generated by the URL query string variables.
+	 */
+	$cache_args = $args;
+	unset( $cache_args['display'] );
+	$cache_args['globals'] = array(
+		'm'        => $m,
+		'monthnum' => $monthnum,
+		'year'     => $year,
+		'week'     => $w,
+	);
+	wp_recursive_ksort( $cache_args );
+	$key   = md5( serialize( $cache_args ) );
 	$cache = wp_cache_get( 'get_calendar', 'calendar' );
 	if ( $cache && is_array( $cache ) && isset( $cache[ $key ] ) ) {
 		/** This filter is documented in wp-includes/general-template.php */
-		$output = apply_filters( 'get_calendar', $cache[ $key ] );
+		$output = apply_filters( 'get_calendar', $cache[ $key ], $args );
-		if ( $display ) {
+		if ( $args['display'] ) {
 			echo $output;
 			return;
 		}
 		return $output;
 	if ( ! is_array( $cache ) ) {
 		$cache = array();
 	}
+	$post_type = $args['post_type'];
 	// Quick check. If we have no posts at all, abort!
 	if ( ! $posts ) {
-		$gotsome = $wpdb->get_var( "SELECT 1 as test FROM $wpdb->posts WHERE post_type = 'post' AND post_status = 'publish' LIMIT 1" );
+		$gotsome = $wpdb->get_var(
+			$wpdb->prepare(
+				"SELECT 1 as test
+				FROM $wpdb->posts
+				WHERE post_type = %s
+				AND post_status = 'publish'
+				LIMIT 1",
+				$post_type
+			)
+		);
 		if ( ! $gotsome ) {
 			$cache[ $key ] = '';
 			wp_cache_set( 'get_calendar', $cache, 'calendar' );
 			return;
 		}
 	}
-	if ( isset( $_GET['w'] ) ) {
-		$w = (int) $_GET['w'];
-	}
 	// week_begins = 0 stands for Sunday.
 	$week_begins = (int) get_option( 'start_of_week' );
 	// Let's figure out when we are.
 	if ( ! empty( $monthnum ) && ! empty( $year ) ) {
-		$thismonth = zeroise( (int) $monthnum, 2 );
+		$thismonth = (int) $monthnum;
 		$thisyear  = (int) $year;
 	} elseif ( ! empty( $w ) ) {
 		// We need to get the month from MySQL.
 		$thisyear = (int) substr( $m, 0, 4 );
 		// It seems MySQL's weeks disagree with PHP's.
 		$d         = ( ( $w - 1 ) * 7 ) + 6;
-		$thismonth = $wpdb->get_var( "SELECT DATE_FORMAT((DATE_ADD('{$thisyear}0101', INTERVAL $d DAY) ), '%m')" );
+		$thismonth = (int) $wpdb->get_var(
+			$wpdb->prepare(
+				"SELECT DATE_FORMAT((DATE_ADD('%d0101', INTERVAL %d DAY) ), '%%m')",
+				$thisyear,
+				$d
+			)
+		);
 	} elseif ( ! empty( $m ) ) {
 		$thisyear = (int) substr( $m, 0, 4 );
 		if ( strlen( $m ) < 6 ) {
-			$thismonth = '01';
+			$thismonth = 1;
 		} else {
-			$thismonth = zeroise( (int) substr( $m, 4, 2 ), 2 );
+			$thismonth = (int) substr( $m, 4, 2 );
 		}
 	} else {
-		$thisyear  = current_time( 'Y' );
+		$thisyear  = (int) current_time( 'Y' );
-		$thismonth = current_time( 'm' );
+		$thismonth = (int) current_time( 'm' );
 	}
 	$unixmonth = mktime( 0, 0, 0, $thismonth, 1, $thisyear );
 	$last_day  = gmdate( 't', $unixmonth );
 	// Get the next and previous month and year with at least one post.
 	$previous = $wpdb->get_row(
-		"SELECT MONTH(post_date) AS month, YEAR(post_date) AS year
+		$wpdb->prepare(
-		FROM $wpdb->posts
+			"SELECT MONTH(post_date) AS month, YEAR(post_date) AS year
-		WHERE post_date < '$thisyear-$thismonth-01'
+			FROM $wpdb->posts
-		AND post_type = 'post' AND post_status = 'publish'
+			WHERE post_date < '%d-%d-01'
-		ORDER BY post_date DESC
+			AND post_type = %s AND post_status = 'publish'
-		LIMIT 1"
+			ORDER BY post_date DESC
+			LIMIT 1",
+			$thisyear,
+			zeroise( $thismonth, 2 ),
+			$post_type
+		)
 	);
-	$next     = $wpdb->get_row(
-		"SELECT MONTH(post_date) AS month, YEAR(post_date) AS year
+	$next = $wpdb->get_row(
-		FROM $wpdb->posts
+		$wpdb->prepare(
-		WHERE post_date > '$thisyear-$thismonth-{$last_day} 23:59:59'
+			"SELECT MONTH(post_date) AS month, YEAR(post_date) AS year
-		AND post_type = 'post' AND post_status = 'publish'
+			FROM $wpdb->posts
-		ORDER BY post_date ASC
+			WHERE post_date > '%d-%d-%d 23:59:59'
-		LIMIT 1"
+			AND post_type = %s AND post_status = 'publish'
+			ORDER BY post_date ASC
+			LIMIT 1",
+			$thisyear,
+			zeroise( $thismonth, 2 ),
+			$last_day,
+			$post_type
+		)
 	);
 	/* translators: Calendar caption: 1: Month name, 2: 4-digit year. */
 	$calendar_caption = _x( '%1$s %2$s', 'calendar caption' );
 	$calendar_output  = '<table id="wp-calendar" class="wp-calendar-table">
 	for ( $wdcount = 0; $wdcount <= 6; $wdcount++ ) {
 		$myweek[] = $wp_locale->get_weekday( ( $wdcount + $week_begins ) % 7 );
 	}
 	foreach ( $myweek as $wd ) {
-		$day_name         = $initial ? $wp_locale->get_weekday_initial( $wd ) : $wp_locale->get_weekday_abbrev( $wd );
+		$day_name         = $args['initial'] ? $wp_locale->get_weekday_initial( $wd ) : $wp_locale->get_weekday_abbrev( $wd );
 		$wd               = esc_attr( $wd );
-		$calendar_output .= "\n\t\t<th scope=\"col\" title=\"$wd\">$day_name</th>";
+		$calendar_output .= "\n\t\t<th scope=\"col\" aria-label=\"$wd\">$day_name</th>";
 	}
 	$calendar_output .= '
 	</tr>
 	</thead>
 	$daywithpost = array();
 	// Get days with posts.
 	$dayswithposts = $wpdb->get_results(
-		"SELECT DISTINCT DAYOFMONTH(post_date)
+		$wpdb->prepare(
-		FROM $wpdb->posts WHERE post_date >= '{$thisyear}-{$thismonth}-01 00:00:00'
+			"SELECT DISTINCT DAYOFMONTH(post_date)
-		AND post_type = 'post' AND post_status = 'publish'
+			FROM $wpdb->posts WHERE post_date >= '%d-%d-01 00:00:00'
-		AND post_date <= '{$thisyear}-{$thismonth}-{$last_day} 23:59:59'",
+			AND post_type = %s AND post_status = 'publish'
+			AND post_date <= '%d-%d-%d 23:59:59'",
+			$thisyear,
+			zeroise( $thismonth, 2 ),
+			$post_type,
+			$thisyear,
+			zeroise( $thismonth, 2 ),
+			$last_day
+		),
 		ARRAY_N
 	);
 	if ( $dayswithposts ) {
 		foreach ( (array) $dayswithposts as $daywith ) {
 			$daywithpost[] = (int) $daywith[0];
 		}
 	}
 	// See how much we should pad in the beginning.
-	$pad = calendar_week_mod( gmdate( 'w', $unixmonth ) - $week_begins );
+	$pad = calendar_week_mod( (int) gmdate( 'w', $unixmonth ) - $week_begins );
-	if ( 0 != $pad ) {
+	if ( $pad > 0 ) {
 		$calendar_output .= "\n\t\t" . '<td colspan="' . esc_attr( $pad ) . '" class="pad">&nbsp;</td>';
 	}
 	$newrow      = false;
 	$daysinmonth = (int) gmdate( 't', $unixmonth );
 	for ( $day = 1; $day <= $daysinmonth; ++$day ) {
 		if ( isset( $newrow ) && $newrow ) {
 			$calendar_output .= "\n\t</tr>\n\t<tr>\n\t\t";
 		}
 		$newrow = false;
-		if ( current_time( 'j' ) == $day &&
+		if ( (int) current_time( 'j' ) === $day
-			current_time( 'm' ) == $thismonth &&
+			&& (int) current_time( 'm' ) === $thismonth
-			current_time( 'Y' ) == $thisyear ) {
+			&& (int) current_time( 'Y' ) === $thisyear
+		) {
 			$calendar_output .= '<td id="today">';
 		} else {
 			$calendar_output .= '<td>';
 		}
 			$calendar_output .= $day;
 		}
 		$calendar_output .= '</td>';
-		if ( 6 == calendar_week_mod( gmdate( 'w', mktime( 0, 0, 0, $thismonth, $day, $thisyear ) ) - $week_begins ) ) {
+		if ( 6 === (int) calendar_week_mod( (int) gmdate( 'w', mktime( 0, 0, 0, $thismonth, $day, $thisyear ) ) - $week_begins ) ) {
 			$newrow = true;
 		}
 	}
-	$pad = 7 - calendar_week_mod( gmdate( 'w', mktime( 0, 0, 0, $thismonth, $day, $thisyear ) ) - $week_begins );
+	$pad = 7 - calendar_week_mod( (int) gmdate( 'w', mktime( 0, 0, 0, $thismonth, $day, $thisyear ) ) - $week_begins );
-	if ( 0 != $pad && 7 != $pad ) {
+	if ( 0 < $pad && $pad < 7 ) {
 		$calendar_output .= "\n\t\t" . '<td class="pad" colspan="' . esc_attr( $pad ) . '">&nbsp;</td>';
 	}
 	$calendar_output .= "\n\t</tr>\n\t</tbody>";
 	$calendar_output .= "\n\t</table>";
 	$calendar_output .= '<nav aria-label="' . __( 'Previous and next months' ) . '" class="wp-calendar-nav">';
 	if ( $previous ) {
-		$calendar_output .= "\n\t\t" . '<span class="wp-calendar-nav-prev"><a href="' . get_month_link( $previous->year, $previous->month ) . '">&laquo; ' .
+		$calendar_output .= "\n\t\t" . sprintf(
-			$wp_locale->get_month_abbrev( $wp_locale->get_month( $previous->month ) ) .
+			'<span class="wp-calendar-nav-prev"><a href="%1$s">&laquo; %2$s</a></span>',
-		'</a></span>';
+			get_month_link( $previous->year, $previous->month ),
+			$wp_locale->get_month_abbrev( $wp_locale->get_month( $previous->month ) )
+		);
 	} else {
 		$calendar_output .= "\n\t\t" . '<span class="wp-calendar-nav-prev">&nbsp;</span>';
 	}
 	$calendar_output .= "\n\t\t" . '<span class="pad">&nbsp;</span>';
 	if ( $next ) {
-		$calendar_output .= "\n\t\t" . '<span class="wp-calendar-nav-next"><a href="' . get_month_link( $next->year, $next->month ) . '">' .
+		$calendar_output .= "\n\t\t" . sprintf(
-			$wp_locale->get_month_abbrev( $wp_locale->get_month( $next->month ) ) .
+			'<span class="wp-calendar-nav-next"><a href="%1$s">%2$s &raquo;</a></span>',
-		' &raquo;</a></span>';
+			get_month_link( $next->year, $next->month ),
+			$wp_locale->get_month_abbrev( $wp_locale->get_month( $next->month ) )
+		);
 	} else {
 		$calendar_output .= "\n\t\t" . '<span class="wp-calendar-nav-next">&nbsp;</span>';
 	}
 	$calendar_output .= '
 	</nav>';
 	$cache[ $key ] = $calendar_output;
 	wp_cache_set( 'get_calendar', $cache, 'calendar' );
-	if ( $display ) {
+	/**
-		/**
+	 * Filters the HTML calendar output.
-		 * Filters the HTML calendar output.
+	 *
-		 *
+	 * @since 3.0.0
-		 * @since 3.0.0
+	 * @since 6.8.0 Added the `$args` parameter.
-		 *
+	 *
-		 * @param string $calendar_output HTML output of the calendar.
+	 * @param string $calendar_output HTML output of the calendar.
-		 */
+	 * @param array  $args {
-		echo apply_filters( 'get_calendar', $calendar_output );
+	 *     Optional. Array of display arguments.
+	 *
+	 *     @type bool   $initial   Whether to use initial calendar names. Default true.
+	 *     @type bool   $display   Whether to display the calendar output. Default true.
+	 *     @type string $post_type Optional. Post type. Default 'post'.
+	 * }
+	 */
+	$calendar_output = apply_filters( 'get_calendar', $calendar_output, $args );
+	if ( $args['display'] ) {
+		echo $calendar_output;
 		return;
 	}
-	/** This filter is documented in wp-includes/general-template.php */
-	return apply_filters( 'get_calendar', $calendar_output );
+	return $calendar_output;
 }
 /**
 * Purges the cached results of get_calendar.
 *
 function the_date_xml() {
 	echo mysql2date( 'Y-m-d', get_post()->post_date, false );
 }
 /**
-* Displays or retrieves the date the current post was written (once per date)
+* Displays or retrieves the date of the post (once per date).
 *
 * Will only output the date if the current post's date is different from the
 * previous one output.
 *
 * i.e. Only one date listing will show per day worth of posts shown in the loop, even if the
 * function is called several times for each post.
 *
-* HTML output can be filtered with 'the_date'.
+* HTML output can be filtered with {@see 'the_date'}.
-* Date string output can be filtered with 'get_the_date'.
+* Date string output can be filtered with {@see 'get_the_date'}.
 *
 * @since 0.71
 *
 * @global string $currentday  The day of the current post in the loop.
 * @global string $previousday The day of the previous post in the loop.
 		$the_date    = $before . get_the_date( $format ) . $after;
 		$previousday = $currentday;
 	}
 	/**
-	 * Filters the date a post was published for display.
+	 * Filters the date of the post, for display.
 	 *
 	 * @since 0.71
 	 *
 	 * @param string $the_date The formatted date string.
 	 * @param string $format   PHP date format.
 		return $the_date;
 	}
 }
 /**
-* Retrieves the date on which the post was written.
+* Retrieves the date of the post.
 *
 * Unlike the_date() this function will always return the date.
 * Modify output with the {@see 'get_the_date'} filter.
 *
 * @since 3.0.0
 	$_format = ! empty( $format ) ? $format : get_option( 'date_format' );
 	$the_date = get_post_time( $_format, false, $post, true );
 	/**
-	 * Filters the date a post was published.
+	 * Filters the date of the post.
 	 *
 	 * @since 3.0.0
 	 *
-	 * @param string|int  $the_date Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
+	 * @param string|int $the_date Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
-	 * @param string      $format   PHP date format.
+	 * @param string     $format   PHP date format.
-	 * @param WP_Post     $post     The post object.
+	 * @param WP_Post    $post     The post object.
 	 */
 	return apply_filters( 'get_the_date', $the_date, $format, $post );
 }
 /**
 */
 function the_modified_date( $format = '', $before = '', $after = '', $display = true ) {
 	$the_modified_date = $before . get_the_modified_date( $format ) . $after;
 	/**
-	 * Filters the date a post was last modified for display.
+	 * Filters the date a post was last modified, for display.
 	 *
 	 * @since 2.1.0
 	 *
-	 * @param string|false $the_modified_date The last modified date or false if no post is found.
+	 * @param string $the_modified_date The last modified date.
-	 * @param string       $format            PHP date format.
+	 * @param string $format            PHP date format.
-	 * @param string       $before            HTML output before the date.
+	 * @param string $before            HTML output before the date.
-	 * @param string       $after             HTML output after the date.
+	 * @param string $after             HTML output after the date.
 	 */
 	$the_modified_date = apply_filters( 'the_modified_date', $the_modified_date, $format, $before, $after );
 	if ( $display ) {
 		echo $the_modified_date;
 	 */
 	return apply_filters( 'get_the_modified_date', $the_time, $format, $post );
 }
 /**
-* Displays the time at which the post was written.
+* Displays the time of the post.
 *
 * @since 0.71
 *
 * @param string $format Optional. Format to use for retrieving the time the post
 *                       was written. Accepts 'G', 'U', or PHP date format.
 *                       Defaults to the 'time_format' option.
 */
 function the_time( $format = '' ) {
 	/**
-	 * Filters the time a post was written for display.
+	 * Filters the time of the post, for display.
 	 *
 	 * @since 0.71
 	 *
 	 * @param string $get_the_time The formatted time.
 	 * @param string $format       Format to use for retrieving the time the post
 	 */
 	echo apply_filters( 'the_time', get_the_time( $format ), $format );
 }
 /**
-* Retrieves the time at which the post was written.
+* Retrieves the time of the post.
 *
 * @since 1.5.0
 *
 * @param string      $format Optional. Format to use for retrieving the time the post
 *                            was written. Accepts 'G', 'U', or PHP date format.
 	$_format = ! empty( $format ) ? $format : get_option( 'time_format' );
 	$the_time = get_post_time( $_format, false, $post, true );
 	/**
-	 * Filters the time a post was written.
+	 * Filters the time of the post.
 	 *
 	 * @since 1.5.0
 	 *
-	 * @param string|int  $the_time Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
+	 * @param string|int $the_time Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
-	 * @param string      $format   Format to use for retrieving the time the post
+	 * @param string     $format   Format to use for retrieving the time the post
-	 *                              was written. Accepts 'G', 'U', or PHP date format.
+	 *                             was written. Accepts 'G', 'U', or PHP date format.
-	 * @param WP_Post     $post     Post object.
+	 * @param WP_Post    $post     Post object.
 	 */
 	return apply_filters( 'get_the_time', $the_time, $format, $post );
 }
 /**
-* Retrieves the time at which the post was written.
+* Retrieves the localized time of the post.
 *
 * @since 2.0.0
 *
 * @param string      $format    Optional. Format to use for retrieving the time the post
 *                               was written. Accepts 'G', 'U', or PHP date format. Default 'U'.
 		$time = $datetime->format( $format );
 	}
 	/**
-	 * Filters the localized time a post was written.
+	 * Filters the localized time of the post.
 	 *
 	 * @since 2.6.0
 	 *
 	 * @param string|int $time   Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
-	 * @param string     $format Format to use for retrieving the time the post was written.
+	 * @param string     $format Format to use for retrieving the date of the post.
 	 *                           Accepts 'G', 'U', or PHP date format.
 	 * @param bool       $gmt    Whether to retrieve the GMT time.
 	 */
 	return apply_filters( 'get_post_time', $time, $format, $gmt );
 }
 	 */
 	return apply_filters( 'get_post_modified_time', $time, $format, $gmt );
 }
 /**
-* Displays the weekday on which the post was written.
+* Displays the localized weekday for the post.
 *
 * @since 0.71
 *
 * @global WP_Locale $wp_locale WordPress date and time locale object.
 */
 	}
 	$the_weekday = $wp_locale->get_weekday( get_post_time( 'w', false, $post ) );
 	/**
-	 * Filters the weekday on which the post was written, for display.
+	 * Filters the localized weekday of the post, for display.
 	 *
 	 * @since 0.71
 	 *
 	 * @param string $the_weekday
 	 */
 	echo apply_filters( 'the_weekday', $the_weekday );
 }
 /**
-* Displays the weekday on which the post was written.
+* Displays the localized weekday for the post.
 *
 * Will only output the weekday if the current post's weekday is different from
 * the previous one output.
 *
 * @since 0.71
 		$the_weekday_date .= $after;
 		$previousweekday   = $currentday;
 	}
 	/**
-	 * Filters the localized date on which the post was written, for display.
+	 * Filters the localized weekday of the post, for display.
 	 *
 	 * @since 0.71
 	 *
 	 * @param string $the_weekday_date The weekday on which the post was written.
 	 * @param string $before           The HTML to output before the date.
 		/* translators: 1: Site title, 2: Separator (raquo). */
 		'comstitle' => __( '%1$s %2$s Comments Feed' ),
 	);
 	$args = wp_parse_args( $args, $defaults );
+	/**
+	 * Filters the feed links arguments.
+	 *
+	 * @since 6.7.0
+	 *
+	 * @param array $args An array of feed links arguments.
+	 */
+	$args = apply_filters( 'feed_links_args', $args );
 	/**
 	 * Filters whether to display the posts feed link.
 	 *
 	 * @since 4.4.0
 		/* translators: 1: Site name, 2: Separator (raquo), 3: Post type name. */
 		'posttypetitle' => __( '%1$s %2$s %3$s Feed' ),
 	);
 	$args = wp_parse_args( $args, $defaults );
+	/**
+	 * Filters the extra feed links arguments.
+	 *
+	 * @since 6.7.0
+	 *
+	 * @param array $args An array of extra feed links arguments.
+	 */
+	$args = apply_filters( 'feed_links_extra_args', $args );
 	if ( is_singular() ) {
 		$id   = 0;
 		$post = get_post( $id );
 /**
 * Finds out which editor should be displayed by default.
 *
 * Works out which of the editors to display as the current editor for a
-* user. The 'html' setting is for the "Text" editor tab.
+* user. The 'html' setting is for the "Code" editor tab.
 *
 * @since 2.5.0
 *
 * @return string Either 'tinymce', 'html', or 'test'
 */
 *
 * @since 2.1.0
 */
 function the_search_query() {
 	/**
-	 * Filters the contents of the search query variable for display.
+	 * Filters the contents of the search query variable, for display.
 	 *
 	 * @since 2.3.0
 	 *
 	 * @param mixed $search Contents of the search query variable.
 	 */
 	$r          = '';
 	$page_links = array();
 	$dots       = false;
 	if ( $args['prev_next'] && $current && 1 < $current ) :
-		$link = str_replace( '%_%', 2 == $current ? '' : $args['format'], $args['base'] );
+		$link = str_replace( '%_%', 2 === $current ? '' : $args['format'], $args['base'] );
 		$link = str_replace( '%#%', $current - 1, $link );
 		if ( $add_args ) {
 			$link = add_query_arg( $add_args, $link );
 		}
 		$link .= $args['add_fragment'];
 			$args['prev_text']
 		);
 	endif;
 	for ( $n = 1; $n <= $total; $n++ ) :
-		if ( $n == $current ) :
+		if ( $n === $current ) :
 			$page_links[] = sprintf(
 				'<span aria-current="%s" class="page-numbers current">%s</span>',
 				esc_attr( $args['aria_current'] ),
 				$args['before_page_number'] . number_format_i18n( $n ) . $args['after_page_number']
 			);
 			$dots = true;
 		else :
 			if ( $args['show_all'] || ( $n <= $end_size || ( $current && $n >= $current - $mid_size && $n <= $current + $mid_size ) || $n > $total - $end_size ) ) :
-				$link = str_replace( '%_%', 1 == $n ? '' : $args['format'], $args['base'] );
+				$link = str_replace( '%_%', 1 === $n ? '' : $args['format'], $args['base'] );
 				$link = str_replace( '%#%', $n, $link );
 				if ( $add_args ) {
 					$link = add_query_arg( $add_args, $link );
 				}
 				$link .= $args['add_fragment'];
 	wp_admin_css_color(
 		'modern',
 		_x( 'Modern', 'admin color scheme' ),
 		admin_url( "css/colors/modern/colors$suffix.css" ),
-		array( '#1e1e1e', '#3858e9', '#33f078' ),
+		array( '#1e1e1e', '#3858e9', '#7b90ff' ),
 		array(
 			'base'    => '#f3f1f1',
 			'focus'   => '#fff',
 			'current' => '#fff',
 		)
 *
 * @param string $type The type of generator to output - (html|xhtml|atom|rss2|rdf|comment|export).
 */
 function the_generator( $type ) {
 	/**
-	 * Filters the output of the XHTML generator tag for display.
+	 * Filters the output of the XHTML generator tag, for display.
 	 *
 	 * @since 2.5.0
 	 *
 	 * @param string $generator_type The generator output.
 	 * @param string $type           The type of generator to output. Accepts 'html',

changeset 22	8c2e4d02f4ef
parent 21	48c4eec2b7e6