enmi-conf.org: comparison wp/wp-includes/deprecated.php

equal deleted inserted replaced

-:3d4e9c994f10
+:a86126ab1dd4
 /**
 * Sets up the WordPress Loop.
 *
 * Use The Loop instead.
 *
-* @link https://codex.wordpress.org/The_Loop
+* @link https://developer.wordpress.org/themes/basics/the-loop/
 *
 * @since 1.0.1
 * @deprecated 1.5.0
 */
 function start_wp() {
 	$author_data = get_userdata($user_id);
 	$post = get_post($post_id);
 	$post_author_data = get_userdata($post->post_author);
 	if ( (($user_id == $post_author_data->ID) && !($post->post_status == 'publish' && $author_data->user_level < 2))
-			 || ($author_data->user_level > $post_author_data->user_level)
+			|| ($author_data->user_level > $post_author_data->user_level)
-			 || ($author_data->user_level >= 10) ) {
+			|| ($author_data->user_level >= 10) ) {
 		return true;
 	} else {
 		return false;
 	}
 }
 * @return bool
 */
 function user_can_delete_post($user_id, $post_id, $blog_id = 1) {
 	_deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
-	// right now if one can edit, one can delete
+	// Right now if one can edit, one can delete.
 	return user_can_edit_post($user_id, $post_id, $blog_id);
 }
 /**
 * Whether user can set new posts' dates.
 * @return bool returns true if $user_id can edit $post_id's comments
 */
 function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
 	_deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
-	// right now if one can edit a post, one can edit comments made on it
+	// Right now if one can edit a post, one can edit comments made on it.
 	return user_can_edit_post($user_id, $post_id, $blog_id);
 }
 /**
 * Whether user can delete a post.
 * @return bool returns true if $user_id can delete $post_id's comments
 */
 function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {
 	_deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
-	// right now if one can edit comments, one can delete comments
+	// Right now if one can edit comments, one can delete comments.
 	return user_can_edit_post_comments($user_id, $post_id, $blog_id);
 }
 /**
 * Can user can edit other user.
 *
 * @since 0.71
 * @deprecated 2.1.0 Use get_bookmarks()
 * @see get_bookmarks()
 *
-* @param string $cat_name Optional. The category name to use. If no match is found uses all.
+* @param string $cat_name         Optional. The category name to use. If no match is found, uses all.
-* @param string $before Optional. The html to output before the link.
+*                                 Default 'noname'.
-* @param string $after Optional. The html to output after the link.
+* @param string $before           Optional. The HTML to output before the link. Default empty.
-* @param string $between Optional. The html to output between the link/image and its description. Not used if no image or $show_images is true.
+* @param string $after            Optional. The HTML to output after the link. Default '<br />'.
-* @param bool $show_images Optional. Whether to show images (if defined).
+* @param string $between          Optional. The HTML to output between the link/image and its description.
-* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner.
+*                                 Not used if no image or $show_images is true. Default ' '.
-*		If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which will return links in a
+* @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
-*		random order.
+* @param string $orderby          Optional. The order to output the links. E.g. 'id', 'name', 'url',
-* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
+*                                 'description', 'rating', or 'owner'. Default 'id'.
-* @param bool $show_rating Optional. Show rating stars/chars.
+*                                 If you start the name with an underscore, the order will be reversed.
-* @param int $limit		Optional. Limit to X entries. If not specified, all entries are shown.
+*                                 Specifying 'rand' as the order will return links in a random order.
-* @param int $show_updated Optional. Whether to show last updated timestamp
+* @param bool   $show_description Optional. Whether to show the description if show_images=false/not defined.
+*                                 Default true.
+* @param bool   $show_rating      Optional. Show rating stars/chars. Default false.
+* @param int    $limit            Optional. Limit to X entries. If not specified, all entries are shown.
+*                                 Default -1.
+* @param int    $show_updated     Optional. Whether to show last updated timestamp. Default 0.
 */
 function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
-						 $show_description = true, $show_rating = false,
+						$show_description = true, $show_rating = false,
-						 $limit = -1, $show_updated = 0) {
+						$limit = -1, $show_updated = 0) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
 	$cat_id = -1;
 	$cat = get_term_by('name', $cat_name, 'link_category');
 	if ( $cat )
 		'category_name' => $category,
 		'show_description' => 1,
 		'title_li' => '',
 	);
-	$r = wp_parse_args( $args, $defaults );
+	$parsed_args = wp_parse_args( $args, $defaults );
-	return wp_list_bookmarks($r);
+	return wp_list_bookmarks($parsed_args);
 }
 /**
 * Gets an array of link objects associated with category $cat_name.
 *
 *
 * @since 1.0.1
 * @deprecated 2.1.0 Use get_bookmarks()
 * @see get_bookmarks()
 *
-* @param string $cat_name The category name to use. If no match is found uses all.
+* @param string $cat_name Optional. The category name to use. If no match is found, uses all.
-* @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.
+*                         Default 'noname'.
-*		Or maybe owner. If you start the name with an underscore the order will be reversed. You can also
+* @param string $orderby  Optional. The order to output the links. E.g. 'id', 'name', 'url',
-*		specify 'rand' as the order which will return links in a random order.
+*                         'description', 'rating', or 'owner'. Default 'name'.
-* @param int $limit Limit to X entries. If not specified, all entries are shown.
+*                         If you start the name with an underscore, the order will be reversed.
+*                         Specifying 'rand' as the order will return links in a random order.
+* @param int    $limit    Optional. Limit to X entries. If not specified, all entries are shown.
+*                         Default -1.
 * @return array
 */
 function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
 *
 * @since 1.0.1
 * @deprecated 2.1.0 Use get_bookmarks()
 * @see get_bookmarks()
 *
-* @param int $category The category to use. If no category supplied uses all
+* @param int    $category Optional. The category to use. If no category supplied, uses all.
-* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
+*                         Default 0.
-*		'description', or 'rating'. Or maybe owner. If you start the name with an
+* @param string $orderby  Optional. The order to output the links. E.g. 'id', 'name', 'url',
-*		underscore the order will be reversed. You can also specify 'rand' as the
+*                         'description', 'rating', or 'owner'. Default 'name'.
-*		order which will return links in a random order.
+*                         If you start the name with an underscore, the order will be reversed.
-* @param int $limit Limit to X entries. If not specified, all entries are shown.
+*                         Specifying 'rand' as the order will return links in a random order.
+* @param int    $limit    Optional. Limit to X entries. If not specified, all entries are shown.
+*                         Default 0.
 * @return array
 */
 function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
 *
 * @since 0.71
 * @deprecated 2.1.0 Use get_bookmarks()
 * @see get_bookmarks()
 *
