X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/4feeb71a9d812a9ae371c28a3d8b442a4394ded7..607b7e02d77e7326161e8ec15639052d2040f745:/wp-includes/deprecated.php?ds=sidebyside diff --git a/wp-includes/deprecated.php b/wp-includes/deprecated.php index f79761ba..0d30113b 100644 --- a/wp-includes/deprecated.php +++ b/wp-includes/deprecated.php @@ -61,7 +61,7 @@ function get_postdata($postid) { function start_wp() { global $wp_query; - _deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop') ); + _deprecated_function( __FUNCTION__, '1.5.0', __('new WordPress Loop') ); // Since the old style loop is being used, advance the query iterator here. $wp_query->next_post(); @@ -134,7 +134,7 @@ function the_category_head( $before = '', $after = '' ) { */ function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') { - _deprecated_function( __FUNCTION__, '2.0', 'previous_post_link()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'previous_post_link()' ); if ( empty($in_same_cat) || 'no' == $in_same_cat ) $in_same_cat = false; @@ -169,7 +169,7 @@ function previous_post($format='%', $previous='previous post: ', $title='yes', $ * @param string $excluded_categories */ function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') { - _deprecated_function( __FUNCTION__, '2.0', 'next_post_link()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'next_post_link()' ); if ( empty($in_same_cat) || 'no' == $in_same_cat ) $in_same_cat = false; @@ -202,7 +202,7 @@ function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat= * @return bool */ function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') { - _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); $author_data = get_userdata($user_id); return ($author_data->user_level > 1); @@ -221,7 +221,7 @@ function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') { * @return bool */ function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') { - _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); $author_data = get_userdata($user_id); return ($author_data->user_level >= 1); @@ -240,7 +240,7 @@ function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') { * @return bool */ function user_can_edit_post($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); $author_data = get_userdata($user_id); $post = get_post($post_id); @@ -268,7 +268,7 @@ function user_can_edit_post($user_id, $post_id, $blog_id = 1) { * @return bool */ function user_can_delete_post($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); // right now if one can edit, one can delete return user_can_edit_post($user_id, $post_id, $blog_id); @@ -287,7 +287,7 @@ function user_can_delete_post($user_id, $post_id, $blog_id = 1) { * @return bool */ function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') { - _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); $author_data = get_userdata($user_id); return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id)); @@ -306,7 +306,7 @@ function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') { * @return bool returns true if $user_id can edit $post_id's date */ function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); $author_data = get_userdata($user_id); return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id)); @@ -325,7 +325,7 @@ function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) { * @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', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); // 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); @@ -344,7 +344,7 @@ function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) { * @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', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); // right now if one can edit comments, one can delete comments return user_can_edit_post_comments($user_id, $post_id, $blog_id); @@ -362,7 +362,7 @@ function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) { * @return bool */ function user_can_edit_user($user_id, $other_user) { - _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); $user = get_userdata($user_id); $other = get_userdata($other_user); @@ -395,7 +395,7 @@ function user_can_edit_user($user_id, $other_user) { function get_linksbyname($cat_name = "noname", $before = '', $after = '
', $between = " ", $show_images = true, $orderby = 'id', $show_description = true, $show_rating = false, $limit = -1, $show_updated = 0) { - _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); $cat_id = -1; $cat = get_term_by('name', $cat_name, 'link_category'); @@ -417,7 +417,7 @@ function get_linksbyname($cat_name = "noname", $before = '', $after = '
', * @return string|null */ function wp_get_linksbyname($category, $args = '') { - _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()'); + _deprecated_function(__FUNCTION__, '2.1.0', 'wp_list_bookmarks()'); $defaults = array( 'after' => '
', @@ -455,7 +455,7 @@ function wp_get_linksbyname($category, $args = '') { * @return array */ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) { - _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); $cat_id = -1; $cat = get_term_by('name', $cat_name, 'link_category'); @@ -506,7 +506,7 @@ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit * @return array */ function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { - _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); $links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ; @@ -539,7 +539,7 @@ function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { */ function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '
', $between = " ", $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { - _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); } @@ -566,7 +566,7 @@ function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = */ function get_links_withrating($category = -1, $before = '', $after = '
', $between = " ", $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { - _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); } @@ -581,7 +581,7 @@ function get_links_withrating($category = -1, $before = '', $after = '
', $ * @return int Only returns 0. */ function get_autotoggle($id = 0) { - _deprecated_function( __FUNCTION__, '2.1' ); + _deprecated_function( __FUNCTION__, '2.1.0' ); return 0; } @@ -615,7 +615,7 @@ function get_autotoggle($id = 0) { 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()' ); + _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'); @@ -633,7 +633,7 @@ function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_orde * @return false|null|string */ function wp_list_cats($args = '') { - _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' ); $r = wp_parse_args( $args ); @@ -677,7 +677,7 @@ function wp_list_cats($args = '') { 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()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_dropdown_categories()' ); $show_option_all = ''; if ( $optionall ) @@ -709,7 +709,7 @@ function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = ' * @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()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_authors()' ); $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image'); return wp_list_authors($args); @@ -727,7 +727,7 @@ function list_authors($optioncount = false, $exclude_admin = true, $show_fullnam * @return array */ function wp_get_post_cats($blogid = '1', $post_ID = 0) { - _deprecated_function( __FUNCTION__, '2.1', 'wp_get_post_categories()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_get_post_categories()' ); return wp_get_post_categories($post_ID); } @@ -745,7 +745,7 @@ function wp_get_post_cats($blogid = '1', $post_ID = 0) { * @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()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_set_post_categories()' ); return wp_set_post_categories($post_ID, $post_categories); } @@ -765,7 +765,7 @@ function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array( * @return string|null */ function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) { - _deprecated_function( __FUNCTION__, '2.1', 'wp_get_archives()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_get_archives()' ); $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count'); return wp_get_archives($args); } @@ -783,7 +783,7 @@ function get_archives($type='', $limit='', $format='html', $before = '', $after * @return string|null */ function get_author_link($echo, $author_id, $author_nicename = '') { - _deprecated_function( __FUNCTION__, '2.1', 'get_author_posts_url()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_author_posts_url()' ); $link = get_author_posts_url($author_id, $author_nicename); @@ -810,7 +810,7 @@ function get_author_link($echo, $author_id, $author_nicename = '') { */ function link_pages($before='
', $after='
', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page', $pagelink='%', $more_file='') { - _deprecated_function( __FUNCTION__, '2.1', 'wp_link_pages()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_link_pages()' ); $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file'); return wp_link_pages($args); @@ -827,7 +827,7 @@ function link_pages($before='
', $after='
', $next_or_number='number', * @return string */ function get_settings($option) { - _deprecated_function( __FUNCTION__, '2.1', 'get_option()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_option()' ); return get_option($option); } @@ -840,7 +840,7 @@ function get_settings($option) { * @see the_permalink() */ function permalink_link() { - _deprecated_function( __FUNCTION__, '1.2', 'the_permalink()' ); + _deprecated_function( __FUNCTION__, '1.2.0', 'the_permalink()' ); the_permalink(); } @@ -854,7 +854,7 @@ function permalink_link() { * @param string $deprecated */ function permalink_single_rss($deprecated = '') { - _deprecated_function( __FUNCTION__, '2.3', 'the_permalink_rss()' ); + _deprecated_function( __FUNCTION__, '2.3.0', 'the_permalink_rss()' ); the_permalink_rss(); } @@ -869,7 +869,7 @@ function permalink_single_rss($deprecated = '') { * @return null|string */ function wp_get_links($args = '') { - _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' ); if ( strpos( $args, '=' ) === false ) { $cat_id = $args; @@ -923,7 +923,7 @@ function wp_get_links($args = '') { */ function get_links($category = -1, $before = '', $after = '
', $between = ' ', $show_images = true, $orderby = 'name', $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) { - _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); $order = 'ASC'; if ( substr($orderby, 0, 1) == '_' ) { @@ -1015,7 +1015,7 @@ function get_links($category = -1, $before = '', $after = '
', $between = ' * @param string $order Sort link categories by 'name' or 'id' */ function get_links_list($order = 'name') { - _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' ); $order = strtolower($order); @@ -1060,7 +1060,7 @@ function get_links_list($order = 'name') { * @param bool $count the number of links in the db */ function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) { - _deprecated_function( __FUNCTION__, '2.1' ); + _deprecated_function( __FUNCTION__, '2.1.0' ); } /** @@ -1074,7 +1074,7 @@ function links_popup_script($text = 'Links', $width=400, $height=400, $file='lin * @return mixed Value of the 'link_rating' field, false otherwise. */ function get_linkrating( $link ) { - _deprecated_function( __FUNCTION__, '2.1', 'sanitize_bookmark_field()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'sanitize_bookmark_field()' ); return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display'); } @@ -1089,7 +1089,7 @@ function get_linkrating( $link ) { * @return string */ function get_linkcatname($id = 0) { - _deprecated_function( __FUNCTION__, '2.1', 'get_category()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_category()' ); $id = (int) $id; @@ -1117,7 +1117,7 @@ function get_linkcatname($id = 0) { * @param string $link_text */ function comments_rss_link($link_text = 'Comments RSS') { - _deprecated_function( __FUNCTION__, '2.5', 'post_comments_feed_link()' ); + _deprecated_function( __FUNCTION__, '2.5.0', 'post_comments_feed_link()' ); post_comments_feed_link($link_text); } @@ -1133,7 +1133,7 @@ function comments_rss_link($link_text = 'Comments RSS') { * @return string */ function get_category_rss_link($echo = false, $cat_ID = 1) { - _deprecated_function( __FUNCTION__, '2.5', 'get_category_feed_link()' ); + _deprecated_function( __FUNCTION__, '2.5.0', 'get_category_feed_link()' ); $link = get_category_feed_link($cat_ID, 'rss2'); @@ -1154,7 +1154,7 @@ function get_category_rss_link($echo = false, $cat_ID = 1) { * @return string */ function get_author_rss_link($echo = false, $author_id = 1) { - _deprecated_function( __FUNCTION__, '2.5', 'get_author_feed_link()' ); + _deprecated_function( __FUNCTION__, '2.5.0', 'get_author_feed_link()' ); $link = get_author_feed_link($author_id); if ( $echo ) @@ -1172,7 +1172,7 @@ function get_author_rss_link($echo = false, $author_id = 1) { * @return string */ function comments_rss() { - _deprecated_function( __FUNCTION__, '2.2', 'get_post_comments_feed_link()' ); + _deprecated_function( __FUNCTION__, '2.2.0', 'get_post_comments_feed_link()' ); return esc_url( get_post_comments_feed_link() ); } @@ -1189,7 +1189,7 @@ function comments_rss() { * @return int The new user's ID. */ function create_user($username, $password, $email) { - _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' ); + _deprecated_function( __FUNCTION__, '2.0.0', 'wp_create_user()' ); return wp_create_user($username, $password, $email); } @@ -1199,7 +1199,7 @@ function create_user($username, $password, $email) { * @deprecated 2.5.0 */ function gzip_compression() { - _deprecated_function( __FUNCTION__, '2.5' ); + _deprecated_function( __FUNCTION__, '2.5.0' ); return false; } @@ -1216,7 +1216,7 @@ function gzip_compression() { * @return array The comment data */ function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = false ) { - _deprecated_function( __FUNCTION__, '2.7', 'get_comment()' ); + _deprecated_function( __FUNCTION__, '2.7.0', 'get_comment()' ); return get_comment($comment_ID, ARRAY_A); } @@ -1231,7 +1231,7 @@ function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = fals * @return string category name */ function get_catname( $cat_ID ) { - _deprecated_function( __FUNCTION__, '2.8', 'get_cat_name()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_cat_name()' ); return get_cat_name( $cat_ID ); } @@ -1249,7 +1249,7 @@ function get_catname( $cat_ID ) { * @return string */ function get_category_children( $id, $before = '/', $after = '', $visited = array() ) { - _deprecated_function( __FUNCTION__, '2.8', 'get_term_children()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_term_children()' ); if ( 0 == $id ) return ''; @@ -1284,7 +1284,7 @@ function get_category_children( $id, $before = '/', $after = '', $visited = arra * @return object List of all of the category IDs. */ function get_all_category_ids() { - _deprecated_function( __FUNCTION__, '4.0', 'get_terms()' ); + _deprecated_function( __FUNCTION__, '4.0.0', 'get_terms()' ); if ( ! $cat_ids = wp_cache_get( 'all_category_ids', 'category' ) ) { $cat_ids = get_terms( 'category', array('fields' => 'ids', 'get' => 'all') ); @@ -1304,7 +1304,7 @@ function get_all_category_ids() { * @return string The author's description. */ function get_the_author_description() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'description\')' ); return get_the_author_meta('description'); } @@ -1316,7 +1316,7 @@ function get_the_author_description() { * @see the_author_meta() */ function the_author_description() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'description\')' ); the_author_meta('description'); } @@ -1330,7 +1330,7 @@ function the_author_description() { * @return string The author's login name (username). */ function get_the_author_login() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'login\')' ); return get_the_author_meta('login'); } @@ -1342,7 +1342,7 @@ function get_the_author_login() { * @see the_author_meta() */ function the_author_login() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'login\')' ); the_author_meta('login'); } @@ -1356,7 +1356,7 @@ function the_author_login() { * @return string The author's first name. */ function get_the_author_firstname() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'first_name\')' ); return get_the_author_meta('first_name'); } @@ -1368,7 +1368,7 @@ function get_the_author_firstname() { * @see the_author_meta() */ function the_author_firstname() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'first_name\')' ); the_author_meta('first_name'); } @@ -1382,7 +1382,7 @@ function the_author_firstname() { * @return string The author's last name. */ function get_the_author_lastname() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'last_name\')' ); return get_the_author_meta('last_name'); } @@ -1394,7 +1394,7 @@ function get_the_author_lastname() { * @see the_author_meta() */ function the_author_lastname() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'last_name\')' ); the_author_meta('last_name'); } @@ -1408,7 +1408,7 @@ function the_author_lastname() { * @return string The author's nickname. */ function get_the_author_nickname() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'nickname\')' ); return get_the_author_meta('nickname'); } @@ -1420,7 +1420,7 @@ function get_the_author_nickname() { * @see the_author_meta() */ function the_author_nickname() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'nickname\')' ); the_author_meta('nickname'); } @@ -1434,7 +1434,7 @@ function the_author_nickname() { * @return string The author's username. */ function get_the_author_email() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'email\')' ); return get_the_author_meta('email'); } @@ -1446,7 +1446,7 @@ function get_the_author_email() { * @see the_author_meta() */ function the_author_email() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'email\')' ); the_author_meta('email'); } @@ -1460,7 +1460,7 @@ function the_author_email() { * @return string The author's ICQ number. */ function get_the_author_icq() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'icq\')' ); return get_the_author_meta('icq'); } @@ -1472,7 +1472,7 @@ function get_the_author_icq() { * @see the_author_meta() */ function the_author_icq() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'icq\')' ); the_author_meta('icq'); } @@ -1486,7 +1486,7 @@ function the_author_icq() { * @return string The author's Yahoo! IM name. */ function get_the_author_yim() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'yim\')' ); return get_the_author_meta('yim'); } @@ -1498,7 +1498,7 @@ function get_the_author_yim() { * @see the_author_meta() */ function the_author_yim() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'yim\')' ); the_author_meta('yim'); } @@ -1512,7 +1512,7 @@ function the_author_yim() { * @return string The author's MSN address. */ function get_the_author_msn() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'msn\')' ); return get_the_author_meta('msn'); } @@ -1524,7 +1524,7 @@ function get_the_author_msn() { * @see the_author_meta() */ function the_author_msn() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'msn\')' ); the_author_meta('msn'); } @@ -1538,7 +1538,7 @@ function the_author_msn() { * @return string The author's AIM address. */ function get_the_author_aim() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'aim\')' ); return get_the_author_meta('aim'); } @@ -1550,7 +1550,7 @@ function get_the_author_aim() { * @see the_author_meta() */ function the_author_aim() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'aim\')' ); the_author_meta('aim'); } @@ -1565,7 +1565,7 @@ function the_author_aim() { * @return string The author's display name. */ function get_author_name( $auth_id = false ) { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'display_name\')' ); return get_the_author_meta('display_name', $auth_id); } @@ -1579,7 +1579,7 @@ function get_author_name( $auth_id = false ) { * @return string The URL to the author's page. */ function get_the_author_url() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'url\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'url\')' ); return get_the_author_meta('url'); } @@ -1591,7 +1591,7 @@ function get_the_author_url() { * @see the_author_meta() */ function the_author_url() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'url\')' ); the_author_meta('url'); } @@ -1605,7 +1605,7 @@ function the_author_url() { * @return string|int The author's ID. */ function get_the_author_ID() { - _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'ID\')' ); return get_the_author_meta('ID'); } @@ -1617,7 +1617,7 @@ function get_the_author_ID() { * @see the_author_meta() */ function the_author_ID() { - _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'ID\')' ); the_author_meta('ID'); } @@ -1650,7 +1650,7 @@ function the_author_ID() { * @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', 'the_content_feed' ); + _deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed' ); $content = get_the_content($more_link_text, $stripteaser); $content = apply_filters('the_content_rss', $content); if ( $cut && !$encode_html ) @@ -1696,7 +1696,7 @@ function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file * @return string HTML stripped out of content with links at the bottom. */ function make_url_footnote( $content ) { - _deprecated_function( __FUNCTION__, '2.9', '' ); + _deprecated_function( __FUNCTION__, '2.9.0', '' ); preg_match_all( '/(.+?)<\/a>/', $content, $matches ); $links_summary = "\n"; for ( $i = 0, $c = count( $matches[0] ); $i < $c; $i++ ) { @@ -1735,7 +1735,7 @@ function make_url_footnote( $content ) { * @return string Translated context string without pipe */ function _c( $text, $domain = 'default' ) { - _deprecated_function( __FUNCTION__, '2.9', '_x()' ); + _deprecated_function( __FUNCTION__, '2.9.0', '_x()' ); return before_last_bar( translate( $text, $domain ) ); } @@ -1752,7 +1752,7 @@ function _c( $text, $domain = 'default' ) { * @return string Translated text */ function translate_with_context( $text, $domain = 'default' ) { - _deprecated_function( __FUNCTION__, '2.9', '_x()' ); + _deprecated_function( __FUNCTION__, '2.9.0', '_x()' ); return before_last_bar( translate( $text, $domain ) ); } @@ -1773,7 +1773,7 @@ function translate_with_context( $text, $domain = 'default' ) { * @return string The translated singular or plural form. */ function _nc( $single, $plural, $number, $domain = 'default' ) { - _deprecated_function( __FUNCTION__, '2.9', '_nx()' ); + _deprecated_function( __FUNCTION__, '2.9.0', '_nx()' ); return before_last_bar( _n( $single, $plural, $number, $domain ) ); } @@ -1785,7 +1785,7 @@ function _nc( $single, $plural, $number, $domain = 'default' ) { * @see _n() */ function __ngettext() { - _deprecated_function( __FUNCTION__, '2.8', '_n()' ); + _deprecated_function( __FUNCTION__, '2.8.0', '_n()' ); $args = func_get_args(); return call_user_func_array('_n', $args); } @@ -1798,7 +1798,7 @@ function __ngettext() { * @see _n_noop() */ function __ngettext_noop() { - _deprecated_function( __FUNCTION__, '2.8', '_n_noop()' ); + _deprecated_function( __FUNCTION__, '2.8.0', '_n_noop()' ); $args = func_get_args(); return call_user_func_array('_n_noop', $args); @@ -1814,7 +1814,7 @@ function __ngettext_noop() { * @return array List of all options. */ function get_alloptions() { - _deprecated_function( __FUNCTION__, '3.0', 'wp_load_alloptions()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'wp_load_alloptions()' ); return wp_load_alloptions(); } @@ -1832,7 +1832,7 @@ function get_alloptions() { * @return string */ function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false) { - _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_link()' ); + _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_link()' ); $id = (int) $id; $_post = get_post($id); @@ -1860,7 +1860,7 @@ function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = 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', 'wp_get_attachment_image_src()' ); + _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image_src()' ); $id = (int) $id; if ( !$post = get_post($id) ) return false; @@ -1902,7 +1902,7 @@ function get_attachment_icon_src( $id = 0, $fullsize = false ) { * @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()' ); + _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' ); $id = (int) $id; if ( !$post = get_post($id) ) return false; @@ -1958,7 +1958,7 @@ function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) { * @return false|string */ function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) { - _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' ); + _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' ); $id = (int) $id; if ( !$post = get_post($id) ) return false; @@ -1986,7 +1986,7 @@ function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) * @return object|array Bookmark object or array, depending on the type specified by `$output`. */ function get_link( $bookmark_id, $output = OBJECT, $filter = 'raw' ) { - _deprecated_function( __FUNCTION__, '2.1', 'get_bookmark()' ); + _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmark()' ); return get_bookmark($bookmark_id, $output, $filter); } @@ -2002,7 +2002,7 @@ function get_link( $bookmark_id, $output = OBJECT, $filter = 'raw' ) { * @return string The cleaned URL. */ function sanitize_url( $url, $protocols = null ) { - _deprecated_function( __FUNCTION__, '2.8', 'esc_url_raw()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'esc_url_raw()' ); return esc_url_raw( $url, $protocols ); } @@ -2020,20 +2020,20 @@ function sanitize_url( $url, $protocols = null ) { * @param string $url The URL to be cleaned. * @param array $protocols Optional. An array of acceptable protocols. * @param string $context Optional. How the URL will be used. Default is 'display'. - * @return string The cleaned $url after the 'clean_url' filter is applied. + * @return string The cleaned $url after the {@see 'clean_url'} filter is applied. */ function clean_url( $url, $protocols = null, $context = 'display' ) { if ( $context == 'db' ) - _deprecated_function( 'clean_url( $context = \'db\' )', '3.0', 'esc_url_raw()' ); + _deprecated_function( 'clean_url( $context = \'db\' )', '3.0.0', 'esc_url_raw()' ); else - _deprecated_function( __FUNCTION__, '3.0', 'esc_url()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'esc_url()' ); return esc_url( $url, $protocols, $context ); } /** * Escape single quotes, specialchar double quotes, and fix line endings. * - * The filter 'js_escape' is also applied by esc_js() + * The filter {@see 'js_escape'} is also applied by esc_js(). * * @since 2.0.4 * @deprecated 2.8.0 Use esc_js() @@ -2043,7 +2043,7 @@ function clean_url( $url, $protocols = null, $context = 'display' ) { * @return string Escaped text. */ function js_escape( $text ) { - _deprecated_function( __FUNCTION__, '2.8', 'esc_js()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'esc_js()' ); return esc_js( $text ); } @@ -2060,8 +2060,8 @@ function js_escape( $text ) { * @return string Escaped `$string`. */ function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) { - _deprecated_function( __FUNCTION__, '2.8', 'esc_html()' ); - if ( func_num_args() > 1 ) { // Maintain backwards compat for people passing additional args + _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 call_user_func_array( '_wp_specialchars', $args ); } else { @@ -2080,19 +2080,19 @@ function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false * @return string */ function attribute_escape( $text ) { - _deprecated_function( __FUNCTION__, '2.8', 'esc_attr()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'esc_attr()' ); return esc_attr( $text ); } /** - * Register widget for sidebar with backwards compatibility. + * Register widget for sidebar with backward compatibility. * * Allows $name to be an array that accepts either three elements to grab the * first element and the third for the name or just uses the first element of * the array for the name. * - * Passes to {@link wp_register_sidebar_widget()} after argument list and - * backwards compatibility is complete. + * Passes to wp_register_sidebar_widget() after argument list and backward + * compatibility is complete. * * @since 2.2.0 * @deprecated 2.8.0 Use wp_register_sidebar_widget() @@ -2104,7 +2104,7 @@ function attribute_escape( $text ) { * @param mixed $params ,... Widget parameters. */ function register_sidebar_widget($name, $output_callback, $classname = '') { - _deprecated_function( __FUNCTION__, '2.8', 'wp_register_sidebar_widget()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_sidebar_widget()' ); // Compat if ( is_array($name) ) { if ( count($name) == 3 ) @@ -2126,7 +2126,7 @@ function register_sidebar_widget($name, $output_callback, $classname = '') { } /** - * Alias of {@link wp_unregister_sidebar_widget()}. + * Serves as an alias of wp_unregister_sidebar_widget(). * * @since 2.2.0 * @deprecated 2.8.0 Use wp_unregister_sidebar_widget() @@ -2135,7 +2135,7 @@ function register_sidebar_widget($name, $output_callback, $classname = '') { * @param int|string $id Widget ID. */ function unregister_sidebar_widget($id) { - _deprecated_function( __FUNCTION__, '2.8', 'wp_unregister_sidebar_widget()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'wp_unregister_sidebar_widget()' ); return wp_unregister_sidebar_widget($id); } @@ -2159,7 +2159,7 @@ function unregister_sidebar_widget($id) { * @param int $height Widget height. */ function register_widget_control($name, $control_callback, $width = '', $height = '') { - _deprecated_function( __FUNCTION__, '2.8', 'wp_register_widget_control()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_widget_control()' ); // Compat if ( is_array($name) ) { if ( count($name) == 3 ) @@ -2192,7 +2192,7 @@ function register_widget_control($name, $control_callback, $width = '', $height * @param int|string $id Widget ID. */ function unregister_widget_control($id) { - _deprecated_function( __FUNCTION__, '2.8', 'wp_unregister_widget_control()' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'wp_unregister_widget_control()' ); return wp_unregister_widget_control($id); } @@ -2209,7 +2209,7 @@ function unregister_widget_control($id) { * @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', 'delete_user_meta()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'delete_user_meta()' ); global $wpdb; if ( !is_numeric( $user_id ) ) return false; @@ -2255,7 +2255,7 @@ function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) { * @return mixed */ function get_usermeta( $user_id, $meta_key = '' ) { - _deprecated_function( __FUNCTION__, '3.0', 'get_user_meta()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'get_user_meta()' ); global $wpdb; $user_id = (int) $user_id; @@ -2308,7 +2308,7 @@ function get_usermeta( $user_id, $meta_key = '' ) { * @return bool True on successful update, false on failure. */ function update_usermeta( $user_id, $meta_key, $meta_value ) { - _deprecated_function( __FUNCTION__, '3.0', 'update_user_meta()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'update_user_meta()' ); global $wpdb; if ( !is_numeric( $user_id ) ) return false; @@ -2363,7 +2363,7 @@ function update_usermeta( $user_id, $meta_key, $meta_value ) { * @return array List of users that are part of that site ID */ function get_users_of_blog( $id = '' ) { - _deprecated_function( __FUNCTION__, '3.1', 'get_users()' ); + _deprecated_function( __FUNCTION__, '3.1.0', 'get_users()' ); global $wpdb, $blog_id; if ( empty($id) ) @@ -2383,7 +2383,7 @@ function get_users_of_blog( $id = '' ) { * @param bool $add Optional, default is true. Add or remove links. Defaults to true. */ function automatic_feed_links( $add = true ) { - _deprecated_function( __FUNCTION__, '3.0', "add_theme_support( 'automatic-feed-links' )" ); + _deprecated_function( __FUNCTION__, '3.0.0', "add_theme_support( 'automatic-feed-links' )" ); if ( $add ) add_theme_support( 'automatic-feed-links' ); @@ -2403,7 +2403,7 @@ function automatic_feed_links( $add = true ) { * @return string The author's field from the current author's DB object. */ function get_profile( $field, $user = false ) { - _deprecated_function( __FUNCTION__, '3.0', 'get_the_author_meta()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'get_the_author_meta()' ); if ( $user ) { $user = get_user_by( 'login', $user ); $user = $user->ID; @@ -2422,7 +2422,7 @@ function get_profile( $field, $user = false ) { * @return int Number of posts the given user has written. */ function get_usernumposts( $userid ) { - _deprecated_function( __FUNCTION__, '3.0', 'count_user_posts()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'count_user_posts()' ); return count_user_posts( $userid ); } @@ -2455,7 +2455,7 @@ function funky_javascript_callback($matches) { * @return string Fixed text. */ function funky_javascript_fix($text) { - _deprecated_function( __FUNCTION__, '3.0' ); + _deprecated_function( __FUNCTION__, '3.0.0' ); // Fixes for browsers' JavaScript bugs. global $is_macIE, $is_winIE; @@ -2478,7 +2478,7 @@ function funky_javascript_fix($text) { * @return bool Whether the taxonomy exists. */ function is_taxonomy( $taxonomy ) { - _deprecated_function( __FUNCTION__, '3.0', 'taxonomy_exists()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'taxonomy_exists()' ); return taxonomy_exists( $taxonomy ); } @@ -2495,7 +2495,7 @@ function is_taxonomy( $taxonomy ) { * @return mixed Get the term id or Term Object, if exists. */ function is_term( $term, $taxonomy = '', $parent = 0 ) { - _deprecated_function( __FUNCTION__, '3.0', 'term_exists()' ); + _deprecated_function( __FUNCTION__, '3.0.0', 'term_exists()' ); return term_exists( $term, $taxonomy, $parent ); } @@ -2512,7 +2512,7 @@ function is_term( $term, $taxonomy = '', $parent = 0 ) { * @return bool */ function is_plugin_page() { - _deprecated_function( __FUNCTION__, '3.1' ); + _deprecated_function( __FUNCTION__, '3.1.0' ); global $plugin_page; @@ -2535,7 +2535,7 @@ function is_plugin_page() { * @return bool Always return True */ function update_category_cache() { - _deprecated_function( __FUNCTION__, '3.1' ); + _deprecated_function( __FUNCTION__, '3.1.0' ); return true; } @@ -2549,7 +2549,7 @@ function update_category_cache() { * @return bool */ function wp_timezone_supported() { - _deprecated_function( __FUNCTION__, '3.2' ); + _deprecated_function( __FUNCTION__, '3.2.0' ); return true; } @@ -2569,7 +2569,7 @@ function wp_timezone_supported() { * @param bool $extended Optional. Unused. */ function the_editor($content, $id = 'content', $prev_id = 'title', $media_buttons = true, $tab_index = 2, $extended = true) { - _deprecated_function( __FUNCTION__, '3.3', 'wp_editor()' ); + _deprecated_function( __FUNCTION__, '3.3.0', 'wp_editor()' ); wp_editor( $content, $id, array( 'media_buttons' => $media_buttons ) ); } @@ -2584,7 +2584,7 @@ function the_editor($content, $id = 'content', $prev_id = 'title', $media_button * @return array of arrays. The array is indexed by user_id, containing $metavalues object arrays. */ function get_user_metavalues($ids) { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); $objects = array(); @@ -2618,7 +2618,7 @@ function get_user_metavalues($ids) { * @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' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); if ( is_object($user) ) { if ( !isset($user->ID) ) @@ -2657,7 +2657,7 @@ function sanitize_user_object($user, $context = 'display') { * @return string */ function get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $start = true) { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); $posts = get_boundary_post($in_same_cat, $excluded_categories, $start); // If there is no post stop. @@ -2695,7 +2695,7 @@ function get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $ex * @param string $excluded_categories Optional. Excluded categories IDs. */ function start_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); echo get_boundary_post_rel_link($title, $in_same_cat, $excluded_categories, true); } @@ -2709,7 +2709,7 @@ function start_post_rel_link($title = '%title', $in_same_cat = false, $excluded_ * @return string */ function get_index_rel_link() { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); $link = "\n"; return apply_filters( "index_rel_link", $link ); @@ -2722,7 +2722,7 @@ function get_index_rel_link() { * @deprecated 3.3.0 */ function index_rel_link() { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); echo get_index_rel_link(); } @@ -2737,7 +2737,7 @@ function index_rel_link() { * @return string */ function get_parent_post_rel_link( $title = '%title' ) { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); if ( ! empty( $GLOBALS['post'] ) && ! empty( $GLOBALS['post']->post_parent ) ) $post = get_post($GLOBALS['post']->post_parent); @@ -2767,7 +2767,7 @@ function get_parent_post_rel_link( $title = '%title' ) { * @param string $title Optional. Link title format. Default '%title'. */ function parent_post_rel_link( $title = '%title' ) { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); echo get_parent_post_rel_link($title); } @@ -2781,7 +2781,7 @@ function parent_post_rel_link( $title = '%title' ) { * @param WP_Admin_Bar $wp_admin_bar WP_Admin_Bar instance. */ function wp_admin_bar_dashboard_view_site_menu( $wp_admin_bar ) { - _deprecated_function( __FUNCTION__, '3.3' ); + _deprecated_function( __FUNCTION__, '3.3.0' ); $user_id = get_current_user_id(); @@ -2806,7 +2806,7 @@ function wp_admin_bar_dashboard_view_site_menu( $wp_admin_bar ) { * @return bool True if the current users belong to $blog_id, false if not. */ function is_blog_user( $blog_id = 0 ) { - _deprecated_function( __FUNCTION__, '3.3', 'is_user_member_of_blog()' ); + _deprecated_function( __FUNCTION__, '3.3.0', 'is_user_member_of_blog()' ); return is_user_member_of_blog( get_current_user_id(), $blog_id ); } @@ -2818,7 +2818,7 @@ function is_blog_user( $blog_id = 0 ) { * @deprecated 3.4.0 Use error_log() * @see error_log() * - * @link http://www.php.net/manual/en/function.error-log.php + * @link https://secure.php.net/manual/en/function.error-log.php * * @param string $filename File name. * @param string $mode Type of access you required to the stream. @@ -2836,7 +2836,7 @@ function debug_fopen( $filename, $mode ) { * @deprecated 3.4.0 Use error_log() * @see error_log() * - * @link http://www.php.net/manual/en/function.error-log.php + * @link https://secure.php.net/manual/en/function.error-log.php * * @param mixed $fp Unused. * @param string $string Message to log. @@ -2854,7 +2854,7 @@ function debug_fwrite( $fp, $string ) { * @deprecated 3.4.0 Use error_log() * @see error_log() * - * @link http://www.php.net/manual/en/function.error-log.php + * @link https://secure.php.net/manual/en/function.error-log.php * * @param mixed $fp Unused. */ @@ -2876,7 +2876,7 @@ function debug_fclose( $fp ) { * @return array Theme list with theme data. */ function get_themes() { - _deprecated_function( __FUNCTION__, '3.4', 'wp_get_themes()' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_themes()' ); global $wp_themes; if ( isset( $wp_themes ) ) @@ -2907,7 +2907,7 @@ function get_themes() { * @return array|null Null, if theme name does not exist. Theme data, if exists. */ function get_theme( $theme ) { - _deprecated_function( __FUNCTION__, '3.4', 'wp_get_theme( $stylesheet )' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme( $stylesheet )' ); $themes = get_themes(); if ( is_array( $themes ) && array_key_exists( $theme, $themes ) ) @@ -2925,7 +2925,7 @@ function get_theme( $theme ) { * @return string */ function get_current_theme() { - _deprecated_function( __FUNCTION__, '3.4', 'wp_get_theme()' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme()' ); if ( $theme = get_option( 'current_theme' ) ) return $theme; @@ -2946,7 +2946,7 @@ function get_current_theme() { * @return string The pre block without paragraph/line-break conversion. */ function clean_pre($matches) { - _deprecated_function( __FUNCTION__, '3.4' ); + _deprecated_function( __FUNCTION__, '3.4.0' ); if ( is_array($matches) ) $text = $matches[1] . $matches[2] . ""; @@ -2968,12 +2968,12 @@ function clean_pre($matches) { * @deprecated 3.4.0 Use add_theme_support() * @see add_theme_support() * - * @param callable $wp_head_callback Call on 'wp_head' action. + * @param callable $wp_head_callback Call on the {@see 'wp_head'} action. * @param callable $admin_head_callback Call on custom header administration screen. * @param callable $admin_preview_callback Output a custom header image div on the custom header administration screen. Optional. */ function add_custom_image_header( $wp_head_callback, $admin_head_callback, $admin_preview_callback = '' ) { - _deprecated_function( __FUNCTION__, '3.4', 'add_theme_support( \'custom-header\', $args )' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'add_theme_support( \'custom-header\', $args )' ); $args = array( 'wp-head-callback' => $wp_head_callback, 'admin-head-callback' => $admin_head_callback, @@ -2993,7 +2993,7 @@ function add_custom_image_header( $wp_head_callback, $admin_head_callback, $admi * @return null|bool Whether support was removed. */ function remove_custom_image_header() { - _deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support( \'custom-header\' )' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'remove_theme_support( \'custom-header\' )' ); return remove_theme_support( 'custom-header' ); } @@ -3004,12 +3004,12 @@ function remove_custom_image_header() { * @deprecated 3.4.0 Use add_theme_support() * @see add_theme_support() * - * @param callable $wp_head_callback Call on 'wp_head' action. + * @param callable $wp_head_callback Call on the {@see 'wp_head'} action. * @param callable $admin_head_callback Call on custom background administration screen. * @param callable $admin_preview_callback Output a custom background image div on the custom background administration screen. Optional. */ function add_custom_background( $wp_head_callback = '', $admin_head_callback = '', $admin_preview_callback = '' ) { - _deprecated_function( __FUNCTION__, '3.4', 'add_theme_support( \'custom-background\', $args )' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'add_theme_support( \'custom-background\', $args )' ); $args = array(); if ( $wp_head_callback ) $args['wp-head-callback'] = $wp_head_callback; @@ -3030,7 +3030,7 @@ function add_custom_background( $wp_head_callback = '', $admin_head_callback = ' * @return null|bool Whether support was removed. */ function remove_custom_background() { - _deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support( \'custom-background\' )' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'remove_theme_support( \'custom-background\' )' ); return remove_theme_support( 'custom-background' ); } @@ -3045,7 +3045,7 @@ function remove_custom_background() { * @return array Theme data. */ function get_theme_data( $theme_file ) { - _deprecated_function( __FUNCTION__, '3.4', 'wp_get_theme()' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme()' ); $theme = new WP_Theme( basename( dirname( $theme_file ) ), dirname( dirname( $theme_file ) ) ); $theme_data = array( @@ -3082,7 +3082,7 @@ function get_theme_data( $theme_file ) { * @param array $pages list of page objects */ function update_page_cache( &$pages ) { - _deprecated_function( __FUNCTION__, '3.4', 'update_post_cache()' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'update_post_cache()' ); update_post_cache( $pages ); } @@ -3100,7 +3100,7 @@ function update_page_cache( &$pages ) { * @param int $id Page ID to clean */ function clean_page_cache( $id ) { - _deprecated_function( __FUNCTION__, '3.4', 'clean_post_cache()' ); + _deprecated_function( __FUNCTION__, '3.4.0', 'clean_post_cache()' ); clean_post_cache( $id ); } @@ -3132,7 +3132,7 @@ function wp_explain_nonce( $action ) { * @param int $post_id An optional post ID. */ function sticky_class( $post_id = null ) { - _deprecated_function( __FUNCTION__, '3.5', 'post_class()' ); + _deprecated_function( __FUNCTION__, '3.5.0', 'post_class()' ); if ( is_sticky( $post_id ) ) echo ' sticky'; } @@ -3150,7 +3150,7 @@ function sticky_class( $post_id = null ) { * @param WP_Post &$post Post object, passed by reference (unused). */ function _get_post_ancestors( &$post ) { - _deprecated_function( __FUNCTION__, '3.5' ); + _deprecated_function( __FUNCTION__, '3.5.0' ); } /** @@ -3164,7 +3164,7 @@ function _get_post_ancestors( &$post ) { * @return resource The resulting image resource on success, Error string on failure. */ function wp_load_image( $file ) { - _deprecated_function( __FUNCTION__, '3.5', 'wp_get_image_editor()' ); + _deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' ); if ( is_numeric( $file ) ) $file = get_attached_file( $file ); @@ -3175,8 +3175,9 @@ function wp_load_image( $file ) { if ( ! function_exists('imagecreatefromstring') ) return __('The GD image library is not installed.'); - // Set artificially high because GD uses uncompressed images in memory - @ini_set( 'memory_limit', apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT ) ); + // Set artificially high because GD uses uncompressed images in memory. + wp_raise_memory_limit( 'image' ); + $image = imagecreatefromstring( file_get_contents( $file ) ); if ( !is_resource( $image ) ) @@ -3210,7 +3211,7 @@ function wp_load_image( $file ) { * @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', 'wp_get_image_editor()' ); + _deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' ); $editor = wp_get_image_editor( $file ); if ( is_wp_error( $editor ) ) @@ -3245,7 +3246,7 @@ function image_resize( $file, $max_w, $max_h, $crop = false, $suffix = null, $de * @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()' ); + _deprecated_function( __FUNCTION__, '3.5.0', 'get_post()' ); return get_post( $postid, $mode ); } @@ -3261,7 +3262,7 @@ function wp_get_single_post( $postid = 0, $mode = OBJECT ) { * @return bool False if does not authenticate, true if username and password authenticates. */ function user_pass_ok($user_login, $user_pass) { - _deprecated_function( __FUNCTION__, '3.5', 'wp_authenticate()' ); + _deprecated_function( __FUNCTION__, '3.5.0', 'wp_authenticate()' ); $user = wp_authenticate( $user_login, $user_pass ); if ( is_wp_error( $user ) ) return false; @@ -3288,7 +3289,7 @@ function _save_post_hook() {} * @return bool */ function gd_edit_image_support($mime_type) { - _deprecated_function( __FUNCTION__, '3.5', 'wp_image_editor_supports()' ); + _deprecated_function( __FUNCTION__, '3.5.0', 'wp_image_editor_supports()' ); if ( function_exists('imagetypes') ) { switch( $mime_type ) { @@ -3323,9 +3324,9 @@ function gd_edit_image_support($mime_type) { * @return string A shorthand byte value. */ function wp_convert_bytes_to_hr( $bytes ) { - _deprecated_function( __FUNCTION__, '3.6', 'size_format()' ); + _deprecated_function( __FUNCTION__, '3.6.0', 'size_format()' ); - $units = array( 0 => 'B', 1 => 'kB', 2 => 'MB', 3 => 'GB', 4 => 'TB' ); + $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 ); @@ -3351,7 +3352,7 @@ function wp_convert_bytes_to_hr( $bytes ) { * @return string Trimmed search terms. */ function _search_terms_tidy( $t ) { - _deprecated_function( __FUNCTION__, '3.7' ); + _deprecated_function( __FUNCTION__, '3.7.0' ); return trim( $t, "\"'\n\r " ); } @@ -3368,7 +3369,7 @@ function _search_terms_tidy( $t ) { */ function rich_edit_exists() { global $wp_rich_edit_exists; - _deprecated_function( __FUNCTION__, '3.9' ); + _deprecated_function( __FUNCTION__, '3.9.0' ); if ( ! isset( $wp_rich_edit_exists ) ) $wp_rich_edit_exists = file_exists( ABSPATH . WPINC . '/js/tinymce/tinymce.js' ); @@ -3402,7 +3403,7 @@ function default_topic_count_text( $count ) { * @return string The very same text. */ function format_to_post( $content ) { - _deprecated_function( __FUNCTION__, '3.9' ); + _deprecated_function( __FUNCTION__, '3.9.0' ); return $content; } @@ -3417,7 +3418,7 @@ function format_to_post( $content ) { * @return string text, safe for inclusion in LIKE query. */ function like_escape($text) { - _deprecated_function( __FUNCTION__, '4.0', 'wpdb::esc_like()' ); + _deprecated_function( __FUNCTION__, '4.0.0', 'wpdb::esc_like()' ); return str_replace( array( "%", "_" ), array( "\\%", "\\_" ), $text ); } @@ -3434,7 +3435,7 @@ function like_escape($text) { * @return bool Whether SSL access is available. */ function url_is_accessable_via_ssl( $url ) { - _deprecated_function( __FUNCTION__, '4.0' ); + _deprecated_function( __FUNCTION__, '4.0.0' ); $response = wp_remote_get( set_url_scheme( $url, 'https' ) ); @@ -3458,7 +3459,7 @@ function url_is_accessable_via_ssl( $url ) { * @deprecated 4.3.0 */ function preview_theme() { - _deprecated_function( __FUNCTION__, '4.3' ); + _deprecated_function( __FUNCTION__, '4.3.0' ); } /** @@ -3471,7 +3472,7 @@ function preview_theme() { * @return string */ function _preview_theme_template_filter() { - _deprecated_function( __FUNCTION__, '4.3' ); + _deprecated_function( __FUNCTION__, '4.3.0' ); return ''; } @@ -3485,7 +3486,7 @@ function _preview_theme_template_filter() { * @return string */ function _preview_theme_stylesheet_filter() { - _deprecated_function( __FUNCTION__, '4.3' ); + _deprecated_function( __FUNCTION__, '4.3.0' ); return ''; } @@ -3500,7 +3501,7 @@ function _preview_theme_stylesheet_filter() { * @return string */ function preview_theme_ob_filter( $content ) { - _deprecated_function( __FUNCTION__, '4.3' ); + _deprecated_function( __FUNCTION__, '4.3.0' ); return $content; } @@ -3517,14 +3518,14 @@ function preview_theme_ob_filter( $content ) { * @return string */ function preview_theme_ob_filter_callback( $matches ) { - _deprecated_function( __FUNCTION__, '4.3' ); + _deprecated_function( __FUNCTION__, '4.3.0' ); return ''; } /** * Formats text for the rich text editor. * - * The filter 'richedit_pre' is applied here. If $text is empty the filter will + * The {@see 'richedit_pre'} filter is applied here. If $text is empty the filter will * be applied to an empty string. * * @since 2.0.0 @@ -3534,11 +3535,11 @@ function preview_theme_ob_filter_callback( $matches ) { * @return string The formatted text after filter is applied. */ function wp_richedit_pre($text) { - _deprecated_function( __FUNCTION__, '4.3', 'format_for_editor()' ); + _deprecated_function( __FUNCTION__, '4.3.0', 'format_for_editor()' ); if ( empty( $text ) ) { /** - * Filter text returned for the rich text editor. + * Filters text returned for the rich text editor. * * This filter is first evaluated, and the value returned, if an empty string * is passed to wp_richedit_pre(). If an empty string is passed, it results @@ -3567,7 +3568,7 @@ function wp_richedit_pre($text) { * Formats text for the HTML editor. * * Unless $output is empty it will pass through htmlspecialchars before the - * 'htmledit_pre' filter is applied. + * {@see 'htmledit_pre'} filter is applied. * * @since 2.5.0 * @deprecated 4.3.0 Use format_for_editor() @@ -3577,13 +3578,13 @@ function wp_richedit_pre($text) { * @return string Formatted text after filter applied. */ function wp_htmledit_pre($output) { - _deprecated_function( __FUNCTION__, '4.3', 'format_for_editor()' ); + _deprecated_function( __FUNCTION__, '4.3.0', 'format_for_editor()' ); if ( !empty($output) ) $output = htmlspecialchars($output, ENT_NOQUOTES, get_option( 'blog_charset' ) ); // convert only < > & /** - * Filter the text before it is formatted for the HTML editor. + * Filters the text before it is formatted for the HTML editor. * * @since 2.5.0 * @deprecated 4.3.0 @@ -3604,7 +3605,7 @@ function wp_htmledit_pre($output) { * @return string|false */ function post_permalink( $post_id = 0 ) { - _deprecated_function( __FUNCTION__, '4.4', 'get_permalink()' ); + _deprecated_function( __FUNCTION__, '4.4.0', 'get_permalink()' ); return get_permalink( $post_id ); } @@ -3626,7 +3627,7 @@ function post_permalink( $post_id = 0 ) { * @return bool|string False on failure and string of headers if HEAD request. */ function wp_get_http( $url, $file_path = false, $red = 1 ) { - _deprecated_function( __FUNCTION__, '4.4', 'WP_Http' ); + _deprecated_function( __FUNCTION__, '4.4.0', 'WP_Http' ); @set_time_limit( 60 ); @@ -3680,7 +3681,7 @@ function wp_get_http( $url, $file_path = false, $red = 1 ) { * @return bool True if forced, false if not forced. */ function force_ssl_login( $force = null ) { - _deprecated_function( __FUNCTION__, '4.4', 'force_ssl_admin()' ); + _deprecated_function( __FUNCTION__, '4.4.0', 'force_ssl_admin()' ); return force_ssl_admin( $force ); } @@ -3693,7 +3694,7 @@ function force_ssl_login( $force = null ) { * @return string Full path to comments popup template file. */ function get_comments_popup_template() { - _deprecated_function( __FUNCTION__, '4.5' ); + _deprecated_function( __FUNCTION__, '4.5.0' ); return ''; } @@ -3707,7 +3708,7 @@ function get_comments_popup_template() { * @return bool */ function is_comments_popup() { - _deprecated_function( __FUNCTION__, '4.5' ); + _deprecated_function( __FUNCTION__, '4.5.0' ); return false; } @@ -3719,7 +3720,7 @@ function is_comments_popup() { * @deprecated 4.5.0 */ function comments_popup_script() { - _deprecated_function( __FUNCTION__, '4.5' ); + _deprecated_function( __FUNCTION__, '4.5.0' ); } /** @@ -3732,25 +3733,24 @@ function comments_popup_script() { * @return string Content that has filtered links. */ function popuplinks( $text ) { - _deprecated_function( __FUNCTION__, '4.5' ); + _deprecated_function( __FUNCTION__, '4.5.0' ); $text = preg_replace('//i', "", $text); return $text; } /** - * Returns the base URL of the uploads directory. - * Note: this function will be removed in 4.6. + * The Google Video embed handler callback. * - * @ignore - * @since 4.4.0 - * @access private - * @deprecated 4.5.0 Use wp_get_upload_dir() - * @see wp_get_upload_dir() + * Deprecated function that previously assisted in turning Google Video URLs + * into embeds but that service has since been shut down. + * + * @since 2.9.0 + * @deprecated 4.6.0 * - * @return string The base URL. + * @return string An empty string. */ -function _wp_upload_dir_baseurl() { - _deprecated_function( __FUNCTION__, '4.5', 'wp_get_upload_dir()' ); - $upload_dir = wp_get_upload_dir(); - return $upload_dir['baseurl']; +function wp_embed_handler_googlevideo( $matches, $attr, $url, $rawattr ) { + _deprecated_function( __FUNCTION__, '4.6.0' ); + + return ''; }