PageRenderTime 100ms CodeModel.GetById 37ms app.highlight 43ms RepoModel.GetById 1ms app.codeStats 1ms

/wp-includes/deprecated.php

https://github.com/shaiquddin/WordPress
PHP | 3331 lines | 1325 code | 332 blank | 1674 comment | 204 complexity | 10a39f101602a30737781fba54c01848 MD5 | raw file

Large files files are truncated, but you can click here to view the full file

   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 */
  26function 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 */
  59function start_wp() {
  60	global $wp_query;
  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( get_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 */
  81function 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 */
 105function 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 */
 136function 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->ID);
 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 $next
 168 * @param string $title
 169 * @param string $in_same_cat
 170 * @param int $limitnext
 171 * @param string $excluded_categories
 172 */
 173function 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, $post->ID);
 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 */
 207function 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 */
 227function 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 */
 247function 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 */
 276function 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 */
 296function 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 */
 316function 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 */
 336function 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 */
 356function 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 */
 375function 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 */
 407function 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 */
 432function wp_get_linksbyname($category, $args = '') {
 433	_deprecated_function(__FUNCTION__, '2.1', '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 */
 473function 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 */
 527function 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 */
 560function 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 */
 588function 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 */
 605function 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 */
 636function 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 */
 655function 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 */
 696function 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 */
 729function 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 */
 746function 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 */
 764function 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 */
 783function 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 */
 802function 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 */
 829function 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 */
 848function 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 */
 862function 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 $deprecated
 876 */
 877function permalink_single_rss($deprecated = '') {
 878	_deprecated_function( __FUNCTION__, '2.3', '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 */
 894function wp_get_links($args = '') {
 895	_deprecated_function( __FUNCTION__, '2.1', '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 */
 948function 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') * HOUR_IN_SECONDS)) . ')';
 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 */
1042function 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 */
1088function 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 */
1113function 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 */
1129function 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 */
1158function 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 */
1175function 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 */
1197function 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 */
1216function 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 */
1234function 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*/
1244function 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 */
1262function 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 */
1278function 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 */
1297function 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 get_the_author_meta('description')
1327 * @see get_the_author_meta()
1328 *
1329 * @return string The author's description.
1330 */
1331function 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 */
1344function 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 get_the_author_meta('login')
1355 * @see get_the_author_meta()
1356 *
1357 * @return string The author's login name (username).
1358 */
1359function 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 */
1372function 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 get_the_author_meta('first_name')
1383 * @see get_the_author_meta()
1384 *
1385 * @return string The author's first name.
1386 */
1387function 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 */
1400function 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 */
1415function 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 */
1428function 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 */
1443function 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 */
1456function 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 */
1471function 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 */
1484function 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 */
1499function 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 */
1512function 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 */
1527function 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 */
1540function 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 */
1555function 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 */
1568function 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 */
1583function 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 */
1596function 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 */
1612function 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 */
1627function 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 */
1640function 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 */
1655function 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*/
1668function 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 */
1707function 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(']]>', ']]&gt;', $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 */
1753function 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][

Large files files are truncated, but you can click here to view the full file