-* @param string $cat_name The category name to use. If no match is found uses all
+* @param string $cat_name         Optional. The category name to use. If no match is found, uses all.
-* @param string $before The html to output before the link
+*                                 Default 'noname'.
-* @param string $after The html to output after the link
+* @param string $before           Optional. The HTML to output before the link. Default empty.
-* @param string $between The html to output between the link/image and its description. Not used if no image or show_images is true
+* @param string $after            Optional. The HTML to output after the link. Default '<br />'.
-* @param bool $show_images Whether to show images (if defined).
+* @param string $between          Optional. The HTML to output between the link/image and its description.
-* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
+*                                 Not used if no image or $show_images is true. Default ' '.
-*		'description', or 'rating'. Or maybe owner. If you start the name with an
+* @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
-*		underscore the order will be reversed. You can also specify 'rand' as the
+* @param string $orderby          Optional. The order to output the links. E.g. 'id', 'name', 'url',
-*		order which will return links in a random order.
+*                                 'description', 'rating', or 'owner'. Default 'id'.
-* @param bool $show_description Whether to show the description if show_images=false/not defined
+*                                 If you start the name with an underscore, the order will be reversed.
-* @param int $limit Limit to X entries. If not specified, all entries are shown.
+*                                 Specifying 'rand' as the order will return links in a random order.
-* @param int $show_updated Whether to show last updated timestamp
+* @param bool   $show_description Optional. Whether to show the description if show_images=false/not defined.
+*                                 Default true.
+* @param int    $limit		       Optional. Limit to X entries. If not specified, all entries are shown.
+*                                 Default -1.
+* @param int    $show_updated     Optional. Whether to show last updated timestamp. Default 0.
 */
 function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
 									$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
 *
 * @since 0.71
 * @deprecated 2.1.0 Use get_bookmarks()
 * @see get_bookmarks()
 *
-* @param int $category The category to use. If no category supplied uses all
+* @param int    $category         Optional. The category to use. If no category supplied, uses all.
-* @param string $before The html to output before the link
+*                                 Default 0.
-* @param string $after The html to output after the link
+* @param string $before           Optional. The HTML to output before the link. Default empty.
-* @param string $between The html to output between the link/image and its description. Not used if no image or show_images == true
+* @param string $after            Optional. The HTML to output after the link. Default '<br />'.
-* @param bool $show_images Whether to show images (if defined).
+* @param string $between          Optional. The HTML to output between the link/image and its description.
-* @param string $orderby The order to output the links. E.g. 'id', 'name', 'url',
+*                                 Not used if no image or $show_images is true. Default ' '.
-*		'description', or 'rating'. Or maybe owner. If you start the name with an
+* @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
-*		underscore the order will be reversed. You can also specify 'rand' as the
+* @param string $orderby          Optional. The order to output the links. E.g. 'id', 'name', 'url',
-*		order which will return links in a random order.
+*                                 'description', 'rating', or 'owner'. Default 'id'.
-* @param bool $show_description Whether to show the description if show_images=false/not defined.
+*                                 If you start the name with an underscore, the order will be reversed.
-* @param int $limit Limit to X entries. If not specified, all entries are shown.
+*                                 Specifying 'rand' as the order will return links in a random order.
-* @param int $show_updated Whether to show last updated timestamp
+* @param bool   $show_description Optional. Whether to show the description if show_images=false/not defined.
+*                                 Default true.
+* @param int    $limit		       Optional. Limit to X entries. If not specified, all entries are shown.
+*                                 Default -1.
+* @param int    $show_updated     Optional. Whether to show last updated timestamp. Default 0.
 */
 function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
-							  $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
+							$orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
 	get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
 }
 * @param int $recurse
 * @param string $feed
 * @param string $feed_image
 * @param string $exclude
 * @param bool $hierarchical
-* @return false|null
+* @return null|false
 */
 function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,
-				   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,
+				$optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,
-				   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
+				$recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' );
 	$query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',
 		'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');
 	return wp_list_cats($query);
 * @since 1.2.0
 * @deprecated 2.1.0 Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
