WordPress 3.0 beta 1 documentation kindly provided to you by Hay Kranen
WordPress 3.0 beta 1 documentation kindly provided to you by Hay Kranen
| [ Index ] |
PHP Cross Reference of WordPress 3.0 beta 1 |
|
| [ Index ] [ Variables ] [ Functions ] [ Classes ] [ Constants ] [ Statistics ] | ||
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Deprecated functions from past WordPress versions. You shouldn't use these 4 * functions and look for the alternatives instead. The functions will be 5 * removed in a later version. 6 * 7 * @package WordPress 8 * @subpackage Deprecated 9 */ 10 11 /* 12 * Deprecated functions come here to die. 13 */ 14 15 /** 16 * Entire Post data. 17 * 18 * @since 0.71 19 * @deprecated 1.5.1 20 * @deprecated Use get_post() 21 * @see get_post() 22 * 23 * @param int $postid 24 * @return array 25 */ 26 function get_postdata($postid) { 27 _deprecated_function( __FUNCTION__, '1.5.1', 'get_post()' ); 28 29 $post = &get_post($postid); 30 31 $postdata = array ( 32 'ID' => $post->ID, 33 'Author_ID' => $post->post_author, 34 'Date' => $post->post_date, 35 'Content' => $post->post_content, 36 'Excerpt' => $post->post_excerpt, 37 'Title' => $post->post_title, 38 'Category' => $post->post_category, 39 'post_status' => $post->post_status, 40 'comment_status' => $post->comment_status, 41 'ping_status' => $post->ping_status, 42 'post_password' => $post->post_password, 43 'to_ping' => $post->to_ping, 44 'pinged' => $post->pinged, 45 'post_type' => $post->post_type, 46 'post_name' => $post->post_name 47 ); 48 49 return $postdata; 50 } 51 52 /** 53 * Sets up the WordPress Loop. 54 * 55 * @since 1.0.1 56 * @deprecated 1.5 57 * @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop} 58 */ 59 function start_wp() { 60 global $wp_query, $post; 61 62 _deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop') ); 63 64 // Since the old style loop is being used, advance the query iterator here. 65 $wp_query->next_post(); 66 67 setup_postdata($post); 68 } 69 70 /** 71 * Return or Print Category ID. 72 * 73 * @since 0.71 74 * @deprecated 0.71 75 * @deprecated use get_the_category() 76 * @see get_the_category() 77 * 78 * @param bool $echo 79 * @return null|int 80 */ 81 function the_category_ID($echo = true) { 82 _deprecated_function( __FUNCTION__, '0.71', 'get_the_category()' ); 83 84 // Grab the first cat in the list. 85 $categories = get_the_category(); 86 $cat = $categories[0]->term_id; 87 88 if ( $echo ) 89 echo $cat; 90 91 return $cat; 92 } 93 94 /** 95 * Print category with optional text before and after. 96 * 97 * @since 0.71 98 * @deprecated 0.71 99 * @deprecated use get_the_category_by_ID() 100 * @see get_the_category_by_ID() 101 * 102 * @param string $before 103 * @param string $after 104 */ 105 function the_category_head($before='', $after='') { 106 global $currentcat, $previouscat; 107 108 _deprecated_function( __FUNCTION__, '0.71', 'get_the_category_by_ID()' ); 109 110 // Grab the first cat in the list. 111 $categories = get_the_category(); 112 $currentcat = $categories[0]->category_id; 113 if ( $currentcat != $previouscat ) { 114 echo $before; 115 echo get_the_category_by_ID($currentcat); 116 echo $after; 117 $previouscat = $currentcat; 118 } 119 } 120 121 /** 122 * Prints link to the previous post. 123 * 124 * @since 1.5 125 * @deprecated 2.0 126 * @deprecated Use previous_post_link() 127 * @see previous_post_link() 128 * 129 * @param string $format 130 * @param string $previous 131 * @param string $title 132 * @param string $in_same_cat 133 * @param int $limitprev 134 * @param string $excluded_categories 135 */ 136 function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') { 137 138 _deprecated_function( __FUNCTION__, '2.0', 'previous_post_link()' ); 139 140 if ( empty($in_same_cat) || 'no' == $in_same_cat ) 141 $in_same_cat = false; 142 else 143 $in_same_cat = true; 144 145 $post = get_previous_post($in_same_cat, $excluded_categories); 146 147 if ( !$post ) 148 return; 149 150 $string = '<a href="'.get_permalink($post->ID).'">'.$previous; 151 if ( 'yes' == $title ) 152 $string .= apply_filters('the_title', $post->post_title, $post); 153 $string .= '</a>'; 154 $format = str_replace('%', $string, $format); 155 echo $format; 156 } 157 158 /** 159 * Prints link to the next post. 160 * 161 * @since 0.71 162 * @deprecated 2.0 163 * @deprecated Use next_post_link() 164 * @see next_post_link() 165 * 166 * @param string $format 167 * @param string $previous 168 * @param string $title 169 * @param string $in_same_cat 170 * @param int $limitprev 171 * @param string $excluded_categories 172 */ 173 function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') { 174 _deprecated_function( __FUNCTION__, '2.0', 'next_post_link()' ); 175 176 if ( empty($in_same_cat) || 'no' == $in_same_cat ) 177 $in_same_cat = false; 178 else 179 $in_same_cat = true; 180 181 $post = get_next_post($in_same_cat, $excluded_categories); 182 183 if ( !$post ) 184 return; 185 186 $string = '<a href="'.get_permalink($post->ID).'">'.$next; 187 if ( 'yes' == $title ) 188 $string .= apply_filters('the_title', $post->post_title, $nextpost); 189 $string .= '</a>'; 190 $format = str_replace('%', $string, $format); 191 echo $format; 192 } 193 194 /** 195 * Whether user can create a post. 196 * 197 * @since 1.5 198 * @deprecated 2.0 199 * @deprecated Use current_user_can() 200 * @see current_user_can() 201 * 202 * @param int $user_id 203 * @param int $blog_id Not Used 204 * @param int $category_id Not Used 205 * @return bool 206 */ 207 function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') { 208 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 209 210 $author_data = get_userdata($user_id); 211 return ($author_data->user_level > 1); 212 } 213 214 /** 215 * Whether user can create a post. 216 * 217 * @since 1.5 218 * @deprecated 2.0 219 * @deprecated Use current_user_can() 220 * @see current_user_can() 221 * 222 * @param int $user_id 223 * @param int $blog_id Not Used 224 * @param int $category_id Not Used 225 * @return bool 226 */ 227 function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') { 228 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 229 230 $author_data = get_userdata($user_id); 231 return ($author_data->user_level >= 1); 232 } 233 234 /** 235 * Whether user can edit a post. 236 * 237 * @since 1.5 238 * @deprecated 2.0 239 * @deprecated Use current_user_can() 240 * @see current_user_can() 241 * 242 * @param int $user_id 243 * @param int $post_id 244 * @param int $blog_id Not Used 245 * @return bool 246 */ 247 function user_can_edit_post($user_id, $post_id, $blog_id = 1) { 248 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 249 250 $author_data = get_userdata($user_id); 251 $post = get_post($post_id); 252 $post_author_data = get_userdata($post->post_author); 253 254 if ( (($user_id == $post_author_data->ID) && !($post->post_status == 'publish' && $author_data->user_level < 2)) 255 || ($author_data->user_level > $post_author_data->user_level) 256 || ($author_data->user_level >= 10) ) { 257 return true; 258 } else { 259 return false; 260 } 261 } 262 263 /** 264 * Whether user can delete a post. 265 * 266 * @since 1.5 267 * @deprecated 2.0 268 * @deprecated Use current_user_can() 269 * @see current_user_can() 270 * 271 * @param int $user_id 272 * @param int $post_id 273 * @param int $blog_id Not Used 274 * @return bool 275 */ 276 function user_can_delete_post($user_id, $post_id, $blog_id = 1) { 277 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 278 279 // right now if one can edit, one can delete 280 return user_can_edit_post($user_id, $post_id, $blog_id); 281 } 282 283 /** 284 * Whether user can set new posts' dates. 285 * 286 * @since 1.5 287 * @deprecated 2.0 288 * @deprecated Use current_user_can() 289 * @see current_user_can() 290 * 291 * @param int $user_id 292 * @param int $blog_id Not Used 293 * @param int $category_id Not Used 294 * @return bool 295 */ 296 function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') { 297 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 298 299 $author_data = get_userdata($user_id); 300 return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id)); 301 } 302 303 /** 304 * Whether user can delete a post. 305 * 306 * @since 1.5 307 * @deprecated 2.0 308 * @deprecated Use current_user_can() 309 * @see current_user_can() 310 * 311 * @param int $user_id 312 * @param int $post_id 313 * @param int $blog_id Not Used 314 * @return bool returns true if $user_id can edit $post_id's date 315 */ 316 function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) { 317 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 318 319 $author_data = get_userdata($user_id); 320 return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id)); 321 } 322 323 /** 324 * Whether user can delete a post. 325 * 326 * @since 1.5 327 * @deprecated 2.0 328 * @deprecated Use current_user_can() 329 * @see current_user_can() 330 * 331 * @param int $user_id 332 * @param int $post_id 333 * @param int $blog_id Not Used 334 * @return bool returns true if $user_id can edit $post_id's comments 335 */ 336 function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) { 337 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 338 339 // right now if one can edit a post, one can edit comments made on it 340 return user_can_edit_post($user_id, $post_id, $blog_id); 341 } 342 343 /** 344 * Whether user can delete a post. 345 * 346 * @since 1.5 347 * @deprecated 2.0 348 * @deprecated Use current_user_can() 349 * @see current_user_can() 350 * 351 * @param int $user_id 352 * @param int $post_id 353 * @param int $blog_id Not Used 354 * @return bool returns true if $user_id can delete $post_id's comments 355 */ 356 function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) { 357 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 358 359 // right now if one can edit comments, one can delete comments 360 return user_can_edit_post_comments($user_id, $post_id, $blog_id); 361 } 362 363 /** 364 * Can user can edit other user. 365 * 366 * @since 1.5 367 * @deprecated 2.0 368 * @deprecated Use current_user_can() 369 * @see current_user_can() 370 * 371 * @param int $user_id 372 * @param int $other_user 373 * @return bool 374 */ 375 function user_can_edit_user($user_id, $other_user) { 376 _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' ); 377 378 $user = get_userdata($user_id); 379 $other = get_userdata($other_user); 380 if ( $user->user_level > $other->user_level || $user->user_level > 8 || $user->ID == $other->ID ) 381 return true; 382 else 383 return false; 384 } 385 386 /** 387 * Gets the links associated with category $cat_name. 388 * 389 * @since 0.71 390 * @deprecated 2.1 391 * @deprecated Use get_bookmarks() 392 * @see get_bookmarks() 393 * 394 * @param string $cat_name Optional. The category name to use. If no match is found uses all. 395 * @param string $before Optional. The html to output before the link. 396 * @param string $after Optional. The html to output after the link. 397 * @param string $between Optional. The html to output between the link/image and it's description. Not used if no image or $show_images is true. 398 * @param bool $show_images Optional. Whether to show images (if defined). 399 * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner. 400 * If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which will return links in a 401 * random order. 402 * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. 403 * @param bool $show_rating Optional. Show rating stars/chars. 404 * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. 405 * @param int $show_updated Optional. Whether to show last updated timestamp 406 */ 407 function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id', 408 $show_description = true, $show_rating = false, 409 $limit = -1, $show_updated = 0) { 410 _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); 411 412 $cat_id = -1; 413 $cat = get_term_by('name', $cat_name, 'link_category'); 414 if ( $cat ) 415 $cat_id = $cat->term_id; 416 417 get_links($cat_id, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated); 418 } 419 420 /** 421 * Gets the links associated with the named category. 422 * 423 * @since 1.0.1 424 * @deprecated 2.1 425 * @deprecated Use wp_list_bookmarks() 426 * @see wp_list_bookmarks() 427 * 428 * @param string $category The category to use. 429 * @param string $args 430 * @return bool|null 431 */ 432 function wp_get_linksbyname($category, $args = '') { 433 _deprecated_function(__FUNCTION__, '0.0', 'wp_list_bookmarks()'); 434 435 $defaults = array( 436 'after' => '<br />', 437 'before' => '', 438 'categorize' => 0, 439 'category_after' => '', 440 'category_before' => '', 441 'category_name' => $category, 442 'show_description' => 1, 443 'title_li' => '', 444 ); 445 446 $r = wp_parse_args( $args, $defaults ); 447 448 return wp_list_bookmarks($r); 449 } 450 451 /** 452 * Gets an array of link objects associated with category $cat_name. 453 * 454 * <code> 455 * $links = get_linkobjectsbyname('fred'); 456 * foreach ($links as $link) { 457 * echo '<li>'.$link->link_name.'</li>'; 458 * } 459 * </code> 460 * 461 * @since 1.0.1 462 * @deprecated 2.1 463 * @deprecated Use get_bookmarks() 464 * @see get_bookmarks() 465 * 466 * @param string $cat_name The category name to use. If no match is found uses all. 467 * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'. 468 * Or maybe owner. If you start the name with an underscore the order will be reversed. You can also 469 * specify 'rand' as the order which will return links in a random order. 470 * @param int $limit Limit to X entries. If not specified, all entries are shown. 471 * @return unknown 472 */ 473 function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) { 474 _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); 475 476 $cat_id = -1; 477 $cat = get_term_by('name', $cat_name, 'link_category'); 478 if ( $cat ) 479 $cat_id = $cat->term_id; 480 481 return get_linkobjects($cat_id, $orderby, $limit); 482 } 483 484 /** 485 * Gets an array of link objects associated with category n. 486 * 487 * Usage: 488 * <code> 489 * $links = get_linkobjects(1); 490 * if ($links) { 491 * foreach ($links as $link) { 492 * echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>'; 493 * } 494 * } 495 * </code> 496 * 497 * Fields are: 498 * <ol> 499 * <li>link_id</li> 500 * <li>link_url</li> 501 * <li>link_name</li> 502 * <li>link_image</li> 503 * <li>link_target</li> 504 * <li>link_category</li> 505 * <li>link_description</li> 506 * <li>link_visible</li> 507 * <li>link_owner</li> 508 * <li>link_rating</li> 509 * <li>link_updated</li> 510 * <li>link_rel</li> 511 * <li>link_notes</li> 512 * </ol> 513 * 514 * @since 1.0.1 515 * @deprecated 2.1 516 * @deprecated Use get_bookmarks() 517 * @see get_bookmarks() 518 * 519 * @param int $category The category to use. If no category supplied uses all 520 * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', 521 * 'description', or 'rating'. Or maybe owner. If you start the name with an 522 * underscore the order will be reversed. You can also specify 'rand' as the 523 * order which will return links in a random order. 524 * @param int $limit Limit to X entries. If not specified, all entries are shown. 525 * @return unknown 526 */ 527 function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { 528 _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); 529 530 $links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ; 531 532 $links_array = array(); 533 foreach ($links as $link) 534 $links_array[] = $link; 535 536 return $links_array; 537 } 538 539 /** 540 * Gets the links associated with category 'cat_name' and display rating stars/chars. 541 * 542 * @since 0.71 543 * @deprecated 2.1 544 * @deprecated Use get_bookmarks() 545 * @see get_bookmarks() 546 * 547 * @param string $cat_name The category name to use. If no match is found uses all 548 * @param string $before The html to output before the link 549 * @param string $after The html to output after the link 550 * @param string $between The html to output between the link/image and it's description. Not used if no image or show_images is true 551 * @param bool $show_images Whether to show images (if defined). 552 * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', 553 * 'description', or 'rating'. Or maybe owner. If you start the name with an 554 * underscore the order will be reversed. You can also specify 'rand' as the 555 * order which will return links in a random order. 556 * @param bool $show_description Whether to show the description if show_images=false/not defined 557 * @param int $limit Limit to X entries. If not specified, all entries are shown. 558 * @param int $show_updated Whether to show last updated timestamp 559 */ 560 function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ", 561 $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { 562 _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); 563 564 get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); 565 } 566 567 /** 568 * Gets the links associated with category n and display rating stars/chars. 569 * 570 * @since 0.71 571 * @deprecated 2.1 572 * @deprecated Use get_bookmarks() 573 * @see get_bookmarks() 574 * 575 * @param int $category The category to use. If no category supplied uses all 576 * @param string $before The html to output before the link 577 * @param string $after The html to output after the link 578 * @param string $between The html to output between the link/image and it's description. Not used if no image or show_images == true 579 * @param bool $show_images Whether to show images (if defined). 580 * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 581 * 'description', or 'rating'. Or maybe owner. If you start the name with an 582 * underscore the order will be reversed. You can also specify 'rand' as the 583 * order which will return links in a random order. 584 * @param bool $show_description Whether to show the description if show_images=false/not defined. 585 * @param string $limit Limit to X entries. If not specified, all entries are shown. 586 * @param int $show_updated Whether to show last updated timestamp 587 */ 588 function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true, 589 $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { 590 _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); 591 592 get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); 593 } 594 595 /** 596 * Gets the auto_toggle setting. 597 * 598 * @since 0.71 599 * @deprecated 2.1 600 * @deprecated No alternative function available 601 * 602 * @param int $id The category to get. If no category supplied uses 0 603 * @return int Only returns 0. 604 */ 605 function get_autotoggle($id = 0) { 606 _deprecated_function( __FUNCTION__, '2.1' ); 607 return 0; 608 } 609 610 /** 611 * @since 0.71 612 * @deprecated 2.1 613 * @deprecated Use wp_list_categories() 614 * @see wp_list_categories() 615 * 616 * @param int $optionall 617 * @param string $all 618 * @param string $sort_column 619 * @param string $sort_order 620 * @param string $file 621 * @param bool $list 622 * @param int $optiondates 623 * @param int $optioncount 624 * @param int $hide_empty 625 * @param int $use_desc_for_title 626 * @param bool $children 627 * @param int $child_of 628 * @param int $categories 629 * @param int $recurse 630 * @param string $feed 631 * @param string $feed_image 632 * @param string $exclude 633 * @param bool $hierarchical 634 * @return unknown 635 */ 636 function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0, 637 $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0, 638 $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) { 639 _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' ); 640 641 $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children', 642 'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical'); 643 return wp_list_cats($query); 644 } 645 646 /** 647 * @since 1.2 648 * @deprecated 2.1 649 * @deprecated Use wp_list_categories() 650 * @see wp_list_categories() 651 * 652 * @param string|array $args 653 * @return unknown 654 */ 655 function wp_list_cats($args = '') { 656 _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' ); 657 658 $r = wp_parse_args( $args ); 659 660 // Map to new names. 661 if ( isset($r['optionall']) && isset($r['all'])) 662 $r['show_option_all'] = $r['all']; 663 if ( isset($r['sort_column']) ) 664 $r['orderby'] = $r['sort_column']; 665 if ( isset($r['sort_order']) ) 666 $r['order'] = $r['sort_order']; 667 if ( isset($r['optiondates']) ) 668 $r['show_last_update'] = $r['optiondates']; 669 if ( isset($r['optioncount']) ) 670 $r['show_count'] = $r['optioncount']; 671 if ( isset($r['list']) ) 672 $r['style'] = $r['list'] ? 'list' : 'break'; 673 $r['title_li'] = ''; 674 675 return wp_list_categories($r); 676 } 677 678 /** 679 * @since 0.71 680 * @deprecated 2.1 681 * @deprecated Use wp_dropdown_categories() 682 * @see wp_dropdown_categories() 683 * 684 * @param int $optionall 685 * @param string $all 686 * @param string $orderby 687 * @param string $order 688 * @param int $show_last_update 689 * @param int $show_count 690 * @param int $hide_empty 691 * @param bool $optionnone 692 * @param int $selected 693 * @param int $exclude 694 * @return unknown 695 */ 696 function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc', 697 $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false, 698 $selected = 0, $exclude = 0) { 699 _deprecated_function( __FUNCTION__, '2.1', 'wp_dropdown_categories()' ); 700 701 $show_option_all = ''; 702 if ( $optionall ) 703 $show_option_all = $all; 704 705 $show_option_none = ''; 706 if ( $optionnone ) 707 $show_option_none = __('None'); 708 709 $vars = compact('show_option_all', 'show_option_none', 'orderby', 'order', 710 'show_last_update', 'show_count', 'hide_empty', 'selected', 'exclude'); 711 $query = add_query_arg($vars, ''); 712 return wp_dropdown_categories($query); 713 } 714 715 /** 716 * @since 1.2 717 * @deprecated 2.1 718 * @deprecated Use wp_list_authors() 719 * @see wp_list_authors() 720 * 721 * @param bool $optioncount 722 * @param bool $exclude_admin 723 * @param bool $show_fullname 724 * @param bool $hide_empty 725 * @param string $feed 726 * @param string $feed_image 727 * @return unknown 728 */ 729 function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') { 730 _deprecated_function( __FUNCTION__, '2.1', 'wp_list_authors()' ); 731 732 $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image'); 733 return wp_list_authors($args); 734 } 735 736 /** 737 * @since 1.0.1 738 * @deprecated 2.1 739 * @deprecated Use wp_get_post_categories() 740 * @see wp_get_post_categories() 741 * 742 * @param int $blogid Not Used 743 * @param int $post_ID 744 * @return unknown 745 */ 746 function wp_get_post_cats($blogid = '1', $post_ID = 0) { 747 _deprecated_function( __FUNCTION__, '2.1', 'wp_get_post_categories()' ); 748 return wp_get_post_categories($post_ID); 749 } 750 751 /** 752 * Sets the categories that the post id belongs to. 753 * 754 * @since 1.0.1 755 * @deprecated 2.1 756 * @deprecated Use wp_set_post_categories() 757 * @see wp_set_post_categories() 758 * 759 * @param int $blogid Not used 760 * @param int $post_ID 761 * @param array $post_categories 762 * @return unknown 763 */ 764 function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) { 765 _deprecated_function( __FUNCTION__, '2.1', 'wp_set_post_categories()' ); 766 return wp_set_post_categories($post_ID, $post_categories); 767 } 768 769 /** 770 * @since 0.71 771 * @deprecated 2.1 772 * @deprecated Use wp_get_archives() 773 * @see wp_get_archives() 774 * 775 * @param string $type 776 * @param string $limit 777 * @param string $format 778 * @param string $before 779 * @param string $after 780 * @param bool $show_post_count 781 * @return unknown 782 */ 783 function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) { 784 _deprecated_function( __FUNCTION__, '2.1', 'wp_get_archives()' ); 785 $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count'); 786 return wp_get_archives($args); 787 } 788 789 /** 790 * Returns or Prints link to the author's posts. 791 * 792 * @since 1.2 793 * @deprecated 2.1 794 * @deprecated Use get_author_posts_url() 795 * @see get_author_posts_url() 796 * 797 * @param bool $echo Optional. 798 * @param int $author_id Required. 799 * @param string $author_nicename Optional. 800 * @return string|null 801 */ 802 function get_author_link($echo = false, $author_id, $author_nicename = '') { 803 _deprecated_function( __FUNCTION__, '2.1', 'get_author_posts_url()' ); 804 805 $link = get_author_posts_url($author_id, $author_nicename); 806 807 if ( $echo ) 808 echo $link; 809 return $link; 810 } 811 812 /** 813 * Print list of pages based on arguments. 814 * 815 * @since 0.71 816 * @deprecated 2.1 817 * @deprecated Use wp_link_pages() 818 * @see wp_link_pages() 819 * 820 * @param string $before 821 * @param string $after 822 * @param string $next_or_number 823 * @param string $nextpagelink 824 * @param string $previouspagelink 825 * @param string $pagelink 826 * @param string $more_file 827 * @return string 828 */ 829 function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page', 830 $pagelink='%', $more_file='') { 831 _deprecated_function( __FUNCTION__, '2.1', 'wp_link_pages()' ); 832 833 $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file'); 834 return wp_link_pages($args); 835 } 836 837 /** 838 * Get value based on option. 839 * 840 * @since 0.71 841 * @deprecated 2.1 842 * @deprecated Use get_option() 843 * @see get_option() 844 * 845 * @param string $option 846 * @return string 847 */ 848 function get_settings($option) { 849 _deprecated_function( __FUNCTION__, '2.1', 'get_option()' ); 850 851 return get_option($option); 852 } 853 854 /** 855 * Print the permalink of the current post in the loop. 856 * 857 * @since 0.71 858 * @deprecated 1.2 859 * @deprecated Use the_permalink() 860 * @see the_permalink() 861 */ 862 function permalink_link() { 863 _deprecated_function( __FUNCTION__, '1.2', 'the_permalink()' ); 864 the_permalink(); 865 } 866 867 /** 868 * Print the permalink to the RSS feed. 869 * 870 * @since 0.71 871 * @deprecated 2.3 872 * @deprecated Use the_permalink_rss() 873 * @see the_permalink_rss() 874 * 875 * @param string $file 876 */ 877 function permalink_single_rss($deprecated = '') { 878 _deprecated_function( __FUNCTION__, '0.0', 'the_permalink_rss()' ); 879 the_permalink_rss(); 880 } 881 882 /** 883 * Gets the links associated with category. 884 * 885 * @see get_links() for argument information that can be used in $args 886 * @since 1.0.1 887 * @deprecated 2.1 888 * @deprecated Use wp_list_bookmarks() 889 * @see wp_list_bookmarks() 890 * 891 * @param string $args a query string 892 * @return null|string 893 */ 894 function wp_get_links($args = '') { 895 _deprecated_function( __FUNCTION__, '0.0', 'wp_list_bookmarks()' ); 896 897 if ( strpos( $args, '=' ) === false ) { 898 $cat_id = $args; 899 $args = add_query_arg( 'category', $cat_id, $args ); 900 } 901 902 $defaults = array( 903 'after' => '<br />', 904 'before' => '', 905 'between' => ' ', 906 'categorize' => 0, 907 'category' => '', 908 'echo' => true, 909 'limit' => -1, 910 'orderby' => 'name', 911 'show_description' => true, 912 'show_images' => true, 913 'show_rating' => false, 914 'show_updated' => true, 915 'title_li' => '', 916 ); 917 918 $r = wp_parse_args( $args, $defaults ); 919 920 return wp_list_bookmarks($r); 921 } 922 923 /** 924 * Gets the links associated with category by id. 925 * 926 * @since 0.71 927 * @deprecated 2.1 928 * @deprecated Use get_bookmarks() 929 * @see get_bookmarks() 930 * 931 * @param int $category The category to use. If no category supplied uses all 932 * @param string $before the html to output before the link 933 * @param string $after the html to output after the link 934 * @param string $between the html to output between the link/image and its description. 935 * Not used if no image or show_images == true 936 * @param bool $show_images whether to show images (if defined). 937 * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', 938 * 'description', or 'rating'. Or maybe owner. If you start the name with an 939 * underscore the order will be reversed. You can also specify 'rand' as the order 940 * which will return links in a random order. 941 * @param bool $show_description whether to show the description if show_images=false/not defined. 942 * @param bool $show_rating show rating stars/chars 943 * @param int $limit Limit to X entries. If not specified, all entries are shown. 944 * @param int $show_updated whether to show last updated timestamp 945 * @param bool $echo whether to echo the results, or return them instead 946 * @return null|string 947 */ 948 function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name', 949 $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) { 950 _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' ); 951 952 $order = 'ASC'; 953 if ( substr($orderby, 0, 1) == '_' ) { 954 $order = 'DESC'; 955 $orderby = substr($orderby, 1); 956 } 957 958 if ( $category == -1 ) //get_bookmarks uses '' to signify all categories 959 $category = ''; 960 961 $results = get_bookmarks(array('category' => $category, 'orderby' => $orderby, 'order' => $order, 'show_updated' => $show_updated, 'limit' => $limit)); 962 963 if ( !$results ) 964 return; 965 966 $output = ''; 967 968 foreach ( (array) $results as $row ) { 969 if ( !isset($row->recently_updated) ) 970 $row->recently_updated = false; 971 $output .= $before; 972 if ( $show_updated && $row->recently_updated ) 973 $output .= get_option('links_recently_updated_prepend'); 974 $the_link = '#'; 975 if ( !empty($row->link_url) ) 976 $the_link = esc_url($row->link_url); 977 $rel = $row->link_rel; 978 if ( '' != $rel ) 979 $rel = ' rel="' . $rel . '"'; 980 981 $desc = esc_attr(sanitize_bookmark_field('link_description', $row->link_description, $row->link_id, 'display')); 982 $name = esc_attr(sanitize_bookmark_field('link_name', $row->link_name, $row->link_id, 'display')); 983 $title = $desc; 984 985 if ( $show_updated ) 986 if (substr($row->link_updated_f, 0, 2) != '00') 987 $title .= ' ('.__('Last updated') . ' ' . date(get_option('links_updated_date_format'), $row->link_updated_f + (get_option('gmt_offset') * 3600)) . ')'; 988 989 if ( '' != $title ) 990 $title = ' title="' . $title . '"'; 991 992 $alt = ' alt="' . $name . '"'; 993 994 $target = $row->link_target; 995 if ( '' != $target ) 996 $target = ' target="' . $target . '"'; 997 998 $output .= '<a href="' . $the_link . '"' . $rel . $title . $target. '>'; 999 1000 if ( $row->link_image != null && $show_images ) { 1001 if ( strpos($row->link_image, 'http') !== false ) 1002 $output .= "<img src=\"$row->link_image\" $alt $title />"; 1003 else // If it's a relative path 1004 $output .= "<img src=\"" . get_option('siteurl') . "$row->link_image\" $alt $title />"; 1005 } else { 1006 $output .= $name; 1007 } 1008 1009 $output .= '</a>'; 1010 1011 if ( $show_updated && $row->recently_updated ) 1012 $output .= get_option('links_recently_updated_append'); 1013 1014 if ( $show_description && '' != $desc ) 1015 $output .= $between . $desc; 1016 1017 if ($show_rating) { 1018 $output .= $between . get_linkrating($row); 1019 } 1020 1021 $output .= "$after\n"; 1022 } // end while 1023 1024 if ( !$echo ) 1025 return $output; 1026 echo $output; 1027 } 1028 1029 /** 1030 * Output entire list of links by category. 1031 * 1032 * Output a list of all links, listed by category, using the settings in 1033 * $wpdb->linkcategories and output it as a nested HTML unordered list. 1034 * 1035 * @since 1.0.1 1036 * @deprecated 2.1 1037 * @deprecated Use wp_list_bookmarks() 1038 * @see wp_list_bookmarks() 1039 * 1040 * @param string $order Sort link categories by 'name' or 'id' 1041 */ 1042 function get_links_list($order = 'name') { 1043 _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' ); 1044 1045 $order = strtolower($order); 1046 1047 // Handle link category sorting 1048 $direction = 'ASC'; 1049 if ( '_' == substr($order,0,1) ) { 1050 $direction = 'DESC'; 1051 $order = substr($order,1); 1052 } 1053 1054 if ( !isset($direction) ) 1055 $direction = ''; 1056 1057 $cats = get_categories(array('type' => 'link', 'orderby' => $order, 'order' => $direction, 'hierarchical' => 0)); 1058 1059 // Display each category 1060 if ( $cats ) { 1061 foreach ( (array) $cats as $cat ) { 1062 // Handle each category. 1063 1064 // Display the category name 1065 echo ' <li id="linkcat-' . $cat->term_id . '" class="linkcat"><h2>' . apply_filters('link_category', $cat->name ) . "</h2>\n\t<ul>\n"; 1066 // Call get_links() with all the appropriate params 1067 get_links($cat->term_id, '<li>', "</li>", "\n", true, 'name', false); 1068 1069 // Close the last category 1070 echo "\n\t</ul>\n</li>\n"; 1071 } 1072 } 1073 } 1074 1075 /** 1076 * Show the link to the links popup and the number of links. 1077 * 1078 * @since 0.71 1079 * @deprecated 2.1 1080 * @deprecated {@internal Use function instead is unknown}} 1081 * 1082 * @param string $text the text of the link 1083 * @param int $width the width of the popup window 1084 * @param int $height the height of the popup window 1085 * @param string $file the page to open in the popup window 1086 * @param bool $count the number of links in the db 1087 */ 1088 function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) { 1089 _deprecated_function( __FUNCTION__, '2.1' ); 1090 1091 if ( $count ) 1092 $counts = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->links"); 1093 1094 $javascript = "<a href=\"#\" onclick=\"javascript:window.open('$file?popup=1', '_blank', 'width=$width,height=$height,scrollbars=yes,status=no'); return false\">"; 1095 $javascript .= $text; 1096 1097 if ( $count ) 1098 $javascript .= " ($counts)"; 1099 1100 $javascript .= "</a>\n\n"; 1101 echo $javascript; 1102 } 1103 1104 /** 1105 * @since 1.0.1 1106 * @deprecated 2.1 1107 * @deprecated Use sanitize_bookmark_field() 1108 * @see sanitize_bookmark_field() 1109 * 1110 * @param object $link 1111 * @return unknown 1112 */ 1113 function get_linkrating($link) { 1114 _deprecated_function( __FUNCTION__, '2.1', 'sanitize_bookmark_field()' ); 1115 return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display'); 1116 } 1117 1118 /** 1119 * Gets the name of category by id. 1120 * 1121 * @since 0.71 1122 * @deprecated 2.1 1123 * @deprecated Use get_category() 1124 * @see get_category() 1125 * 1126 * @param int $id The category to get. If no category supplied uses 0 1127 * @return string 1128 */ 1129 function get_linkcatname($id = 0) { 1130 _deprecated_function( __FUNCTION__, '2.1', 'get_category()' ); 1131 1132 $id = (int) $id; 1133 1134 if ( empty($id) ) 1135 return ''; 1136 1137 $cats = wp_get_link_cats($id); 1138 1139 if ( empty($cats) || ! is_array($cats) ) 1140 return ''; 1141 1142 $cat_id = (int) $cats[0]; // Take the first cat. 1143 1144 $cat = get_category($cat_id); 1145 return $cat->name; 1146 } 1147 1148 /** 1149 * Print RSS comment feed link. 1150 * 1151 * @since 1.0.1 1152 * @deprecated 2.5 1153 * @deprecated Use post_comments_feed_link() 1154 * @see post_comments_feed_link() 1155 * 1156 * @param string $link_text 1157 */ 1158 function comments_rss_link($link_text = 'Comments RSS') { 1159 _deprecated_function( __FUNCTION__, '2.5', 'post_comments_feed_link()' ); 1160 post_comments_feed_link($link_text); 1161 } 1162 1163 /** 1164 * Print/Return link to category RSS2 feed. 1165 * 1166 * @since 1.2 1167 * @deprecated 2.5 1168 * @deprecated Use get_category_feed_link() 1169 * @see get_category_feed_link() 1170 * 1171 * @param bool $echo 1172 * @param int $cat_ID 1173 * @return string|null 1174 */ 1175 function get_category_rss_link($echo = false, $cat_ID = 1) { 1176 _deprecated_function( __FUNCTION__, '2.5', 'get_category_feed_link()' ); 1177 1178 $link = get_category_feed_link($cat_ID, 'rss2'); 1179 1180 if ( $echo ) 1181 echo $link; 1182 return $link; 1183 } 1184 1185 /** 1186 * Print/Return link to author RSS feed. 1187 * 1188 * @since 1.2 1189 * @deprecated 2.5 1190 * @deprecated Use get_author_feed_link() 1191 * @see get_author_feed_link() 1192 * 1193 * @param bool $echo 1194 * @param int $author_id 1195 * @return string|null 1196 */ 1197 function get_author_rss_link($echo = false, $author_id = 1) { 1198 _deprecated_function( __FUNCTION__, '2.5', 'get_author_feed_link()' ); 1199 1200 $link = get_author_feed_link($author_id); 1201 if ( $echo ) 1202 echo $link; 1203 return $link; 1204 } 1205 1206 /** 1207 * Return link to the post RSS feed. 1208 * 1209 * @since 1.5 1210 * @deprecated 2.2 1211 * @deprecated Use get_post_comments_feed_link() 1212 * @see get_post_comments_feed_link() 1213 * 1214 * @return string 1215 */ 1216 function comments_rss() { 1217 _deprecated_function( __FUNCTION__, '2.2', 'get_post_comments_feed_link()' ); 1218 return get_post_comments_feed_link(); 1219 } 1220 1221 /** 1222 * An alias of wp_create_user(). 1223 * 1224 * @since 2.0 1225 * @deprecated 2.0 1226 * @deprecated Use wp_create_user() 1227 * @see wp_create_user() 1228 * 1229 * @param string $username The user's username. 1230 * @param string $password The user's password. 1231 * @param string $email The user's email (optional). 1232 * @return int The new user's ID. 1233 */ 1234 function create_user($username, $password, $email) { 1235 _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' ); 1236 return wp_create_user($username, $password, $email); 1237 } 1238 1239 /** 1240 * Unused function. 1241 * 1242 * @deprecated 2.5 1243 */ 1244 function gzip_compression() { 1245 _deprecated_function( __FUNCTION__, '2.5' ); 1246 return false; 1247 } 1248 1249 /** 1250 * Retrieve an array of comment data about comment $comment_ID. 1251 * 1252 * @since 0.71 1253 * @deprecated 2.7 1254 * @deprecated Use get_comment() 1255 * @see get_comment() 1256 * 1257 * @param int $comment_ID The ID of the comment 1258 * @param int $no_cache Whether to use the cache (cast to bool) 1259 * @param bool $include_unapproved Whether to include unapproved comments 1260 * @return array The comment data 1261 */ 1262 function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = false ) { 1263 _deprecated_function( __FUNCTION__, '2.7', 'get_comment()' ); 1264 return get_comment($comment_ID, ARRAY_A); 1265 } 1266 1267 /** 1268 * Retrieve the category name by the category ID. 1269 * 1270 * @since 0.71 1271 * @deprecated 2.8 1272 * @deprecated Use get_cat_name() 1273 * @see get_cat_name() 1274 * 1275 * @param int $cat_ID Category ID 1276 * @return string category name 1277 */ 1278 function get_catname( $cat_ID ) { 1279 _deprecated_function( __FUNCTION__, '2.8', 'get_cat_name()' ); 1280 return get_cat_name( $cat_ID ); 1281 } 1282 1283 /** 1284 * Retrieve category children list separated before and after the term IDs. 1285 * 1286 * @since 1.2.0 1287 * @deprecated 2.8 1288 * @deprecated Use get_term_children() 1289 * @see get_term_children() 1290 * 1291 * @param int $id Category ID to retrieve children. 1292 * @param string $before Optional. Prepend before category term ID. 1293 * @param string $after Optional, default is empty string. Append after category term ID. 1294 * @param array $visited Optional. Category Term IDs that have already been added. 1295 * @return string 1296 */ 1297 function get_category_children( $id, $before = '/', $after = '', $visited = array() ) { 1298 _deprecated_function( __FUNCTION__, '2.8', 'get_term_children()' ); 1299 if ( 0 == $id ) 1300 return ''; 1301 1302 $chain = ''; 1303 /** TODO: consult hierarchy */ 1304 $cat_ids = get_all_category_ids(); 1305 foreach ( (array) $cat_ids as $cat_id ) { 1306 if ( $cat_id == $id ) 1307 continue; 1308 1309 $category = get_category( $cat_id ); 1310 if ( is_wp_error( $category ) ) 1311 return $category; 1312 if ( $category->parent == $id && !in_array( $category->term_id, $visited ) ) { 1313 $visited[] = $category->term_id; 1314 $chain .= $before.$category->term_id.$after; 1315 $chain .= get_category_children( $category->term_id, $before, $after ); 1316 } 1317 } 1318 return $chain; 1319 } 1320 1321 /** 1322 * Retrieve the description of the author of the current post. 1323 * 1324 * @since 1.5 1325 * @deprecated 2.8 1326 * @deprecated Use the_author_meta('description') 1327 * @see get_the_author_meta() 1328 * 1329 * @return string The author's description. 1330 */ 1331 function get_the_author_description() { 1332 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' ); 1333 return get_the_author_meta('description'); 1334 } 1335 1336 /** 1337 * Display the description of the author of the current post. 1338 * 1339 * @since 1.0.0 1340 * @deprecated 2.8 1341 * @deprecated Use the_author_meta('description') 1342 * @see the_author_meta() 1343 */ 1344 function the_author_description() { 1345 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')' ); 1346 the_author_meta('description'); 1347 } 1348 1349 /** 1350 * Retrieve the login name of the author of the current post. 1351 * 1352 * @since 1.5 1353 * @deprecated 2.8 1354 * @deprecated Use the_author_meta('login') 1355 * @see get_the_author_meta() 1356 * 1357 * @return string The author's login name (username). 1358 */ 1359 function get_the_author_login() { 1360 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' ); 1361 return get_the_author_meta('login'); 1362 } 1363 1364 /** 1365 * Display the login name of the author of the current post. 1366 * 1367 * @since 0.71 1368 * @deprecated 2.8 1369 * @deprecated Use the_author_meta('login') 1370 * @see the_author_meta() 1371 */ 1372 function the_author_login() { 1373 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')' ); 1374 the_author_meta('login'); 1375 } 1376 1377 /** 1378 * Retrieve the first name of the author of the current post. 1379 * 1380 * @since 1.5 1381 * @deprecated 2.8 1382 * @deprecated Use the_author_meta('first_name') 1383 * @see get_the_author_meta() 1384 * 1385 * @return string The author's first name. 1386 */ 1387 function get_the_author_firstname() { 1388 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' ); 1389 return get_the_author_meta('first_name'); 1390 } 1391 1392 /** 1393 * Display the first name of the author of the current post. 1394 * 1395 * @since 0.71 1396 * @deprecated 2.8 1397 * @deprecated Use the_author_meta('first_name') 1398 * @see the_author_meta() 1399 */ 1400 function the_author_firstname() { 1401 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' ); 1402 the_author_meta('first_name'); 1403 } 1404 1405 /** 1406 * Retrieve the last name of the author of the current post. 1407 * 1408 * @since 1.5 1409 * @deprecated 2.8 1410 * @deprecated Use get_the_author_meta('last_name') 1411 * @see get_the_author_meta() 1412 * 1413 * @return string The author's last name. 1414 */ 1415 function get_the_author_lastname() { 1416 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' ); 1417 return get_the_author_meta('last_name'); 1418 } 1419 1420 /** 1421 * Display the last name of the author of the current post. 1422 * 1423 * @since 0.71 1424 * @deprecated 2.8 1425 * @deprecated Use the_author_meta('last_name') 1426 * @see the_author_meta() 1427 */ 1428 function the_author_lastname() { 1429 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' ); 1430 the_author_meta('last_name'); 1431 } 1432 1433 /** 1434 * Retrieve the nickname of the author of the current post. 1435 * 1436 * @since 1.5 1437 * @deprecated 2.8 1438 * @deprecated Use get_the_author_meta('nickname') 1439 * @see get_the_author_meta() 1440 * 1441 * @return string The author's nickname. 1442 */ 1443 function get_the_author_nickname() { 1444 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' ); 1445 return get_the_author_meta('nickname'); 1446 } 1447 1448 /** 1449 * Display the nickname of the author of the current post. 1450 * 1451 * @since 0.71 1452 * @deprecated 2.8 1453 * @deprecated Use the_author_meta('nickname') 1454 * @see the_author_meta() 1455 */ 1456 function the_author_nickname() { 1457 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' ); 1458 the_author_meta('nickname'); 1459 } 1460 1461 /** 1462 * Retrieve the email of the author of the current post. 1463 * 1464 * @since 1.5 1465 * @deprecated 2.8 1466 * @deprecated Use get_the_author_meta('email') 1467 * @see get_the_author_meta() 1468 * 1469 * @return string The author's username. 1470 */ 1471 function get_the_author_email() { 1472 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' ); 1473 return get_the_author_meta('email'); 1474 } 1475 1476 /** 1477 * Display the email of the author of the current post. 1478 * 1479 * @since 0.71 1480 * @deprecated 2.8 1481 * @deprecated Use the_author_meta('email') 1482 * @see the_author_meta() 1483 */ 1484 function the_author_email() { 1485 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')' ); 1486 the_author_meta('email'); 1487 } 1488 1489 /** 1490 * Retrieve the ICQ number of the author of the current post. 1491 * 1492 * @since 1.5 1493 * @deprecated 2.8 1494 * @deprecated Use get_the_author_meta('icq') 1495 * @see get_the_author_meta() 1496 * 1497 * @return string The author's ICQ number. 1498 */ 1499 function get_the_author_icq() { 1500 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' ); 1501 return get_the_author_meta('icq'); 1502 } 1503 1504 /** 1505 * Display the ICQ number of the author of the current post. 1506 * 1507 * @since 0.71 1508 * @deprecated 2.8 1509 * @deprecated Use the_author_meta('icq') 1510 * @see the_author_meta() 1511 */ 1512 function the_author_icq() { 1513 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')' ); 1514 the_author_meta('icq'); 1515 } 1516 1517 /** 1518 * Retrieve the Yahoo! IM name of the author of the current post. 1519 * 1520 * @since 1.5 1521 * @deprecated 2.8 1522 * @deprecated Use get_the_author_meta('yim') 1523 * @see get_the_author_meta() 1524 * 1525 * @return string The author's Yahoo! IM name. 1526 */ 1527 function get_the_author_yim() { 1528 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' ); 1529 return get_the_author_meta('yim'); 1530 } 1531 1532 /** 1533 * Display the Yahoo! IM name of the author of the current post. 1534 * 1535 * @since 0.71 1536 * @deprecated 2.8 1537 * @deprecated Use the_author_meta('yim') 1538 * @see the_author_meta() 1539 */ 1540 function the_author_yim() { 1541 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')' ); 1542 the_author_meta('yim'); 1543 } 1544 1545 /** 1546 * Retrieve the MSN address of the author of the current post. 1547 * 1548 * @since 1.5 1549 * @deprecated 2.8 1550 * @deprecated Use get_the_author_meta('msn') 1551 * @see get_the_author_meta() 1552 * 1553 * @return string The author's MSN address. 1554 */ 1555 function get_the_author_msn() { 1556 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' ); 1557 return get_the_author_meta('msn'); 1558 } 1559 1560 /** 1561 * Display the MSN address of the author of the current post. 1562 * 1563 * @since 0.71 1564 * @deprecated 2.8 1565 * @deprecated Use the_author_meta('msn') 1566 * @see the_author_meta() 1567 */ 1568 function the_author_msn() { 1569 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')' ); 1570 the_author_meta('msn'); 1571 } 1572 1573 /** 1574 * Retrieve the AIM address of the author of the current post. 1575 * 1576 * @since 1.5 1577 * @deprecated 2.8 1578 * @deprecated Use get_the_author_meta('aim') 1579 * @see get_the_author_meta() 1580 * 1581 * @return string The author's AIM address. 1582 */ 1583 function get_the_author_aim() { 1584 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' ); 1585 return get_the_author_meta('aim'); 1586 } 1587 1588 /** 1589 * Display the AIM address of the author of the current post. 1590 * 1591 * @since 0.71 1592 * @see the_author_meta() 1593 * @deprecated 2.8 1594 * @deprecated Use the_author_meta('aim') 1595 */ 1596 function the_author_aim() { 1597 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')' ); 1598 the_author_meta('aim'); 1599 } 1600 1601 /** 1602 * Retrieve the specified author's preferred display name. 1603 * 1604 * @since 1.0.0 1605 * @deprecated 2.8 1606 * @deprecated Use get_the_author_meta('display_name') 1607 * @see get_the_author_meta() 1608 * 1609 * @param int $auth_id The ID of the author. 1610 * @return string The author's display name. 1611 */ 1612 function get_author_name( $auth_id = false ) { 1613 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' ); 1614 return get_the_author_meta('display_name', $auth_id); 1615 } 1616 1617 /** 1618 * Retrieve the URL to the home page of the author of the current post. 1619 * 1620 * @since 1.5 1621 * @deprecated 2.8 1622 * @deprecated Use get_the_author_meta('url') 1623 * @see get_the_author_meta() 1624 * 1625 * @return string The URL to the author's page. 1626 */ 1627 function get_the_author_url() { 1628 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'url\')' ); 1629 return get_the_author_meta('url'); 1630 } 1631 1632 /** 1633 * Display the URL to the home page of the author of the current post. 1634 * 1635 * @since 0.71 1636 * @deprecated 2.8 1637 * @deprecated Use the_author_meta('url') 1638 * @see the_author_meta() 1639 */ 1640 function the_author_url() { 1641 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')' ); 1642 the_author_meta('url'); 1643 } 1644 1645 /** 1646 * Retrieve the ID of the author of the current post. 1647 * 1648 * @since 1.5 1649 * @deprecated 2.8 1650 * @deprecated Use get_the_author_meta('ID') 1651 * @see get_the_author_meta() 1652 * 1653 * @return int The author's ID. 1654 */ 1655 function get_the_author_ID() { 1656 _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')' ); 1657 return get_the_author_meta('ID'); 1658 } 1659 1660 /** 1661 * Display the ID of the author of the current post. 1662 * 1663 * @since 0.71 1664 * @deprecated 2.8 1665 * @deprecated Use the_author_meta('ID') 1666 * @see the_author_meta() 1667 */ 1668 function the_author_ID() { 1669 _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')' ); 1670 the_author_meta('ID'); 1671 } 1672 1673 /** 1674 * Display the post content for the feed. 1675 * 1676 * For encoding the html or the $encode_html parameter, there are three possible 1677 * values. '0' will make urls footnotes and use make_url_footnote(). '1' will 1678 * encode special characters and automatically display all of the content. The 1679 * value of '2' will strip all HTML tags from the content. 1680 * 1681 * Also note that you cannot set the amount of words and not set the html 1682 * encoding. If that is the case, then the html encoding will default to 2, 1683 * which will strip all HTML tags. 1684 * 1685 * To restrict the amount of words of the content, you can use the cut 1686 * parameter. If the content is less than the amount, then there won't be any 1687 * dots added to the end. If there is content left over, then dots will be added 1688 * and the rest of the content will be removed. 1689 * 1690 * @package WordPress 1691 * @subpackage Feed 1692 * @since 0.71 1693 * @uses apply_filters() Calls 'the_content_rss' on the content before processing. 1694 * @see get_the_content() For the $more_link_text, $stripteaser, and $more_file 1695 * parameters. 1696 * 1697 * @deprecated 2.9.0 1698 * @deprecated Use the_content_feed() 1699 * @see the_content_feed() 1700 * 1701 * @param string $more_link_text Optional. Text to display when more content is available but not displayed. 1702 * @param int|bool $stripteaser Optional. Default is 0. 1703 * @param string $more_file Optional. 1704 * @param int $cut Optional. Amount of words to keep for the content. 1705 * @param int $encode_html Optional. How to encode the content. 1706 */ 1707 function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) { 1708 _deprecated_function( __FUNCTION__, '2.9', 'the_content_feed' ); 1709 $content = get_the_content($more_link_text, $stripteaser, $more_file); 1710 $content = apply_filters('the_content_rss', $content); 1711 if ( $cut && !$encode_html ) 1712 $encode_html = 2; 1713 if ( 1== $encode_html ) { 1714 $content = esc_html($content); 1715 $cut = 0; 1716 } elseif ( 0 == $encode_html ) { 1717 $content = make_url_footnote($content); 1718 } elseif ( 2 == $encode_html ) { 1719 $content = strip_tags($content); 1720 } 1721 if ( $cut ) { 1722 $blah = explode(' ', $content); 1723 if ( count($blah) > $cut ) { 1724 $k = $cut; 1725 $use_dotdotdot = 1; 1726 } else { 1727 $k = count($blah); 1728 $use_dotdotdot = 0; 1729 } 1730 1731 /** @todo Check performance, might be faster to use array slice instead. */ 1732 for ( $i=0; $i<$k; $i++ ) 1733 $excerpt .= $blah[$i].' '; 1734 $excerpt .= ($use_dotdotdot) ? '...' : ''; 1735 $content = $excerpt; 1736 } 1737 $content = str_replace(']]>', ']]>', $content); 1738 echo $content; 1739 } 1740 1741 /** 1742 * Strip HTML and put links at the bottom of stripped content. 1743 * 1744 * Searches for all of the links, strips them out of the content, and places 1745 * them at the bottom of the content with numbers. 1746 * 1747 * @since 0.71 1748 * @deprecated 2.9.0 1749 * 1750 * @param string $content Content to get links 1751 * @return string HTML stripped out of content with links at the bottom. 1752 */ 1753 function make_url_footnote( $content ) { 1754 _deprecated_function( __FUNCTION__, '2.9', '' ); 1755 preg_match_all( '/<a(.+?)href=\"(.+?)\"(.*?)>(.+?)<\/a>/', $content, $matches ); 1756 $links_summary = "\n"; 1757 for ( $i=0; $i<count($matches[0]); $i++ ) { 1758 $link_match = $matches[0][$i]; 1759 $link_number = '['.($i+1).']'; 1760 $link_url = $matches[2][$i]; 1761 $link_text = $matches[4][$i]; 1762 $content = str_replace( $link_match, $link_text . ' ' . $link_number, $content ); 1763 $link_url = ( ( strtolower( substr( $link_url, 0, 7 ) ) != 'http://' ) && ( strtolower( substr( $link_url, 0, 8 ) ) != 'https://' ) ) ? get_option( 'home' ) . $link_url : $link_url; 1764 $links_summary .= "\n" . $link_number . ' ' . $link_url; 1765 } 1766 $content = strip_tags( $content ); 1767 $content .= $links_summary; 1768 return $content; 1769 } 1770 1771 /** 1772 * Retrieve translated string with vertical bar context 1773 * 1774 * Quite a few times, there will be collisions with similar translatable text 1775 * found in more than two places but with different translated context. 1776 * 1777 * In order to use the separate contexts, the _c() function is used and the 1778 * translatable string uses a pipe ('|') which has the context the string is in. 1779 * 1780 * When the translated string is returned, it is everything before the pipe, not 1781 * including the pipe character. If there is no pipe in the translated text then 1782 * everything is returned. 1783 * 1784 * @since 2.2.0 1785 * @deprecated 2.9.0 1786 * @deprecated Use _x() 1787 * @see _x() 1788 * 1789 * @param string $text Text to translate 1790 * @param string $domain Optional. Domain to retrieve the translated text 1791 * @return string Translated context string without pipe 1792 */ 1793 function _c( $text, $domain = 'default' ) { 1794 _deprecated_function( __FUNCTION__, '2.9', '_x()' ); 1795 return before_last_bar( translate( $text, $domain ) ); 1796 } 1797 1798 /** 1799 * Translates $text like translate(), but assumes that the text 1800 * contains a context after its last vertical bar. 1801 * 1802 * @since 2.5 1803 * @uses translate() 1804 * @deprecated 3.0.0 1805 * @deprecated Use _x() 1806 * @see _x() 1807 * 1808 * @param string $text Text to translate 1809 * @param string $domain Domain to retrieve the translated text 1810 * @return string Translated text 1811 */ 1812 function translate_with_context( $text, $domain = 'default' ) { 1813 _deprecated_function( __FUNCTION__, '2.9', '_x()' ); 1814 return before_last_bar( translate( $text, $domain ) ); 1815 } 1816 1817 /** 1818 * A version of _n(), which supports contexts. 1819 * Strips everything from the translation after the last bar. 1820 * 1821 * @since 2.7.0 1822 * @deprecated 3.0.0 1823 * @deprecated Use _nx() 1824 * @see _nx() 1825 * @see _n() For parameters. 1826 * @see _c() For parameters. _c() is deprecated. 1827 * 1828 */ 1829 function _nc( $single, $plural, $number, $domain = 'default' ) { 1830 _deprecated_function( __FUNCTION__, '2.9', '_nx()' ); 1831 return before_last_bar( _n( $single, $plural, $number, $domain ) ); 1832 } 1833 1834 /** 1835 * Retrieve the plural or single form based on the amount. 1836 * 1837 * @since 1.2.0 1838 * @deprecated 2.8.0 1839 * @deprecated Use _n() 1840 * @see _n() 1841 */ 1842 function __ngettext() { 1843 _deprecated_function( __FUNCTION__, '2.8', '_n()' ); 1844 $args = func_get_args(); 1845 return call_user_func_array('_n', $args); 1846 } 1847 1848 /** 1849 * Register plural strings in POT file, but don't translate them. 1850 * 1851 * @since 2.5 1852 * @deprecated 2.8.0 1853 * @deprecated Use _n_noop() 1854 * @see _n_noop() 1855 */ 1856 function __ngettext_noop() { 1857 _deprecated_function( __FUNCTION__, '2.8', '_n_noop()' ); 1858 $args = func_get_args(); 1859 return call_user_func_array('_n_noop', $args); 1860 1861 } 1862 1863 /** 1864 * Retrieve all autoload options, or all options if no autoloaded ones exist. 1865 * 1866 * @since 1.0.0 1867 * @deprecated 3.0.0 1868 * @deprecated Use wp_load_alloptions()) 1869 * @see wp_load_alloptions() 1870 * 1871 * @return array List of all options. 1872 */ 1873 function get_alloptions() { 1874 _deprecated_function( __FUNCTION__, '3.0', 'wp_load_alloptions()' ); 1875 return wp_load_alloptions(); 1876 } 1877 1878 /** 1879 * Retrieve HTML content of attachment image with link. 1880 * 1881 * @since 2.0.0 1882 * @deprecated 2.5.0 1883 * @deprecated Use wp_get_attachment_link() 1884 * @see wp_get_attachment_link() 1885 * 1886 * @param int $id Optional. Post ID. 1887 * @param bool $fullsize Optional, default is false. Whether to use full size image. 1888 * @param array $max_dims Optional. Max image dimensions. 1889 * @param bool $permalink Optional, default is false. Whether to include permalink to image. 1890 * @return string 1891 */ 1892 function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false) { 1893 _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_link()' ); 1894 $id = (int) $id; 1895 $_post = & get_post($id); 1896 1897 if ( ('attachment' != $_post->post_type) || !$url = wp_get_attachment_url($_post->ID) ) 1898 return __('Missing Attachment'); 1899 1900 if ( $permalink ) 1901 $url = get_attachment_link($_post->ID); 1902 1903 $post_title = esc_attr($_post->post_title); 1904 1905 $innerHTML = get_attachment_innerHTML($_post->ID, $fullsize, $max_dims); 1906 return "<a href='$url' title='$post_title'>$innerHTML</a>"; 1907 } 1908 1909 /** 1910 * Retrieve icon URL and Path. 1911 * 1912 * @since 2.1.0 1913 * @deprecated 2.5.0 1914 * @deprecated Use wp_get_attachment_image_src() 1915 * @see wp_get_attachment_image_src() 1916 * 1917 * @param int $id Optional. Post ID. 1918 * @param bool $fullsize Optional, default to false. Whether to have full image. 1919 * @return array Icon URL and full path to file, respectively. 1920 */ 1921 function get_attachment_icon_src( $id = 0, $fullsize = false ) { 1922 _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image_src()' ); 1923 $id = (int) $id; 1924 if ( !$post = & get_post($id) ) 1925 return false; 1926 1927 $file = get_attached_file( $post->ID ); 1928 1929 if ( !$fullsize && $src = wp_get_attachment_thumb_url( $post->ID ) ) { 1930 // We have a thumbnail desired, specified and existing 1931 1932 $src_file = basename($src); 1933 $class = 'attachmentthumb'; 1934 } elseif ( wp_attachment_is_image( $post->ID ) ) { 1935 // We have an image without a thumbnail 1936 1937 $src = wp_get_attachment_url( $post->ID ); 1938 $src_file = & $file; 1939 $class = 'attachmentimage'; 1940 } elseif ( $src = wp_mime_type_icon( $post->ID ) ) { 1941 // No thumb, no image. We'll look for a mime-related icon instead. 1942 1943 $icon_dir = apply_filters( 'icon_dir', get_template_directory() . '/images' ); 1944 $src_file = $icon_dir . '/' . basename($src); 1945 } 1946 1947 if ( !isset($src) || !$src ) 1948 return false; 1949 1950 return array($src, $src_file); 1951 } 1952 1953 /** 1954 * Retrieve HTML content of icon attachment image element. 1955 * 1956 * @since 2.0.0 1957 * @deprecated 2.5.0 1958 * @deprecated Use wp_get_attachment_image() 1959 * @see wp_get_attachment_image() 1960 * 1961 * @param int $id Optional. Post ID. 1962 * @param bool $fullsize Optional, default to false. Whether to have full size image. 1963 * @param array $max_dims Optional. Dimensions of image. 1964 * @return string HTML content. 1965 */ 1966 function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) { 1967 _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' ); 1968 $id = (int) $id; 1969 if ( !$post = & get_post($id) ) 1970 return false; 1971 1972 if ( !$src = get_attachment_icon_src( $post->ID, $fullsize ) ) 1973 return false; 1974 1975 list($src, $src_file) = $src; 1976 1977 // Do we need to constrain the image? 1978 if ( ($max_dims = apply_filters('attachment_max_dims', $max_dims)) && file_exists($src_file) ) { 1979 1980 $imagesize = getimagesize($src_file); 1981 1982 if (($imagesize[0] > $max_dims[0]) || $imagesize[1] > $max_dims[1] ) { 1983 $actual_aspect = $imagesize[0] / $imagesize[1]; 1984 $desired_aspect = $max_dims[0] / $max_dims[1]; 1985 1986 if ( $actual_aspect >= $desired_aspect ) { 1987 $height = $actual_aspect * $max_dims[0]; 1988 $constraint = "width='{$max_dims[0]}' "; 1989 $post->iconsize = array($max_dims[0], $height); 1990 } else { 1991 $width = $max_dims[1] / $actual_aspect; 1992 $constraint = "height='{$max_dims[1]}' "; 1993 $post->iconsize = array($width, $max_dims[1]); 1994 } 1995 } else { 1996 $post->iconsize = array($imagesize[0], $imagesize[1]); 1997 $constraint = ''; 1998 } 1999 } else { 2000 $constraint = ''; 2001 } 2002 2003 $post_title = esc_attr($post->post_title); 2004 2005 $icon = "<img src='$src' title='$post_title' alt='$post_title' $constraint/>"; 2006 2007 return apply_filters( 'attachment_icon', $icon, $post->ID ); 2008 } 2009 2010 /** 2011 * Retrieve HTML content of image element. 2012 * 2013 * @since 2.0.0 2014 * @deprecated 2.5.0 2015 * @deprecated Use wp_get_attachment_image() 2016 * @see wp_get_attachment_image() 2017 * 2018 * @param int $id Optional. Post ID. 2019 * @param bool $fullsize Optional, default to false. Whether to have full size image. 2020 * @param array $max_dims Optional. Dimensions of image. 2021 * @return string 2022 */ 2023 function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) { 2024 _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' ); 2025 $id = (int) $id; 2026 if ( !$post = & get_post($id) ) 2027 return false; 2028 2029 if ( $innerHTML = get_attachment_icon($post->ID, $fullsize, $max_dims)) 2030 return $innerHTML; 2031 2032 2033 $innerHTML = esc_attr($post->post_title); 2034 2035 return apply_filters('attachment_innerHTML', $innerHTML, $post->ID); 2036 } 2037 2038 /* 2039 * Retrieve bookmark data based on ID. 2040 * 2041 * @since 2.0.0 2042 * @deprecated 2.1.0 2043 * @deprecated Use get_bookmark() 2044 * @see get_bookmark() 2045 * 2046 * @param int $bookmark_id ID of link 2047 * @param string $output OBJECT, ARRAY_N, or ARRAY_A 2048 * @return object|array 2049 */ 2050 function get_link($bookmark_id, $output = OBJECT, $filter = 'raw') { 2051 _deprecated_function( __FUNCTION__, '2.1', 'get_bookmark()' ); 2052 return get_bookmark($bookmark_id, $output, $filter); 2053 } 2054 2055 /** 2056 * Performs esc_url() for database or redirect usage. 2057 * 2058 * @since 2.3.1 2059 * @deprecated 2.8.0 2060 * @deprecated Use esc_url_raw() 2061 * @see esc_url_raw() 2062 * 2063 * @param string $url The URL to be cleaned. 2064 * @param array $protocols An array of acceptable protocols. 2065 * @return string The cleaned URL. 2066 */ 2067 function sanitize_url( $url, $protocols = null ) { 2068 _deprecated_function( __FUNCTION__, '2.8', 'esc_url_raw()' ); 2069 return esc_url_raw( $url, $protocols ); 2070 } 2071 2072 /** 2073 * Checks and cleans a URL. 2074 * 2075 * A number of characters are removed from the URL. If the URL is for displaying 2076 * (the default behaviour) amperstands are also replaced. The 'clean_url' filter 2077 * is applied to the returned cleaned URL. 2078 * 2079 * @since 1.2.0 2080 * @deprecated 3.0.0 2081 * @deprecated Use esc_url() 2082 * @see Alias for esc_url() 2083 * 2084 * @param string $url The URL to be cleaned. 2085 * @param array $protocols Optional. An array of acceptable protocols. 2086 * @param string $context Optional. How the URL will be used. Default is 'display'. 2087 * @return string The cleaned $url after the 'clean_url' filter is applied. 2088 */ 2089 function clean_url( $url, $protocols = null, $context = 'display' ) { 2090 if ( $context == 'db' ) 2091 _deprecated_function( 'clean_url( $context = \'db\' )', '3.0', 'esc_url_raw()' ); 2092 else 2093 _deprecated_function( __FUNCTION__, '3.0', 'esc_url()' ); 2094 return esc_url( $url, $protocols, $context ); 2095 } 2096 2097 /** 2098 * Escape single quotes, specialchar double quotes, and fix line endings. 2099 * 2100 * The filter 'js_escape' is also applied by esc_js() 2101 * 2102 * @since 2.0.4 2103 * @deprecated 2.8.0 2104 * @deprecated Use esc_js() 2105 * @see esc_js() 2106 * 2107 * @param string $text The text to be escaped. 2108 * @return string Escaped text. 2109 */ 2110 function js_escape( $text ) { 2111 _deprecated_function( __FUNCTION__, '2.8', 'esc_js()' ); 2112 return esc_js( $text ); 2113 } 2114 2115 /** 2116 * Escaping for HTML blocks. 2117 * 2118 * @deprecated 2.8.0 2119 * @deprecated Use esc_html() 2120 * @see esc_html() 2121 */ 2122 function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) { 2123 _deprecated_function( __FUNCTION__, '2.8', 'esc_html()' ); 2124 if ( func_num_args() > 1 ) { // Maintain backwards compat for people passing additional args 2125 $args = func_get_args(); 2126 return call_user_func_array( '_wp_specialchars', $args ); 2127 } else { 2128 return esc_html( $string ); 2129 } 2130 } 2131 2132 2133 /** 2134 * Escaping for HTML attributes. 2135 * 2136 * @since 2.0.6 2137 * @deprecated 2.8.0 2138 * @deprecated Use esc_attr() 2139 * @see esc_attr() 2140 * 2141 * @param string $text 2142 * @return string 2143 */ 2144 function attribute_escape( $text ) { 2145 _deprecated_function( __FUNCTION__, '2.8', 'esc_attr()' ); 2146 return esc_attr( $text ); 2147 } 2148 2149 /** 2150 * Register widget for sidebar with backwards compatibility. 2151 * 2152 * Allows $name to be an array that accepts either three elements to grab the 2153 * first element and the third for the name or just uses the first element of 2154 * the array for the name. 2155 * 2156 * Passes to {@link wp_register_sidebar_widget()} after argument list and 2157 * backwards compatibility is complete. 2158 * 2159 * @since 2.2.0 2160 * @deprecated 2.8.0 2161 * @deprecated Use wp_register_sidebar_widget() 2162 * @see wp_register_sidebar_widget() 2163 * 2164 * @param string|int $name Widget ID. 2165 * @param callback $output_callback Run when widget is called. 2166 * @param string $classname Classname widget option. 2167 * @param mixed $params,... Widget parameters. 2168 */ 2169 function register_sidebar_widget($name, $output_callback, $classname = '') { 2170 _deprecated_function( __FUNCTION__, '2.8', 'wp_register_sidebar_widget()' ); 2171 // Compat 2172 if ( is_array($name) ) { 2173 if ( count($name) == 3 ) 2174 $name = sprintf($name[0], $name[2]); 2175 else 2176 $name = $name[0]; 2177 } 2178 2179 $id = sanitize_title($name); 2180 $options = array(); 2181 if ( !empty($classname) && is_string($classname) ) 2182 $options['classname'] = $classname; 2183 $params = array_slice(func_get_args(), 2); 2184 $args = array($id, $name, $output_callback, $options); 2185 if ( !empty($params) ) 2186 $args = array_merge($args, $params); 2187 2188 call_user_func_array('wp_register_sidebar_widget', $args); 2189 } 2190 2191 /** 2192 * Alias of {@link wp_unregister_sidebar_widget()}. 2193 * 2194 * @since 2.2.0 2195 * @deprecated 2.8.0 2196 * @deprecated Use wp_unregister_sidebar_widget() 2197 * @see wp_unregister_sidebar_widget() 2198 * 2199 * @param int|string $id Widget ID. 2200 */ 2201 function unregister_sidebar_widget($id) { 2202 _deprecated_function( __FUNCTION__, '2.8', 'wp_unregister_sidebar_widget()' ); 2203 return wp_unregister_sidebar_widget($id); 2204 } 2205 2206 /** 2207 * Registers widget control callback for customizing options. 2208 * 2209 * Allows $name to be an array that accepts either three elements to grab the 2210 * first element and the third for the name or just uses the first element of 2211 * the array for the name. 2212 * 2213 * Passes to {@link wp_register_widget_control()} after the argument list has 2214 * been compiled. 2215 * 2216 * @since 2.2.0 2217 * @deprecated 2.8.0 2218 * @deprecated Use wp_register_widget_control() 2219 * @see wp_register_widget_control() 2220 * 2221 * @param int|string $name Sidebar ID. 2222 * @param callback $control_callback Widget control callback to display and process form. 2223 * @param int $width Widget width. 2224 * @param int $height Widget height. 2225 */ 2226 function register_widget_control($name, $control_callback, $width = '', $height = '') { 2227 _deprecated_function( __FUNCTION__, '2.8', 'wp_register_widget_control()' ); 2228 // Compat 2229 if ( is_array($name) ) { 2230 if ( count($name) == 3 ) 2231 $name = sprintf($name[0], $name[2]); 2232 else 2233 $name = $name[0]; 2234 } 2235 2236 $id = sanitize_title($name); 2237 $options = array(); 2238 if ( !empty($width) ) 2239 $options['width'] = $width; 2240 if ( !empty($height) ) 2241 $options['height'] = $height; 2242 $params = array_slice(func_get_args(), 4); 2243 $args = array($id, $name, $control_callback, $options); 2244 if ( !empty($params) ) 2245 $args = array_merge($args, $params); 2246 2247 call_user_func_array('wp_register_widget_control', $args); 2248 } 2249 2250 /** 2251 * Alias of {@link wp_unregister_widget_control()}. 2252 * 2253 * @since 2.2.0 2254 * @deprecated 2.8.0 2255 * @deprecated Use wp_unregister_widget_control() 2256 * @see wp_unregister_widget_control() 2257 * 2258 * @param int|string $id Widget ID. 2259 */ 2260 function unregister_widget_control($id) { 2261 _deprecated_function( __FUNCTION__, '2.8', 'wp_unregister_widget_control()' ); 2262 return wp_unregister_widget_control($id); 2263 } 2264 2265 /** 2266 * Remove user meta data. 2267 * 2268 * @since 2.0.0 2269 * @deprecated 3.0.0 2270 * @deprecated Use delete_user_meta() 2271 * @see delete_user_meta() 2272 * 2273 * @param int $user_id User ID. 2274 * @param string $meta_key Metadata key. 2275 * @param mixed $meta_value Metadata value. 2276 * @return bool True deletion completed and false if user_id is not a number. 2277 */ 2278 function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) { 2279 _deprecated_function( __FUNCTION__, '3.0', 'delete_user_meta()' ); 2280 global $wpdb; 2281 if ( !is_numeric( $user_id ) ) 2282 return false; 2283 $meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key); 2284 2285 if ( is_array($meta_value) || is_object($meta_value) ) 2286 $meta_value = serialize($meta_value); 2287 $meta_value = trim( $meta_value ); 2288 2289 $cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) ); 2290 2291 if ( $cur && $cur->umeta_id ) 2292 do_action( 'delete_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value ); 2293 2294 if ( ! empty($meta_value) ) 2295 $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s AND meta_value = %s", $user_id, $meta_key, $meta_value) ); 2296 else 2297 $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) ); 2298 2299 wp_cache_delete($user_id, 'users'); 2300 2301 if ( $cur && $cur->umeta_id ) 2302 do_action( 'deleted_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value ); 2303 2304 return true; 2305 } 2306 2307 /** 2308 * Retrieve user metadata. 2309 * 2310 * If $user_id is not a number, then the function will fail over with a 'false' 2311 * boolean return value. Other returned values depend on whether there is only 2312 * one item to be returned, which be that single item type. If there is more 2313 * than one metadata value, then it will be list of metadata values. 2314 * 2315 * @since 2.0.0 2316 * @deprecated 3.0.0 2317 * @deprecated Use get_user_meta() 2318 * @see get_user_meta() 2319 * 2320 * @param int $user_id User ID 2321 * @param string $meta_key Optional. Metadata key. 2322 * @return mixed 2323 */ 2324 function get_usermeta( $user_id, $meta_key = '' ) { 2325 _deprecated_function( __FUNCTION__, '3.0', 'get_user_meta()' ); 2326 global $wpdb; 2327 $user_id = (int) $user_id; 2328 2329 if ( !$user_id ) 2330 return false; 2331 2332 if ( !empty($meta_key) ) { 2333 $meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key); 2334 $user = wp_cache_get($user_id, 'users'); 2335 // Check the cached user object 2336 if ( false !== $user && isset($user->$meta_key) ) 2337 $metas = array($user->$meta_key); 2338 else 2339 $metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) ); 2340 } else { 2341 $metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d", $user_id) ); 2342 } 2343 2344 if ( empty($metas) ) { 2345 if ( empty($meta_key) ) 2346 return array(); 2347 else 2348 return ''; 2349 } 2350 2351 $metas = array_map('maybe_unserialize', $metas); 2352 2353 if ( count($metas) == 1 ) 2354 return $metas[0]; 2355 else 2356 return $metas; 2357 } 2358 2359 /** 2360 * Update metadata of user. 2361 * 2362 * There is no need to serialize values, they will be serialized if it is 2363 * needed. The metadata key can only be a string with underscores. All else will 2364 * be removed. 2365 * 2366 * Will remove the metadata, if the meta value is empty. 2367 * 2368 * @since 2.0.0 2369 * @deprecated 3.0.0 2370 * @deprecated Use update_user_meta() 2371 * @see update_user_meta() 2372 * 2373 * @param int $user_id User ID 2374 * @param string $meta_key Metadata key. 2375 * @param mixed $meta_value Metadata value. 2376 * @return bool True on successful update, false on failure. 2377 */ 2378 function update_usermeta( $user_id, $meta_key, $meta_value ) { 2379 _deprecated_function( __FUNCTION__, '3.0', 'update_user_meta()' ); 2380 global $wpdb; 2381 if ( !is_numeric( $user_id ) ) 2382 return false; 2383 $meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key); 2384 2385 /** @todo Might need fix because usermeta data is assumed to be already escaped */ 2386 if ( is_string($meta_value) ) 2387 $meta_value = stripslashes($meta_value); 2388 $meta_value = maybe_serialize($meta_value); 2389 2390 if (empty($meta_value)) { 2391 return delete_usermeta($user_id, $meta_key); 2392 } 2393 2394 $cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) ); 2395 2396 if ( $cur ) 2397 do_action( 'update_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value ); 2398 2399 if ( !$cur ) 2400 $wpdb->insert($wpdb->usermeta, compact('user_id', 'meta_key', 'meta_value') ); 2401 else if ( $cur->meta_value != $meta_value ) 2402 $wpdb->update($wpdb->usermeta, compact('meta_value'), compact('user_id', 'meta_key') ); 2403 else 2404 return false; 2405 2406 wp_cache_delete($user_id, 'users'); 2407 2408 if ( !$cur ) 2409 do_action( 'added_usermeta', $wpdb->insert_id, $user_id, $meta_key, $meta_value ); 2410 else 2411 do_action( 'updated_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value ); 2412 2413 return true; 2414 } 2415 2416 /** 2417 * Enable/disable automatic general feed link outputting. 2418 * 2419 * @since 2.8.0 2420 * @deprecated 3.0.0 2421 * @deprecated Use add_theme_support( 'automatic-feed-links' ) 2422 * 2423 * @param boolean $add Optional, default is true. Add or remove links. Defaults to true. 2424 */ 2425 function automatic_feed_links( $add = true ) { 2426 _deprecated_function( __FUNCTION__, '3.0', "add_theme_support( 'automatic-feed-links' )" ); 2427 2428 if ( $add ) 2429 add_theme_support( 'automatic-feed-links' ); 2430 else 2431 remove_action( 'wp_head', 'feed_links_extra', 3 ); // Just do this yourself in 3.0+ 2432 } 2433 2434 /** 2435 * Retrieve user data based on field. 2436 * 2437 * @since 1.5.0 2438 * @deprecated 3.0.0 2439 * @deprecated Use get_the_author_meta() 2440 * @see get_the_author_meta() 2441 */ 2442 function get_profile( $field, $user = false ) { 2443 _deprecated_function( __FUNCTION__, '3.0', 'get_the_author_meta()' ); 2444 if ( $user ) { 2445 $user = get_user_by( 'login', $user ); 2446 $user = $user->ID; 2447 } 2448 return get_the_author_meta( $field, $user ); 2449 } 2450 2451 /** 2452 * Number of posts user has written. 2453 * 2454 * @since 0.71 2455 * @deprecated 3.0.0 2456 * @deprecated Use count_user_posts() 2457 * @see count_user_posts() 2458 */ 2459 function get_usernumposts( $userid ) { 2460 _deprecated_function( __FUNCTION__, '3.0', 'count_user_posts()' ); 2461 return count_user_posts( $userid ); 2462 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Mon Apr 5 14:26:09 2010 | Cross-referenced by PHPXref 0.7 |
