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

equal deleted inserted replaced

-:346c88efed21
+:5e2f62d02dcd
 /**
 * Sets up the WordPress Loop.
 *
 * @since 1.0.1
-* @deprecated 1.5
+* @deprecated 1.5.0
-* @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop}
+* @deprecated Use The Loop - {@link https://codex.wordpress.org/The_Loop Use new WordPress Loop}
 */
 function start_wp() {
 	global $wp_query;
 	_deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop') );
 }
 /**
 * Prints link to the previous post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use previous_post_link()
 * @see previous_post_link()
 *
 * @param string $format
 * @param string $previous
 /**
 * Prints link to the next post.
 *
 * @since 0.71
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use next_post_link()
 * @see next_post_link()
 *
 * @param string $format
 * @param string $next
 }
 /**
 * Whether user can create a post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $blog_id Not Used
 }
 /**
 * Whether user can create a post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $blog_id Not Used
 }
 /**
 * Whether user can edit a post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $post_id
 }
 /**
 * Whether user can delete a post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $post_id
 }
 /**
 * Whether user can set new posts' dates.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $blog_id Not Used
 }
 /**
 * Whether user can delete a post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $post_id
 }
 /**
 * Whether user can delete a post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $post_id
 }
 /**
 * Whether user can delete a post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $post_id
 }
 /**
 * Can user can edit other user.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use current_user_can()
 * @see current_user_can()
 *
 * @param int $user_id
 * @param int $other_user
 /**
 * Gets the links associated with category $cat_name.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated 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 $before Optional. The html to output before the link.
 /**
 * Gets the links associated with the named category.
 *
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_list_bookmarks()
 * @see wp_list_bookmarks()
 *
 * @param string $category The category to use.
 * @param string $args
-* @return bool|null
+* @return string|null
 */
 function wp_get_linksbyname($category, $args = '') {
 	_deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()');
 	$defaults = array(
 }
 /**
 * Gets an array of link objects associated with category $cat_name.
 *
-* <code>
+*     $links = get_linkobjectsbyname( 'fred' );
-*	$links = get_linkobjectsbyname('fred');
+*     foreach ( $links as $link ) {
-*	foreach ($links as $link) {
+*      	echo '<li>' . $link->link_name . '</li>';
-* 		echo '<li>'.$link->link_name.'</li>';
+*     }
-*	}
-* </code>
 *
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_bookmarks()
 * @see get_bookmarks()
 *
 * @param string $cat_name 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'.
 *		Or maybe owner. 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 random order.
 * @param int $limit Limit to X entries. If not specified, all entries are shown.
-* @return unknown
+* @return array
 */
 function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
 	_deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 	$cat_id = -1;
 /**
 * Gets an array of link objects associated with category n.
 *
 * Usage:
-* <code>
+*
-*	$links = get_linkobjects(1);
+*     $links = get_linkobjects(1);
-*	if ($links) {
+*     if ($links) {
-*		foreach ($links as $link) {
+*     	foreach ($links as $link) {
-*			echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>';
+*     		echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>';
-*		}
+*     	}
-*	}
+*     }
-* </code>
 *
 * Fields are:
-* <ol>
+*
-*	<li>link_id</li>
+* - link_id
-*	<li>link_url</li>
+* - link_url
-*	<li>link_name</li>
+* - link_name
-*	<li>link_image</li>
+* - link_image
-*	<li>link_target</li>
+* - link_target
-*	<li>link_category</li>
+* - link_category
-*	<li>link_description</li>
+* - link_description
-*	<li>link_visible</li>
+* - link_visible
-*	<li>link_owner</li>
+* - link_owner
-*	<li>link_rating</li>
+* - link_rating
-*	<li>link_updated</li>
+* - link_updated
-*	<li>link_rel</li>
+* - link_rel
-*	<li>link_notes</li>
+* - link_notes
-* </ol>
 *
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_bookmarks()
 * @see get_bookmarks()
 *
 * @param int $category The category to use. If no category supplied uses all
 * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
 *		'description', or 'rating'. Or maybe owner. 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 random order.
 * @param int $limit Limit to X entries. If not specified, all entries are shown.
-* @return unknown
+* @return array
 */
 function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
 	_deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 	$links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ;
 /**
 * Gets the links associated with category 'cat_name' and display rating stars/chars.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_bookmarks()
 * @see get_bookmarks()
 *
 * @param string $cat_name The category name to use. If no match is found uses all
 * @param string $before The html to output before the link
 /**
 * Gets the links associated with category n and display rating stars/chars.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_bookmarks()
 * @see get_bookmarks()
 *
 * @param int $category The category to use. If no category supplied uses all
 * @param string $before The html to output before the link
 * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url',
 *		'description', or 'rating'. Or maybe owner. 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 random order.
 * @param bool $show_description Whether to show the description if show_images=false/not defined.
-* @param string $limit Limit to X entries. If not specified, all entries are shown.
+* @param int $limit Limit to X entries. If not specified, all entries are shown.
 * @param int $show_updated Whether to show last updated timestamp
 */
 function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
 							  $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
 	_deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 /**
 * Gets the auto_toggle setting.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated No alternative function available
 *
 * @param int $id The category to get. If no category supplied uses 0
 * @return int Only returns 0.
 */
 	return 0;
 }
 /**
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param int $optionall
 * @param string $all
 * @param int $recurse
 * @param string $feed
 * @param string $feed_image
 * @param string $exclude
 * @param bool $hierarchical
-* @return unknown
+* @return false|null
 */
 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,
 				   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
 	_deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
 		'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');
 	return wp_list_cats($query);
 }
 /**
-* @since 1.2
+* @since 1.2.0
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
-* @return unknown
+* @return false|null|string
 */
 function wp_list_cats($args = '') {
 	_deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
 	$r = wp_parse_args( $args );
 	return wp_list_categories($r);
 }
 /**
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_dropdown_categories()
 * @see wp_dropdown_categories()
 *
 * @param int $optionall
 * @param string $all
 * @param int $show_count
 * @param int $hide_empty
 * @param bool $optionnone
 * @param int $selected
 * @param int $exclude
-* @return unknown
+* @return string
 */
 function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',
 		$show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,
 		$selected = 0, $exclude = 0) {
 	_deprecated_function( __FUNCTION__, '2.1', 'wp_dropdown_categories()' );
 	$query = add_query_arg($vars, '');
 	return wp_dropdown_categories($query);
 }
 /**
-* @since 1.2
+* List authors.
-* @deprecated 2.1
+*
+* @since 1.2.0
+* @deprecated 2.1.0
 * @deprecated Use wp_list_authors()
 * @see wp_list_authors()
 *
 * @param bool $optioncount
 * @param bool $exclude_admin
 * @param bool $show_fullname
 * @param bool $hide_empty
 * @param string $feed
 * @param string $feed_image
-* @return unknown
+* @return null|string
 */
 function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') {
 	_deprecated_function( __FUNCTION__, '2.1', 'wp_list_authors()' );
 	$args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image');
 	return wp_list_authors($args);
 }
 /**
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_get_post_categories()
 * @see wp_get_post_categories()
 *
 * @param int $blogid Not Used
 * @param int $post_ID
-* @return unknown
+* @return array
 */
 function wp_get_post_cats($blogid = '1', $post_ID = 0) {
 	_deprecated_function( __FUNCTION__, '2.1', 'wp_get_post_categories()' );
 	return wp_get_post_categories($post_ID);
 }
 /**
 * Sets the categories that the post id belongs to.
 *
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_set_post_categories()
 * @see wp_set_post_categories()
 *
 * @param int $blogid Not used
 * @param int $post_ID
 * @param array $post_categories
-* @return unknown
+* @return bool|mixed
 */
 function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) {
 	_deprecated_function( __FUNCTION__, '2.1', 'wp_set_post_categories()' );
 	return wp_set_post_categories($post_ID, $post_categories);
 }
 /**
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_get_archives()
 * @see wp_get_archives()
 *
 * @param string $type
 * @param string $limit
 * @param string $format
 * @param string $before
 * @param string $after
 * @param bool $show_post_count
-* @return unknown
+* @return string|null
 */
 function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) {
 	_deprecated_function( __FUNCTION__, '2.1', 'wp_get_archives()' );
 	$args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count');
 	return wp_get_archives($args);
 }
 /**
 * Returns or Prints link to the author's posts.
 *
-* @since 1.2
+* @since 1.2.0
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_author_posts_url()
 * @see get_author_posts_url()
 *
 * @param bool $echo
 * @param int $author_id
 /**
 * Print list of pages based on arguments.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_link_pages()
 * @see wp_link_pages()
 *
 * @param string $before
 * @param string $after
 /**
 * Get value based on option.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_option()
 * @see get_option()
 *
 * @param string $option
 * @return string
 /**
 * Print the permalink of the current post in the loop.
 *
 * @since 0.71
-* @deprecated 1.2
+* @deprecated 1.2.0
 * @deprecated Use the_permalink()
 * @see the_permalink()
 */
 function permalink_link() {
 	_deprecated_function( __FUNCTION__, '1.2', 'the_permalink()' );
 /**
 * Print the permalink to the RSS feed.
 *
 * @since 0.71
-* @deprecated 2.3
+* @deprecated 2.3.0
 * @deprecated Use the_permalink_rss()
 * @see the_permalink_rss()
 *
 * @param string $deprecated
 */
 /**
 * Gets the links associated with category.
 *
 * @see get_links() for argument information that can be used in $args
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_list_bookmarks()
 * @see wp_list_bookmarks()
 *
 * @param string $args a query string
 * @return null|string
 /**
 * Gets the links associated with category by id.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_bookmarks()
 * @see get_bookmarks()
 *
 * @param int $category The category to use. If no category supplied uses all
 * @param string $before the html to output before the link
 *
 * Output a list of all links, listed by category, using the settings in
 * $wpdb->linkcategories and output it as a nested HTML unordered list.
 *
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use wp_list_bookmarks()
 * @see wp_list_bookmarks()
 *
 * @param string $order Sort link categories by 'name' or 'id'
 */
 /**
 * Show the link to the links popup and the number of links.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated {@internal Use function instead is unknown}}
 *
 * @param string $text the text of the link
 * @param int $width the width of the popup window
 * @param int $height the height of the popup window
 	_deprecated_function( __FUNCTION__, '2.1' );
 }
 /**
 * @since 1.0.1
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use sanitize_bookmark_field()
 * @see sanitize_bookmark_field()
 *
 * @param object $link
-* @return unknown
+* @return mixed
 */
 function get_linkrating($link) {
 	_deprecated_function( __FUNCTION__, '2.1', 'sanitize_bookmark_field()' );
 	return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
 }
 /**
 * Gets the name of category by id.
 *
 * @since 0.71
-* @deprecated 2.1
+* @deprecated 2.1.0
 * @deprecated Use get_category()
 * @see get_category()
 *
 * @param int $id The category to get. If no category supplied uses 0
 * @return string
 /**
 * Print RSS comment feed link.
 *
 * @since 1.0.1
-* @deprecated 2.5
+* @deprecated 2.5.0
 * @deprecated Use post_comments_feed_link()
 * @see post_comments_feed_link()
 *
 * @param string $link_text
 */
 }
 /**
 * Print/Return link to category RSS2 feed.
 *
-* @since 1.2
+* @since 1.2.0
-* @deprecated 2.5
+* @deprecated 2.5.0
 * @deprecated Use get_category_feed_link()
 * @see get_category_feed_link()
 *
 * @param bool $echo
 * @param int $cat_ID
-* @return string|null
+* @return string
 */
 function get_category_rss_link($echo = false, $cat_ID = 1) {
 	_deprecated_function( __FUNCTION__, '2.5', 'get_category_feed_link()' );
 	$link = get_category_feed_link($cat_ID, 'rss2');
 }
 /**
 * Print/Return link to author RSS feed.
 *
-* @since 1.2
+* @since 1.2.0
-* @deprecated 2.5
+* @deprecated 2.5.0
 * @deprecated Use get_author_feed_link()
 * @see get_author_feed_link()
 *
 * @param bool $echo
 * @param int $author_id
-* @return string|null
+* @return string
 */
 function get_author_rss_link($echo = false, $author_id = 1) {
 	_deprecated_function( __FUNCTION__, '2.5', 'get_author_feed_link()' );
 	$link = get_author_feed_link($author_id);
 }
 /**
 * Return link to the post RSS feed.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.2
+* @deprecated 2.2.0
 * @deprecated Use get_post_comments_feed_link()
 * @see get_post_comments_feed_link()
 *
 * @return string
 */
 }
 /**
 * An alias of wp_create_user().
 *
-* @since 2.0
+* @since 2.0.0
-* @deprecated 2.0
+* @deprecated 2.0.0
 * @deprecated Use wp_create_user()
 * @see wp_create_user()
 *
 * @param string $username The user's username.
 * @param string $password The user's password.
-* @param string $email The user's email (optional).
+* @param string $email    The user's email.
 * @return int The new user's ID.
 */
 function create_user($username, $password, $email) {
 	_deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' );
 	return wp_create_user($username, $password, $email);
 }
 /**
 * Unused function.
 *
-* @deprecated 2.5
+* @deprecated 2.5.0
 */
 function gzip_compression() {
 	_deprecated_function( __FUNCTION__, '2.5' );
 	return false;
 }
 /**
 * Retrieve an array of comment data about comment $comment_ID.
 *
 * @since 0.71
-* @deprecated 2.7
+* @deprecated 2.7.0
 * @deprecated Use get_comment()
 * @see get_comment()
 *
 * @param int $comment_ID The ID of the comment
 * @param int $no_cache Whether to use the cache (cast to bool)
 /**
 * Retrieve the category name by the category ID.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_cat_name()
 * @see get_cat_name()
 *
 * @param int $cat_ID Category ID
 * @return string category name
 /**
 * Retrieve category children list separated before and after the term IDs.
 *
 * @since 1.2.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_term_children()
 * @see get_term_children()
 *
 * @param int $id Category ID to retrieve children.
 * @param string $before Optional. Prepend before category term ID.
 	}
 	return $chain;
 }
 /**
+* Retrieves all category IDs.
+*
+* @since 2.0.0
+* @deprecated 4.0.0 Use get_terms() instead.
+* @see get_terms()
+* @link https://codex.wordpress.org/Function_Reference/get_all_category_ids
+*
+* @return object List of all of the category IDs.
+*/
+function get_all_category_ids() {
+	_deprecated_function( __FUNCTION__, '4.0', 'get_terms()' );
+	if ( ! $cat_ids = wp_cache_get( 'all_category_ids', 'category' ) ) {
+		$cat_ids = get_terms( 'category', array('fields' => 'ids', 'get' => 'all') );
+		wp_cache_add( 'all_category_ids', $cat_ids, 'category' );
+	}
+	return $cat_ids;
+}
+/**
 * Retrieve the description of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('description')
 * @see get_the_author_meta()
 *
 * @return string The author's description.
 */
 /**
 * Display the description of the author of the current post.
 *
 * @since 1.0.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('description')
 * @see the_author_meta()
 */
 function the_author_description() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')' );
 }
 /**
 * Retrieve the login name of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('login')
 * @see get_the_author_meta()
 *
 * @return string The author's login name (username).
 */
 /**
 * Display the login name of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('login')
 * @see the_author_meta()
 */
 function the_author_login() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')' );
 }
 /**
 * Retrieve the first name of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('first_name')
 * @see get_the_author_meta()
 *
 * @return string The author's first name.
 */
 /**
 * Display the first name of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('first_name')
 * @see the_author_meta()
 */
 function the_author_firstname() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' );
 }
 /**
 * Retrieve the last name of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('last_name')
 * @see get_the_author_meta()
 *
 * @return string The author's last name.
 */
 /**
 * Display the last name of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('last_name')
 * @see the_author_meta()
 */
 function the_author_lastname() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' );
 }
 /**
 * Retrieve the nickname of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('nickname')
 * @see get_the_author_meta()
 *
 * @return string The author's nickname.
 */
 /**
 * Display the nickname of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('nickname')
 * @see the_author_meta()
 */
 function the_author_nickname() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' );
 }
 /**
 * Retrieve the email of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('email')
 * @see get_the_author_meta()
 *
 * @return string The author's username.
 */
 /**
 * Display the email of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('email')
 * @see the_author_meta()
 */
 function the_author_email() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')' );
 }
 /**
 * Retrieve the ICQ number of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('icq')
 * @see get_the_author_meta()
 *
 * @return string The author's ICQ number.
 */
 /**
 * Display the ICQ number of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('icq')
 * @see the_author_meta()
 */
 function the_author_icq() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')' );
 }
 /**
 * Retrieve the Yahoo! IM name of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('yim')
 * @see get_the_author_meta()
 *
 * @return string The author's Yahoo! IM name.
 */
 /**
 * Display the Yahoo! IM name of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('yim')
 * @see the_author_meta()
 */
 function the_author_yim() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')' );
 }
 /**
 * Retrieve the MSN address of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('msn')
 * @see get_the_author_meta()
 *
 * @return string The author's MSN address.
 */
 /**
 * Display the MSN address of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('msn')
 * @see the_author_meta()
 */
 function the_author_msn() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')' );
 }
 /**
 * Retrieve the AIM address of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('aim')
 * @see get_the_author_meta()
 *
 * @return string The author's AIM address.
 */
 /**
 * Display the AIM address of the author of the current post.
 *
 * @since 0.71
 * @see the_author_meta()
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('aim')
 */
 function the_author_aim() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')' );
 	the_author_meta('aim');
 /**
 * Retrieve the specified author's preferred display name.
 *
 * @since 1.0.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('display_name')
 * @see get_the_author_meta()
 *
 * @param int $auth_id The ID of the author.
 * @return string The author's display name.
 }
 /**
 * Retrieve the URL to the home page of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('url')
 * @see get_the_author_meta()
 *
 * @return string The URL to the author's page.
 */
 /**
 * Display the URL to the home page of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('url')
 * @see the_author_meta()
 */
 function the_author_url() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')' );
 }
 /**
 * Retrieve the ID of the author of the current post.
 *
-* @since 1.5
+* @since 1.5.0
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use get_the_author_meta('ID')
 * @see get_the_author_meta()
 *
-* @return int The author's ID.
+* @return string|int The author's ID.
 */
 function get_the_author_ID() {
 	_deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')' );
 	return get_the_author_meta('ID');
 }
 /**
 * Display the ID of the author of the current post.
 *
 * @since 0.71
-* @deprecated 2.8
+* @deprecated 2.8.0
 * @deprecated Use the_author_meta('ID')
 * @see the_author_meta()
 */
 function the_author_ID() {
 	_deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')' );
 * To restrict the amount of words of the content, you can use the cut
 * parameter. If the content is less than the amount, then there won't be any
 * dots added to the end. If there is content left over, then dots will be added
 * and the rest of the content will be removed.
 *