-* @return false|null|string
+* @return null|string|false
 */
 function wp_list_cats($args = '') {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' );
-	$r = wp_parse_args( $args );
+	$parsed_args = wp_parse_args( $args );
 	// Map to new names.
-	if ( isset($r['optionall']) && isset($r['all']))
+	if ( isset($parsed_args['optionall']) && isset($parsed_args['all']))
-		$r['show_option_all'] = $r['all'];
+		$parsed_args['show_option_all'] = $parsed_args['all'];
-	if ( isset($r['sort_column']) )
+	if ( isset($parsed_args['sort_column']) )
-		$r['orderby'] = $r['sort_column'];
+		$parsed_args['orderby'] = $parsed_args['sort_column'];
-	if ( isset($r['sort_order']) )
+	if ( isset($parsed_args['sort_order']) )
-		$r['order'] = $r['sort_order'];
+		$parsed_args['order'] = $parsed_args['sort_order'];
-	if ( isset($r['optiondates']) )
+	if ( isset($parsed_args['optiondates']) )
-		$r['show_last_update'] = $r['optiondates'];
+		$parsed_args['show_last_update'] = $parsed_args['optiondates'];
-	if ( isset($r['optioncount']) )
+	if ( isset($parsed_args['optioncount']) )
-		$r['show_count'] = $r['optioncount'];
+		$parsed_args['show_count'] = $parsed_args['optioncount'];
-	if ( isset($r['list']) )
+	if ( isset($parsed_args['list']) )
-		$r['style'] = $r['list'] ? 'list' : 'break';
+		$parsed_args['style'] = $parsed_args['list'] ? 'list' : 'break';
-	$r['title_li'] = '';
+	$parsed_args['title_li'] = '';
-	return wp_list_categories($r);
+	return wp_list_categories($parsed_args);
 }
 /**
 * Deprecated method for generating a drop-down of categories.
 *
 	_deprecated_function( __FUNCTION__, '2.1.0', 'wp_get_post_categories()' );
 	return wp_get_post_categories($post_ID);
 }
 /**
-* Sets the categories that the post id belongs to.
+* Sets the categories that the post ID belongs to.
 *
 * @since 1.0.1
 * @deprecated 2.1.0
 * @deprecated Use wp_set_post_categories()
 * @see wp_set_post_categories()
 		'show_rating' => false,
 		'show_updated' => true,
 		'title_li' => '',
 	);
-	$r = wp_parse_args( $args, $defaults );
+	$parsed_args = wp_parse_args( $args, $defaults );
-	return wp_list_bookmarks($r);
+	return wp_list_bookmarks($parsed_args);
 }
 /**
-* Gets the links associated with category by id.
+* Gets the links associated with category by ID.
 *
 * @since 0.71
 * @deprecated 2.1.0 Use get_bookmarks()
 * @see get_bookmarks()
 *
-* @param int $category The category to use. If no category supplied uses all
+* @param int    $category         Optional. The category to use. If no category supplied uses all.
-* @param string $before the html to output before the link
+*                                 Default 0.
-* @param string $after the html to output after the link
+* @param string $before           Optional. The HTML to output before the link. Default empty.
-* @param string $between the html to output between the link/image and its description.
+* @param string $after            Optional. The HTML to output after the link. Default '<br />'.
-*		Not used if no image or show_images == true
+* @param string $between          Optional. The HTML to output between the link/image and its description.
-* @param bool $show_images whether to show images (if defined).
+*                                 Not used if no image or $show_images is true. Default ' '.
-* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
+* @param bool   $show_images      Optional. Whether to show images (if defined). Default true.
-*		'description', or 'rating'. Or maybe owner. If you start the name with an
+* @param string $orderby          Optional. The order to output the links. E.g. 'id', 'name', 'url',
-*		underscore the order will be reversed. You can also specify 'rand' as the order
+*                                 'description', 'rating', or 'owner'. Default 'name'.
-*		which will return links in a random order.
+*                                 If you start the name with an underscore, the order will be reversed.
-* @param bool $show_description whether to show the description if show_images=false/not defined.
+*                                 Specifying 'rand' as the order will return links in a random order.
-* @param bool $show_rating show rating stars/chars
+* @param bool   $show_description Optional. Whether to show the description if show_images=false/not defined.
-* @param int $limit Limit to X entries. If not specified, all entries are shown.
+*                                 Default true.
-* @param int $show_updated whether to show last updated timestamp
+* @param bool   $show_rating      Optional. Show rating stars/chars. Default false.
-* @param bool $echo whether to echo the results, or return them instead
+* @param int    $limit            Optional. Limit to X entries. If not specified, all entries are shown.
+*                                 Default -1.
+* @param int    $show_updated     Optional. Whether to show last updated timestamp. Default 1.
+* @param bool   $echo             Whether to echo the results, or return them instead.
 * @return null|string
 */
 function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
 			$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
 	if ( substr($orderby, 0, 1) == '_' ) {
 		$order = 'DESC';
 		$orderby = substr($orderby, 1);
 	}
-	if ( $category == -1 ) //get_bookmarks uses '' to signify all categories
+	if ( $category == -1 ) // get_bookmarks() uses '' to signify all categories.
 		$category = '';
 	$results = get_bookmarks(array('category' => $category, 'orderby' => $orderby, 'order' => $order, 'show_updated' => $show_updated, 'limit' => $limit));
 	if ( !$results )
 		$name = esc_attr(sanitize_bookmark_field('link_name', $row->link_name, $row->link_id, 'display'));
 		$title = $desc;
 		if ( $show_updated )
 			if (substr($row->link_updated_f, 0, 2) != '00')
-				$title .= ' ('.__('Last updated') . ' ' . date(get_option('links_updated_date_format'), $row->link_updated_f + (get_option('gmt_offset') * HOUR_IN_SECONDS)) . ')';
+				$title .= ' ('.__('Last updated') . ' ' . gmdate(get_option('links_updated_date_format'), $row->link_updated_f + (get_option('gmt_offset') * HOUR_IN_SECONDS)) . ')';
 		if ( '' != $title )
 			$title = ' title="' . $title . '"';
 		$alt = ' alt="' . $name . '"';
 		$output .= '<a href="' . $the_link . '"' . $rel . $title . $target. '>';
 		if ( $row->link_image != null && $show_images ) {
 			if ( strpos($row->link_image, 'http') !== false )
 				$output .= "<img src=\"$row->link_image\" $alt $title />";
-			else // If it's a relative path
+			else // If it's a relative path.
 				$output .= "<img src=\"" . get_option('siteurl') . "$row->link_image\" $alt $title />";
 		} else {
 			$output .= $name;
 		}
 		if ($show_rating) {
 			$output .= $between . get_linkrating($row);
 		}
 		$output .= "$after\n";
