WordPress.org

Make WordPress Core

Ticket #7493: 7493-deprecated-docs.diff

File 7493-deprecated-docs.diff, 36.0 KB (added by nacin, 8 years ago)
  • wp-includes/deprecated.php

     
    8282 * Entire Post data.
    8383 *
    8484 * @since 0.71
     85 * @deprecated 1.5.1
    8586 * @deprecated Use get_post()
    8687 * @see get_post()
    8788 *
     
    8990 * @return array
    9091 */
    9192function get_postdata($postid) {
    92         _deprecated_function(__FUNCTION__, '0.0', 'get_post()');
     93        _deprecated_function(__FUNCTION__, '1.5.1', 'get_post()');
    9394
    9495        $post = &get_post($postid);
    9596
     
    118119 * Sets up the WordPress Loop.
    119120 *
    120121 * @since 1.0.1
    121  * @deprecated Since 1.5 - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop}
     122 * @deprecated 1.5
     123 * @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop}
    122124 */
    123125function start_wp() {
    124126        global $wp_query, $post;
     
    135137 * Return or Print Category ID.
    136138 *
    137139 * @since 0.71
     140 * @deprecated 0.71
    138141 * @deprecated use get_the_category()
    139142 * @see get_the_category()
    140143 *
     
    142145 * @return null|int
    143146 */
    144147function the_category_ID($echo = true) {
    145         _deprecated_function(__FUNCTION__, '0.0', 'get_the_category()');
     148        _deprecated_function(__FUNCTION__, '0.71', 'get_the_category()');
    146149
    147150        // Grab the first cat in the list.
    148151        $categories = get_the_category();
     
    158161 * Print category with optional text before and after.
    159162 *
    160163 * @since 0.71
     164 * @deprecated 0.71
    161165 * @deprecated use get_the_category_by_ID()
    162166 * @see get_the_category_by_ID()
    163167 *
     
    167171function the_category_head($before='', $after='') {
    168172        global $currentcat, $previouscat;
    169173
    170         _deprecated_function(__FUNCTION__, '0.0', 'get_the_category_by_ID()');
     174        _deprecated_function(__FUNCTION__, '0.71', 'get_the_category_by_ID()');
    171175
    172176        // Grab the first cat in the list.
    173177        $categories = get_the_category();
     
    184188 * Prints link to the previous post.
    185189 *
    186190 * @since 1.5
     191 * @deprecated 2.0
    187192 * @deprecated Use previous_post_link()
    188193 * @see previous_post_link()
    189194 *
     
    196201 */
    197202function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') {
    198203
    199         _deprecated_function(__FUNCTION__, '0.0', 'previous_post_link()');
     204        _deprecated_function(__FUNCTION__, '2.0', 'previous_post_link()');
    200205
    201206        if ( empty($in_same_cat) || 'no' == $in_same_cat )
    202207                $in_same_cat = false;
     
    220225 * Prints link to the next post.
    221226 *
    222227 * @since 0.71
     228 * @deprecated 2.0
    223229 * @deprecated Use next_post_link()
    224230 * @see next_post_link()
    225231 *
     
    231237 * @param string $excluded_categories
    232238 */
    233239function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') {
    234         _deprecated_function(__FUNCTION__, '0.0', 'next_post_link()');
     240        _deprecated_function(__FUNCTION__, '2.0', 'next_post_link()');
    235241
    236242        if ( empty($in_same_cat) || 'no' == $in_same_cat )
    237243                $in_same_cat = false;
     
    255261 * Whether user can create a post.
    256262 *
    257263 * @since 1.5
     264 * @deprecated 2.0
    258265 * @deprecated Use current_user_can()
    259266 * @see current_user_can()
    260267 *
     
    264271 * @return bool
    265272 */
    266273function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') {
    267         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     274        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    268275
    269276        $author_data = get_userdata($user_id);
    270277        return ($author_data->user_level > 1);
     
    274281 * Whether user can create a post.
    275282 *
    276283 * @since 1.5
     284 * @deprecated 2.0
    277285 * @deprecated Use current_user_can()
    278286 * @see current_user_can()
    279287 *
     
    283291 * @return bool
    284292 */
    285293function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {
    286         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     294        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    287295
    288296        $author_data = get_userdata($user_id);
    289297        return ($author_data->user_level >= 1);
     
    293301 * Whether user can edit a post.
    294302 *
    295303 * @since 1.5
     304 * @deprecated 2.0
    296305 * @deprecated Use current_user_can()
    297306 * @see current_user_can()
    298307 *
     
    302311 * @return bool
    303312 */
    304313function user_can_edit_post($user_id, $post_id, $blog_id = 1) {
    305         _deprecated_function(__FUNCTION__, '0', 'current_user_can()');
     314        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    306315
    307316        $author_data = get_userdata($user_id);
    308317        $post = get_post($post_id);
     
    321330 * Whether user can delete a post.
    322331 *
    323332 * @since 1.5
     333 * @deprecated 2.0
    324334 * @deprecated Use current_user_can()
    325335 * @see current_user_can()
    326336 *
     
    330340 * @return bool
    331341 */
    332342function user_can_delete_post($user_id, $post_id, $blog_id = 1) {
    333         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     343        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    334344
    335345        // right now if one can edit, one can delete
    336346        return user_can_edit_post($user_id, $post_id, $blog_id);
     
    340350 * Whether user can set new posts' dates.
    341351 *
    342352 * @since 1.5
     353 * @deprecated 2.0
    343354 * @deprecated Use current_user_can()
    344355 * @see current_user_can()
    345356 *
     
    349360 * @return bool
    350361 */
    351362function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') {
    352         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     363        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    353364
    354365        $author_data = get_userdata($user_id);
    355366        return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id));
     
    359370 * Whether user can delete a post.
    360371 *
    361372 * @since 1.5
     373 * @deprecated 2.0
    362374 * @deprecated Use current_user_can()
    363375 * @see current_user_can()
    364376 *
     
    368380 * @return bool returns true if $user_id can edit $post_id's date
    369381 */
    370382function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) {
    371         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     383        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    372384
    373385        $author_data = get_userdata($user_id);
    374386        return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id));
     
    378390 * Whether user can delete a post.
    379391 *
    380392 * @since 1.5
     393 * @deprecated 2.0
    381394 * @deprecated Use current_user_can()
    382395 * @see current_user_can()
    383396 *
     
    387400 * @return bool returns true if $user_id can edit $post_id's comments
    388401 */
    389402function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
    390         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     403        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    391404
    392405        // right now if one can edit a post, one can edit comments made on it
    393406        return user_can_edit_post($user_id, $post_id, $blog_id);
     
    397410 * Whether user can delete a post.
    398411 *
    399412 * @since 1.5
     413 * @deprecated 2.0
    400414 * @deprecated Use current_user_can()
    401415 * @see current_user_can()
    402416 *
     
    406420 * @return bool returns true if $user_id can delete $post_id's comments
    407421 */
    408422function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {
    409         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     423        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    410424
    411425        // right now if one can edit comments, one can delete comments
    412426        return user_can_edit_post_comments($user_id, $post_id, $blog_id);
     
    416430 * Can user can edit other user.
    417431 *
    418432 * @since 1.5
     433 * @deprecated 2.0
    419434 * @deprecated Use current_user_can()
    420435 * @see current_user_can()
    421436 *
     
    424439 * @return bool
    425440 */
    426441function user_can_edit_user($user_id, $other_user) {
    427         _deprecated_function(__FUNCTION__, '0.0', 'current_user_can()');
     442        _deprecated_function(__FUNCTION__, '2.0', 'current_user_can()');
    428443
    429444        $user  = get_userdata($user_id);
    430445        $other = get_userdata($other_user);
     
    438453 * Gets the links associated with category $cat_name.
    439454 *
    440455 * @since 0.71
    441  * @deprecated Use get_links()
    442  * @see get_links()
     456 * @deprecated 2.1
     457 * @deprecated Use get_bookmarks()
     458 * @see get_bookmarks()
    443459 *
    444460 * @param string $cat_name Optional. The category name to use. If no match is found uses all.
    445461 * @param string $before Optional. The html to output before the link.
     
    457473function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
    458474                                                 $show_description = true, $show_rating = false,
    459475                                                 $limit = -1, $show_updated = 0) {
    460         _deprecated_function(__FUNCTION__, '0.0', 'get_links()');
     476        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()');
    461477
    462478        $cat_id = -1;
    463479        $cat = get_term_by('name', $cat_name, 'link_category');
     
    471487 * Gets the links associated with the named category.
    472488 *
    473489 * @since 1.0.1
    474  * @deprecated Use wp_get_links()
    475  * @see wp_get_links()
     490 * @deprecated 2.1
     491 * @deprecated Use wp_list_bookmarks()
     492 * @see wp_list_bookmarks()
    476493 *
    477494 * @param string $category The category to use.
    478495 * @param string $args
    479496 * @return bool|null
    480497 */
    481498function wp_get_linksbyname($category, $args = '') {
    482         _deprecated_function(__FUNCTION__, '0.0', 'wp_get_links()');
     499        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()');
    483500
    484         $cat = get_term_by('name', $category, 'link_category');
    485         if ( !$cat )
    486                 return false;
    487         $cat_id = $cat->term_id;
     501        $defaults = array(
     502                'after' => '<br />',
     503                'before' => '',
     504                'categorize' => 0,
     505                'category_after' => '',
     506                'category_before' => '',
     507                'category_name' => $category,
     508                'show_description' => 1,
     509                'title_li' => '',
     510        );
    488511
    489         $args = add_query_arg('category', $cat_id, $args);
    490         wp_get_links($args);
     512        $r = wp_parse_args( $args, $defaults );
     513        return wp_list_bookmarks( $r );
    491514}
    492515
    493516/**
     
    501524 * </code>
    502525 *
    503526 * @since 1.0.1
    504  * @deprecated Use get_linkobjects()
    505  * @see get_linkobjects()
     527 * @deprecated 2.1
     528 * @deprecated Use get_bookmarks()
     529 * @see get_bookmarks()
    506530 *
    507531 * @param string $cat_name The category name to use. If no match is found uses all.
    508532 * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.
     
    512536 * @return unknown
    513537 */
    514538function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
    515         _deprecated_function(__FUNCTION__, '0.0', 'get_linkobjects()');
     539        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()');
    516540
    517541        $cat_id = -1;
    518542        $cat = get_term_by('name', $cat_name, 'link_category');
     
    553577 * </ol>
    554578 *
    555579 * @since 1.0.1
     580 * @deprecated 2.1
    556581 * @deprecated Use get_bookmarks()
    557582 * @see get_bookmarks()
    558583 *
     
    565590 * @return unknown
    566591 */
    567592function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
    568         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
     593        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()');
    569594
    570595        $links = get_bookmarks("category=$category&orderby=$orderby&limit=$limit");
    571596
     
    580605 * Gets the links associated with category 'cat_name' and display rating stars/chars.
    581606 *
    582607 * @since 0.71
     608 * @deprecated 2.1
    583609 * @deprecated Use get_bookmarks()
    584610 * @see get_bookmarks()
    585611 *
     
    598624 */
    599625function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
    600626                                                                        $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
    601         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
     627        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()');
    602628
    603629        get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
    604630}
     
    607633 * Gets the links associated with category n and display rating stars/chars.
    608634 *
    609635 * @since 0.71
     636 * @deprecated 2.1
    610637 * @deprecated Use get_bookmarks()
    611638 * @see get_bookmarks()
    612639 *
     
    625652 */
    626653function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
    627654                                                          $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
    628         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
     655        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()');
    629656
    630657        get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
    631658}
     
    640667 * @return int Only returns 0.
    641668 */
    642669function get_autotoggle($id = 0) {
    643         _deprecated_function(__FUNCTION__, '0.0' );
     670        _deprecated_function(__FUNCTION__, '2.1' );
    644671        return 0;
    645672}
    646673
    647674/**
    648675 * @since 0.71
     676 * @deprecated 2.1
    649677 * @deprecated Use wp_list_categories()
    650678 * @see wp_list_categories()
    651679 *
     
    672700function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,
    673701                                   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,
    674702                                   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
    675         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_categories()');
     703        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()');
    676704
    677705        $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',
    678706                'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');
     
    681709
    682710/**
    683711 * @since 1.2
     712 * @deprecated 2.1
    684713 * @deprecated Use wp_list_categories()
    685714 * @see wp_list_categories()
    686715 *
     
    688717 * @return unknown
    689718 */
    690719function wp_list_cats($args = '') {
    691         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_categories()');
     720        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()');
    692721
    693722        $r = wp_parse_args( $args );
    694723
     
    730759function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',
    731760                $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,
    732761                $selected = 0, $exclude = 0) {
    733         _deprecated_function(__FUNCTION__, '0.0', 'wp_dropdown_categories()');
     762        _deprecated_function(__FUNCTION__, '2.1', 'wp_dropdown_categories()');
    734763
    735764        $show_option_all = '';
    736765        if ( $optionall )
     
    748777
    749778/**
    750779 * @since 2.1
     780 * @deprecated 2.1
    751781 * @deprecated Use wp_tiny_mce().
    752782 * @see wp_tiny_mce()
    753783 */
    754784function tinymce_include() {
    755         _deprecated_function(__FUNCTION__, '0.0', 'wp_tiny_mce()');
     785        _deprecated_function(__FUNCTION__, '2.1', 'wp_tiny_mce()');
    756786
    757787        wp_tiny_mce();
    758788}
    759789
    760790/**
    761791 * @since 1.2
     792 * @deprecated 2.1
    762793 * @deprecated Use wp_list_authors()
    763794 * @see wp_list_authors()
    764795 *
     
    771802 * @return unknown
    772803 */
    773804function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') {
    774         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_authors()');
     805        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_authors()');
    775806
    776807        $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image');
    777808        return wp_list_authors($args);
     
    779810
    780811/**
    781812 * @since 1.0.1
     813 * @deprecated 2.1
    782814 * @deprecated Use wp_get_post_categories()
    783815 * @see wp_get_post_categories()
    784816 *
     
    787819 * @return unknown
    788820 */
    789821function wp_get_post_cats($blogid = '1', $post_ID = 0) {
    790         _deprecated_function(__FUNCTION__, '0.0', 'wp_get_post_categories()');
     822        _deprecated_function(__FUNCTION__, '2.1', 'wp_get_post_categories()');
    791823        return wp_get_post_categories($post_ID);
    792824}
    793825
     
    795827 * Sets the categories that the post id belongs to.
    796828 *
    797829 * @since 1.0.1
     830 * @deprecated 2.1
    798831 * @deprecated Use wp_set_post_categories()
    799832 * @see wp_set_post_categories()
    800833 *
     
    804837 * @return unknown
    805838 */
    806839function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) {
    807         _deprecated_function(__FUNCTION__, '0.0', 'wp_set_post_categories()');
     840        _deprecated_function(__FUNCTION__, '2.1', 'wp_set_post_categories()');
    808841        return wp_set_post_categories($post_ID, $post_categories);
    809842}
    810843
    811844/**
    812845 * @since 0.71
     846 * @deprecated 2.1
    813847 * @deprecated Use wp_get_archives()
    814848 * @see wp_get_archives()
    815849 *
     
    822856 * @return unknown
    823857 */
    824858function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) {
    825         _deprecated_function(__FUNCTION__, '0.0', 'wp_get_archives()');
     859        _deprecated_function(__FUNCTION__, '2.1', 'wp_get_archives()');
    826860        $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count');
    827861        return wp_get_archives($args);
    828862}
     
    831865 * Returns or Prints link to the author's posts.
    832866 *
    833867 * @since 1.2
     868 * @deprecated 2.1
    834869 * @deprecated Use get_author_posts_url()
    835870 * @see get_author_posts_url()
    836871 *
     
    840875 * @return string|null
    841876 */
    842877function get_author_link($echo = false, $author_id, $author_nicename = '') {
    843         _deprecated_function(__FUNCTION__, '0.0', 'get_author_posts_url()');
     878        _deprecated_function(__FUNCTION__, '2.1', 'get_author_posts_url()');
    844879
    845880        $link = get_author_posts_url($author_id, $author_nicename);
    846881
     
    853888 * Print list of pages based on arguments.
    854889 *
    855890 * @since 0.71
     891 * @deprecated 2.1
    856892 * @deprecated Use wp_link_pages()
    857893 * @see wp_link_pages()
    858894 *
     
    867903 */
    868904function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',
    869905                                        $pagelink='%', $more_file='') {
    870         _deprecated_function(__FUNCTION__, '0.0', 'wp_link_pages()');
     906        _deprecated_function(__FUNCTION__, '2.1', 'wp_link_pages()');
    871907
    872908        $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');
    873909        return wp_link_pages($args);
     
    877913 * Get value based on option.
    878914 *
    879915 * @since 0.71
     916 * @deprecated 2.1
    880917 * @deprecated Use get_option()
    881918 * @see get_option()
    882919 *
     
    884921 * @return string
    885922 */
    886923function get_settings($option) {
    887         _deprecated_function(__FUNCTION__, '0.0', 'get_option()');
     924        _deprecated_function(__FUNCTION__, '2.1', 'get_option()');
    888925
    889926        return get_option($option);
    890927}
     
    893930 * Print the permalink of the current post in the loop.
    894931 *
    895932 * @since 0.71
     933 * @deprecated 1.2
    896934 * @deprecated Use the_permalink()
    897935 * @see the_permalink()
    898936 */
    899937function permalink_link() {
    900         _deprecated_function(__FUNCTION__, '0.0', 'the_permalink()');
     938        _deprecated_function(__FUNCTION__, '1.2', 'the_permalink()');
    901939        the_permalink();
    902940}
    903941
     
    905943 * Print the permalink to the RSS feed.
    906944 *
    907945 * @since 0.71
     946 * @deprecated 2.3
    908947 * @deprecated Use the_permalink_rss()
    909948 * @see the_permalink_rss()
    910949 *
    911950 * @param string $file
    912951 */
    913952function permalink_single_rss($deprecated = '') {
    914         _deprecated_function(__FUNCTION__, '0.0', 'the_permalink_rss()');
     953        _deprecated_function(__FUNCTION__, '2.3', 'the_permalink_rss()');
    915954        the_permalink_rss();
    916955}
    917956
    918957/**
    919958 * Gets the links associated with category.
    920959 *
    921  * @see get_links() for argument information that can be used in $args
    922960 * @since 1.0.1
    923  * @deprecated Use get_bookmarks()
    924  * @see get_bookmarks()
     961 * @deprecated 2.1
     962 * @deprecated Use wp_list_bookmarks()
     963 * @see wp_list_bookmarks()
    925964 *
    926965 * @param string $args a query string
    927966 * @return null|string
    928967 */
    929968function wp_get_links($args = '') {
    930         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
     969        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()');
    931970
    932971        if ( strpos( $args, '=' ) === false ) {
    933972                $cat_id = $args;
     
    935974        }
    936975
    937976        $defaults = array(
    938                 'category' => -1, 'before' => '',
    939                 'after' => '<br />', 'between' => ' ',
    940                 'show_images' => true, 'orderby' => 'name',
    941                 'show_description' => true, 'show_rating' => false,
    942                 'limit' => -1, 'show_updated' => true,
    943                 'echo' => true
     977                'after' => '<br />',
     978                'before' => '',
     979                'between' => ' ',
     980                'categorize' => 0,
     981                'category' => '',
     982                'echo' => true,
     983                'limit' => -1,
     984                'orderby' => 'name',
     985                'show_description' => true,
     986                'show_images' => true,
     987                'show_rating' => false,
     988                'show_updated' => true,
     989                'title_li' => '',
    944990        );
    945991
    946992        $r = wp_parse_args( $args, $defaults );
    947         extract( $r, EXTR_SKIP );
    948993
    949         return get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated, $echo);
     994        return wp_list_bookmarks( $r );
    950995}
    951996
    952997/**
    953998 * Gets the links associated with category by id.
    954999 *
    9551000 * @since 0.71
     1001 * @deprecated 2.1
    9561002 * @deprecated Use get_bookmarks()
    9571003 * @see get_bookmarks()
    9581004 *
     
    9751021 */
    9761022function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
    9771023                        $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {
    978         _deprecated_function(__FUNCTION__, '0.0', 'get_bookmarks()');
     1024        _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()');
    9791025
    9801026        $order = 'ASC';
    9811027        if ( substr($orderby, 0, 1) == '_' ) {
     
    10621108 *
    10631109 * @author Dougal
    10641110 * @since 1.0.1
     1111 * @deprecated 2.1
    10651112 * @deprecated Use wp_list_bookmarks()
    10661113 * @see wp_list_bookmarks()
    10671114 *
     
    10691116 * @param string $$deprecated Not Used
    10701117 */
    10711118function get_links_list($order = 'name', $deprecated = '') {
    1072         _deprecated_function(__FUNCTION__, '0.0', 'wp_list_bookmarks()');
     1119        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()');
    10731120
    10741121        $order = strtolower($order);
    10751122
     
    11081155 * @link http://sprite.csr.unibo.it/fullo/
    11091156 *
    11101157 * @since 0.71
     1158 * @deprecated 2.1
    11111159 * @deprecated {@internal Use function instead is unknown}}
    11121160 *
    11131161 * @param string $text the text of the link
     
    11171165 * @param bool $count the number of links in the db
    11181166 */
    11191167function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) {
    1120         _deprecated_function(__FUNCTION__, '0.0' );
     1168        _deprecated_function(__FUNCTION__, '2.1' );
    11211169
    11221170        if ( $count )
    11231171                $counts = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->links");
     
    11341182
    11351183/**
    11361184 * @since 1.0.1
     1185 * @deprecated 2.1
    11371186 * @deprecated Use sanitize_bookmark_field()
    11381187 * @see sanitize_bookmark_field()
    11391188 *
     
    11411190 * @return unknown
    11421191 */
    11431192function get_linkrating($link) {
    1144         _deprecated_function(__FUNCTION__, '0.0', 'sanitize_bookmark_field()');
     1193        _deprecated_function(__FUNCTION__, '2.1', 'sanitize_bookmark_field()');
    11451194        return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
    11461195}
    11471196
     
    11491198 * Gets the name of category by id.
    11501199 *
    11511200 * @since 0.71
     1201 * @deprecated 2.1
    11521202 * @deprecated Use get_category()
    11531203 * @see get_category()
    11541204 *
     
    11561206 * @return string
    11571207 */
    11581208function get_linkcatname($id = 0) {
    1159         _deprecated_function(__FUNCTION__, '0.0', 'get_category()');
     1209        _deprecated_function(__FUNCTION__, '2.1', 'get_category()');
    11601210
    11611211        $id = (int) $id;
    11621212
     
    11781228 * Print RSS comment feed link.
    11791229 *
    11801230 * @since 1.0.1
     1231 * @deprecated 2.5
    11811232 * @deprecated Use post_comments_feed_link()
    11821233 * @see post_comments_feed_link()
    11831234 *
     
    11851236 * @param string $deprecated Not used
    11861237 */
    11871238function comments_rss_link($link_text = 'Comments RSS', $deprecated = '') {
    1188         _deprecated_function(__FUNCTION__, '0.0', 'post_comments_feed_link()');
     1239        _deprecated_function(__FUNCTION__, '2.5', 'post_comments_feed_link()');
    11891240        post_comments_feed_link($link_text);
    11901241}
    11911242
     
    11931244 * Print/Return link to category RSS2 feed.
    11941245 *
    11951246 * @since 1.2
     1247 * @deprecated 2.5
    11961248 * @deprecated Use get_category_feed_link()
    11971249 * @see get_category_feed_link()
    11981250 *
     
    12021254 * @return string|null
    12031255 */
    12041256function get_category_rss_link($echo = false, $cat_ID = 1, $deprecated = '') {
    1205         _deprecated_function(__FUNCTION__, '0.0', 'get_category_feed_link()');
     1257        _deprecated_function(__FUNCTION__, '2.5', 'get_category_feed_link()');
    12061258
    12071259        $link = get_category_feed_link($cat_ID, 'rss2');
    12081260
     
    12151267 * Print/Return link to author RSS feed.
    12161268 *
    12171269 * @since 1.2
     1270 * @deprecated 2.5
    12181271 * @deprecated Use get_author_feed_link()
    12191272 * @see get_author_feed_link()
    12201273 *
     
    12241277 * @return string|null
    12251278 */
    12261279function get_author_rss_link($echo = false, $author_id = 1, $deprecated = '') {
    1227         _deprecated_function(__FUNCTION__, '0.0', 'get_author_feed_link()');
     1280        _deprecated_function(__FUNCTION__, '2.5', 'get_author_feed_link()');
    12281281
    12291282        $link = get_author_feed_link($author_id);
    12301283        if ( $echo )
     
    12361289 * Return link to the post RSS feed.
    12371290 *
    12381291 * @since 1.5
     1292 * @deprecated 2.2
    12391293 * @deprecated Use get_post_comments_feed_link()
    12401294 * @see get_post_comments_feed_link()
    12411295 *
     
    12501304/**
    12511305 * An alias of wp_create_user().
    12521306 *
     1307 * @since 2.0
     1308 * @deprecated 2.0
     1309 * @deprecated Use wp_create_user()
     1310 * @see wp_create_user()
     1311 *
    12531312 * @param string $username The user's username.
    12541313 * @param string $password The user's password.
    12551314 * @param string $email The user's email (optional).
    12561315 * @return int The new user's ID.
    1257  * @deprecated Use wp_create_user()
    1258  * @see wp_create_user()
    12591316 */
    12601317function create_user($username, $password, $email) {
    12611318        _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' );
     
    12661323 * Unused Admin function.
    12671324 *
    12681325 * @since 2.0
     1326 * @deprecated 2.5
     1327 *
    12691328 * @param string $deprecated Unknown
    1270  * @deprecated 2.5
    12711329 */
    12721330function documentation_link( $deprecated = '' ) {
    12731331        _deprecated_function( __FUNCTION__, '2.5', '' );
     
    12861344/**
    12871345 * Retrieve an array of comment data about comment $comment_ID.
    12881346 *
     1347 * @since 0.71
     1348 * @deprecated 2.7
    12891349 * @deprecated Use get_comment()
    12901350 * @see get_comment()
    1291  * @since 0.71
    12921351 *
    1293  * @uses $id
    1294  * @uses $wpdb Database Object
    1295  *
    12961352 * @param int $comment_ID The ID of the comment
    12971353 * @param int $no_cache Whether to use the cache or not (casted to bool)
    12981354 * @param bool $include_unapproved Whether to include unapproved comments or not
     
    13071363 * Retrieve the category name by the category ID.
    13081364 *
    13091365 * @since 0.71
     1366 * @deprecated 2.8
    13101367 * @deprecated Use get_cat_name()
    1311  * @see get_cat_name() get_catname() is deprecated in favor of get_cat_name().
     1368 * @see get_cat_name()
    13121369 *
    13131370 * @param int $cat_ID Category ID
    13141371 * @return string category name
     
    13221379 * Retrieve category children list separated before and after the term IDs.
    13231380 *
    13241381 * @since 1.2.0
     1382 * @deprecated 2.8
     1383 * @deprecated Use get_term_children()
     1384 * @see get_term_children()
    13251385 *
    13261386 * @param int $id Category ID to retrieve children.
    13271387 * @param string $before Optional. Prepend before category term ID.
     
    13581418 *
    13591419 * @since 1.5
    13601420 * @deprecated 2.8
    1361  * @uses $authordata The current author's DB object.
     1421 * @deprecated Use the_author_meta('description')
     1422 * @see get_the_author_meta()
     1423 *
    13621424 * @return string The author's description.
    1363  * @deprecated Use the_author_meta('description')
    13641425 */
    13651426function get_the_author_description() {
    13661427        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' );
     
    13701431/**
    13711432 * Display the description of the author of the current post.
    13721433 *
    1373  * @link http://codex.wordpress.org/Template_Tags/the_author_description
    13741434 * @since 1.0.0
    13751435 * @deprecated 2.8
    13761436 * @deprecated Use the_author_meta('description')
     1437 * @see the_author_meta()
    13771438 */
    13781439function the_author_description() {
    13791440        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'description\')' );
     
    13851446 *
    13861447 * @since 1.5
    13871448 * @deprecated 2.8
    1388  * @uses $authordata The current author's DB object.
     1449 * @deprecated Use the_author_meta('login')
     1450 * @see get_the_author_meta()
     1451 *
    13891452 * @return string The author's login name (username).
    1390  * @deprecated Use the_author_meta('login')
    13911453 */
    13921454function get_the_author_login() {
    13931455        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' );
     
    13971459/**
    13981460 * Display the login name of the author of the current post.
    13991461 *
    1400  * @link http://codex.wordpress.org/Template_Tags/the_author_login
    14011462 * @since 0.71
    14021463 * @deprecated 2.8
    14031464 * @deprecated Use the_author_meta('login')
     1465 * @see the_author_meta()
    14041466 */
    14051467function the_author_login() {
    14061468        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'login\')' );
     
    14121474 *
    14131475 * @since 1.5
    14141476 * @deprecated 2.8
    1415  * @uses $authordata The current author's DB object.
     1477 * @deprecated Use the_author_meta('first_name')
     1478 * @see get_the_author_meta()
     1479 *
    14161480 * @return string The author's first name.
    1417  * @deprecated Use the_author_meta('first_name')
    14181481 */
    14191482function get_the_author_firstname() {
    14201483        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' );
     
    14241487/**
    14251488 * Display the first name of the author of the current post.
    14261489 *
    1427  * @link http://codex.wordpress.org/Template_Tags/the_author_firstname
    14281490 * @since 0.71
    14291491 * @deprecated 2.8
    14301492 * @deprecated Use the_author_meta('first_name')
     1493 * @see the_author_meta()
    14311494 */
    14321495function the_author_firstname() {
    14331496        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' );
     
    14391502 *
    14401503 * @since 1.5
    14411504 * @deprecated 2.8
    1442  * @uses $authordata The current author's DB object.
     1505 * @deprecated Use get_the_author_meta('last_name')
     1506 * @see get_the_author_meta()
     1507 *
    14431508 * @return string The author's last name.
    1444  * @deprecated Use the_author_meta('last_name')
    14451509 */
    14461510function get_the_author_lastname() {
    14471511        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' );
     
    14511515/**
    14521516 * Display the last name of the author of the current post.
    14531517 *
    1454  * @link http://codex.wordpress.org/Template_Tags/the_author_lastname
    14551518 * @since 0.71
    14561519 * @deprecated 2.8
    14571520 * @deprecated Use the_author_meta('last_name')
     1521 * @see the_author_meta()
    14581522 */
    14591523function the_author_lastname() {
    14601524        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' );
     
    14661530 *
    14671531 * @since 1.5
    14681532 * @deprecated 2.8
    1469  * @uses $authordata The current author's DB object.
     1533 * @deprecated Use get_the_author_meta('nickname')
     1534 * @see get_the_author_meta()
     1535 *
    14701536 * @return string The author's nickname.
    1471  * @deprecated Use the_author_meta('nickname')
    14721537 */
    14731538function get_the_author_nickname() {
    14741539        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' );
     
    14781543/**
    14791544 * Display the nickname of the author of the current post.
    14801545 *
    1481  * @link http://codex.wordpress.org/Template_Tags/the_author_nickname
    14821546 * @since 0.71
    14831547 * @deprecated 2.8
    14841548 * @deprecated Use the_author_meta('nickname')
     1549 * @see the_author_meta()
    14851550 */
    14861551function the_author_nickname() {
    14871552        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' );
     
    14931558 *
    14941559 * @since 1.5
    14951560 * @deprecated 2.8
    1496  * @uses $authordata The current author's DB object.
     1561 * @deprecated Use get_the_author_meta('email')
     1562 * @see get_the_author_meta()
     1563 *
    14971564 * @return string The author's username.
    1498  * @deprecated Use the_author_meta('email')
    14991565 */
    15001566function get_the_author_email() {
    15011567        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' );
     
    15051571/**
    15061572 * Display the email of the author of the current post.
    15071573 *
    1508  * @link http://codex.wordpress.org/Template_Tags/the_author_email
    15091574 * @since 0.71
    15101575 * @deprecated 2.8
    15111576 * @deprecated Use the_author_meta('email')
     1577 * @see the_author_meta()
    15121578 */
    15131579function the_author_email() {
    15141580        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'email\')' );
     
    15201586 *
    15211587 * @since 1.5
    15221588 * @deprecated 2.8
    1523  * @uses $authordata The current author's DB object.
     1589 * @deprecated Use get_the_author_meta('icq')
     1590 * @see get_the_author_meta()
     1591 *
    15241592 * @return string The author's ICQ number.
    1525  * @deprecated Use the_author_meta('icq')
    15261593 */
    15271594function get_the_author_icq() {
    15281595        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' );
     
    15321599/**
    15331600 * Display the ICQ number of the author of the current post.
    15341601 *
    1535  * @link http://codex.wordpress.org/Template_Tags/the_author_icq
    15361602 * @since 0.71
    15371603 * @deprecated 2.8
    1538  * @see get_the_author_icq()
    15391604 * @deprecated Use the_author_meta('icq')
     1605 * @see the_author_meta()
    15401606 */
    15411607function the_author_icq() {
    15421608        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'icq\')' );
     
    15481614 *
    15491615 * @since 1.5
    15501616 * @deprecated 2.8
    1551  * @uses $authordata The current author's DB object.
     1617 * @deprecated Use get_the_author_meta('yim')
     1618 * @see get_the_author_meta()
     1619 *
    15521620 * @return string The author's Yahoo! IM name.
    1553  * @deprecated Use the_author_meta('yim')
    15541621 */
    15551622function get_the_author_yim() {
    15561623        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' );
     
    15601627/**
    15611628 * Display the Yahoo! IM name of the author of the current post.
    15621629 *
    1563  * @link http://codex.wordpress.org/Template_Tags/the_author_yim
    15641630 * @since 0.71
    15651631 * @deprecated 2.8
    15661632 * @deprecated Use the_author_meta('yim')
     1633 * @see the_author_meta()
    15671634 */
    15681635function the_author_yim() {
    15691636        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'yim\')' );
     
    15751642 *
    15761643 * @since 1.5
    15771644 * @deprecated 2.8
    1578  * @uses $authordata The current author's DB object.
     1645 * @deprecated Use get_the_author_meta('msn')
     1646 * @see get_the_author_meta()
     1647 *
    15791648 * @return string The author's MSN address.
    1580  * @deprecated Use the_author_meta('msn')
    15811649 */
    15821650function get_the_author_msn() {
    15831651        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' );
     
    15871655/**
    15881656 * Display the MSN address of the author of the current post.
    15891657 *
    1590  * @link http://codex.wordpress.org/Template_Tags/the_author_msn
    15911658 * @since 0.71
    15921659 * @deprecated 2.8
    1593  * @see get_the_author_msn()
    15941660 * @deprecated Use the_author_meta('msn')
     1661 * @see the_author_meta()
    15951662 */
    15961663function the_author_msn() {
    15971664        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'msn\')' );
     
    16031670 *
    16041671 * @since 1.5
    16051672 * @deprecated 2.8
    1606  * @uses $authordata The current author's DB object.
     1673 * @deprecated Use get_the_author_meta('aim')
     1674 * @see get_the_author_meta()
     1675 *
    16071676 * @return string The author's AIM address.
    1608  * @deprecated Use the_author_meta('aim')
    16091677 */
    16101678function get_the_author_aim() {
    16111679        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' );
     
    16151683/**
    16161684 * Display the AIM address of the author of the current post.
    16171685 *
    1618  * @link http://codex.wordpress.org/Template_Tags/the_author_aim
    16191686 * @since 0.71
     1687 * @see the_author_meta()
    16201688 * @deprecated 2.8
    1621  * @see get_the_author_aim()
    16221689 * @deprecated Use the_author_meta('aim')
    16231690 */
    16241691function the_author_aim() {
     
    16311698 *
    16321699 * @since 1.0.0
    16331700 * @deprecated 2.8
     1701 * @deprecated Use get_the_author_meta('display_name')
     1702 * @see get_the_author_meta()
     1703 *
    16341704 * @param int $auth_id The ID of the author.
    16351705 * @return string The author's display name.
    1636  * @deprecated Use the_author_meta('display_name')
    16371706 */
    16381707function get_author_name( $auth_id = false ) {
    16391708        _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' );
     
    16451714 *
    16461715 * @since 1.5
    16471716 * @deprecated 2.8
    1648  * @uses $authordata The current author's DB object.
     1717 * @deprecated Use get_the_author_meta('url')
     1718 * @see get_the_author_meta()
     1719 *
    16491720 * @return string The URL to the author's page.
    16501721 */
    16511722function get_the_author_url() {
     
    16561727/**
    16571728 * Display the URL to the home page of the author of the current post.
    16581729 *
    1659  * @link http://codex.wordpress.org/Template_Tags/the_author_url
    16601730 * @since 0.71
    16611731 * @deprecated 2.8
     1732 * @deprecated Use the_author_meta('url')
     1733 * @see the_author_meta()
    16621734 */
    16631735function the_author_url() {
    16641736        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'url\')' );
     
    16701742 *
    16711743 * @since 1.5
    16721744 * @deprecated 2.8
     1745 * @deprecated Use get_the_author_meta('ID')
     1746 * @see get_the_author_meta()
     1747 *
    16731748 * @return int The author's ID.
    16741749 */
    16751750function get_the_author_ID() {
     
    16801755/**
    16811756 * Display the ID of the author of the current post.
    16821757 *
    1683  * @link http://codex.wordpress.org/Template_Tags/the_author_ID
    16841758 * @since 0.71
    16851759 * @deprecated 2.8
    1686  * @uses get_the_author_ID()
     1760 * @deprecated Use the_author_meta('ID')
     1761 * @see the_author_meta()
    16871762*/
    16881763function the_author_ID() {
    16891764        _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'ID\')' );
     
    17151790 *              parameters.
    17161791 *
    17171792 * @deprecated 2.9.0
     1793 * @deprecated Use the_content_feed()
     1794 * @see the_content_feed()
    17181795 *
    17191796 * @param string $more_link_text Optional. Text to display when more content is available but not displayed.
    17201797 * @param int|bool $stripteaser Optional. Default is 0.
     
    18011878 *
    18021879 * @since 2.2.0
    18031880 * @deprecated 2.9.0
     1881 * @deprecated Use _x()
     1882 * @see _x()
    18041883 *
    18051884 * @param string $text Text to translate
    18061885 * @param string $domain Optional. Domain to retrieve the translated text