-* @package WordPress
+* @since 0.71
-* @subpackage Feed
-* @since 0.71
-* @uses apply_filters() Calls 'the_content_rss' on the content before processing.
 *
 * @deprecated 2.9.0
 * @deprecated 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 int|bool $stripteaser Optional. Default is 0.
+* @param int $stripteaser Optional. Default is 0.
 * @param string $more_file Optional.
 * @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) {
 */
 function make_url_footnote( $content ) {
 	_deprecated_function( __FUNCTION__, '2.9', '' );
 	preg_match_all( '/<a(.+?)href=\"(.+?)\"(.*?)>(.+?)<\/a>/', $content, $matches );
 	$links_summary = "\n";
-	for ( $i=0; $i<count($matches[0]); $i++ ) {
+	for ( $i = 0, $c = count( $matches[0] ); $i < $c; $i++ ) {
 		$link_match = $matches[0][$i];
 		$link_number = '['.($i+1).']';
 		$link_url = $matches[2][$i];
 		$link_text = $matches[4][$i];
 		$content = str_replace( $link_match, $link_text . ' ' . $link_number, $content );
 /**
 * Translates $text like translate(), but assumes that the text
 * contains a context after its last vertical bar.
 *
-* @since 2.5
+* @since 2.5.0
-* @uses translate()
 * @deprecated 3.0.0
 * @deprecated Use _x()
 * @see _x()
 *
 * @param string $text Text to translate
 }
 /**
 * Register plural strings in POT file, but don't translate them.
 *
-* @since 2.5
+* @since 2.5.0
 * @deprecated 2.8.0
 * @deprecated Use _n_noop()
 * @see _n_noop()
 */
 function __ngettext_noop() {
 	if ( !$fullsize && $src = wp_get_attachment_thumb_url( $post->ID ) ) {
 		// We have a thumbnail desired, specified and existing
 		$src_file = basename($src);
-		$class = 'attachmentthumb';
 	} elseif ( wp_attachment_is_image( $post->ID ) ) {
 		// We have an image without a thumbnail
 		$src = wp_get_attachment_url( $post->ID );
 		$src_file = & $file;
-		$class = 'attachmentimage';
 	} elseif ( $src = wp_mime_type_icon( $post->ID ) ) {
 		// No thumb, no image. We'll look for a mime-related icon instead.
 		$icon_dir = apply_filters( 'icon_dir', get_template_directory() . '/images' );
 		$src_file = $icon_dir . '/' . basename($src);
 * @see wp_get_attachment_image()
 *
 * @param int $id Optional. Post ID.
 * @param bool $fullsize Optional, default to false. Whether to have full size image.
 * @param array $max_dims Optional. Dimensions of image.
-* @return string HTML content.
+* @return false|string HTML content.
 */
 function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) {
 	_deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' );
 	$id = (int) $id;
 	if ( !$post = get_post($id) )
 * @see wp_get_attachment_image()
 *
 * @param int $id Optional. Post ID.
 * @param bool $fullsize Optional, default to false. Whether to have full size image.
 * @param array $max_dims Optional. Dimensions of image.
-* @return string
+* @return false|string
 */
 function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) {
 	_deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' );
 	$id = (int) $id;
 	if ( !$post = get_post($id) )
 * @see wp_register_sidebar_widget()
 *
 * @param string|int $name Widget ID.
 * @param callback $output_callback Run when widget is called.
 * @param string $classname Classname widget option.
-* @param mixed $params,... Widget parameters.
+* @param mixed $params ,... Widget parameters.
 */
 function register_sidebar_widget($name, $output_callback, $classname = '') {
 	_deprecated_function( __FUNCTION__, '2.8', 'wp_register_sidebar_widget()' );
 	// Compat
 	if ( is_array($name) ) {
 	if ( $cur )
 		do_action( 'update_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );
 	if ( !$cur )
 		$wpdb->insert($wpdb->usermeta, compact('user_id', 'meta_key', 'meta_value') );
-	else if ( $cur->meta_value != $meta_value )
+	elseif ( $cur->meta_value != $meta_value )
 		$wpdb->update($wpdb->usermeta, compact('meta_value'), compact('user_id', 'meta_key') );
 	else
 		return false;
 	clean_user_cache( $user_id );
 * For setups that use the multi-blog feature. Can be used outside of the
 * multi-blog feature.
 *
 * @since 2.2.0
 * @deprecated 3.1.0
-* @uses $wpdb WordPress database object for queries
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 * @uses $blog_id The Blog id of the blog for those that use more than one blog
 *
 * @param int $id Blog ID.
 * @return array List of users that are part of that Blog ID
 */
 function funky_javascript_callback($matches) {
 	return "&#".base_convert($matches[1],16,10).";";
 }
 /**
-* Fixes javascript bugs in browsers.
+* Fixes JavaScript bugs in browsers.
 *
 * Converts unicode characters to HTML numbered entities.
 *
 * @since 1.5.0
 * @uses $is_macIE
 * @param string $text Text to be made safe.
 * @return string Fixed text.
 */
 function funky_javascript_fix($text) {
 	_deprecated_function( __FUNCTION__, '3.0' );
-	// Fixes for browsers' javascript bugs
+	// Fixes for browsers' JavaScript bugs.
 	global $is_macIE, $is_winIE;
 	if ( $is_winIE || $is_macIE )
 		$text =  preg_replace_callback("/\%u([0-9A-F]{4,4})/",
 					"funky_javascript_callback",
 */
 function the_editor($content, $id = 'content', $prev_id = 'title', $media_buttons = true, $tab_index = 2, $extended = true) {
 	_deprecated_function( __FUNCTION__, '3.3', 'wp_editor()' );
 	wp_editor( $content, $id, array( 'media_buttons' => $media_buttons ) );
-	return;
 }
 /**
 * Perform the query to get the $metavalues array(s) needed by _fill_user and _fill_many_users
 *
 	_deprecated_function( __FUNCTION__, '3.3' );
 	if ( is_object($user) ) {
 		if ( !isset($user->ID) )
 			$user->ID = 0;
-		if ( !is_a( $user, 'WP_User' ) ) {
+		if ( ! ( $user instanceof WP_User ) ) {
 			$vars = get_object_vars($user);
 			foreach ( array_keys($vars) as $field ) {
 				if ( is_string($user->$field) || is_numeric($user->$field) )
 					$user->$field = sanitize_user_field($field, $user->$field, $user->ID, $context);
 			}
 }
 /**
 * Accepts matches array from preg_replace_callback in wpautop() or a string.
 *
-* Ensures that the contents of a <<pre>>...<</pre>> HTML block are not
+* Ensures that the contents of a `<pre>...</pre>` HTML block are not
 * converted into paragraphs or line-breaks.
 *
 * @since 1.2.0
 * @deprecated 3.4.0
 *
 * @since 3.1.0
 * @deprecated 3.4.0
 * @deprecated Use remove_theme_support('custom-header')
 * @see remove_theme_support()
 *
-* @return bool Whether support was removed.
+* @return null|bool Whether support was removed.
 */
 function remove_custom_image_header() {
 	_deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support( \'custom-header\' )' );
 	return remove_theme_support( 'custom-header' );
 }
 * Remove custom background support.
 *
 * @since 3.1.0
 * @see add_custom_background()
 *
-* @return bool Whether support was removed.
+* @return null|bool Whether support was removed.
 */
 function remove_custom_background() {
 	_deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support( \'custom-background\' )' );
 	return remove_theme_support( 'custom-background' );
 }
 * associated with 'all_page_ids' and 'get_pages'.
 *
 * @since 2.0.0
 * @deprecated 3.4.0
 *
-* @uses do_action() Will call the 'clean_page_cache' hook action.
-*
 * @param int $id Page ID to clean
 */
 function clean_page_cache( $id ) {
 	_deprecated_function( __FUNCTION__, '3.4', 'clean_post_cache()' );
 * @deprecated 3.5.0
 * @see get_post()
 *
 * @param int $postid Post ID.
 * @param string $mode How to return result, either OBJECT, ARRAY_N, or ARRAY_A.
-* @return object|array Post object or array holding post contents and information
+* @return WP_Post|null Post object or array holding post contents and information
 */
 function wp_get_single_post( $postid = 0, $mode = OBJECT ) {
 	_deprecated_function( __FUNCTION__, '3.5', 'get_post()' );
 	return get_post( $postid, $mode );
 }
 */
 function _search_terms_tidy( $t ) {
 	_deprecated_function( __FUNCTION__, '3.7' );
 	return trim( $t, "\"'\n\r " );
 }
+/**
+* Determine if TinyMCE is available.
+*
+* Checks to see if the user has deleted the tinymce files to slim down
+* their WordPress install.
+*
+* @since 2.1.0
+* @deprecated 3.9.0
+*
+* @return bool Whether TinyMCE exists.
+*/
+function rich_edit_exists() {
+	global $wp_rich_edit_exists;
+	_deprecated_function( __FUNCTION__, '3.9' );
+	if ( ! isset( $wp_rich_edit_exists ) )
+		$wp_rich_edit_exists = file_exists( ABSPATH . WPINC . '/js/tinymce/tinymce.js' );
+	return $wp_rich_edit_exists;
+}
+/**
+* Old callback for tag link tooltips.
+*
+* @since 2.7.0
+* @deprecated 3.9.0
+* @access private
+*/
+function default_topic_count_text( $count ) {
+	return $count;
+}
+/**
+* Formerly used to escape strings before inserting into the DB.
+*
+* Has not performed this function for many, many years. Use wpdb::prepare() instead.
+*
+* @since 0.71
+* @deprecated 3.9.0
+*
+* @param string $content The text to format.
+* @return string The very same text.
+*/
+function format_to_post( $content ) {
+	_deprecated_function( __FUNCTION__, '3.9' );
+	return $content;
+}
+/**
+* Formerly used to escape strings before searching the DB. It was poorly documented and never worked as described.
+*
+* @since 2.5.0
+* @deprecated 4.0.0
+* @deprecated Use wpdb::esc_like()
+*
+* @param string $text The text to be escaped.
+* @return string text, safe for inclusion in LIKE query.
+*/
+function like_escape($text) {
+	_deprecated_function( __FUNCTION__, '4.0', 'wpdb::esc_like()' );
+	return str_replace( array( "%", "_" ), array( "\\%", "\\_" ), $text );
+}
+/**
+* Determines if the URL can be accessed over SSL.
+*
+* Determines if the URL can be accessed over SSL by using the WordPress HTTP API to access
+* the URL using https as the scheme.
+*
+* @since 2.5.0
+* @deprecated 4.0.0
+*
+* @param string $url The URL to test.
+* @return bool Whether SSL access is available.
+*/
+function url_is_accessable_via_ssl( $url ) {
+	_deprecated_function( __FUNCTION__, '4.0' );
+	$response = wp_remote_get( set_url_scheme( $url, 'https' ) );
+	if ( !is_wp_error( $response ) ) {
+		$status = wp_remote_retrieve_response_code( $response );
+		if ( 200 == $status || 401 == $status ) {
+			return true;
+		}
+	}
+	return false;
+}

changeset 5	5e2f62d02dcd
parent 0	d970ebf37754
child 7	cf61fcea0001