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