diff options
Diffstat (limited to 'srcs/wordpress/wp-includes/deprecated.php')
| -rw-r--r-- | srcs/wordpress/wp-includes/deprecated.php | 3955 |
1 files changed, 0 insertions, 3955 deletions
diff --git a/srcs/wordpress/wp-includes/deprecated.php b/srcs/wordpress/wp-includes/deprecated.php deleted file mode 100644 index 98da670..0000000 --- a/srcs/wordpress/wp-includes/deprecated.php +++ /dev/null @@ -1,3955 +0,0 @@ -<?php -/** - * Deprecated functions from past WordPress versions. You shouldn't use these - * functions and look for the alternatives instead. The functions will be - * removed in a later version. - * - * @package WordPress - * @subpackage Deprecated - */ - -/* - * Deprecated functions come here to die. - */ - -/** - * Retrieves all post data for a given post. - * - * @since 0.71 - * @deprecated 1.5.1 Use get_post() - * @see get_post() - * - * @param int $postid Post ID. - * @return array Post data. - */ -function get_postdata($postid) { - _deprecated_function( __FUNCTION__, '1.5.1', 'get_post()' ); - - $post = get_post($postid); - - $postdata = array ( - 'ID' => $post->ID, - 'Author_ID' => $post->post_author, - 'Date' => $post->post_date, - 'Content' => $post->post_content, - 'Excerpt' => $post->post_excerpt, - 'Title' => $post->post_title, - 'Category' => $post->post_category, - 'post_status' => $post->post_status, - 'comment_status' => $post->comment_status, - 'ping_status' => $post->ping_status, - 'post_password' => $post->post_password, - 'to_ping' => $post->to_ping, - 'pinged' => $post->pinged, - 'post_type' => $post->post_type, - 'post_name' => $post->post_name - ); - - return $postdata; -} - -/** - * Sets up the WordPress Loop. - * - * Use The Loop instead. - * - * @link https://developer.wordpress.org/themes/basics/the-loop/ - * - * @since 1.0.1 - * @deprecated 1.5.0 - */ -function start_wp() { - global $wp_query; - - _deprecated_function( __FUNCTION__, '1.5.0', __('new WordPress Loop') ); - - // Since the old style loop is being used, advance the query iterator here. - $wp_query->next_post(); - - setup_postdata( get_post() ); -} - -/** - * Returns or prints a category ID. - * - * @since 0.71 - * @deprecated 0.71 Use get_the_category() - * @see get_the_category() - * - * @param bool $echo Optional. Whether to echo the output. Default true. - * @return int Category ID. - */ -function the_category_ID($echo = true) { - _deprecated_function( __FUNCTION__, '0.71', 'get_the_category()' ); - - // Grab the first cat in the list. - $categories = get_the_category(); - $cat = $categories[0]->term_id; - - if ( $echo ) - echo $cat; - - return $cat; -} - -/** - * Prints a category with optional text before and after. - * - * @since 0.71 - * @deprecated 0.71 Use get_the_category_by_ID() - * @see get_the_category_by_ID() - * - * @param string $before Optional. Text to display before the category. Default empty. - * @param string $after Optional. Text to display after the category. Default empty. - */ -function the_category_head( $before = '', $after = '' ) { - global $currentcat, $previouscat; - - _deprecated_function( __FUNCTION__, '0.71', 'get_the_category_by_ID()' ); - - // Grab the first cat in the list. - $categories = get_the_category(); - $currentcat = $categories[0]->category_id; - if ( $currentcat != $previouscat ) { - echo $before; - echo get_the_category_by_ID($currentcat); - echo $after; - $previouscat = $currentcat; - } -} - -/** - * Prints a link to the previous post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use previous_post_link() - * @see previous_post_link() - * - * @param string $format - * @param string $previous - * @param string $title - * @param string $in_same_cat - * @param int $limitprev - * @param string $excluded_categories - */ -function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') { - - _deprecated_function( __FUNCTION__, '2.0.0', 'previous_post_link()' ); - - if ( empty($in_same_cat) || 'no' == $in_same_cat ) - $in_same_cat = false; - else - $in_same_cat = true; - - $post = get_previous_post($in_same_cat, $excluded_categories); - - if ( !$post ) - return; - - $string = '<a href="'.get_permalink($post->ID).'">'.$previous; - if ( 'yes' == $title ) - $string .= apply_filters('the_title', $post->post_title, $post->ID); - $string .= '</a>'; - $format = str_replace('%', $string, $format); - echo $format; -} - -/** - * Prints link to the next post. - * - * @since 0.71 - * @deprecated 2.0.0 Use next_post_link() - * @see next_post_link() - * - * @param string $format - * @param string $next - * @param string $title - * @param string $in_same_cat - * @param int $limitnext - * @param string $excluded_categories - */ -function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') { - _deprecated_function( __FUNCTION__, '2.0.0', 'next_post_link()' ); - - if ( empty($in_same_cat) || 'no' == $in_same_cat ) - $in_same_cat = false; - else - $in_same_cat = true; - - $post = get_next_post($in_same_cat, $excluded_categories); - - if ( !$post ) - return; - - $string = '<a href="'.get_permalink($post->ID).'">'.$next; - if ( 'yes' == $title ) - $string .= apply_filters('the_title', $post->post_title, $post->ID); - $string .= '</a>'; - $format = str_replace('%', $string, $format); - echo $format; -} - -/** - * Whether user can create a post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $blog_id Not Used - * @param int $category_id Not Used - * @return bool - */ -function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - $author_data = get_userdata($user_id); - return ($author_data->user_level > 1); -} - -/** - * Whether user can create a post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $blog_id Not Used - * @param int $category_id Not Used - * @return bool - */ -function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - $author_data = get_userdata($user_id); - return ($author_data->user_level >= 1); -} - -/** - * Whether user can edit a post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $post_id - * @param int $blog_id Not Used - * @return bool - */ -function user_can_edit_post($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - $author_data = get_userdata($user_id); - $post = get_post($post_id); - $post_author_data = get_userdata($post->post_author); - - if ( (($user_id == $post_author_data->ID) && !($post->post_status == 'publish' && $author_data->user_level < 2)) - || ($author_data->user_level > $post_author_data->user_level) - || ($author_data->user_level >= 10) ) { - return true; - } else { - return false; - } -} - -/** - * Whether user can delete a post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $post_id - * @param int $blog_id Not Used - * @return bool - */ -function user_can_delete_post($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - // right now if one can edit, one can delete - return user_can_edit_post($user_id, $post_id, $blog_id); -} - -/** - * Whether user can set new posts' dates. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $blog_id Not Used - * @param int $category_id Not Used - * @return bool - */ -function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - $author_data = get_userdata($user_id); - return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id)); -} - -/** - * Whether user can delete a post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $post_id - * @param int $blog_id Not Used - * @return bool returns true if $user_id can edit $post_id's date - */ -function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - $author_data = get_userdata($user_id); - return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id)); -} - -/** - * Whether user can delete a post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $post_id - * @param int $blog_id Not Used - * @return bool returns true if $user_id can edit $post_id's comments - */ -function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - // right now if one can edit a post, one can edit comments made on it - return user_can_edit_post($user_id, $post_id, $blog_id); -} - -/** - * Whether user can delete a post. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $post_id - * @param int $blog_id Not Used - * @return bool returns true if $user_id can delete $post_id's comments - */ -function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - // right now if one can edit comments, one can delete comments - return user_can_edit_post_comments($user_id, $post_id, $blog_id); -} - -/** - * Can user can edit other user. - * - * @since 1.5.0 - * @deprecated 2.0.0 Use current_user_can() - * @see current_user_can() - * - * @param int $user_id - * @param int $other_user - * @return bool - */ -function user_can_edit_user($user_id, $other_user) { - _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' ); - - $user = get_userdata($user_id); - $other = get_userdata($other_user); - if ( $user->user_level > $other->user_level || $user->user_level > 8 || $user->ID == $other->ID ) - return true; - else - return false; -} - -/** - * Gets the links associated with category $cat_name. - * - * @since 0.71 - * @deprecated 2.1.0 Use get_bookmarks() - * @see get_bookmarks() - * - * @param string $cat_name Optional. The category name to use. If no match is found uses all. - * @param string $before Optional. The html to output before the link. - * @param string $after Optional. The html to output after the link. - * @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. - * @param bool $show_images Optional. Whether to show images (if defined). - * @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner. - * 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 - * random order. - * @param bool $show_description Optional. Whether to show the description if show_images=false/not defined. - * @param bool $show_rating Optional. Show rating stars/chars. - * @param int $limit Optional. Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated Optional. Whether to show last updated timestamp - */ -function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id', - $show_description = true, $show_rating = false, - $limit = -1, $show_updated = 0) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); - - $cat_id = -1; - $cat = get_term_by('name', $cat_name, 'link_category'); - if ( $cat ) - $cat_id = $cat->term_id; - - get_links($cat_id, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated); -} - -/** - * Gets the links associated with the named category. - * - * @since 1.0.1 - * @deprecated 2.1.0 Use wp_list_bookmarks() - * @see wp_list_bookmarks() - * - * @param string $category The category to use. - * @param string $args - * @return string|null - */ -function wp_get_linksbyname($category, $args = '') { - _deprecated_function(__FUNCTION__, '2.1.0', 'wp_list_bookmarks()'); - - $defaults = array( - 'after' => '<br />', - 'before' => '', - 'categorize' => 0, - 'category_after' => '', - 'category_before' => '', - 'category_name' => $category, - 'show_description' => 1, - 'title_li' => '', - ); - - $parsed_args = wp_parse_args( $args, $defaults ); - - return wp_list_bookmarks($parsed_args); -} - -/** - * Gets an array of link objects associated with category $cat_name. - * - * $links = get_linkobjectsbyname( 'fred' ); - * foreach ( $links as $link ) { - * echo '<li>' . $link->link_name . '</li>'; - * } - * - * @since 1.0.1 - * @deprecated 2.1.0 Use get_bookmarks() - * @see get_bookmarks() - * - * @param string $cat_name The category name to use. If no match is found uses all. - * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'. - * Or maybe owner. 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 random order. - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @return array - */ -function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); - - $cat_id = -1; - $cat = get_term_by('name', $cat_name, 'link_category'); - if ( $cat ) - $cat_id = $cat->term_id; - - return get_linkobjects($cat_id, $orderby, $limit); -} - -/** - * Gets an array of link objects associated with category n. - * - * Usage: - * - * $links = get_linkobjects(1); - * if ($links) { - * foreach ($links as $link) { - * echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>'; - * } - * } - * - * Fields are: - * - * - link_id - * - link_url - * - link_name - * - link_image - * - link_target - * - link_category - * - link_description - * - link_visible - * - link_owner - * - link_rating - * - link_updated - * - link_rel - * - link_notes - * - * @since 1.0.1 - * @deprecated 2.1.0 Use get_bookmarks() - * @see get_bookmarks() - * - * @param int $category The category to use. If no category supplied uses all - * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. 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 random order. - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @return array - */ -function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); - - $links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ; - - $links_array = array(); - foreach ($links as $link) - $links_array[] = $link; - - return $links_array; -} - -/** - * Gets the links associated with category 'cat_name' and display rating stars/chars. - * - * @since 0.71 - * @deprecated 2.1.0 Use get_bookmarks() - * @see get_bookmarks() - * - * @param string $cat_name The category name to use. If no match is found uses all - * @param string $before The html to output before the link - * @param string $after The html to output after the link - * @param string $between The html to output between the link/image and its description. Not used if no image or show_images is true - * @param bool $show_images Whether to show images (if defined). - * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. 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 random order. - * @param bool $show_description Whether to show the description if show_images=false/not defined - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated Whether to show last updated timestamp - */ -function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ", - $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); - - get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); -} - -/** - * Gets the links associated with category n and display rating stars/chars. - * - * @since 0.71 - * @deprecated 2.1.0 Use get_bookmarks() - * @see get_bookmarks() - * - * @param int $category The category to use. If no category supplied uses all - * @param string $before The html to output before the link - * @param string $after The html to output after the link - * @param string $between The html to output between the link/image and its description. Not used if no image or show_images == true - * @param bool $show_images Whether to show images (if defined). - * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. 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 random order. - * @param bool $show_description Whether to show the description if show_images=false/not defined. - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated Whether to show last updated timestamp - */ -function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true, - $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); - - get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated); -} - -/** - * Gets the auto_toggle setting. - * - * @since 0.71 - * @deprecated 2.1.0 - * - * @param int $id The category to get. If no category supplied uses 0 - * @return int Only returns 0. - */ -function get_autotoggle($id = 0) { - _deprecated_function( __FUNCTION__, '2.1.0' ); - return 0; -} - -/** - * Lists categories. - * - * @since 0.71 - * @deprecated 2.1.0 Use wp_list_categories() - * @see wp_list_categories() - * - * @param int $optionall - * @param string $all - * @param string $sort_column - * @param string $sort_order - * @param string $file - * @param bool $list - * @param int $optiondates - * @param int $optioncount - * @param int $hide_empty - * @param int $use_desc_for_title - * @param bool $children - * @param int $child_of - * @param int $categories - * @param int $recurse - * @param string $feed - * @param string $feed_image - * @param string $exclude - * @param bool $hierarchical - * @return false|null - */ -function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0, - $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0, - $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' ); - - $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children', - 'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical'); - return wp_list_cats($query); -} - -/** - * Lists categories. - * - * @since 1.2.0 - * @deprecated 2.1.0 Use wp_list_categories() - * @see wp_list_categories() - * - * @param string|array $args - * @return false|null|string - */ -function wp_list_cats($args = '') { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' ); - - $parsed_args = wp_parse_args( $args ); - - // Map to new names. - if ( isset($parsed_args['optionall']) && isset($parsed_args['all'])) - $parsed_args['show_option_all'] = $parsed_args['all']; - if ( isset($parsed_args['sort_column']) ) - $parsed_args['orderby'] = $parsed_args['sort_column']; - if ( isset($parsed_args['sort_order']) ) - $parsed_args['order'] = $parsed_args['sort_order']; - if ( isset($parsed_args['optiondates']) ) - $parsed_args['show_last_update'] = $parsed_args['optiondates']; - if ( isset($parsed_args['optioncount']) ) - $parsed_args['show_count'] = $parsed_args['optioncount']; - if ( isset($parsed_args['list']) ) - $parsed_args['style'] = $parsed_args['list'] ? 'list' : 'break'; - $parsed_args['title_li'] = ''; - - return wp_list_categories($parsed_args); -} - -/** - * Deprecated method for generating a drop-down of categories. - * - * @since 0.71 - * @deprecated 2.1.0 Use wp_dropdown_categories() - * @see wp_dropdown_categories() - * - * @param int $optionall - * @param string $all - * @param string $orderby - * @param string $order - * @param int $show_last_update - * @param int $show_count - * @param int $hide_empty - * @param bool $optionnone - * @param int $selected - * @param int $exclude - * @return string - */ -function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc', - $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false, - $selected = 0, $exclude = 0) { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_dropdown_categories()' ); - - $show_option_all = ''; - if ( $optionall ) - $show_option_all = $all; - - $show_option_none = ''; - if ( $optionnone ) - $show_option_none = __('None'); - - $vars = compact('show_option_all', 'show_option_none', 'orderby', 'order', - 'show_last_update', 'show_count', 'hide_empty', 'selected', 'exclude'); - $query = add_query_arg($vars, ''); - return wp_dropdown_categories($query); -} - -/** - * Lists authors. - * - * @since 1.2.0 - * @deprecated 2.1.0 Use wp_list_authors() - * @see wp_list_authors() - * - * @param bool $optioncount - * @param bool $exclude_admin - * @param bool $show_fullname - * @param bool $hide_empty - * @param string $feed - * @param string $feed_image - * @return null|string - */ -function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_authors()' ); - - $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image'); - return wp_list_authors($args); -} - -/** - * Retrieves a list of post categories. - * - * @since 1.0.1 - * @deprecated 2.1.0 Use wp_get_post_categories() - * @see wp_get_post_categories() - * - * @param int $blogid Not Used - * @param int $post_ID - * @return array - */ -function wp_get_post_cats($blogid = '1', $post_ID = 0) { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_get_post_categories()' ); - return wp_get_post_categories($post_ID); -} - -/** - * Sets the categories that the post id belongs to. - * - * @since 1.0.1 - * @deprecated 2.1.0 - * @deprecated Use wp_set_post_categories() - * @see wp_set_post_categories() - * - * @param int $blogid Not used - * @param int $post_ID - * @param array $post_categories - * @return bool|mixed - */ -function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_set_post_categories()' ); - return wp_set_post_categories($post_ID, $post_categories); -} - -/** - * Retrieves a list of archives. - * - * @since 0.71 - * @deprecated 2.1.0 Use wp_get_archives() - * @see wp_get_archives() - * - * @param string $type - * @param string $limit - * @param string $format - * @param string $before - * @param string $after - * @param bool $show_post_count - * @return string|null - */ -function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_get_archives()' ); - $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count'); - return wp_get_archives($args); -} - -/** - * Returns or Prints link to the author's posts. - * - * @since 1.2.0 - * @deprecated 2.1.0 Use get_author_posts_url() - * @see get_author_posts_url() - * - * @param bool $echo - * @param int $author_id - * @param string $author_nicename Optional. - * @return string|null - */ -function get_author_link($echo, $author_id, $author_nicename = '') { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_author_posts_url()' ); - - $link = get_author_posts_url($author_id, $author_nicename); - - if ( $echo ) - echo $link; - return $link; -} - -/** - * Print list of pages based on arguments. - * - * @since 0.71 - * @deprecated 2.1.0 Use wp_link_pages() - * @see wp_link_pages() - * - * @param string $before - * @param string $after - * @param string $next_or_number - * @param string $nextpagelink - * @param string $previouspagelink - * @param string $pagelink - * @param string $more_file - * @return string - */ -function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page', - $pagelink='%', $more_file='') { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_link_pages()' ); - - $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file'); - return wp_link_pages($args); -} - -/** - * Get value based on option. - * - * @since 0.71 - * @deprecated 2.1.0 Use get_option() - * @see get_option() - * - * @param string $option - * @return string - */ -function get_settings($option) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_option()' ); - - return get_option($option); -} - -/** - * Print the permalink of the current post in the loop. - * - * @since 0.71 - * @deprecated 1.2.0 Use the_permalink() - * @see the_permalink() - */ -function permalink_link() { - _deprecated_function( __FUNCTION__, '1.2.0', 'the_permalink()' ); - the_permalink(); -} - -/** - * Print the permalink to the RSS feed. - * - * @since 0.71 - * @deprecated 2.3.0 Use the_permalink_rss() - * @see the_permalink_rss() - * - * @param string $deprecated - */ -function permalink_single_rss($deprecated = '') { - _deprecated_function( __FUNCTION__, '2.3.0', 'the_permalink_rss()' ); - the_permalink_rss(); -} - -/** - * Gets the links associated with category. - * - * @since 1.0.1 - * @deprecated 2.1.0 Use wp_list_bookmarks() - * @see wp_list_bookmarks() - * - * @param string $args a query string - * @return null|string - */ -function wp_get_links($args = '') { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' ); - - if ( strpos( $args, '=' ) === false ) { - $cat_id = $args; - $args = add_query_arg( 'category', $cat_id, $args ); - } - - $defaults = array( - 'after' => '<br />', - 'before' => '', - 'between' => ' ', - 'categorize' => 0, - 'category' => '', - 'echo' => true, - 'limit' => -1, - 'orderby' => 'name', - 'show_description' => true, - 'show_images' => true, - 'show_rating' => false, - 'show_updated' => true, - 'title_li' => '', - ); - - $parsed_args = wp_parse_args( $args, $defaults ); - - return wp_list_bookmarks($parsed_args); -} - -/** - * Gets the links associated with category by id. - * - * @since 0.71 - * @deprecated 2.1.0 Use get_bookmarks() - * @see get_bookmarks() - * - * @param int $category The category to use. If no category supplied uses all - * @param string $before the html to output before the link - * @param string $after the html to output after the link - * @param string $between the html to output between the link/image and its description. - * Not used if no image or show_images == true - * @param bool $show_images whether to show images (if defined). - * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url', - * 'description', or 'rating'. Or maybe owner. 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 random order. - * @param bool $show_description whether to show the description if show_images=false/not defined. - * @param bool $show_rating show rating stars/chars - * @param int $limit Limit to X entries. If not specified, all entries are shown. - * @param int $show_updated whether to show last updated timestamp - * @param bool $echo whether to echo the results, or return them instead - * @return null|string - */ -function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name', - $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); - - $order = 'ASC'; - if ( substr($orderby, 0, 1) == '_' ) { - $order = 'DESC'; - $orderby = substr($orderby, 1); - } - - if ( $category == -1 ) //get_bookmarks uses '' to signify all categories - $category = ''; - - $results = get_bookmarks(array('category' => $category, 'orderby' => $orderby, 'order' => $order, 'show_updated' => $show_updated, 'limit' => $limit)); - - if ( !$results ) - return; - - $output = ''; - - foreach ( (array) $results as $row ) { - if ( !isset($row->recently_updated) ) - $row->recently_updated = false; - $output .= $before; - if ( $show_updated && $row->recently_updated ) - $output .= get_option('links_recently_updated_prepend'); - $the_link = '#'; - if ( !empty($row->link_url) ) - $the_link = esc_url($row->link_url); - $rel = $row->link_rel; - if ( '' != $rel ) - $rel = ' rel="' . $rel . '"'; - - $desc = esc_attr(sanitize_bookmark_field('link_description', $row->link_description, $row->link_id, 'display')); - $name = esc_attr(sanitize_bookmark_field('link_name', $row->link_name, $row->link_id, 'display')); - $title = $desc; - - if ( $show_updated ) - if (substr($row->link_updated_f, 0, 2) != '00') - $title .= ' ('.__('Last updated') . ' ' . gmdate(get_option('links_updated_date_format'), $row->link_updated_f + (get_option('gmt_offset') * HOUR_IN_SECONDS)) . ')'; - - if ( '' != $title ) - $title = ' title="' . $title . '"'; - - $alt = ' alt="' . $name . '"'; - - $target = $row->link_target; - if ( '' != $target ) - $target = ' target="' . $target . '"'; - - $output .= '<a href="' . $the_link . '"' . $rel . $title . $target. '>'; - - if ( $row->link_image != null && $show_images ) { - if ( strpos($row->link_image, 'http') !== false ) - $output .= "<img src=\"$row->link_image\" $alt $title />"; - else // If it's a relative path - $output .= "<img src=\"" . get_option('siteurl') . "$row->link_image\" $alt $title />"; - } else { - $output .= $name; - } - - $output .= '</a>'; - - if ( $show_updated && $row->recently_updated ) - $output .= get_option('links_recently_updated_append'); - - if ( $show_description && '' != $desc ) - $output .= $between . $desc; - - if ($show_rating) { - $output .= $between . get_linkrating($row); - } - - $output .= "$after\n"; - } // end while - - if ( !$echo ) - return $output; - echo $output; -} - -/** - * Output entire list of links by category. - * - * Output a list of all links, listed by category, using the settings in - * $wpdb->linkcategories and output it as a nested HTML unordered list. - * - * @since 1.0.1 - * @deprecated 2.1.0 Use wp_list_bookmarks() - * @see wp_list_bookmarks() - * - * @param string $order Sort link categories by 'name' or 'id' - */ -function get_links_list($order = 'name') { - _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' ); - - $order = strtolower($order); - - // Handle link category sorting - $direction = 'ASC'; - if ( '_' == substr($order,0,1) ) { - $direction = 'DESC'; - $order = substr($order,1); - } - - if ( !isset($direction) ) - $direction = ''; - - $cats = get_categories(array('type' => 'link', 'orderby' => $order, 'order' => $direction, 'hierarchical' => 0)); - - // Display each category - if ( $cats ) { - foreach ( (array) $cats as $cat ) { - // Handle each category. - - // Display the category name - echo ' <li id="linkcat-' . $cat->term_id . '" class="linkcat"><h2>' . apply_filters('link_category', $cat->name ) . "</h2>\n\t<ul>\n"; - // Call get_links() with all the appropriate params - get_links($cat->term_id, '<li>', "</li>", "\n", true, 'name', false); - - // Close the last category - echo "\n\t</ul>\n</li>\n"; - } - } -} - -/** - * Show the link to the links popup and the number of links. - * - * @since 0.71 - * @deprecated 2.1.0 - * - * @param string $text the text of the link - * @param int $width the width of the popup window - * @param int $height the height of the popup window - * @param string $file the page to open in the popup window - * @param bool $count the number of links in the db - */ -function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) { - _deprecated_function( __FUNCTION__, '2.1.0' ); -} - -/** - * Legacy function that retrieved the value of a link's link_rating field. - * - * @since 1.0.1 - * @deprecated 2.1.0 Use sanitize_bookmark_field() - * @see sanitize_bookmark_field() - * - * @param object $link Link object. - * @return mixed Value of the 'link_rating' field, false otherwise. - */ -function get_linkrating( $link ) { - _deprecated_function( __FUNCTION__, '2.1.0', 'sanitize_bookmark_field()' ); - return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display'); -} - -/** - * Gets the name of category by id. - * - * @since 0.71 - * @deprecated 2.1.0 Use get_category() - * @see get_category() - * - * @param int $id The category to get. If no category supplied uses 0 - * @return string - */ -function get_linkcatname($id = 0) { - _deprecated_function( __FUNCTION__, '2.1.0', 'get_category()' ); - - $id = (int) $id; - - if ( empty($id) ) - return ''; - |