-	} // end while
+	} // End while.
 	if ( !$echo )
 		return $output;
 	echo $output;
 }
 function get_links_list($order = 'name') {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' );
 	$order = strtolower($order);
-	// Handle link category sorting
+	// Handle link category sorting.
 	$direction = 'ASC';
 	if ( '_' == substr($order,0,1) ) {
 		$direction = 'DESC';
 		$order = substr($order,1);
 	}
 	if ( !isset($direction) )
 		$direction = '';
 	$cats = get_categories(array('type' => 'link', 'orderby' => $order, 'order' => $direction, 'hierarchical' => 0));
-	// Display each category
+	// Display each category.
 	if ( $cats ) {
 		foreach ( (array) $cats as $cat ) {
 			// Handle each category.
-			// Display the category name
+			// Display the category name.
 			echo '  <li id="linkcat-' . $cat->term_id . '" class="linkcat"><h2>' . apply_filters('link_category', $cat->name ) . "</h2>\n\t<ul>\n";
-			// Call get_links() with all the appropriate params
+			// Call get_links() with all the appropriate params.
 			get_links($cat->term_id, '<li>', "</li>", "\n", true, 'name', false);
-			// Close the last category
+			// Close the last category.
 			echo "\n\t</ul>\n</li>\n";
 		}
 	}
 }
 	_deprecated_function( __FUNCTION__, '2.1.0', 'sanitize_bookmark_field()' );
 	return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
 }
 /**
-* Gets the name of category by id.
+* Gets the name of category by ID.
 *
 * @since 0.71
 * @deprecated 2.1.0 Use get_category()
 * @see get_category()
 *
 *
 * @since 1.2.0
 * @deprecated 2.8.0 Use get_term_children()
 * @see get_term_children()
 *
-* @param int $id Category ID to retrieve children.
+* @param int    $id      Category ID to retrieve children.
-* @param string $before Optional. Prepend before category term ID.
+* @param string $before  Optional. Prepend before category term ID. Default '/'.
-* @param string $after Optional, default is empty string. Append after category term ID.
+* @param string $after   Optional. Append after category term ID. Default empty string.
-* @param array $visited Optional. Category Term IDs that have already been added.
+* @param array  $visited Optional. Category Term IDs that have already been added.
+*                        Default empty array.
 * @return string
 */
 function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {
 	_deprecated_function( __FUNCTION__, '2.8.0', 'get_term_children()' );
 	if ( 0 == $id )
 		return '';
 	$chain = '';
-	/** TODO: consult hierarchy */
+	/** TODO: Consult hierarchy */
 	$cat_ids = get_all_category_ids();
 	foreach ( (array) $cat_ids as $cat_id ) {
 		if ( $cat_id == $id )
 			continue;
 *
 * @since 2.0.0
 * @deprecated 4.0.0 Use get_terms()
 * @see get_terms()
 *
-* @link https://codex.wordpress.org/Function_Reference/get_all_category_ids
+* @link https://developer.wordpress.org/reference/functions/get_all_category_ids/
 *
 * @return object List of all of the category IDs.
 */
 function get_all_category_ids() {
 	_deprecated_function( __FUNCTION__, '4.0.0', 'get_terms()' );
-	if ( ! $cat_ids = wp_cache_get( 'all_category_ids', 'category' ) ) {
+	$cat_ids = get_terms(
-		$cat_ids = get_terms( 'category', array('fields' => 'ids', 'get' => 'all') );
+		array(
-		wp_cache_add( 'all_category_ids', $cat_ids, 'category' );
+			'taxonomy' => 'category',
-	}
+			'fields'   => 'ids',
+			'get'      => 'all',
+		)
+	);
 	return $cat_ids;
 }
 /**
 }
 /**
 * Display the post content for the feed.
 *
-* For encoding the html or the $encode_html parameter, there are three possible
+* For encoding the HTML or the $encode_html parameter, there are three possible values:
-* values. '0' will make urls footnotes and use make_url_footnote(). '1' will
+* - '0' will make urls footnotes and use make_url_footnote().
-* encode special characters and automatically display all of the content. The
+* - '1' will encode special characters and automatically display all of the content.
-* value of '2' will strip all HTML tags from the content.
+* - '2' will strip all HTML tags from the content.
 *
-* Also note that you cannot set the amount of words and not set the html
+* Also note that you cannot set the amount of words and not set the HTML encoding.
-* encoding. If that is the case, then the html encoding will default to 2,
+* If that is the case, then the HTML encoding will default to 2, which will strip
-* which will strip all HTML tags.
+* all HTML tags.
 *
-* To restrict the amount of words of the content, you can use the cut
+* To restrict the amount of words of the content, you can use the cut parameter.
-* parameter. If the content is less than the amount, then there won't be any
+* If the content is less than the amount, then there won't be any dots added to the end.
-* dots added to the end. If there is content left over, then dots will be added
+* If there is content left over, then dots will be added and the rest of the content
-* and the rest of the content will be removed.
+* will be removed.
 *
 * @since 0.71
 *
 * @deprecated 2.9.0 Use the_content_feed()
 * @see the_content_feed()
 *
-* @param string $more_link_text Optional. Text to display when more content is available but not displayed.
+* @param string $more_link_text Optional. Text to display when more content is available
-* @param int $stripteaser Optional. Default is 0.
+*                               but not displayed. Default '(more...)'.
-* @param string $more_file Optional.
+* @param int    $stripteaser    Optional. Default 0.
-* @param int $cut Optional. Amount of words to keep for the content.
+* @param string $more_file      Optional.
-* @param int $encode_html Optional. How to encode the content.
+* @param int    $cut            Optional. Amount of words to keep for the content.
+* @param int    $encode_html    Optional. How to encode the content.
 */
 function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
 	_deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed()' );
 	$content = get_the_content($more_link_text, $stripteaser);
 * them at the bottom of the content with numbers.
 *
 * @since 0.71
 * @deprecated 2.9.0
 *
-* @param string $content Content to get links
+* @param string $content Content to get links.
 * @return string HTML stripped out of content with links at the bottom.
 */
 function make_url_footnote( $content ) {
 	_deprecated_function( __FUNCTION__, '2.9.0', '' );
 	preg_match_all( '/<a(.+?)href=\"(.+?)\"(.*?)>(.+?)<\/a>/', $content, $matches );
 *
 * @since 2.2.0
 * @deprecated 2.9.0 Use _x()
 * @see _x()
 *
-* @param string $text Text to translate
+* @param string $text Text to translate.
-* @param string $domain Optional. Domain to retrieve the translated text
+* @param string $domain Optional. Domain to retrieve the translated text.
-* @return string Translated context string without pipe
+* @return string Translated context string without pipe.
 */
 function _c( $text, $domain = 'default' ) {
 	_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
 	return before_last_bar( translate( $text, $domain ) );
 }
 *
 * @since 2.5.0
 * @deprecated 3.0.0 Use _x()
 * @see _x()
 *
-* @param string $text Text to translate
+* @param string $text Text to translate.
-* @param string $domain Domain to retrieve the translated text
+* @param string $domain Domain to retrieve the translated text.
-* @return string Translated text
+* @return string Translated text.
 */
 function translate_with_context( $text, $domain = 'default' ) {
 	_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
 	return before_last_bar( translate( $text, $domain ) );
 }
 *
 * @since 1.2.0
 * @deprecated 2.8.0 Use _n()
 * @see _n()
 */
-function __ngettext() {
+function __ngettext( ...$args ) { // phpcs:ignore PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
 	_deprecated_function( __FUNCTION__, '2.8.0', '_n()' );
-	$args = func_get_args();
+	return _n( ...$args );
-	return call_user_func_array('_n', $args);
 }
 /**
 * Register plural strings in POT file, but don't translate them.
 *
 * @since 2.5.0
 * @deprecated 2.8.0 Use _n_noop()
 * @see _n_noop()
 */
-function __ngettext_noop() {
+function __ngettext_noop( ...$args ) { // phpcs:ignore PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
 	_deprecated_function( __FUNCTION__, '2.8.0', '_n_noop()' );
-	$args = func_get_args();
+	return _n_noop( ...$args );
-	return call_user_func_array('_n_noop', $args);
 }
 /**
 * Retrieve all autoload options, or all options if no autoloaded ones exist.
 *
 * @since 2.0.0
 * @deprecated 2.5.0 Use wp_get_attachment_link()
 * @see wp_get_attachment_link()
 *
-* @param int $id Optional. Post ID.
+* @param int   $id       Optional. Post ID.
-* @param bool $fullsize Optional, default is false. Whether to use full size image.
+* @param bool  $fullsize Optional. Whether to use full size image. Default false.
 * @param array $max_dims Optional. Max image dimensions.
-* @param bool $permalink Optional, default is false. Whether to include permalink to image.
+* @param bool $permalink Optional. Whether to include permalink to image. Default false.
 * @return string
 */
 function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false) {
 	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_link()' );
 	$id = (int) $id;
 *
 * @since 2.1.0
 * @deprecated 2.5.0 Use wp_get_attachment_image_src()
 * @see wp_get_attachment_image_src()
 *
-* @param int $id Optional. Post ID.
+* @param int  $id       Optional. Post ID.
-* @param bool $fullsize Optional, default to false. Whether to have full image.
+* @param bool $fullsize Optional. Whether to have full image. Default false.
 * @return array Icon URL and full path to file, respectively.
 */
 function get_attachment_icon_src( $id = 0, $fullsize = false ) {
 	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image_src()' );
 	$id = (int) $id;
 		return false;
 	$file = get_attached_file( $post->ID );
 	if ( !$fullsize && $src = wp_get_attachment_thumb_url( $post->ID ) ) {
-		// We have a thumbnail desired, specified and existing
+		// We have a thumbnail desired, specified and existing.
 		$src_file = wp_basename($src);
 	} elseif ( wp_attachment_is_image( $post->ID ) ) {
-		// We have an image without a thumbnail
+		// We have an image without a thumbnail.
 		$src = wp_get_attachment_url( $post->ID );
 		$src_file = & $file;
 	} elseif ( $src = wp_mime_type_icon( $post->ID ) ) {
 		// No thumb, no image. We'll look for a mime-related icon instead.
 *
 * @since 2.0.0
 * @deprecated 2.5.0 Use wp_get_attachment_image()
 * @see wp_get_attachment_image()
 *
-* @param int $id Optional. Post ID.
+* @param int   $id       Optional. Post ID.
-* @param bool $fullsize Optional, default to false. Whether to have full size image.
+* @param bool  $fullsize Optional. Whether to have full size image. Default false.
 * @param array $max_dims Optional. Dimensions of image.
-* @return false|string HTML content.
+* @return string|false HTML content.
 */
 function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) {
 	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' );
 	$id = (int) $id;
 	if ( !$post = get_post($id) )
 	list($src, $src_file) = $src;
 	// Do we need to constrain the image?
 	if ( ($max_dims = apply_filters('attachment_max_dims', $max_dims)) && file_exists($src_file) ) {
-		$imagesize = getimagesize($src_file);
+		$imagesize = @getimagesize($src_file);
 		if (($imagesize[0] > $max_dims[0]) || $imagesize[1] > $max_dims[1] ) {
 			$actual_aspect = $imagesize[0] / $imagesize[1];
 			$desired_aspect = $max_dims[0] / $max_dims[1];
 *
 * @since 2.0.0
 * @deprecated 2.5.0 Use wp_get_attachment_image()
 * @see wp_get_attachment_image()
 *
-* @param int $id Optional. Post ID.
+* @param int   $id       Optional. Post ID.
-* @param bool $fullsize Optional, default to false. Whether to have full size image.
+* @param bool  $fullsize Optional. Whether to have full size image. Default false.
 * @param array $max_dims Optional. Dimensions of image.
-* @return false|string
+* @return string|false
 */
 function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) {
 	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' );
 	$id = (int) $id;
 	if ( !$post = get_post($id) )
 * @return string Escaped `$string`.
 */
 function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
 	_deprecated_function( __FUNCTION__, '2.8.0', 'esc_html()' );
 	if ( func_num_args() > 1 ) { // Maintain back-compat for people passing additional arguments.
-		$args = func_get_args();
+		return _wp_specialchars( $string, $quote_style, $charset, $double_encode );
-		return call_user_func_array( '_wp_specialchars', $args );
 	} else {
 		return esc_html( $string );
 	}
 }
 * @see wp_register_sidebar_widget()
 *
 * @param string|int $name            Widget ID.
 * @param callable   $output_callback Run when widget is called.
 * @param string     $classname       Optional. Classname widget option. Default empty.
-* @param mixed      $params ,...     Widget parameters.
+* @param mixed      ...$params       Widget parameters.
 */
-function register_sidebar_widget($name, $output_callback, $classname = '') {
+function register_sidebar_widget($name, $output_callback, $classname = '', ...$params) {
 	_deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_sidebar_widget()' );
-	// Compat
+	// Compat.
-	if ( is_array($name) ) {
+	if ( is_array( $name ) ) {
-		if ( count($name) == 3 )
+		if ( count( $name ) === 3 ) {
-			$name = sprintf($name[0], $name[2]);
+			$name = sprintf( $name[0], $name[2] );
-		else
+		} else {
 			$name = $name[0];
+		}
 	}
-	$id = sanitize_title($name);
+	$id      = sanitize_title( $name );
 	$options = array();
-	if ( !empty($classname) && is_string($classname) )
+	if ( ! empty( $classname ) && is_string( $classname ) ) {
 		$options['classname'] = $classname;
-	$params = array_slice(func_get_args(), 2);
+	}
-	$args = array($id, $name, $output_callback, $options);
-	if ( !empty($params) )
+	wp_register_sidebar_widget( $id, $name, $output_callback, $options, ...$params );
-		$args = array_merge($args, $params);
-	call_user_func_array('wp_register_sidebar_widget', $args);
 }
 /**
 * Serves as an alias of wp_unregister_sidebar_widget().
 *
 *
 * @since 2.2.0
 * @deprecated 2.8.0 Use wp_register_widget_control()
 * @see wp_register_widget_control()
 *
-* @param int|string $name Sidebar ID.
+* @param int|string $name             Sidebar ID.
-* @param callable $control_callback Widget control callback to display and process form.
+* @param callable   $control_callback Widget control callback to display and process form.
-* @param int $width Widget width.
+* @param int        $width            Widget width.
-* @param int $height Widget height.
+* @param int        $height           Widget height.
-*/
+* @param mixed      ...$params        Widget parameters.
-function register_widget_control($name, $control_callback, $width = '', $height = '') {
+*/
+function register_widget_control($name, $control_callback, $width = '', $height = '', ...$params) {
 	_deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_widget_control()' );
-	// Compat
+	// Compat.
-	if ( is_array($name) ) {
+	if ( is_array( $name ) ) {
-		if ( count($name) == 3 )
+		if ( count( $name ) === 3 ) {
-			$name = sprintf($name[0], $name[2]);
+			$name = sprintf( $name[0], $name[2] );
-		else
+		} else {
 			$name = $name[0];
+		}
 	}
-	$id = sanitize_title($name);
+	$id      = sanitize_title( $name );
 	$options = array();
-	if ( !empty($width) )
+	if ( ! empty( $width ) ) {
 		$options['width'] = $width;
-	if ( !empty($height) )
+	}
+	if ( ! empty( $height ) ) {
 		$options['height'] = $height;
-	$params = array_slice(func_get_args(), 4);
+	}
-	$args = array($id, $name, $control_callback, $options);
-	if ( !empty($params) )
+	wp_register_widget_control( $id, $name, $control_callback, $options, ...$params );
-		$args = array_merge($args, $params);
-	call_user_func_array('wp_register_widget_control', $args);
 }
 /**
 * Alias of wp_unregister_widget_control().
 *
 * @deprecated 3.0.0 Use delete_user_meta()
 * @see delete_user_meta()
 *
 * @param int $user_id User ID.
 * @param string $meta_key Metadata key.
-* @param mixed $meta_value Metadata value.
+* @param mixed $meta_value Optional. Metadata value. Default empty.
 * @return bool True deletion completed and false if user_id is not a number.
 */
 function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) {
 	_deprecated_function( __FUNCTION__, '3.0.0', 'delete_user_meta()' );
 	global $wpdb;
 * @since 2.0.0
 * @deprecated 3.0.0 Use get_user_meta()
 * @see get_user_meta()
 *
 * @param int $user_id User ID
-* @param string $meta_key Optional. Metadata key.
+* @param string $meta_key Optional. Metadata key. Default empty.
 * @return mixed
 */
 function get_usermeta( $user_id, $meta_key = '' ) {
 	_deprecated_function( __FUNCTION__, '3.0.0', 'get_user_meta()' );
 	global $wpdb;
 		return false;
 	if ( !empty($meta_key) ) {
 		$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);
 		$user = wp_cache_get($user_id, 'users');
-		// Check the cached user object
+		// Check the cached user object.
 		if ( false !== $user && isset($user->$meta_key) )
 			$metas = array($user->$meta_key);
 		else
 			$metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );
 	} else {
 *
 * @since 2.2.0
 * @deprecated 3.1.0 Use get_users()
 * @see get_users()
 *
-* @global wpdb $wpdb    WordPress database abstraction object.
+* @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param int $id Site ID.
 * @return array List of users that are part of that site ID
 */
 function get_users_of_blog( $id = '' ) {
 *
 * @since 2.8.0
 * @deprecated 3.0.0 Use add_theme_support()
 * @see add_theme_support()
 *
-* @param bool $add Optional, default is true. Add or remove links. Defaults to true.
+* @param bool $add Optional. Add or remove links. Default true.
 */
 function automatic_feed_links( $add = true ) {
 	_deprecated_function( __FUNCTION__, '3.0.0', "add_theme_support( 'automatic-feed-links' )" );
 	if ( $add )
 		add_theme_support( 'automatic-feed-links' );
 	else
-		remove_action( 'wp_head', 'feed_links_extra', 3 ); // Just do this yourself in 3.0+
+		remove_action( 'wp_head', 'feed_links_extra', 3 ); // Just do this yourself in 3.0+.
 }
 /**
 * Retrieve user data based on field.
 *
 * @since 1.5.0
 * @deprecated 3.0.0 Use get_the_author_meta()
 * @see get_the_author_meta()
 *
 * @param string    $field User meta field.
-* @param false|int $user Optional. User ID to retrieve the field for. Default false (current user).
+* @param false|int $user  Optional. User ID to retrieve the field for. Default false (current user).
 * @return string The author's field from the current author's DB object.
 */
 function get_profile( $field, $user = false ) {
 	_deprecated_function( __FUNCTION__, '3.0.0', 'get_the_author_meta()' );
 	if ( $user ) {
 * @see term_exists()
 *
 * @param int|string $term The term to check
 * @param string $taxonomy The taxonomy name to use
 * @param int $parent ID of parent term under which to confine the exists search.
-* @return mixed Get the term id or Term Object, if exists.
+* @return mixed Get the term ID or term object, if exists.
 */
 function is_term( $term, $taxonomy = '', $parent = 0 ) {
 	_deprecated_function( __FUNCTION__, '3.0.0', 'term_exists()' );
 	return term_exists( $term, $taxonomy, $parent );
 }
 /**
 * Determines whether the current admin page is generated by a plugin.
 *
 * Use global $plugin_page and/or get_plugin_page_hookname() hooks.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 * @deprecated 3.1.0
 *
 * @global $plugin_page
 *
 * If the context is 'raw', then the user object or array will get minimal santization of the int fields.
 *
 * @since 2.3.0
 * @deprecated 3.3.0
 *
-* @param object|array $user The User Object or Array
+* @param object|array $user    The user object or array.
-* @param string $context Optional, default is 'display'. How to sanitize user fields.
+* @param string       $context Optional. How to sanitize user fields. Default 'display'.
-* @return object|array The now sanitized User Object or Array (will be the same type as $user)
+* @return object|array The now sanitized user object or array (will be the same type as $user).
 */
 function sanitize_user_object($user, $context = 'display') {
 	_deprecated_function( __FUNCTION__, '3.3.0' );
 	if ( is_object($user) ) {
 * Can either be start or end post relational link.
 *
 * @since 2.8.0
 * @deprecated 3.3.0
 *
-* @param string $title Optional. Link title format.
+* @param string $title               Optional. Link title format. Default '%title'.
-* @param bool $in_same_cat Optional. Whether link should be in a same category.
+* @param bool   $in_same_cat         Optional. Whether link should be in a same category.
-* @param string $excluded_categories Optional. Excluded categories IDs.
+*                                    Default false.
-* @param bool $start Optional, default is true. Whether to display link to first or last post.
+* @param string $excluded_categories Optional. Excluded categories IDs. Default empty.
+* @param bool   $start               Optional. Whether to display link to first or last post.
+*                                    Default true.
 * @return string
 */
 function get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $start = true) {
 	_deprecated_function( __FUNCTION__, '3.3.0' );
 	$posts = get_boundary_post($in_same_cat, $excluded_categories, $start);
-	// If there is no post stop.
+	// If there is no post, stop.
 	if ( empty($posts) )
 		return;
-	// Even though we limited get_posts to return only 1 item it still returns an array of objects.
+	// Even though we limited get_posts() to return only 1 item it still returns an array of objects.
 	$post = $posts[0];
 	if ( empty($post->post_title) )
 		$post->post_title = $start ? __('First Post') : __('Last Post');
 *
 * @since 0.71
 * @deprecated 3.4.0 Use error_log()
 * @see error_log()
 *
-* @link https://secure.php.net/manual/en/function.error-log.php
+* @link https://www.php.net/manual/en/function.error-log.php
 *
 * @param string $filename File name.
 * @param string $mode     Type of access you required to the stream.
 * @return false Always false.
 */
 *
 * @since 0.71
 * @deprecated 3.4.0 Use error_log()
 * @see error_log()
 *
-* @link https://secure.php.net/manual/en/function.error-log.php
+* @link https://www.php.net/manual/en/function.error-log.php
 *
 * @param mixed  $fp     Unused.
 * @param string $string Message to log.
 */
 function debug_fwrite( $fp, $string ) {
 *
 * @since 0.71
 * @deprecated 3.4.0 Use error_log()
 * @see error_log()
 *
-* @link https://secure.php.net/manual/en/function.error-log.php
+* @link https://www.php.net/manual/en/function.error-log.php
 *
 * @param mixed $fp Unused.
 */
 function debug_fclose( $fp ) {
 	_deprecated_function( __FUNCTION__, '3.4.0', 'error_log()' );
 /**
 * Accepts matches array from preg_replace_callback in wpautop() or a string.
 *
 * Ensures that the contents of a `<pre>...</pre>` HTML block are not
-* converted into paragraphs or line-breaks.
+* converted into paragraphs or line breaks.
 *
 * @since 1.2.0
 * @deprecated 3.4.0
 *
 * @param array|string $matches The array or string
-* @return string The pre block without paragraph/line-break conversion.
+* @return string The pre block without paragraph/line break conversion.
 */
 function clean_pre($matches) {
 	_deprecated_function( __FUNCTION__, '3.4.0' );
 	if ( is_array($matches) )
 	if ( is_numeric( $file ) )
 		$file = get_attached_file( $file );
 	if ( ! is_file( $file ) ) {
-		/* translators: %s: file name */
+		/* translators: %s: File name. */
 		return sprintf( __( 'File &#8220;%s&#8221; doesn&#8217;t exist?' ), $file );
 	}
 	if ( ! function_exists('imagecreatefromstring') )
 		return __('The GD image library is not installed.');
 	wp_raise_memory_limit( 'image' );
 	$image = imagecreatefromstring( file_get_contents( $file ) );
 	if ( ! is_resource( $image ) ) {
-		/* translators: %s: file name */
+		/* translators: %s: File name. */
 		return sprintf( __( 'File &#8220;%s&#8221; is not an image.' ), $file );
 	}
 	return $image;
 }
 *
 * @since 2.5.0
 * @deprecated 3.5.0 Use wp_get_image_editor()
 * @see wp_get_image_editor()
 *
-* @param string $file Image file path.
+* @param string $file         Image file path.
-* @param int $max_w Maximum width to resize to.
+* @param int    $max_w        Maximum width to resize to.
-* @param int $max_h Maximum height to resize to.
+* @param int    $max_h        Maximum height to resize to.
-* @param bool $crop Optional. Whether to crop image or resize.
+* @param bool   $crop         Optional. Whether to crop image or resize. Default false.
-* @param string $suffix Optional. File suffix.
+* @param string $suffix       Optional. File suffix. Default null.
-* @param string $dest_path Optional. New image file path.
+* @param string $dest_path    Optional. New image file path. Default null.
-* @param int $jpeg_quality Optional, default is 90. Image quality percentage.
+* @param int    $jpeg_quality Optional. Image quality percentage. Default 90.
 * @return mixed WP_Error on failure. String with new destination path.
 */
 function image_resize( $file, $max_w, $max_h, $crop = false, $suffix = null, $dest_path = null, $jpeg_quality = 90 ) {
 	_deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' );
 	_deprecated_function( __FUNCTION__, '3.6.0', 'size_format()' );
 	$units = array( 0 => 'B', 1 => 'KB', 2 => 'MB', 3 => 'GB', 4 => 'TB' );
 	$log   = log( $bytes, KB_IN_BYTES );
 	$power = (int) $log;
-	$size  = pow( KB_IN_BYTES, $log - $power );
+	$size  = KB_IN_BYTES ** ( $log - $power );
 	if ( ! is_nan( $size ) && array_key_exists( $power, $units ) ) {
 		$unit = $units[ $power ];
 	} else {
 		$size = $bytes;
 */
 function wp_htmledit_pre($output) {
 	_deprecated_function( __FUNCTION__, '4.3.0', 'format_for_editor()' );
 	if ( !empty($output) )
-		$output = htmlspecialchars($output, ENT_NOQUOTES, get_option( 'blog_charset' ) ); // convert only < > &
+		$output = htmlspecialchars($output, ENT_NOQUOTES, get_option( 'blog_charset' ) ); // Convert only '< > &'.
 	/**
 	 * Filters the text before it is formatted for the HTML editor.
 	 *
 	 * @since 2.5.0
 	}
 	if ( false == $file_path )
 		return $headers;
-	// GET request - write it to the supplied filename
+	// GET request - write it to the supplied filename.
 	$out_fp = fopen($file_path, 'w');
 	if ( !$out_fp )
 		return $headers;
 	fwrite( $out_fp,  wp_remote_retrieve_body( $response ) );
 	return '';
 }
 /**
 * Determines whether the current URL is within the comments popup window.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 1.5.0
 * @deprecated 4.5.0
 *
-* @return bool
+* @return false Always returns false.
 */
 function is_comments_popup() {
 	_deprecated_function( __FUNCTION__, '4.5.0' );
 	return false;
 * @deprecated 4.9.0
 */
 function wp_ajax_press_this_save_post() {
 	_deprecated_function( __FUNCTION__, '4.9.0' );
 	if ( is_plugin_active( 'press-this/press-this-plugin.php' ) ) {
-		include( WP_PLUGIN_DIR . '/press-this/class-wp-press-this-plugin.php' );
+		include WP_PLUGIN_DIR . '/press-this/class-wp-press-this-plugin.php';
 		$wp_press_this = new WP_Press_This_Plugin();
 		$wp_press_this->save_post();
 	} else {
 		wp_send_json_error( array( 'errorMessage' => __( 'The Press This plugin is required.' ) ) );
 	}
 * @deprecated 4.9.0
 */
 function wp_ajax_press_this_add_category() {
 	_deprecated_function( __FUNCTION__, '4.9.0' );
 	if ( is_plugin_active( 'press-this/press-this-plugin.php' ) ) {
-		include( WP_PLUGIN_DIR . '/press-this/class-wp-press-this-plugin.php' );
+		include WP_PLUGIN_DIR . '/press-this/class-wp-press-this-plugin.php';
 		$wp_press_this = new WP_Press_This_Plugin();
 		$wp_press_this->add_category();
 	} else {
 		wp_send_json_error( array( 'errorMessage' => __( 'The Press This plugin is required.' ) ) );
 	}
 }
+/**
+* Return the user request object for the specified request ID.
+*
+* @since 4.9.6
+* @deprecated 5.4.0 Use wp_get_user_request()
+* @see wp_get_user_request()
+*
+* @param int $request_id The ID of the user request.
+* @return WP_User_Request|false
+*/
+function wp_get_user_request_data( $request_id ) {
+	_deprecated_function( __FUNCTION__, '5.4.0', 'wp_get_user_request()' );
+	return wp_get_user_request( $request_id );
+}
+/**
+* Filters 'img' elements in post content to add 'srcset' and 'sizes' attributes.
+*
+* @since 4.4.0
+* @deprecated 5.5.0
+*
+* @see wp_image_add_srcset_and_sizes()
+*
+* @param string $content The raw post content to be filtered.
+* @return string Converted content with 'srcset' and 'sizes' attributes added to images.
+*/
+function wp_make_content_images_responsive( $content ) {
+	_deprecated_function( __FUNCTION__, '5.5.0', 'wp_filter_content_tags()' );
+	// This will also add the `loading` attribute to `img` tags, if enabled.
+	return wp_filter_content_tags( $content );
+}
+/**
+* Turn register globals off.
+*
+* @since 2.1.0
+* @access private
+* @deprecated 5.5.0
+*/
+function wp_unregister_GLOBALS() {  // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
+	// register_globals was deprecated in PHP 5.3 and removed entirely in PHP 5.4.
+	_deprecated_function( __FUNCTION__, '5.5.0' );
+}
+/**
+* Does comment contain disallowed characters or words.
+*
+* @since 1.5.0
+* @deprecated 5.5.0 Use wp_check_comment_disallowed_list() instead.
+*                   Please consider writing more inclusive code.
+*
+* @param string $author The author of the comment
+* @param string $email The email of the comment
+* @param string $url The url used in the comment
+* @param string $comment The comment content
+* @param string $user_ip The comment author's IP address
+* @param string $user_agent The author's browser user agent
+* @return bool True if comment contains disallowed content, false if comment does not
+*/
+function wp_blacklist_check( $author, $email, $url, $comment, $user_ip, $user_agent ) {
+	_deprecated_function( __FUNCTION__, '5.5.0', 'wp_check_comment_disallowed_list()' );
+	return wp_check_comment_disallowed_list( $author, $email, $url, $comment, $user_ip, $user_agent );
+}
+/**
+* Filters out `register_meta()` args based on an allowed list.
+*
+* `register_meta()` args may change over time, so requiring the allowed list
+* to be explicitly turned off is a warranty seal of sorts.
+*
+* @access private
+* @since 4.6.0
+* @deprecated 5.5.0 Use _wp_register_meta_args_allowed_list() instead.
+*                   Please consider writing more inclusive code.
+*
+* @param array $args         Arguments from `register_meta()`.
+* @param array $default_args Default arguments for `register_meta()`.
+* @return array Filtered arguments.
+*/
+function _wp_register_meta_args_whitelist( $args, $default_args ) {
+	_deprecated_function( __FUNCTION__, '5.5.0', '_wp_register_meta_args_allowed_list()' );
+	return _wp_register_meta_args_allowed_list( $args, $default_args );
+}
+/**
+* Adds an array of options to the list of allowed options.
+*
+* @since 2.7.0
+* @deprecated 5.5.0 Use add_allowed_options() instead.
+*                   Please consider writing more inclusive code.
+*
+* @global array $allowed_options
+*
+* @param array        $new_options
+* @param string|array $options
+* @return array
+*/
+function add_option_whitelist( $new_options, $options = '' ) {
+	_deprecated_function( __FUNCTION__, '5.5.0', 'add_allowed_options()' );
+	return add_allowed_options( $new_options, $options );
+}
+/**
+* Removes a list of options from the allowed options list.
+*
+* @since 2.7.0
+* @deprecated 5.5.0 Use remove_allowed_options() instead.
+*                   Please consider writing more inclusive code.
+*
+* @global array $allowed_options
+*
+* @param array        $del_options
+* @param string|array $options
+* @return array
+*/
+function remove_option_whitelist( $del_options, $options = '' ) {
+	_deprecated_function( __FUNCTION__, '5.5.0', 'remove_allowed_options()' );
+	return remove_allowed_options( $del_options, $options );
+}

changeset 16	a86126ab1dd4
parent 9	177826044cd9
child 18	be944660c56a