PageRenderTime 62ms CodeModel.GetById 32ms RepoModel.GetById 1ms app.codeStats 0ms

/wp-includes/deprecated.php

https://bitbucket.org/Thane2376/death-edge.ru
PHP | 3501 lines | 1454 code | 338 blank | 1709 comment | 211 complexity | d12580a954ff2f80325051decfcafa0e MD5 | raw file
Possible License(s): LGPL-2.1, GPL-2.0, LGPL-3.0, AGPL-1.0

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. * Deprecated functions come here to die.
  12. */
  13. /**
  14. * Entire Post data.
  15. *
  16. * @since 0.71
  17. * @deprecated 1.5.1
  18. * @deprecated Use get_post()
  19. * @see get_post()
  20. *
  21. * @param int $postid
  22. * @return array
  23. */
  24. function get_postdata($postid) {
  25. _deprecated_function( __FUNCTION__, '1.5.1', 'get_post()' );
  26. $post = get_post($postid);
  27. $postdata = array (
  28. 'ID' => $post->ID,
  29. 'Author_ID' => $post->post_author,
  30. 'Date' => $post->post_date,
  31. 'Content' => $post->post_content,
  32. 'Excerpt' => $post->post_excerpt,
  33. 'Title' => $post->post_title,
  34. 'Category' => $post->post_category,
  35. 'post_status' => $post->post_status,
  36. 'comment_status' => $post->comment_status,
  37. 'ping_status' => $post->ping_status,
  38. 'post_password' => $post->post_password,
  39. 'to_ping' => $post->to_ping,
  40. 'pinged' => $post->pinged,
  41. 'post_type' => $post->post_type,
  42. 'post_name' => $post->post_name
  43. );
  44. return $postdata;
  45. }
  46. /**
  47. * Sets up the WordPress Loop.
  48. *
  49. * @since 1.0.1
  50. * @deprecated 1.5.0
  51. * @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop}
  52. */
  53. function start_wp() {
  54. global $wp_query;
  55. _deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop') );
  56. // Since the old style loop is being used, advance the query iterator here.
  57. $wp_query->next_post();
  58. setup_postdata( get_post() );
  59. }
  60. /**
  61. * Return or Print Category ID.
  62. *
  63. * @since 0.71
  64. * @deprecated 0.71
  65. * @deprecated use get_the_category()
  66. * @see get_the_category()
  67. *
  68. * @param bool $echo
  69. * @return null|int
  70. */
  71. function the_category_ID($echo = true) {
  72. _deprecated_function( __FUNCTION__, '0.71', 'get_the_category()' );
  73. // Grab the first cat in the list.
  74. $categories = get_the_category();
  75. $cat = $categories[0]->term_id;
  76. if ( $echo )
  77. echo $cat;
  78. return $cat;
  79. }
  80. /**
  81. * Print category with optional text before and after.
  82. *
  83. * @since 0.71
  84. * @deprecated 0.71
  85. * @deprecated use get_the_category_by_ID()
  86. * @see get_the_category_by_ID()
  87. *
  88. * @param string $before
  89. * @param string $after
  90. */
  91. function the_category_head($before='', $after='') {
  92. global $currentcat, $previouscat;
  93. _deprecated_function( __FUNCTION__, '0.71', 'get_the_category_by_ID()' );
  94. // Grab the first cat in the list.
  95. $categories = get_the_category();
  96. $currentcat = $categories[0]->category_id;
  97. if ( $currentcat != $previouscat ) {
  98. echo $before;
  99. echo get_the_category_by_ID($currentcat);
  100. echo $after;
  101. $previouscat = $currentcat;
  102. }
  103. }
  104. /**
  105. * Prints link to the previous post.
  106. *
  107. * @since 1.5.0
  108. * @deprecated 2.0.0
  109. * @deprecated Use previous_post_link()
  110. * @see previous_post_link()
  111. *
  112. * @param string $format
  113. * @param string $previous
  114. * @param string $title
  115. * @param string $in_same_cat
  116. * @param int $limitprev
  117. * @param string $excluded_categories
  118. */
  119. function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') {
  120. _deprecated_function( __FUNCTION__, '2.0', 'previous_post_link()' );
  121. if ( empty($in_same_cat) || 'no' == $in_same_cat )
  122. $in_same_cat = false;
  123. else
  124. $in_same_cat = true;
  125. $post = get_previous_post($in_same_cat, $excluded_categories);
  126. if ( !$post )
  127. return;
  128. $string = '<a href="'.get_permalink($post->ID).'">'.$previous;
  129. if ( 'yes' == $title )
  130. $string .= apply_filters('the_title', $post->post_title, $post->ID);
  131. $string .= '</a>';
  132. $format = str_replace('%', $string, $format);
  133. echo $format;
  134. }
  135. /**
  136. * Prints link to the next post.
  137. *
  138. * @since 0.71
  139. * @deprecated 2.0.0
  140. * @deprecated Use next_post_link()
  141. * @see next_post_link()
  142. *
  143. * @param string $format
  144. * @param string $next
  145. * @param string $title
  146. * @param string $in_same_cat
  147. * @param int $limitnext
  148. * @param string $excluded_categories
  149. */
  150. function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') {
  151. _deprecated_function( __FUNCTION__, '2.0', 'next_post_link()' );
  152. if ( empty($in_same_cat) || 'no' == $in_same_cat )
  153. $in_same_cat = false;
  154. else
  155. $in_same_cat = true;
  156. $post = get_next_post($in_same_cat, $excluded_categories);
  157. if ( !$post )
  158. return;
  159. $string = '<a href="'.get_permalink($post->ID).'">'.$next;
  160. if ( 'yes' == $title )
  161. $string .= apply_filters('the_title', $post->post_title, $post->ID);
  162. $string .= '</a>';
  163. $format = str_replace('%', $string, $format);
  164. echo $format;
  165. }
  166. /**
  167. * Whether user can create a post.
  168. *
  169. * @since 1.5.0
  170. * @deprecated 2.0.0
  171. * @deprecated Use current_user_can()
  172. * @see current_user_can()
  173. *
  174. * @param int $user_id
  175. * @param int $blog_id Not Used
  176. * @param int $category_id Not Used
  177. * @return bool
  178. */
  179. function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') {
  180. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  181. $author_data = get_userdata($user_id);
  182. return ($author_data->user_level > 1);
  183. }
  184. /**
  185. * Whether user can create a post.
  186. *
  187. * @since 1.5.0
  188. * @deprecated 2.0.0
  189. * @deprecated Use current_user_can()
  190. * @see current_user_can()
  191. *
  192. * @param int $user_id
  193. * @param int $blog_id Not Used
  194. * @param int $category_id Not Used
  195. * @return bool
  196. */
  197. function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {
  198. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  199. $author_data = get_userdata($user_id);
  200. return ($author_data->user_level >= 1);
  201. }
  202. /**
  203. * Whether user can edit a post.
  204. *
  205. * @since 1.5.0
  206. * @deprecated 2.0.0
  207. * @deprecated Use current_user_can()
  208. * @see current_user_can()
  209. *
  210. * @param int $user_id
  211. * @param int $post_id
  212. * @param int $blog_id Not Used
  213. * @return bool
  214. */
  215. function user_can_edit_post($user_id, $post_id, $blog_id = 1) {
  216. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  217. $author_data = get_userdata($user_id);
  218. $post = get_post($post_id);
  219. $post_author_data = get_userdata($post->post_author);
  220. if ( (($user_id == $post_author_data->ID) && !($post->post_status == 'publish' && $author_data->user_level < 2))
  221. || ($author_data->user_level > $post_author_data->user_level)
  222. || ($author_data->user_level >= 10) ) {
  223. return true;
  224. } else {
  225. return false;
  226. }
  227. }
  228. /**
  229. * Whether user can delete a post.
  230. *
  231. * @since 1.5.0
  232. * @deprecated 2.0.0
  233. * @deprecated Use current_user_can()
  234. * @see current_user_can()
  235. *
  236. * @param int $user_id
  237. * @param int $post_id
  238. * @param int $blog_id Not Used
  239. * @return bool
  240. */
  241. function user_can_delete_post($user_id, $post_id, $blog_id = 1) {
  242. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  243. // right now if one can edit, one can delete
  244. return user_can_edit_post($user_id, $post_id, $blog_id);
  245. }
  246. /**
  247. * Whether user can set new posts' dates.
  248. *
  249. * @since 1.5.0
  250. * @deprecated 2.0.0
  251. * @deprecated Use current_user_can()
  252. * @see current_user_can()
  253. *
  254. * @param int $user_id
  255. * @param int $blog_id Not Used
  256. * @param int $category_id Not Used
  257. * @return bool
  258. */
  259. function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') {
  260. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  261. $author_data = get_userdata($user_id);
  262. return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id));
  263. }
  264. /**
  265. * Whether user can delete a post.
  266. *
  267. * @since 1.5.0
  268. * @deprecated 2.0.0
  269. * @deprecated Use current_user_can()
  270. * @see current_user_can()
  271. *
  272. * @param int $user_id
  273. * @param int $post_id
  274. * @param int $blog_id Not Used
  275. * @return bool returns true if $user_id can edit $post_id's date
  276. */
  277. function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) {
  278. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  279. $author_data = get_userdata($user_id);
  280. return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id));
  281. }
  282. /**
  283. * Whether user can delete a post.
  284. *
  285. * @since 1.5.0
  286. * @deprecated 2.0.0
  287. * @deprecated Use current_user_can()
  288. * @see current_user_can()
  289. *
  290. * @param int $user_id
  291. * @param int $post_id
  292. * @param int $blog_id Not Used
  293. * @return bool returns true if $user_id can edit $post_id's comments
  294. */
  295. function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
  296. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  297. // right now if one can edit a post, one can edit comments made on it
  298. return user_can_edit_post($user_id, $post_id, $blog_id);
  299. }
  300. /**
  301. * Whether user can delete a post.
  302. *
  303. * @since 1.5.0
  304. * @deprecated 2.0.0
  305. * @deprecated Use current_user_can()
  306. * @see current_user_can()
  307. *
  308. * @param int $user_id
  309. * @param int $post_id
  310. * @param int $blog_id Not Used
  311. * @return bool returns true if $user_id can delete $post_id's comments
  312. */
  313. function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {
  314. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  315. // right now if one can edit comments, one can delete comments
  316. return user_can_edit_post_comments($user_id, $post_id, $blog_id);
  317. }
  318. /**
  319. * Can user can edit other user.
  320. *
  321. * @since 1.5.0
  322. * @deprecated 2.0.0
  323. * @deprecated Use current_user_can()
  324. * @see current_user_can()
  325. *
  326. * @param int $user_id
  327. * @param int $other_user
  328. * @return bool
  329. */
  330. function user_can_edit_user($user_id, $other_user) {
  331. _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
  332. $user = get_userdata($user_id);
  333. $other = get_userdata($other_user);
  334. if ( $user->user_level > $other->user_level || $user->user_level > 8 || $user->ID == $other->ID )
  335. return true;
  336. else
  337. return false;
  338. }
  339. /**
  340. * Gets the links associated with category $cat_name.
  341. *
  342. * @since 0.71
  343. * @deprecated 2.1.0
  344. * @deprecated Use get_bookmarks()
  345. * @see get_bookmarks()
  346. *
  347. * @param string $cat_name Optional. The category name to use. If no match is found uses all.
  348. * @param string $before Optional. The html to output before the link.
  349. * @param string $after Optional. The html to output after the link.
  350. * @param string $between Optional. The html to output between the link/image and its description. Not used if no image or $show_images is true.
  351. * @param bool $show_images Optional. Whether to show images (if defined).
  352. * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner.
  353. * 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
  354. * random order.
  355. * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
  356. * @param bool $show_rating Optional. Show rating stars/chars.
  357. * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
  358. * @param int $show_updated Optional. Whether to show last updated timestamp
  359. */
  360. function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
  361. $show_description = true, $show_rating = false,
  362. $limit = -1, $show_updated = 0) {
  363. _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
  364. $cat_id = -1;
  365. $cat = get_term_by('name', $cat_name, 'link_category');
  366. if ( $cat )
  367. $cat_id = $cat->term_id;
  368. get_links($cat_id, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated);
  369. }
  370. /**
  371. * Gets the links associated with the named category.
  372. *
  373. * @since 1.0.1
  374. * @deprecated 2.1.0
  375. * @deprecated Use wp_list_bookmarks()
  376. * @see wp_list_bookmarks()
  377. *
  378. * @param string $category The category to use.
  379. * @param string $args
  380. * @return bool|null
  381. */
  382. function wp_get_linksbyname($category, $args = '') {
  383. _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()');
  384. $defaults = array(
  385. 'after' => '<br />',
  386. 'before' => '',
  387. 'categorize' => 0,
  388. 'category_after' => '',
  389. 'category_before' => '',
  390. 'category_name' => $category,
  391. 'show_description' => 1,
  392. 'title_li' => '',
  393. );
  394. $r = wp_parse_args( $args, $defaults );
  395. return wp_list_bookmarks($r);
  396. }
  397. /**
  398. * Gets an array of link objects associated with category $cat_name.
  399. *
  400. * <code>
  401. * $links = get_linkobjectsbyname('fred');
  402. * foreach ($links as $link) {
  403. * echo '<li>'.$link->link_name.'</li>';
  404. * }
  405. * </code>
  406. *
  407. * @since 1.0.1
  408. * @deprecated 2.1.0
  409. * @deprecated Use get_bookmarks()
  410. * @see get_bookmarks()
  411. *
  412. * @param string $cat_name The category name to use. If no match is found uses all.
  413. * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.
  414. * Or maybe owner. If you start the name with an underscore the order will be reversed. You can also
  415. * specify 'rand' as the order which will return links in a random order.
  416. * @param int $limit Limit to X entries. If not specified, all entries are shown.
  417. * @return unknown
  418. */
  419. function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
  420. _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
  421. $cat_id = -1;
  422. $cat = get_term_by('name', $cat_name, 'link_category');
  423. if ( $cat )
  424. $cat_id = $cat->term_id;
  425. return get_linkobjects($cat_id, $orderby, $limit);
  426. }
  427. /**
  428. * Gets an array of link objects associated with category n.
  429. *
  430. * Usage:
  431. * <code>
  432. * $links = get_linkobjects(1);
  433. * if ($links) {
  434. * foreach ($links as $link) {
  435. * echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>';
  436. * }
  437. * }
  438. * </code>
  439. *
  440. * Fields are:
  441. * <ol>
  442. * <li>link_id</li>
  443. * <li>link_url</li>
  444. * <li>link_name</li>
  445. * <li>link_image</li>
  446. * <li>link_target</li>
  447. * <li>link_category</li>
  448. * <li>link_description</li>
  449. * <li>link_visible</li>
  450. * <li>link_owner</li>
  451. * <li>link_rating</li>
  452. * <li>link_updated</li>
  453. * <li>link_rel</li>
  454. * <li>link_notes</li>
  455. * </ol>
  456. *
  457. * @since 1.0.1
  458. * @deprecated 2.1.0
  459. * @deprecated Use get_bookmarks()
  460. * @see get_bookmarks()
  461. *
  462. * @param int $category The category to use. If no category supplied uses all
  463. * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
  464. * 'description', or 'rating'. Or maybe owner. If you start the name with an
  465. * underscore the order will be reversed. You can also specify 'rand' as the
  466. * order which will return links in a random order.
  467. * @param int $limit Limit to X entries. If not specified, all entries are shown.
  468. * @return unknown
  469. */
  470. function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
  471. _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
  472. $links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ;
  473. $links_array = array();
  474. foreach ($links as $link)
  475. $links_array[] = $link;
  476. return $links_array;
  477. }
  478. /**
  479. * Gets the links associated with category 'cat_name' and display rating stars/chars.
  480. *
  481. * @since 0.71
  482. * @deprecated 2.1.0
  483. * @deprecated Use get_bookmarks()
  484. * @see get_bookmarks()
  485. *
  486. * @param string $cat_name The category name to use. If no match is found uses all
  487. * @param string $before The html to output before the link
  488. * @param string $after The html to output after the link
  489. * @param string $between The html to output between the link/image and its description. Not used if no image or show_images is true
  490. * @param bool $show_images Whether to show images (if defined).
  491. * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
  492. * 'description', or 'rating'. Or maybe owner. If you start the name with an
  493. * underscore the order will be reversed. You can also specify 'rand' as the
  494. * order which will return links in a random order.
  495. * @param bool $show_description Whether to show the description if show_images=false/not defined
  496. * @param int $limit Limit to X entries. If not specified, all entries are shown.
  497. * @param int $show_updated Whether to show last updated timestamp
  498. */
  499. function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
  500. $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
  501. _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
  502. get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
  503. }
  504. /**
  505. * Gets the links associated with category n and display rating stars/chars.
  506. *
  507. * @since 0.71
  508. * @deprecated 2.1.0
  509. * @deprecated Use get_bookmarks()
  510. * @see get_bookmarks()
  511. *
  512. * @param int $category The category to use. If no category supplied uses all
  513. * @param string $before The html to output before the link
  514. * @param string $after The html to output after the link
  515. * @param string $between The html to output between the link/image and its description. Not used if no image or show_images == true
  516. * @param bool $show_images Whether to show images (if defined).
  517. * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url',
  518. * 'description', or 'rating'. Or maybe owner. If you start the name with an
  519. * underscore the order will be reversed. You can also specify 'rand' as the
  520. * order which will return links in a random order.
  521. * @param bool $show_description Whether to show the description if show_images=false/not defined.
  522. * @param string $limit Limit to X entries. If not specified, all entries are shown.
  523. * @param int $show_updated Whether to show last updated timestamp
  524. */
  525. function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
  526. $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
  527. _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
  528. get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
  529. }
  530. /**
  531. * Gets the auto_toggle setting.
  532. *
  533. * @since 0.71
  534. * @deprecated 2.1.0
  535. * @deprecated No alternative function available
  536. *
  537. * @param int $id The category to get. If no category supplied uses 0
  538. * @return int Only returns 0.
  539. */
  540. function get_autotoggle($id = 0) {
  541. _deprecated_function( __FUNCTION__, '2.1' );
  542. return 0;
  543. }
  544. /**
  545. * @since 0.71
  546. * @deprecated 2.1.0
  547. * @deprecated Use wp_list_categories()
  548. * @see wp_list_categories()
  549. *
  550. * @param int $optionall
  551. * @param string $all
  552. * @param string $sort_column
  553. * @param string $sort_order
  554. * @param string $file
  555. * @param bool $list
  556. * @param int $optiondates
  557. * @param int $optioncount
  558. * @param int $hide_empty
  559. * @param int $use_desc_for_title
  560. * @param bool $children
  561. * @param int $child_of
  562. * @param int $categories
  563. * @param int $recurse
  564. * @param string $feed
  565. * @param string $feed_image
  566. * @param string $exclude
  567. * @param bool $hierarchical
  568. * @return unknown
  569. */
  570. function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,
  571. $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,
  572. $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
  573. _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
  574. $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',
  575. 'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');
  576. return wp_list_cats($query);
  577. }
  578. /**
  579. * @since 1.2.0
  580. * @deprecated 2.1.0
  581. * @deprecated Use wp_list_categories()
  582. * @see wp_list_categories()
  583. *
  584. * @param string|array $args
  585. * @return unknown
  586. */
  587. function wp_list_cats($args = '') {
  588. _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
  589. $r = wp_parse_args( $args );
  590. // Map to new names.
  591. if ( isset($r['optionall']) && isset($r['all']))
  592. $r['show_option_all'] = $r['all'];
  593. if ( isset($r['sort_column']) )
  594. $r['orderby'] = $r['sort_column'];
  595. if ( isset($r['sort_order']) )
  596. $r['order'] = $r['sort_order'];
  597. if ( isset($r['optiondates']) )
  598. $r['show_last_update'] = $r['optiondates'];
  599. if ( isset($r['optioncount']) )
  600. $r['show_count'] = $r['optioncount'];
  601. if ( isset($r['list']) )
  602. $r['style'] = $r['list'] ? 'list' : 'break';
  603. $r['title_li'] = '';
  604. return wp_list_categories($r);
  605. }
  606. /**
  607. * @since 0.71
  608. * @deprecated 2.1.0
  609. * @deprecated Use wp_dropdown_categories()
  610. * @see wp_dropdown_categories()
  611. *
  612. * @param int $optionall
  613. * @param string $all
  614. * @param string $orderby
  615. * @param string $order
  616. * @param int $show_last_update
  617. * @param int $show_count
  618. * @param int $hide_empty
  619. * @param bool $optionnone
  620. * @param int $selected
  621. * @param int $exclude
  622. * @return unknown
  623. */
  624. function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',
  625. $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,
  626. $selected = 0, $exclude = 0) {
  627. _deprecated_function( __FUNCTION__, '2.1', 'wp_dropdown_categories()' );
  628. $show_option_all = '';
  629. if ( $optionall )
  630. $show_option_all = $all;
  631. $show_option_none = '';
  632. if ( $optionnone )
  633. $show_option_none = __('None');
  634. $vars = compact('show_option_all', 'show_option_none', 'orderby', 'order',
  635. 'show_last_update', 'show_count', 'hide_empty', 'selected', 'exclude');
  636. $query = add_query_arg($vars, '');
  637. return wp_dropdown_categories($query);
  638. }
  639. /**
  640. * List authors.
  641. *
  642. * @since 1.2.0
  643. * @deprecated 2.1.0
  644. * @deprecated Use wp_list_authors()
  645. * @see wp_list_authors()
  646. *
  647. * @param bool $optioncount
  648. * @param bool $exclude_admin
  649. * @param bool $show_fullname
  650. * @param bool $hide_empty
  651. * @param string $feed
  652. * @param string $feed_image
  653. * @return unknown
  654. */
  655. function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') {
  656. _deprecated_function( __FUNCTION__, '2.1', 'wp_list_authors()' );
  657. $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image');
  658. return wp_list_authors($args);
  659. }
  660. /**
  661. * @since 1.0.1
  662. * @deprecated 2.1.0
  663. * @deprecated Use wp_get_post_categories()
  664. * @see wp_get_post_categories()
  665. *
  666. * @param int $blogid Not Used
  667. * @param int $post_ID
  668. * @return unknown
  669. */
  670. function wp_get_post_cats($blogid = '1', $post_ID = 0) {
  671. _deprecated_function( __FUNCTION__, '2.1', 'wp_get_post_categories()' );
  672. return wp_get_post_categories($post_ID);
  673. }
  674. /**
  675. * Sets the categories that the post id belongs to.
  676. *
  677. * @since 1.0.1
  678. * @deprecated 2.1.0
  679. * @deprecated Use wp_set_post_categories()
  680. * @see wp_set_post_categories()
  681. *
  682. * @param int $blogid Not used
  683. * @param int $post_ID
  684. * @param array $post_categories
  685. * @return unknown
  686. */
  687. function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) {
  688. _deprecated_function( __FUNCTION__, '2.1', 'wp_set_post_categories()' );
  689. return wp_set_post_categories($post_ID, $post_categories);
  690. }
  691. /**
  692. * @since 0.71
  693. * @deprecated 2.1.0
  694. * @deprecated Use wp_get_archives()
  695. * @see wp_get_archives()
  696. *
  697. * @param string $type
  698. * @param string $limit
  699. * @param string $format
  700. * @param string $before
  701. * @param string $after
  702. * @param bool $show_post_count
  703. * @return unknown
  704. */
  705. function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) {
  706. _deprecated_function( __FUNCTION__, '2.1', 'wp_get_archives()' );
  707. $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count');
  708. return wp_get_archives($args);
  709. }
  710. /**
  711. * Returns or Prints link to the author's posts.
  712. *
  713. * @since 1.2.0
  714. * @deprecated 2.1.0
  715. * @deprecated Use get_author_posts_url()
  716. * @see get_author_posts_url()
  717. *
  718. * @param bool $echo
  719. * @param int $author_id
  720. * @param string $author_nicename Optional.
  721. * @return string|null
  722. */
  723. function get_author_link($echo, $author_id, $author_nicename = '') {
  724. _deprecated_function( __FUNCTION__, '2.1', 'get_author_posts_url()' );
  725. $link = get_author_posts_url($author_id, $author_nicename);
  726. if ( $echo )
  727. echo $link;
  728. return $link;
  729. }
  730. /**
  731. * Print list of pages based on arguments.
  732. *
  733. * @since 0.71
  734. * @deprecated 2.1.0
  735. * @deprecated Use wp_link_pages()
  736. * @see wp_link_pages()
  737. *
  738. * @param string $before
  739. * @param string $after
  740. * @param string $next_or_number
  741. * @param string $nextpagelink
  742. * @param string $previouspagelink
  743. * @param string $pagelink
  744. * @param string $more_file
  745. * @return string
  746. */
  747. function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',
  748. $pagelink='%', $more_file='') {
  749. _deprecated_function( __FUNCTION__, '2.1', 'wp_link_pages()' );
  750. $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');
  751. return wp_link_pages($args);
  752. }
  753. /**
  754. * Get value based on option.
  755. *
  756. * @since 0.71
  757. * @deprecated 2.1.0
  758. * @deprecated Use get_option()
  759. * @see get_option()
  760. *
  761. * @param string $option
  762. * @return string
  763. */
  764. function get_settings($option) {
  765. _deprecated_function( __FUNCTION__, '2.1', 'get_option()' );
  766. return get_option($option);
  767. }
  768. /**
  769. * Print the permalink of the current post in the loop.
  770. *
  771. * @since 0.71
  772. * @deprecated 1.2.0
  773. * @deprecated Use the_permalink()
  774. * @see the_permalink()
  775. */
  776. function permalink_link() {
  777. _deprecated_function( __FUNCTION__, '1.2', 'the_permalink()' );
  778. the_permalink();
  779. }
  780. /**
  781. * Print the permalink to the RSS feed.
  782. *
  783. * @since 0.71
  784. * @deprecated 2.3.0
  785. * @deprecated Use the_permalink_rss()
  786. * @see the_permalink_rss()
  787. *
  788. * @param string $deprecated
  789. */
  790. function permalink_single_rss($deprecated = '') {
  791. _deprecated_function( __FUNCTION__, '2.3', 'the_permalink_rss()' );
  792. the_permalink_rss();
  793. }
  794. /**
  795. * Gets the links associated with category.
  796. *
  797. * @see get_links() for argument information that can be used in $args
  798. * @since 1.0.1
  799. * @deprecated 2.1.0
  800. * @deprecated Use wp_list_bookmarks()
  801. * @see wp_list_bookmarks()
  802. *
  803. * @param string $args a query string
  804. * @return null|string
  805. */
  806. function wp_get_links($args = '') {
  807. _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' );
  808. if ( strpos( $args, '=' ) === false ) {
  809. $cat_id = $args;
  810. $args = add_query_arg( 'category', $cat_id, $args );
  811. }
  812. $defaults = array(
  813. 'after' => '<br />',
  814. 'before' => '',
  815. 'between' => ' ',
  816. 'categorize' => 0,
  817. 'category' => '',
  818. 'echo' => true,
  819. 'limit' => -1,
  820. 'orderby' => 'name',
  821. 'show_description' => true,
  822. 'show_images' => true,
  823. 'show_rating' => false,
  824. 'show_updated' => true,
  825. 'title_li' => '',
  826. );
  827. $r = wp_parse_args( $args, $defaults );
  828. return wp_list_bookmarks($r);
  829. }
  830. /**
  831. * Gets the links associated with category by id.
  832. *
  833. * @since 0.71
  834. * @deprecated 2.1.0
  835. * @deprecated Use get_bookmarks()
  836. * @see get_bookmarks()
  837. *
  838. * @param int $category The category to use. If no category supplied uses all
  839. * @param string $before the html to output before the link
  840. * @param string $after the html to output after the link
  841. * @param string $between the html to output between the link/image and its description.
  842. * Not used if no image or show_images == true
  843. * @param bool $show_images whether to show images (if defined).
  844. * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
  845. * 'description', or 'rating'. Or maybe owner. If you start the name with an
  846. * underscore the order will be reversed. You can also specify 'rand' as the order
  847. * which will return links in a random order.
  848. * @param bool $show_description whether to show the description if show_images=false/not defined.
  849. * @param bool $show_rating show rating stars/chars
  850. * @param int $limit Limit to X entries. If not specified, all entries are shown.
  851. * @param int $show_updated whether to show last updated timestamp
  852. * @param bool $echo whether to echo the results, or return them instead
  853. * @return null|string
  854. */
  855. function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
  856. $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {
  857. _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
  858. $order = 'ASC';
  859. if ( substr($orderby, 0, 1) == '_' ) {
  860. $order = 'DESC';
  861. $orderby = substr($orderby, 1);
  862. }
  863. if ( $category == -1 ) //get_bookmarks uses '' to signify all categories
  864. $category = '';
  865. $results = get_bookmarks(array('category' => $category, 'orderby' => $orderby, 'order' => $order, 'show_updated' => $show_updated, 'limit' => $limit));
  866. if ( !$results )
  867. return;
  868. $output = '';
  869. foreach ( (array) $results as $row ) {
  870. if ( !isset($row->recently_updated) )
  871. $row->recently_updated = false;
  872. $output .= $before;
  873. if ( $show_updated && $row->recently_updated )
  874. $output .= get_option('links_recently_updated_prepend');
  875. $the_link = '#';
  876. if ( !empty($row->link_url) )
  877. $the_link = esc_url($row->link_url);
  878. $rel = $row->link_rel;
  879. if ( '' != $rel )
  880. $rel = ' rel="' . $rel . '"';
  881. $desc = esc_attr(sanitize_bookmark_field('link_description', $row->link_description, $row->link_id, 'display'));
  882. $name = esc_attr(sanitize_bookmark_field('link_name', $row->link_name, $row->link_id, 'display'));
  883. $title = $desc;
  884. if ( $show_updated )
  885. if (substr($row->link_updated_f, 0, 2) != '00')
  886. $title .= ' ('.__('Last updated') . ' ' . date(get_option('links_updated_date_format'), $row->link_updated_f + (get_option('gmt_offset') * HOUR_IN_SECONDS)) . ')';
  887. if ( '' != $title )
  888. $title = ' title="' . $title . '"';
  889. $alt = ' alt="' . $name . '"';
  890. $target = $row->link_target;
  891. if ( '' != $target )
  892. $target = ' target="' . $target . '"';
  893. $output .= '<a href="' . $the_link . '"' . $rel . $title . $target. '>';
  894. if ( $row->link_image != null && $show_images ) {
  895. if ( strpos($row->link_image, 'http') !== false )
  896. $output .= "<img src=\"$row->link_image\" $alt $title />";
  897. else // If it's a relative path
  898. $output .= "<img src=\"" . get_option('siteurl') . "$row->link_image\" $alt $title />";
  899. } else {
  900. $output .= $name;
  901. }
  902. $output .= '</a>';
  903. if ( $show_updated && $row->recently_updated )
  904. $output .= get_option('links_recently_updated_append');
  905. if ( $show_description && '' != $desc )
  906. $output .= $between . $desc;
  907. if ($show_rating) {
  908. $output .= $between . get_linkrating($row);
  909. }
  910. $output .= "$after\n";
  911. } // end while
  912. if ( !$echo )
  913. return $output;
  914. echo $output;
  915. }
  916. /**
  917. * Output entire list of links by category.
  918. *
  919. * Output a list of all links, listed by category, using the settings in
  920. * $wpdb->linkcategories and output it as a nested HTML unordered list.
  921. *
  922. * @since 1.0.1
  923. * @deprecated 2.1.0
  924. * @deprecated Use wp_list_bookmarks()
  925. * @see wp_list_bookmarks()
  926. *
  927. * @param string $order Sort link categories by 'name' or 'id'
  928. */
  929. function get_links_list($order = 'name') {
  930. _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' );
  931. $order = strtolower($order);
  932. // Handle link category sorting
  933. $direction = 'ASC';
  934. if ( '_' == substr($order,0,1) ) {
  935. $direction = 'DESC';
  936. $order = substr($order,1);
  937. }
  938. if ( !isset($direction) )
  939. $direction = '';
  940. $cats = get_categories(array('type' => 'link', 'orderby' => $order, 'order' => $direction, 'hierarchical' => 0));
  941. // Display each category
  942. if ( $cats ) {
  943. foreach ( (array) $cats as $cat ) {
  944. // Handle each category.
  945. // Display the category name
  946. echo ' <li id="linkcat-' . $cat->term_id . '" class="linkcat"><h2>' . apply_filters('link_category', $cat->name ) . "</h2>\n\t<ul>\n";
  947. // Call get_links() with all the appropriate params
  948. get_links($cat->term_id, '<li>', "</li>", "\n", true, 'name', false);
  949. // Close the last category
  950. echo "\n\t</ul>\n</li>\n";
  951. }
  952. }
  953. }
  954. /**
  955. * Show the link to the links popup and the number of links.
  956. *
  957. * @since 0.71
  958. * @deprecated 2.1.0
  959. * @deprecated {@internal Use function instead is unknown}}
  960. *
  961. * @param string $text the text of the link
  962. * @param int $width the width of the popup window
  963. * @param int $height the height of the popup window
  964. * @param string $file the page to open in the popup window
  965. * @param bool $count the number of links in the db
  966. */
  967. function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) {
  968. _deprecated_function( __FUNCTION__, '2.1' );
  969. }
  970. /**
  971. * @since 1.0.1
  972. * @deprecated 2.1.0
  973. * @deprecated Use sanitize_bookmark_field()
  974. * @see sanitize_bookmark_field()
  975. *
  976. * @param object $link
  977. * @return unknown
  978. */
  979. function get_linkrating($link) {
  980. _deprecated_function( __FUNCTION__, '2.1', 'sanitize_bookmark_field()' );
  981. return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
  982. }
  983. /**
  984. * Gets the name of category by id.
  985. *
  986. * @since 0.71
  987. * @deprecated 2.1.0
  988. * @deprecated Use get_category()
  989. * @see get_category()
  990. *
  991. * @param int $id The category to get. If no category supplied uses 0
  992. * @return string
  993. */
  994. function get_linkcatname($id = 0) {
  995. _deprecated_function( __FUNCTION__, '2.1', 'get_category()' );
  996. $id = (int) $id;
  997. if ( empty($id) )
  998. return '';
  999. $cats = wp_get_link_cats($id);
  1000. if ( empty($cats) || ! is_array($cats) )
  1001. return '';
  1002. $cat_id = (int) $cats[0]; // Take the first cat.
  1003. $cat = get_category($cat_id);
  1004. return $cat->name;
  1005. }
  1006. /**
  1007. * Print RSS comment feed link.
  1008. *
  1009. * @since 1.0.1
  1010. * @deprecated 2.5.0
  1011. * @deprecated Use post_comments_feed_link()
  1012. * @see post_comments_feed_link()
  1013. *
  1014. * @param string $link_text
  1015. */
  1016. function comments_rss_link($link_text = 'Comments RSS') {
  1017. _deprecated_function( __FUNCTION__, '2.5', 'post_comments_feed_link()' );
  1018. post_comments_feed_link($link_text);
  1019. }
  1020. /**
  1021. * Print/Return link to category RSS2 feed.
  1022. *
  1023. * @since 1.2.0
  1024. * @deprecated 2.5.0
  1025. * @deprecated Use get_category_feed_link()
  1026. * @see get_category_feed_link()
  1027. *
  1028. * @param bool $echo
  1029. * @param int $cat_ID
  1030. * @return string|null
  1031. */
  1032. function get_category_rss_link($echo = false, $cat_ID = 1) {
  1033. _deprecated_function( __FUNCTION__, '2.5', 'get_category_feed_link()' );
  1034. $link = get_category_feed_link($cat_ID, 'rss2');
  1035. if ( $echo )
  1036. echo $link;
  1037. return $link;
  1038. }
  1039. /**
  1040. * Print/Return link to author RSS feed.
  1041. *
  1042. * @since 1.2.0
  1043. * @deprecated 2.5.0
  1044. * @deprecated Use get_author_feed_link()
  1045. * @see get_author_feed_link()
  1046. *
  1047. * @param bool $echo
  1048. * @param int $author_id
  1049. * @return string|null
  1050. */
  1051. function get_author_rss_link($echo = false, $author_id = 1) {
  1052. _deprecated_function( __FUNCTION__, '2.5', 'get_author_feed_link()' );
  1053. $link = get_author_feed_link($author_id);
  1054. if ( $echo )
  1055. echo $link;
  1056. return $link;
  1057. }
  1058. /**
  1059. * Return link to the post RSS feed.
  1060. *
  1061. * @since 1.5.0
  1062. * @deprecated 2.2.0
  1063. * @deprecated Use get_post_comments_feed_link()
  1064. * @see get_post_comments_feed_link()
  1065. *
  1066. * @return string
  1067. */
  1068. function comments_rss() {
  1069. _deprecated_function( __FUNCTION__, '2.2', 'get_post_comments_feed_link()' );
  1070. return esc_url( get_post_comments_feed_link() );
  1071. }
  1072. /**
  1073. * An alias of wp_create_user().
  1074. *
  1075. * @since 2.0.0
  1076. * @deprecated 2.0.0
  1077. * @deprecated Use wp_create_user()
  1078. * @see wp_create_user()
  1079. *
  1080. * @param string $username The user's username.
  1081. * @param string $password The user's password.
  1082. * @param string $email The user's email (optional).
  1083. * @return int The new user's ID.
  1084. */
  1085. function create_user($username, $password, $email) {
  1086. _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' );
  1087. return wp_create_user($username, $password, $email);
  1088. }
  1089. /**
  1090. * Unused function.
  1091. *
  1092. * @deprecated 2.5.0
  1093. */
  1094. function gzip_compression() {
  1095. _deprecated_function( __FUNCTION__, '2.5' );
  1096. return false;
  1097. }
  1098. /**
  1099. * Retrieve an array of comment data about comment $comment_ID.
  1100. *
  1101. * @since 0.71
  1102. * @deprecated 2.7.0
  1103. * @deprecated Use get_comment()
  1104. * @see get_comment()
  1105. *
  1106. * @param int $comment_ID The ID of the comment
  1107. * @param int $no_cache Whether to use the cache (cast to bool)
  1108. * @param bool $include_unapproved Whether to include unapproved comments
  1109. * @return array The comment data
  1110. */
  1111. function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = false ) {
  1112. _deprecated_function( __FUNCTION__, '2.7', 'get_comment()' );
  1113. return get_comment($comment_ID, ARRAY_A);
  1114. }
  1115. /**
  1116. * Retrieve the category name by the category ID.
  1117. *
  1118. * @since 0.71
  1119. * @deprecated 2.8.0
  1120. * @deprecated Use get_cat_name()
  1121. * @see get_cat_name()
  1122. *
  1123. * @param int $cat_ID Category ID
  1124. * @return string category name
  1125. */
  1126. function get_catname( $cat_ID ) {
  1127. _deprecated_function( __FUNCTION__, '2.8', 'get_cat_name()' );
  1128. return get_cat_name( $cat_ID );
  1129. }
  1130. /**
  1131. * Retrieve category children list separated before and after the term IDs.
  1132. *
  1133. * @since 1.2.0
  1134. * @deprecated 2.8.0
  1135. * @deprecated Use get_term_children()
  1136. * @see get_term_children()
  1137. *
  1138. * @param int $id Category ID to retrieve children.
  1139. * @param string $before Optional. Prepend before category term ID.
  1140. * @param string $after Optional, default is empty string. Append after category term ID.
  1141. * @param array $visited Optional. Category Term IDs that have already been added.
  1142. * @return string
  1143. */
  1144. function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {
  1145. _deprecated_function( __FUNCTION__, '2.8', 'get_term_children()' );
  1146. if ( 0 == $id )
  1147. return '';
  1148. $chain = '';
  1149. /** TODO: consult hierarchy */
  1150. $cat_ids = get_all_category_ids();
  1151. foreach ( (array) $cat_ids as $cat_id ) {
  1152. if ( $cat_id == $id )
  1153. continue;
  1154. $category = get_category( $cat_id );
  1155. if ( is_wp_error( $category ) )
  1156. return $category;
  1157. if ( $category->parent == $id && !in_array( $category->term_id, $visited ) ) {
  1158. $visited[] = $category->term_id;
  1159. $chain .= $before.$category->term_id.$after;
  1160. $chain .= get_category_children( $category->term_id, $before, $after );
  1161. }
  1162. }
  1163. return $chain;
  1164. }
  1165. /**
  1166. * Retrieves all category IDs.
  1167. *
  1168. * @since 2.0.0
  1169. * @deprecated 4.0.0 Use get_terms() instead.
  1170. * @see get_terms()
  1171. * @link http://codex.wordpress.org/Function_Reference/get_all_category_ids
  1172. *
  1173. * @return object List of all of the category IDs.
  1174. */
  1175. function get_all_category_ids() {
  1176. _deprecated_function( __FUNCTION__, '4.0', 'get_terms()' );
  1177. if ( ! $cat_ids = wp_cache_get( 'all_category_ids', 'category' ) ) {
  1178. $cat_ids = get_terms( 'category', array('fields' => 'ids', 'get' => 'all') );
  1179. wp_cache_add( 'all_category_ids', $cat_ids, 'category' );
  1180. }
  1181. return $cat_ids;
  1182. }
  1183. /**
  1184. * Retrieve the description of the author of the current post.
  1185. *
  1186. * @since 1.5.0
  1187. * @deprecated 2.8.0
  1188. * @deprecated Use get_the_author_meta('description')
  1189. * @see get_the_author_meta()
  1190. *
  1191. * @return string The author's description.
  1192. */
  1193. function get_the_author_description() {
  1194. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' );
  1195. return get_the_author_meta('description');
  1196. }
  1197. /**
  1198. * Display the description of the author of the current post.
  1199. *
  1200. * @since 1.0.0
  1201. * @deprecated 2.8.0
  1202. * @deprecated Use the_author_meta('description')
  1203. * @see the_author_meta()
  1204. */
  1205. function the_author_description() {
  1206. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')' );
  1207. the_author_meta('description');
  1208. }
  1209. /**
  1210. * Retrieve the login name of the author of the current post.
  1211. *
  1212. * @since 1.5.0
  1213. * @deprecated 2.8.0
  1214. * @deprecated Use get_the_author_meta('login')
  1215. * @see get_the_author_meta()
  1216. *
  1217. * @return string The author's login name (username).
  1218. */
  1219. function get_the_author_login() {
  1220. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' );
  1221. return get_the_author_meta('login');
  1222. }
  1223. /**
  1224. * Display the login name of the author of the current post.
  1225. *
  1226. * @since 0.71
  1227. * @deprecated 2.8.0
  1228. * @deprecated Use the_author_meta('login')
  1229. * @see the_author_meta()
  1230. */
  1231. function the_author_login() {
  1232. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')' );
  1233. the_author_meta('login');
  1234. }
  1235. /**
  1236. * Retrieve the first name of the author of the current post.
  1237. *
  1238. * @since 1.5.0
  1239. * @deprecated 2.8.0
  1240. * @deprecated Use get_the_author_meta('first_name')
  1241. * @see get_the_author_meta()
  1242. *
  1243. * @return string The author's first name.
  1244. */
  1245. function get_the_author_firstname() {
  1246. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' );
  1247. return get_the_author_meta('first_name');
  1248. }
  1249. /**
  1250. * Display the first name of the author of the current post.
  1251. *
  1252. * @since 0.71
  1253. * @deprecated 2.8.0
  1254. * @deprecated Use the_author_meta('first_name')
  1255. * @see the_author_meta()
  1256. */
  1257. function the_author_firstname() {
  1258. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' );
  1259. the_author_meta('first_name');
  1260. }
  1261. /**
  1262. * Retrieve the last name of the author of the current post.
  1263. *
  1264. * @since 1.5.0
  1265. * @deprecated 2.8.0
  1266. * @deprecated Use get_the_author_meta('last_name')
  1267. * @see get_the_author_meta()
  1268. *
  1269. * @return string The author's last name.
  1270. */
  1271. function get_the_author_lastname() {
  1272. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' );
  1273. return get_the_author_meta('last_name');
  1274. }
  1275. /**
  1276. * Display the last name of the author of the current post.
  1277. *
  1278. * @since 0.71
  1279. * @deprecated 2.8.0
  1280. * @deprecated Use the_author_meta('last_name')
  1281. * @see the_author_meta()
  1282. */
  1283. function the_author_lastname() {
  1284. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' );
  1285. the_author_meta('last_name');
  1286. }
  1287. /**
  1288. * Retrieve the nickname of the author of the current post.
  1289. *
  1290. * @since 1.5.0
  1291. * @deprecated 2.8.0
  1292. * @deprecated Use get_the_author_meta('nickname')
  1293. * @see get_the_author_meta()
  1294. *
  1295. * @return string The author's nickname.
  1296. */
  1297. function get_the_author_nickname() {
  1298. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' );
  1299. return get_the_author_meta('nickname');
  1300. }
  1301. /**
  1302. * Display the nickname of the author of the current post.
  1303. *
  1304. * @since 0.71
  1305. * @deprecated 2.8.0
  1306. * @deprecated Use the_author_meta('nickname')
  1307. * @see the_author_meta()
  1308. */
  1309. function the_author_nickname() {
  1310. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' );
  1311. the_author_meta('nickname');
  1312. }
  1313. /**
  1314. * Retrieve the email of the author of the current post.
  1315. *
  1316. * @since 1.5.0
  1317. * @deprecated 2.8.0
  1318. * @deprecated Use get_the_author_meta('email')
  1319. * @see get_the_author_meta()
  1320. *
  1321. * @return string The author's username.
  1322. */
  1323. function get_the_author_email() {
  1324. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' );
  1325. return get_the_author_meta('email');
  1326. }
  1327. /**
  1328. * Display the email of the author of the current post.
  1329. *
  1330. * @since 0.71
  1331. * @deprecated 2.8.0
  1332. * @deprecated Use the_author_meta('email')
  1333. * @see the_author_meta()
  1334. */
  1335. function the_author_email() {
  1336. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')' );
  1337. the_author_meta('email');
  1338. }
  1339. /**
  1340. * Retrieve the ICQ number of the author of the current post.
  1341. *
  1342. * @since 1.5.0
  1343. * @deprecated 2.8.0
  1344. * @deprecated Use get_the_author_meta('icq')
  1345. * @see get_the_author_meta()
  1346. *
  1347. * @return string The author's ICQ number.
  1348. */
  1349. function get_the_author_icq() {
  1350. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' );
  1351. return get_the_author_meta('icq');
  1352. }
  1353. /**
  1354. * Display the ICQ number of the author of the current post.
  1355. *
  1356. * @since 0.71
  1357. * @deprecated 2.8.0
  1358. * @deprecated Use the_author_meta('icq')
  1359. * @see the_author_meta()
  1360. */
  1361. function the_author_icq() {
  1362. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')' );
  1363. the_author_meta('icq');
  1364. }
  1365. /**
  1366. * Retrieve the Yahoo! IM name of the author of the current post.
  1367. *
  1368. * @since 1.5.0
  1369. * @deprecated 2.8.0
  1370. * @deprecated Use get_the_author_meta('yim')
  1371. * @see get_the_author_meta()
  1372. *
  1373. * @return string The author's Yahoo! IM name.
  1374. */
  1375. function get_the_author_yim() {
  1376. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' );
  1377. return get_the_author_meta('yim');
  1378. }
  1379. /**
  1380. * Display the Yahoo! IM name of the author of the current post.
  1381. *
  1382. * @since 0.71
  1383. * @deprecated 2.8.0
  1384. * @deprecated Use the_author_meta('yim')
  1385. * @see the_author_meta()
  1386. */
  1387. function the_author_yim() {
  1388. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')' );
  1389. the_author_meta('yim');
  1390. }
  1391. /**
  1392. * Retrieve the MSN address of the author of the current post.
  1393. *
  1394. * @since 1.5.0
  1395. * @deprecated 2.8.0
  1396. * @deprecated Use get_the_author_meta('msn')
  1397. * @see get_the_author_meta()
  1398. *
  1399. * @return string The author's MSN address.
  1400. */
  1401. function get_the_author_msn() {
  1402. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' );
  1403. return get_the_author_meta('msn');
  1404. }
  1405. /**
  1406. * Display the MSN address of the author of the current post.
  1407. *
  1408. * @since 0.71
  1409. * @deprecated 2.8.0
  1410. * @deprecated Use the_author_meta('msn')
  1411. * @see the_author_meta()
  1412. */
  1413. function the_author_msn() {
  1414. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')' );
  1415. the_author_meta('msn');
  1416. }
  1417. /**
  1418. * Retrieve the AIM address of the author of the current post.
  1419. *
  1420. * @since 1.5.0
  1421. * @deprecated 2.8.0
  1422. * @deprecated Use get_the_author_meta('aim')
  1423. * @see get_the_author_meta()
  1424. *
  1425. * @return string The author's AIM address.
  1426. */
  1427. function get_the_author_aim() {
  1428. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' );
  1429. return get_the_author_meta('aim');
  1430. }
  1431. /**
  1432. * Display the AIM address of the author of the current post.
  1433. *
  1434. * @since 0.71
  1435. * @see the_author_meta()
  1436. * @deprecated 2.8.0
  1437. * @deprecated Use the_author_meta('aim')
  1438. */
  1439. function the_author_aim() {
  1440. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')' );
  1441. the_author_meta('aim');
  1442. }
  1443. /**
  1444. * Retrieve the specified author's preferred display name.
  1445. *
  1446. * @since 1.0.0
  1447. * @deprecated 2.8.0
  1448. * @deprecated Use get_the_author_meta('display_name')
  1449. * @see get_the_author_meta()
  1450. *
  1451. * @param int $auth_id The ID of the author.
  1452. * @return string The author's display name.
  1453. */
  1454. function get_author_name( $auth_id = false ) {
  1455. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' );
  1456. return get_the_author_meta('display_name', $auth_id);
  1457. }
  1458. /**
  1459. * Retrieve the URL to the home page of the author of the current post.
  1460. *
  1461. * @since 1.5.0
  1462. * @deprecated 2.8.0
  1463. * @deprecated Use get_the_author_meta('url')
  1464. * @see get_the_author_meta()
  1465. *
  1466. * @return string The URL to the author's page.
  1467. */
  1468. function get_the_author_url() {
  1469. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'url\')' );
  1470. return get_the_author_meta('url');
  1471. }
  1472. /**
  1473. * Display the URL to the home page of the author of the current post.
  1474. *
  1475. * @since 0.71
  1476. * @deprecated 2.8.0
  1477. * @deprecated Use the_author_meta('url')
  1478. * @see the_author_meta()
  1479. */
  1480. function the_author_url() {
  1481. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')' );
  1482. the_author_meta('url');
  1483. }
  1484. /**
  1485. * Retrieve the ID of the author of the current post.
  1486. *
  1487. * @since 1.5.0
  1488. * @deprecated 2.8.0
  1489. * @deprecated Use get_the_author_meta('ID')
  1490. * @see get_the_author_meta()
  1491. *
  1492. * @return int The author's ID.
  1493. */
  1494. function get_the_author_ID() {
  1495. _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')' );
  1496. return get_the_author_meta('ID');
  1497. }
  1498. /**
  1499. * Display the ID of the author of the current post.
  1500. *
  1501. * @since 0.71
  1502. * @deprecated 2.8.0
  1503. * @deprecated Use the_author_meta('ID')
  1504. * @see the_author_meta()
  1505. */
  1506. function the_author_ID() {
  1507. _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')' );
  1508. the_author_meta('ID');
  1509. }
  1510. /**
  1511. * Display the post content for the feed.
  1512. *
  1513. * For encoding the html or the $encode_html parameter, there are three possible
  1514. * values. '0' will make urls footnotes and use make_url_footnote(). '1' will
  1515. * encode special characters and automatically display all of the content. The
  1516. * value of '2' will strip all HTML tags from the content.
  1517. *
  1518. * Also note that you cannot set the amount of words and not set the html
  1519. * encoding. If that is the case, then the html encoding will default to 2,
  1520. * which will strip all HTML tags.
  1521. *
  1522. * To restrict the amount of words of the content, you can use the cut
  1523. * parameter. If the content is less than the amount, then there won't be any
  1524. * dots added to the end. If there is content left over, then dots will be added
  1525. * and the rest of the content will be removed.
  1526. *
  1527. * @since 0.71
  1528. * @uses apply_filters() Calls 'the_content_rss' on the content before processing.
  1529. *
  1530. * @deprecated 2.9.0
  1531. * @deprecated Use the_content_feed()
  1532. * @see the_content_feed()
  1533. *
  1534. * @param string $moreā€¦

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