Ticket #7493: 7493-deprecated-docs.diff
| File 7493-deprecated-docs.diff, 36.0 KB (added by nacin, 4 years ago) |
|---|
-
wp-includes/deprecated.php
82 82 * Entire Post data. 83 83 * 84 84 * @since 0.71 85 * @deprecated 1.5.1 85 86 * @deprecated Use get_post() 86 87 * @see get_post() 87 88 * … … 89 90 * @return array 90 91 */ 91 92 function get_postdata($postid) { 92 _deprecated_function(__FUNCTION__, ' 0.0', 'get_post()');93 _deprecated_function(__FUNCTION__, '1.5.1', 'get_post()'); 93 94 94 95 $post = &get_post($postid); 95 96 … … 118 119 * Sets up the WordPress Loop. 119 120 * 120 121 * @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} 122 124 */ 123 125 function start_wp() { 124 126 global $wp_query, $post; … … 135 137 * Return or Print Category ID. 136 138 * 137 139 * @since 0.71 140 * @deprecated 0.71 138 141 * @deprecated use get_the_category() 139 142 * @see get_the_category() 140 143 * … … 142 145 * @return null|int 143 146 */ 144 147 function the_category_ID($echo = true) { 145 _deprecated_function(__FUNCTION__, '0. 0', 'get_the_category()');148 _deprecated_function(__FUNCTION__, '0.71', 'get_the_category()'); 146 149 147 150 // Grab the first cat in the list. 148 151 $categories = get_the_category(); … … 158 161 * Print category with optional text before and after. 159 162 * 160 163 * @since 0.71 164 * @deprecated 0.71 161 165 * @deprecated use get_the_category_by_ID() 162 166 * @see get_the_category_by_ID() 163 167 * … … 167 171 function the_category_head($before='', $after='') { 168 172 global $currentcat, $previouscat; 169 173 170 _deprecated_function(__FUNCTION__, '0. 0', 'get_the_category_by_ID()');174 _deprecated_function(__FUNCTION__, '0.71', 'get_the_category_by_ID()'); 171 175 172 176 // Grab the first cat in the list. 173 177 $categories = get_the_category(); … … 184 188 * Prints link to the previous post. 185 189 * 186 190 * @since 1.5 191 * @deprecated 2.0 187 192 * @deprecated Use previous_post_link() 188 193 * @see previous_post_link() 189 194 * … … 196 201 */ 197 202 function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') { 198 203 199 _deprecated_function(__FUNCTION__, ' 0.0', 'previous_post_link()');204 _deprecated_function(__FUNCTION__, '2.0', 'previous_post_link()'); 200 205 201 206 if ( empty($in_same_cat) || 'no' == $in_same_cat ) 202 207 $in_same_cat = false; … … 220 225 * Prints link to the next post. 221 226 * 222 227 * @since 0.71 228 * @deprecated 2.0 223 229 * @deprecated Use next_post_link() 224 230 * @see next_post_link() 225 231 * … … 231 237 * @param string $excluded_categories 232 238 */ 233 239 function 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()'); 235 241 236 242 if ( empty($in_same_cat) || 'no' == $in_same_cat ) 237 243 $in_same_cat = false; … … 255 261 * Whether user can create a post. 256 262 * 257 263 * @since 1.5 264 * @deprecated 2.0 258 265 * @deprecated Use current_user_can() 259 266 * @see current_user_can() 260 267 * … … 264 271 * @return bool 265 272 */ 266 273 function 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()'); 268 275 269 276 $author_data = get_userdata($user_id); 270 277 return ($author_data->user_level > 1); … … 274 281 * Whether user can create a post. 275 282 * 276 283 * @since 1.5 284 * @deprecated 2.0 277 285 * @deprecated Use current_user_can() 278 286 * @see current_user_can() 279 287 * … … 283 291 * @return bool 284 292 */ 285 293 function 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()'); 287 295 288 296 $author_data = get_userdata($user_id); 289 297 return ($author_data->user_level >= 1); … … 293 301 * Whether user can edit a post. 294 302 * 295 303 * @since 1.5 304 * @deprecated 2.0 296 305 * @deprecated Use current_user_can() 297 306 * @see current_user_can() 298 307 * … … 302 311 * @return bool 303 312 */ 304 313 function 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()'); 306 315 307 316 $author_data = get_userdata($user_id); 308 317 $post = get_post($post_id); … … 321 330 * Whether user can delete a post. 322 331 * 323 332 * @since 1.5 333 * @deprecated 2.0 324 334 * @deprecated Use current_user_can() 325 335 * @see current_user_can() 326 336 * … … 330 340 * @return bool 331 341 */ 332 342 function 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()'); 334 344 335 345 // right now if one can edit, one can delete 336 346 return user_can_edit_post($user_id, $post_id, $blog_id); … … 340 350 * Whether user can set new posts' dates. 341 351 * 342 352 * @since 1.5 353 * @deprecated 2.0 343 354 * @deprecated Use current_user_can() 344 355 * @see current_user_can() 345 356 * … … 349 360 * @return bool 350 361 */ 351 362 function 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()'); 353 364 354 365 $author_data = get_userdata($user_id); 355 366 return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id)); … … 359 370 * Whether user can delete a post. 360 371 * 361 372 * @since 1.5 373 * @deprecated 2.0 362 374 * @deprecated Use current_user_can() 363 375 * @see current_user_can() 364 376 * … … 368 380 * @return bool returns true if $user_id can edit $post_id's date 369 381 */ 370 382 function 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()'); 372 384 373 385 $author_data = get_userdata($user_id); 374 386 return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id)); … … 378 390 * Whether user can delete a post. 379 391 * 380 392 * @since 1.5 393 * @deprecated 2.0 381 394 * @deprecated Use current_user_can() 382 395 * @see current_user_can() 383 396 * … … 387 400 * @return bool returns true if $user_id can edit $post_id's comments 388 401 */ 389 402 function 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()'); 391 404 392 405 // right now if one can edit a post, one can edit comments made on it 393 406 return user_can_edit_post($user_id, $post_id, $blog_id); … … 397 410 * Whether user can delete a post. 398 411 * 399 412 * @since 1.5 413 * @deprecated 2.0 400 414 * @deprecated Use current_user_can() 401 415 * @see current_user_can() 402 416 * … … 406 420 * @return bool returns true if $user_id can delete $post_id's comments 407 421 */ 408 422 function 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()'); 410 424 411 425 // right now if one can edit comments, one can delete comments 412 426 return user_can_edit_post_comments($user_id, $post_id, $blog_id); … … 416 430 * Can user can edit other user. 417 431 * 418 432 * @since 1.5 433 * @deprecated 2.0 419 434 * @deprecated Use current_user_can() 420 435 * @see current_user_can() 421 436 * … … 424 439 * @return bool 425 440 */ 426 441 function 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()'); 428 443 429 444 $user = get_userdata($user_id); 430 445 $other = get_userdata($other_user); … … 438 453 * Gets the links associated with category $cat_name. 439 454 * 440 455 * @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() 443 459 * 444 460 * @param string $cat_name Optional. The category name to use. If no match is found uses all. 445 461 * @param string $before Optional. The html to output before the link. … … 457 473 function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id', 458 474 $show_description = true, $show_rating = false, 459 475 $limit = -1, $show_updated = 0) { 460 _deprecated_function(__FUNCTION__, ' 0.0', 'get_links()');476 _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 461 477 462 478 $cat_id = -1; 463 479 $cat = get_term_by('name', $cat_name, 'link_category'); … … 471 487 * Gets the links associated with the named category. 472 488 * 473 489 * @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() 476 493 * 477 494 * @param string $category The category to use. 478 495 * @param string $args 479 496 * @return bool|null 480 497 */ 481 498 function wp_get_linksbyname($category, $args = '') { 482 _deprecated_function(__FUNCTION__, ' 0.0', 'wp_get_links()');499 _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()'); 483 500 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 ); 488 511 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 ); 491 514 } 492 515 493 516 /** … … 501 524 * </code> 502 525 * 503 526 * @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() 506 530 * 507 531 * @param string $cat_name The category name to use. If no match is found uses all. 508 532 * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'. … … 512 536 * @return unknown 513 537 */ 514 538 function 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()'); 516 540 517 541 $cat_id = -1; 518 542 $cat = get_term_by('name', $cat_name, 'link_category'); … … 553 577 * </ol> 554 578 * 555 579 * @since 1.0.1 580 * @deprecated 2.1 556 581 * @deprecated Use get_bookmarks() 557 582 * @see get_bookmarks() 558 583 * … … 565 590 * @return unknown 566 591 */ 567 592 function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { 568 _deprecated_function(__FUNCTION__, ' 0.0', 'get_bookmarks()');593 _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()'); 569 594 570 595 $links = get_bookmarks("category=$category&orderby=$orderby&limit=$limit"); 571 596 … … 580 605 * Gets the links associated with category 'cat_name' and display rating stars/chars. 581 606 * 582 607 * @since 0.71 608 * @deprecated 2.1 583 609 * @deprecated Use get_bookmarks() 584 610 * @see get_bookmarks() 585 611 * … … 598 624 */ 599 625 function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ", 600 626 $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()'); 602 628 603 629 get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); 604 630 } … … 607 633 * Gets the links associated with category n and display rating stars/chars. 608 634 * 609 635 * @since 0.71 636 * @deprecated 2.1 610 637 * @deprecated Use get_bookmarks() 611 638 * @see get_bookmarks() 612 639 * … … 625 652 */ 626 653 function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true, 627 654 $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()'); 629 656 630 657 get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); 631 658 } … … 640 667 * @return int Only returns 0. 641 668 */ 642 669 function get_autotoggle($id = 0) { 643 _deprecated_function(__FUNCTION__, ' 0.0' );670 _deprecated_function(__FUNCTION__, '2.1' ); 644 671 return 0; 645 672 } 646 673 647 674 /** 648 675 * @since 0.71 676 * @deprecated 2.1 649 677 * @deprecated Use wp_list_categories() 650 678 * @see wp_list_categories() 651 679 * … … 672 700 function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0, 673 701 $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0, 674 702 $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()'); 676 704 677 705 $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children', 678 706 'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical'); … … 681 709 682 710 /** 683 711 * @since 1.2 712 * @deprecated 2.1 684 713 * @deprecated Use wp_list_categories() 685 714 * @see wp_list_categories() 686 715 * … … 688 717 * @return unknown 689 718 */ 690 719 function wp_list_cats($args = '') { 691 _deprecated_function(__FUNCTION__, ' 0.0', 'wp_list_categories()');720 _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()'); 692 721 693 722 $r = wp_parse_args( $args ); 694 723 … … 730 759 function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc', 731 760 $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false, 732 761 $selected = 0, $exclude = 0) { 733 _deprecated_function(__FUNCTION__, ' 0.0', 'wp_dropdown_categories()');762 _deprecated_function(__FUNCTION__, '2.1', 'wp_dropdown_categories()'); 734 763 735 764 $show_option_all = ''; 736 765 if ( $optionall ) … … 748 777 749 778 /** 750 779 * @since 2.1 780 * @deprecated 2.1 751 781 * @deprecated Use wp_tiny_mce(). 752 782 * @see wp_tiny_mce() 753 783 */ 754 784 function tinymce_include() { 755 _deprecated_function(__FUNCTION__, ' 0.0', 'wp_tiny_mce()');785 _deprecated_function(__FUNCTION__, '2.1', 'wp_tiny_mce()'); 756 786 757 787 wp_tiny_mce(); 758 788 } 759 789 760 790 /** 761 791 * @since 1.2 792 * @deprecated 2.1 762 793 * @deprecated Use wp_list_authors() 763 794 * @see wp_list_authors() 764 795 * … … 771 802 * @return unknown 772 803 */ 773 804 function 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()'); 775 806 776 807 $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image'); 777 808 return wp_list_authors($args); … … 779 810 780 811 /** 781 812 * @since 1.0.1 813 * @deprecated 2.1 782 814 * @deprecated Use wp_get_post_categories() 783 815 * @see wp_get_post_categories() 784 816 * … … 787 819 * @return unknown 788 820 */ 789 821 function 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()'); 791 823 return wp_get_post_categories($post_ID); 792 824 } 793 825 … … 795 827 * Sets the categories that the post id belongs to. 796 828 * 797 829 * @since 1.0.1 830 * @deprecated 2.1 798 831 * @deprecated Use wp_set_post_categories() 799 832 * @see wp_set_post_categories() 800 833 * … … 804 837 * @return unknown 805 838 */ 806 839 function 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()'); 808 841 return wp_set_post_categories($post_ID, $post_categories); 809 842 } 810 843 811 844 /** 812 845 * @since 0.71 846 * @deprecated 2.1 813 847 * @deprecated Use wp_get_archives() 814 848 * @see wp_get_archives() 815 849 * … … 822 856 * @return unknown 823 857 */ 824 858 function 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()'); 826 860 $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count'); 827 861 return wp_get_archives($args); 828 862 } … … 831 865 * Returns or Prints link to the author's posts. 832 866 * 833 867 * @since 1.2 868 * @deprecated 2.1 834 869 * @deprecated Use get_author_posts_url() 835 870 * @see get_author_posts_url() 836 871 * … … 840 875 * @return string|null 841 876 */ 842 877 function 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()'); 844 879 845 880 $link = get_author_posts_url($author_id, $author_nicename); 846 881 … … 853 888 * Print list of pages based on arguments. 854 889 * 855 890 * @since 0.71 891 * @deprecated 2.1 856 892 * @deprecated Use wp_link_pages() 857 893 * @see wp_link_pages() 858 894 * … … 867 903 */ 868 904 function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page', 869 905 $pagelink='%', $more_file='') { 870 _deprecated_function(__FUNCTION__, ' 0.0', 'wp_link_pages()');906 _deprecated_function(__FUNCTION__, '2.1', 'wp_link_pages()'); 871 907 872 908 $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file'); 873 909 return wp_link_pages($args); … … 877 913 * Get value based on option. 878 914 * 879 915 * @since 0.71 916 * @deprecated 2.1 880 917 * @deprecated Use get_option() 881 918 * @see get_option() 882 919 * … … 884 921 * @return string 885 922 */ 886 923 function get_settings($option) { 887 _deprecated_function(__FUNCTION__, ' 0.0', 'get_option()');924 _deprecated_function(__FUNCTION__, '2.1', 'get_option()'); 888 925 889 926 return get_option($option); 890 927 } … … 893 930 * Print the permalink of the current post in the loop. 894 931 * 895 932 * @since 0.71 933 * @deprecated 1.2 896 934 * @deprecated Use the_permalink() 897 935 * @see the_permalink() 898 936 */ 899 937 function permalink_link() { 900 _deprecated_function(__FUNCTION__, ' 0.0', 'the_permalink()');938 _deprecated_function(__FUNCTION__, '1.2', 'the_permalink()'); 901 939 the_permalink(); 902 940 } 903 941 … … 905 943 * Print the permalink to the RSS feed. 906 944 * 907 945 * @since 0.71 946 * @deprecated 2.3 908 947 * @deprecated Use the_permalink_rss() 909 948 * @see the_permalink_rss() 910 949 * 911 950 * @param string $file 912 951 */ 913 952 function permalink_single_rss($deprecated = '') { 914 _deprecated_function(__FUNCTION__, ' 0.0', 'the_permalink_rss()');953 _deprecated_function(__FUNCTION__, '2.3', 'the_permalink_rss()'); 915 954 the_permalink_rss(); 916 955 } 917 956 918 957 /** 919 958 * Gets the links associated with category. 920 959 * 921 * @see get_links() for argument information that can be used in $args922 960 * @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() 925 964 * 926 965 * @param string $args a query string 927 966 * @return null|string 928 967 */ 929 968 function wp_get_links($args = '') { 930 _deprecated_function(__FUNCTION__, ' 0.0', 'get_bookmarks()');969 _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()'); 931 970 932 971 if ( strpos( $args, '=' ) === false ) { 933 972 $cat_id = $args; … … 935 974 } 936 975 937 976 $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' => '', 944 990 ); 945 991 946 992 $r = wp_parse_args( $args, $defaults ); 947 extract( $r, EXTR_SKIP );948 993 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 ); 950 995 } 951 996 952 997 /** 953 998 * Gets the links associated with category by id. 954 999 * 955 1000 * @since 0.71 1001 * @deprecated 2.1 956 1002 * @deprecated Use get_bookmarks() 957 1003 * @see get_bookmarks() 958 1004 * … … 975 1021 */ 976 1022 function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name', 977 1023 $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()'); 979 1025 980 1026 $order = 'ASC'; 981 1027 if ( substr($orderby, 0, 1) == '_' ) { … … 1062 1108 * 1063 1109 * @author Dougal 1064 1110 * @since 1.0.1 1111 * @deprecated 2.1 1065 1112 * @deprecated Use wp_list_bookmarks() 1066 1113 * @see wp_list_bookmarks() 1067 1114 * … … 1069 1116 * @param string $$deprecated Not Used 1070 1117 */ 1071 1118 function get_links_list($order = 'name', $deprecated = '') { 1072 _deprecated_function(__FUNCTION__, ' 0.0', 'wp_list_bookmarks()');1119 _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()'); 1073 1120 1074 1121 $order = strtolower($order); 1075 1122 … … 1108 1155 * @link http://sprite.csr.unibo.it/fullo/ 1109 1156 * 1110 1157 * @since 0.71 1158 * @deprecated 2.1 1111 1159 * @deprecated {@internal Use function instead is unknown}} 1112 1160 * 1113 1161 * @param string $text the text of the link … … 1117 1165 * @param bool $count the number of links in the db 1118 1166 */ 1119 1167 function 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' ); 1121 1169 1122 1170 if ( $count ) 1123 1171 $counts = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->links"); … … 1134 1182 1135 1183 /** 1136 1184 * @since 1.0.1 1185 * @deprecated 2.1 1137 1186 * @deprecated Use sanitize_bookmark_field() 1138 1187 * @see sanitize_bookmark_field() 1139 1188 * … … 1141 1190 * @return unknown 1142 1191 */ 1143 1192 function get_linkrating($link) { 1144 _deprecated_function(__FUNCTION__, ' 0.0', 'sanitize_bookmark_field()');1193 _deprecated_function(__FUNCTION__, '2.1', 'sanitize_bookmark_field()'); 1145 1194 return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display'); 1146 1195 } 1147 1196 … … 1149 1198 * Gets the name of category by id. 1150 1199 * 1151 1200 * @since 0.71 1201 * @deprecated 2.1 1152 1202 * @deprecated Use get_category() 1153 1203 * @see get_category() 1154 1204 * … … 1156 1206 * @return string 1157 1207 */ 1158 1208 function get_linkcatname($id = 0) { 1159 _deprecated_function(__FUNCTION__, ' 0.0', 'get_category()');1209 _deprecated_function(__FUNCTION__, '2.1', 'get_category()'); 1160 1210 1161 1211 $id = (int) $id; 1162 1212 … … 1178 1228 * Print RSS comment feed link. 1179 1229 * 1180 1230 * @since 1.0.1 1231 * @deprecated 2.5 1181 1232 * @deprecated Use post_comments_feed_link() 1182 1233 * @see post_comments_feed_link() 1183 1234 * … … 1185 1236 * @param string $deprecated Not used 1186 1237 */ 1187 1238 function 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()'); 1189 1240 post_comments_feed_link($link_text); 1190 1241 } 1191 1242 … … 1193 1244 * Print/Return link to category RSS2 feed. 1194 1245 * 1195 1246 * @since 1.2 1247 * @deprecated 2.5 1196 1248 * @deprecated Use get_category_feed_link() 1197 1249 * @see get_category_feed_link() 1198 1250 * … … 1202 1254 * @return string|null 1203 1255 */ 1204 1256 function 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()'); 1206 1258 1207 1259 $link = get_category_feed_link($cat_ID, 'rss2'); 1208 1260 … … 1215 1267 * Print/Return link to author RSS feed. 1216 1268 * 1217 1269 * @since 1.2 1270 * @deprecated 2.5 1218 1271 * @deprecated Use get_author_feed_link() 1219 1272 * @see get_author_feed_link() 1220 1273 * … … 1224 1277 * @return string|null 1225 1278 */ 1226 1279 function 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()'); 1228 1281 1229 1282 $link = get_author_feed_link($author_id); 1230 1283 if ( $echo ) … … 1236 1289 * Return link to the post RSS feed. 1237 1290 * 1238 1291 * @since 1.5 1292 * @deprecated 2.2 1239 1293 * @deprecated Use get_post_comments_feed_link() 1240 1294 * @see get_post_comments_feed_link() 1241 1295 * … … 1250 1304 /** 1251 1305 * An alias of wp_create_user(). 1252 1306 * 1307 * @since 2.0 1308 * @deprecated 2.0 1309 * @deprecated Use wp_create_user() 1310 * @see wp_create_user() 1311 * 1253 1312 * @param string $username The user's username. 1254 1313 * @param string $password The user's password. 1255 1314 * @param string $email The user's email (optional). 1256 1315 * @return int The new user's ID. 1257 * @deprecated Use wp_create_user()1258 * @see wp_create_user()1259 1316 */ 1260 1317 function create_user($username, $password, $email) { 1261 1318 _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' ); … … 1266 1323 * Unused Admin function. 1267 1324 * 1268 1325 * @since 2.0 1326 * @deprecated 2.5 1327 * 1269 1328 * @param string $deprecated Unknown 1270 * @deprecated 2.51271 1329 */ 1272 1330 function documentation_link( $deprecated = '' ) { 1273 1331 _deprecated_function( __FUNCTION__, '2.5', '' ); … … 1286 1344 /** 1287 1345 * Retrieve an array of comment data about comment $comment_ID. 1288 1346 * 1347 * @since 0.71 1348 * @deprecated 2.7 1289 1349 * @deprecated Use get_comment() 1290 1350 * @see get_comment() 1291 * @since 0.711292 1351 * 1293 * @uses $id1294 * @uses $wpdb Database Object1295 *1296 1352 * @param int $comment_ID The ID of the comment 1297 1353 * @param int $no_cache Whether to use the cache or not (casted to bool) 1298 1354 * @param bool $include_unapproved Whether to include unapproved comments or not … … 1307 1363 * Retrieve the category name by the category ID. 1308 1364 * 1309 1365 * @since 0.71 1366 * @deprecated 2.8 1310 1367 * @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() 1312 1369 * 1313 1370 * @param int $cat_ID Category ID 1314 1371 * @return string category name … … 1322 1379 * Retrieve category children list separated before and after the term IDs. 1323 1380 * 1324 1381 * @since 1.2.0 1382 * @deprecated 2.8 1383 * @deprecated Use get_term_children() 1384 * @see get_term_children() 1325 1385 * 1326 1386 * @param int $id Category ID to retrieve children. 1327 1387 * @param string $before Optional. Prepend before category term ID. … … 1358 1418 * 1359 1419 * @since 1.5 1360 1420 * @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 * 1362 1424 * @return string The author's description. 1363 * @deprecated Use the_author_meta('description')1364 1425 */ 1365 1426 function get_the_author_description() { 1366 1427 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' ); … … 1370 1431 /** 1371 1432 * Display the description of the author of the current post. 1372 1433 * 1373 * @link http://codex.wordpress.org/Template_Tags/the_author_description1374 1434 * @since 1.0.0 1375 1435 * @deprecated 2.8 1376 1436 * @deprecated Use the_author_meta('description') 1437 * @see the_author_meta() 1377 1438 */ 1378 1439 function the_author_description() { 1379 1440 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'description\')' ); … … 1385 1446 * 1386 1447 * @since 1.5 1387 1448 * @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 * 1389 1452 * @return string The author's login name (username). 1390 * @deprecated Use the_author_meta('login')1391 1453 */ 1392 1454 function get_the_author_login() { 1393 1455 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' ); … … 1397 1459 /** 1398 1460 * Display the login name of the author of the current post. 1399 1461 * 1400 * @link http://codex.wordpress.org/Template_Tags/the_author_login1401 1462 * @since 0.71 1402 1463 * @deprecated 2.8 1403 1464 * @deprecated Use the_author_meta('login') 1465 * @see the_author_meta() 1404 1466 */ 1405 1467 function the_author_login() { 1406 1468 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'login\')' ); … … 1412 1474 * 1413 1475 * @since 1.5 1414 1476 * @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 * 1416 1480 * @return string The author's first name. 1417 * @deprecated Use the_author_meta('first_name')1418 1481 */ 1419 1482 function get_the_author_firstname() { 1420 1483 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' ); … … 1424 1487 /** 1425 1488 * Display the first name of the author of the current post. 1426 1489 * 1427 * @link http://codex.wordpress.org/Template_Tags/the_author_firstname1428 1490 * @since 0.71 1429 1491 * @deprecated 2.8 1430 1492 * @deprecated Use the_author_meta('first_name') 1493 * @see the_author_meta() 1431 1494 */ 1432 1495 function the_author_firstname() { 1433 1496 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' ); … … 1439 1502 * 1440 1503 * @since 1.5 1441 1504 * @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 * 1443 1508 * @return string The author's last name. 1444 * @deprecated Use the_author_meta('last_name')1445 1509 */ 1446 1510 function get_the_author_lastname() { 1447 1511 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' ); … … 1451 1515 /** 1452 1516 * Display the last name of the author of the current post. 1453 1517 * 1454 * @link http://codex.wordpress.org/Template_Tags/the_author_lastname1455 1518 * @since 0.71 1456 1519 * @deprecated 2.8 1457 1520 * @deprecated Use the_author_meta('last_name') 1521 * @see the_author_meta() 1458 1522 */ 1459 1523 function the_author_lastname() { 1460 1524 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' ); … … 1466 1530 * 1467 1531 * @since 1.5 1468 1532 * @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 * 1470 1536 * @return string The author's nickname. 1471 * @deprecated Use the_author_meta('nickname')1472 1537 */ 1473 1538 function get_the_author_nickname() { 1474 1539 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' ); … … 1478 1543 /** 1479 1544 * Display the nickname of the author of the current post. 1480 1545 * 1481 * @link http://codex.wordpress.org/Template_Tags/the_author_nickname1482 1546 * @since 0.71 1483 1547 * @deprecated 2.8 1484 1548 * @deprecated Use the_author_meta('nickname') 1549 * @see the_author_meta() 1485 1550 */ 1486 1551 function the_author_nickname() { 1487 1552 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' ); … … 1493 1558 * 1494 1559 * @since 1.5 1495 1560 * @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 * 1497 1564 * @return string The author's username. 1498 * @deprecated Use the_author_meta('email')1499 1565 */ 1500 1566 function get_the_author_email() { 1501 1567 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' ); … … 1505 1571 /** 1506 1572 * Display the email of the author of the current post. 1507 1573 * 1508 * @link http://codex.wordpress.org/Template_Tags/the_author_email1509 1574 * @since 0.71 1510 1575 * @deprecated 2.8 1511 1576 * @deprecated Use the_author_meta('email') 1577 * @see the_author_meta() 1512 1578 */ 1513 1579 function the_author_email() { 1514 1580 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'email\')' ); … … 1520 1586 * 1521 1587 * @since 1.5 1522 1588 * @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 * 1524 1592 * @return string The author's ICQ number. 1525 * @deprecated Use the_author_meta('icq')1526 1593 */ 1527 1594 function get_the_author_icq() { 1528 1595 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' ); … … 1532 1599 /** 1533 1600 * Display the ICQ number of the author of the current post. 1534 1601 * 1535 * @link http://codex.wordpress.org/Template_Tags/the_author_icq1536 1602 * @since 0.71 1537 1603 * @deprecated 2.8 1538 * @see get_the_author_icq()1539 1604 * @deprecated Use the_author_meta('icq') 1605 * @see the_author_meta() 1540 1606 */ 1541 1607 function the_author_icq() { 1542 1608 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'icq\')' ); … … 1548 1614 * 1549 1615 * @since 1.5 1550 1616 * @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 * 1552 1620 * @return string The author's Yahoo! IM name. 1553 * @deprecated Use the_author_meta('yim')1554 1621 */ 1555 1622 function get_the_author_yim() { 1556 1623 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' ); … … 1560 1627 /** 1561 1628 * Display the Yahoo! IM name of the author of the current post. 1562 1629 * 1563 * @link http://codex.wordpress.org/Template_Tags/the_author_yim1564 1630 * @since 0.71 1565 1631 * @deprecated 2.8 1566 1632 * @deprecated Use the_author_meta('yim') 1633 * @see the_author_meta() 1567 1634 */ 1568 1635 function the_author_yim() { 1569 1636 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'yim\')' ); … … 1575 1642 * 1576 1643 * @since 1.5 1577 1644 * @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 * 1579 1648 * @return string The author's MSN address. 1580 * @deprecated Use the_author_meta('msn')1581 1649 */ 1582 1650 function get_the_author_msn() { 1583 1651 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' ); … … 1587 1655 /** 1588 1656 * Display the MSN address of the author of the current post. 1589 1657 * 1590 * @link http://codex.wordpress.org/Template_Tags/the_author_msn1591 1658 * @since 0.71 1592 1659 * @deprecated 2.8 1593 * @see get_the_author_msn()1594 1660 * @deprecated Use the_author_meta('msn') 1661 * @see the_author_meta() 1595 1662 */ 1596 1663 function the_author_msn() { 1597 1664 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'msn\')' ); … … 1603 1670 * 1604 1671 * @since 1.5 1605 1672 * @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 * 1607 1676 * @return string The author's AIM address. 1608 * @deprecated Use the_author_meta('aim')1609 1677 */ 1610 1678 function get_the_author_aim() { 1611 1679 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' ); … … 1615 1683 /** 1616 1684 * Display the AIM address of the author of the current post. 1617 1685 * 1618 * @link http://codex.wordpress.org/Template_Tags/the_author_aim1619 1686 * @since 0.71 1687 * @see the_author_meta() 1620 1688 * @deprecated 2.8 1621 * @see get_the_author_aim()1622 1689 * @deprecated Use the_author_meta('aim') 1623 1690 */ 1624 1691 function the_author_aim() { … … 1631 1698 * 1632 1699 * @since 1.0.0 1633 1700 * @deprecated 2.8 1701 * @deprecated Use get_the_author_meta('display_name') 1702 * @see get_the_author_meta() 1703 * 1634 1704 * @param int $auth_id The ID of the author. 1635 1705 * @return string The author's display name. 1636 * @deprecated Use the_author_meta('display_name')1637 1706 */ 1638 1707 function get_author_name( $auth_id = false ) { 1639 1708 _deprecated_function(__FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' ); … … 1645 1714 * 1646 1715 * @since 1.5 1647 1716 * @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 * 1649 1720 * @return string The URL to the author's page. 1650 1721 */ 1651 1722 function get_the_author_url() { … … 1656 1727 /** 1657 1728 * Display the URL to the home page of the author of the current post. 1658 1729 * 1659 * @link http://codex.wordpress.org/Template_Tags/the_author_url1660 1730 * @since 0.71 1661 1731 * @deprecated 2.8 1732 * @deprecated Use the_author_meta('url') 1733 * @see the_author_meta() 1662 1734 */ 1663 1735 function the_author_url() { 1664 1736 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'url\')' ); … … 1670 1742 * 1671 1743 * @since 1.5 1672 1744 * @deprecated 2.8 1745 * @deprecated Use get_the_author_meta('ID') 1746 * @see get_the_author_meta() 1747 * 1673 1748 * @return int The author's ID. 1674 1749 */ 1675 1750 function get_the_author_ID() { … … 1680 1755 /** 1681 1756 * Display the ID of the author of the current post. 1682 1757 * 1683 * @link http://codex.wordpress.org/Template_Tags/the_author_ID1684 1758 * @since 0.71 1685 1759 * @deprecated 2.8 1686 * @uses get_the_author_ID() 1760 * @deprecated Use the_author_meta('ID') 1761 * @see the_author_meta() 1687 1762 */ 1688 1763 function the_author_ID() { 1689 1764 _deprecated_function(__FUNCTION__, '2.8', 'the_author_meta(\'ID\')' ); … … 1715 1790 * parameters. 1716 1791 * 1717 1792 * @deprecated 2.9.0 1793 * @deprecated Use the_content_feed() 1794 * @see the_content_feed() 1718 1795 * 1719 1796 * @param string $more_link_text Optional. Text to display when more content is available but not displayed. 1720 1797 * @param int|bool $stripteaser Optional. Default is 0. … … 1801 1878 * 1802 1879 * @since 2.2.0 1803 1880 * @deprecated 2.9.0 1881 * @deprecated Use _x() 1882 * @see _x() 1804 1883 * 1805 1884 * @param string $text Text to translate 1806 1885 * @param string $domain Optional. Domain to retrieve the translated text