11 /*

    11 /*

    12  * Deprecated functions come here to die.

    12  * Deprecated functions come here to die.

    13  */

    13  */

    14 

    14 

    15 /**

    15 /**

    21  * @see get_post()

    20  * @see get_post()

    22  *

    21  *

    25  */

    24  */

    26 function get_postdata($postid) {

    25 function get_postdata($postid) {

    27 	_deprecated_function( __FUNCTION__, '1.5.1', 'get_post()' );

    26 	_deprecated_function( __FUNCTION__, '1.5.1', 'get_post()' );

    28 

    27 

    29 	$post = get_post($postid);

    28 	$post = get_post($postid);

    50 }

    49 }

    51 

    50 

    52 /**

    51 /**

    53  * Sets up the WordPress Loop.

    52  * Sets up the WordPress Loop.

    54  *

    53  *

    55  * @since 1.0.1

    58  * @since 1.0.1

    56  * @deprecated 1.5.0

    59  * @deprecated 1.5.0

    58  */

    60  */

    59 function start_wp() {

    61 function start_wp() {

    60 	global $wp_query;

    62 	global $wp_query;

    61 

    63 

    63 

    65 

    64 	// Since the old style loop is being used, advance the query iterator here.

    66 	// Since the old style loop is being used, advance the query iterator here.

    65 	$wp_query->next_post();

    67 	$wp_query->next_post();

    66 

    68 

    67 	setup_postdata( get_post() );

    69 	setup_postdata( get_post() );

    68 }

    70 }

    69 

    71 

    70 /**

    72 /**

    76  * @see get_the_category()

    77  * @see get_the_category()

    77  *

    78  *

    80  */

    81  */

    81 function the_category_ID($echo = true) {

    82 function the_category_ID($echo = true) {

    82 	_deprecated_function( __FUNCTION__, '0.71', 'get_the_category()' );

    83 	_deprecated_function( __FUNCTION__, '0.71', 'get_the_category()' );

    83 

    84 

    84 	// Grab the first cat in the list.

    85 	// Grab the first cat in the list.

    90 

    91 

    91 	return $cat;

    92 	return $cat;

    92 }

    93 }

    93 

    94 

    94 /**

    95 /**

   100  * @see get_the_category_by_ID()

   100  * @see get_the_category_by_ID()

   101  *

   101  *

   106 	global $currentcat, $previouscat;

   106 	global $currentcat, $previouscat;

   107 

   107 

   108 	_deprecated_function( __FUNCTION__, '0.71', 'get_the_category_by_ID()' );

   108 	_deprecated_function( __FUNCTION__, '0.71', 'get_the_category_by_ID()' );

   109 

   109 

   110 	// Grab the first cat in the list.

   110 	// Grab the first cat in the list.

   117 		$previouscat = $currentcat;

   117 		$previouscat = $currentcat;

   118 	}

   118 	}

   119 }

   119 }

   120 

   120 

   121 /**

   121 /**

   123  *

   123  *

   124  * @since 1.5.0

   124  * @since 1.5.0

   127  * @see previous_post_link()

   126  * @see previous_post_link()

   128  *

   127  *

   129  * @param string $format

   128  * @param string $format

   130  * @param string $previous

   129  * @param string $previous

   131  * @param string $title

   130  * @param string $title

   132  * @param string $in_same_cat

   131  * @param string $in_same_cat

   134  * @param string $excluded_categories

   133  * @param string $excluded_categories

   135  */

   134  */

   136 function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') {

   135 function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') {

   137 

   136 

   139 

   138 

   140 	if ( empty($in_same_cat) || 'no' == $in_same_cat )

   139 	if ( empty($in_same_cat) || 'no' == $in_same_cat )

   141 		$in_same_cat = false;

   140 		$in_same_cat = false;

   142 	else

   141 	else

   143 		$in_same_cat = true;

   142 		$in_same_cat = true;

   157 

   156 

   158 /**

   157 /**

   159  * Prints link to the next post.

   158  * Prints link to the next post.

   160  *

   159  *

   161  * @since 0.71

   160  * @since 0.71

   164  * @see next_post_link()

   162  * @see next_post_link()

   165  *

   163  *

   166  * @param string $format

   164  * @param string $format

   167  * @param string $next

   165  * @param string $next

   168  * @param string $title

   166  * @param string $title

   169  * @param string $in_same_cat

   167  * @param string $in_same_cat

   170  * @param int $limitnext

   168  * @param int $limitnext

   171  * @param string $excluded_categories

   169  * @param string $excluded_categories

   172  */

   170  */

   173 function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') {

   171 function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') {

   175 

   173 

   176 	if ( empty($in_same_cat) || 'no' == $in_same_cat )

   174 	if ( empty($in_same_cat) || 'no' == $in_same_cat )

   177 		$in_same_cat = false;

   175 		$in_same_cat = false;

   178 	else

   176 	else

   179 		$in_same_cat = true;

   177 		$in_same_cat = true;

   193 

   191 

   194 /**

   192 /**

   195  * Whether user can create a post.

   193  * Whether user can create a post.

   196  *

   194  *

   197  * @since 1.5.0

   195  * @since 1.5.0

   200  * @see current_user_can()

   197  * @see current_user_can()

   201  *

   198  *

   202  * @param int $user_id

   199  * @param int $user_id

   203  * @param int $blog_id Not Used

   200  * @param int $blog_id Not Used

   204  * @param int $category_id Not Used

   201  * @param int $category_id Not Used

   205  * @return bool

   202  * @return bool

   206  */

   203  */

   207 function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') {

   204 function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') {

   209 

   206 

   210 	$author_data = get_userdata($user_id);

   207 	$author_data = get_userdata($user_id);

   211 	return ($author_data->user_level > 1);

   208 	return ($author_data->user_level > 1);

   212 }

   209 }

   213 

   210 

   214 /**

   211 /**

   215  * Whether user can create a post.

   212  * Whether user can create a post.

   216  *

   213  *

   217  * @since 1.5.0

   214  * @since 1.5.0

   220  * @see current_user_can()

   216  * @see current_user_can()

   221  *

   217  *

   222  * @param int $user_id

   218  * @param int $user_id

   223  * @param int $blog_id Not Used

   219  * @param int $blog_id Not Used

   224  * @param int $category_id Not Used

   220  * @param int $category_id Not Used

   225  * @return bool

   221  * @return bool

   226  */

   222  */

   227 function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {

   223 function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {

   229 

   225 

   230 	$author_data = get_userdata($user_id);

   226 	$author_data = get_userdata($user_id);

   231 	return ($author_data->user_level >= 1);

   227 	return ($author_data->user_level >= 1);

   232 }

   228 }

   233 

   229 

   234 /**

   230 /**

   235  * Whether user can edit a post.

   231  * Whether user can edit a post.

   236  *

   232  *

   237  * @since 1.5.0

   233  * @since 1.5.0

   240  * @see current_user_can()

   235  * @see current_user_can()

   241  *

   236  *

   242  * @param int $user_id

   237  * @param int $user_id

   243  * @param int $post_id

   238  * @param int $post_id

   244  * @param int $blog_id Not Used

   239  * @param int $blog_id Not Used

   245  * @return bool

   240  * @return bool

   246  */

   241  */

   247 function user_can_edit_post($user_id, $post_id, $blog_id = 1) {

   242 function user_can_edit_post($user_id, $post_id, $blog_id = 1) {

   249 

   244 

   250 	$author_data = get_userdata($user_id);

   245 	$author_data = get_userdata($user_id);

   251 	$post = get_post($post_id);

   246 	$post = get_post($post_id);

   252 	$post_author_data = get_userdata($post->post_author);

   247 	$post_author_data = get_userdata($post->post_author);

   253 

   248 

   262 

   257 

   263 /**

   258 /**

   264  * Whether user can delete a post.

   259  * Whether user can delete a post.

   265  *

   260  *

   266  * @since 1.5.0

   261  * @since 1.5.0

   269  * @see current_user_can()

   263  * @see current_user_can()

   270  *

   264  *

   271  * @param int $user_id

   265  * @param int $user_id

   272  * @param int $post_id

   266  * @param int $post_id

   273  * @param int $blog_id Not Used

   267  * @param int $blog_id Not Used

   274  * @return bool

   268  * @return bool

   275  */

   269  */

   276 function user_can_delete_post($user_id, $post_id, $blog_id = 1) {

   270 function user_can_delete_post($user_id, $post_id, $blog_id = 1) {

   278 

   272 

   279 	// right now if one can edit, one can delete

   273 	// right now if one can edit, one can delete

   280 	return user_can_edit_post($user_id, $post_id, $blog_id);

   274 	return user_can_edit_post($user_id, $post_id, $blog_id);

   281 }

   275 }

   282 

   276 

   283 /**

   277 /**

   284  * Whether user can set new posts' dates.

   278  * Whether user can set new posts' dates.

   285  *

   279  *

   286  * @since 1.5.0

   280  * @since 1.5.0

   289  * @see current_user_can()

   282  * @see current_user_can()

   290  *

   283  *

   291  * @param int $user_id

   284  * @param int $user_id

   292  * @param int $blog_id Not Used

   285  * @param int $blog_id Not Used

   293  * @param int $category_id Not Used

   286  * @param int $category_id Not Used

   294  * @return bool

   287  * @return bool

   295  */

   288  */

   296 function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') {

   289 function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') {

   298 

   291 

   299 	$author_data = get_userdata($user_id);

   292 	$author_data = get_userdata($user_id);

   300 	return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id));

   293 	return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id));

   301 }

   294 }

   302 

   295 

   303 /**

   296 /**

   304  * Whether user can delete a post.

   297  * Whether user can delete a post.

   305  *

   298  *

   306  * @since 1.5.0

   299  * @since 1.5.0

   309  * @see current_user_can()

   301  * @see current_user_can()

   310  *

   302  *

   311  * @param int $user_id

   303  * @param int $user_id

   312  * @param int $post_id

   304  * @param int $post_id

   313  * @param int $blog_id Not Used

   305  * @param int $blog_id Not Used

   314  * @return bool returns true if $user_id can edit $post_id's date

   306  * @return bool returns true if $user_id can edit $post_id's date

   315  */

   307  */

   316 function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) {

   308 function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) {

   318 

   310 

   319 	$author_data = get_userdata($user_id);

   311 	$author_data = get_userdata($user_id);

   320 	return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id));

   312 	return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id));

   321 }

   313 }

   322 

   314 

   323 /**

   315 /**

   324  * Whether user can delete a post.

   316  * Whether user can delete a post.

   325  *

   317  *

   326  * @since 1.5.0

   318  * @since 1.5.0

   329  * @see current_user_can()

   320  * @see current_user_can()

   330  *

   321  *

   331  * @param int $user_id

   322  * @param int $user_id

   332  * @param int $post_id

   323  * @param int $post_id

   333  * @param int $blog_id Not Used

   324  * @param int $blog_id Not Used

   334  * @return bool returns true if $user_id can edit $post_id's comments

   325  * @return bool returns true if $user_id can edit $post_id's comments

   335  */

   326  */

   336 function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {

   327 function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {

   338 

   329 

   339 	// right now if one can edit a post, one can edit comments made on it

   330 	// right now if one can edit a post, one can edit comments made on it

   340 	return user_can_edit_post($user_id, $post_id, $blog_id);

   331 	return user_can_edit_post($user_id, $post_id, $blog_id);

   341 }

   332 }

   342 

   333 

   343 /**

   334 /**

   344  * Whether user can delete a post.

   335  * Whether user can delete a post.

   345  *

   336  *

   346  * @since 1.5.0

   337  * @since 1.5.0

   349  * @see current_user_can()

   339  * @see current_user_can()

   350  *

   340  *

   351  * @param int $user_id

   341  * @param int $user_id

   352  * @param int $post_id

   342  * @param int $post_id

   353  * @param int $blog_id Not Used

   343  * @param int $blog_id Not Used

   354  * @return bool returns true if $user_id can delete $post_id's comments

   344  * @return bool returns true if $user_id can delete $post_id's comments

   355  */

   345  */

   356 function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {

   346 function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {

   358 

   348 

   359 	// right now if one can edit comments, one can delete comments

   349 	// right now if one can edit comments, one can delete comments

   360 	return user_can_edit_post_comments($user_id, $post_id, $blog_id);

   350 	return user_can_edit_post_comments($user_id, $post_id, $blog_id);

   361 }

   351 }

   362 

   352 

   363 /**

   353 /**

   364  * Can user can edit other user.

   354  * Can user can edit other user.

   365  *

   355  *

   366  * @since 1.5.0

   356  * @since 1.5.0

   369  * @see current_user_can()

   358  * @see current_user_can()

   370  *

   359  *

   371  * @param int $user_id

   360  * @param int $user_id

   372  * @param int $other_user

   361  * @param int $other_user

   373  * @return bool

   362  * @return bool

   374  */

   363  */

   375 function user_can_edit_user($user_id, $other_user) {

   364 function user_can_edit_user($user_id, $other_user) {

   377 

   366 

   378 	$user  = get_userdata($user_id);

   367 	$user  = get_userdata($user_id);

   379 	$other = get_userdata($other_user);

   368 	$other = get_userdata($other_user);

   380 	if ( $user->user_level > $other->user_level || $user->user_level > 8 || $user->ID == $other->ID )

   369 	if ( $user->user_level > $other->user_level || $user->user_level > 8 || $user->ID == $other->ID )

   381 		return true;

   370 		return true;

   385 

   374 

   386 /**

   375 /**

   387  * Gets the links associated with category $cat_name.

   376  * Gets the links associated with category $cat_name.

   388  *

   377  *

   389  * @since 0.71

   378  * @since 0.71

   392  * @see get_bookmarks()

   380  * @see get_bookmarks()

   393  *

   381  *

   394  * @param string $cat_name Optional. The category name to use. If no match is found uses all.

   382  * @param string $cat_name Optional. The category name to use. If no match is found uses all.

   395  * @param string $before Optional. The html to output before the link.

   383  * @param string $before Optional. The html to output before the link.

   396  * @param string $after Optional. The html to output after the link.

   384  * @param string $after Optional. The html to output after the link.

   405  * @param int $show_updated Optional. Whether to show last updated timestamp

   393  * @param int $show_updated Optional. Whether to show last updated timestamp

   406  */

   394  */

   407 function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',

   395 function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',

   408 						 $show_description = true, $show_rating = false,

   396 						 $show_description = true, $show_rating = false,

   409 						 $limit = -1, $show_updated = 0) {

   397 						 $limit = -1, $show_updated = 0) {

   411 

   399 

   412 	$cat_id = -1;

   400 	$cat_id = -1;

   413 	$cat = get_term_by('name', $cat_name, 'link_category');

   401 	$cat = get_term_by('name', $cat_name, 'link_category');

   414 	if ( $cat )

   402 	if ( $cat )

   415 		$cat_id = $cat->term_id;

   403 		$cat_id = $cat->term_id;

   419 

   407 

   420 /**

   408 /**

   421  * Gets the links associated with the named category.

   409  * Gets the links associated with the named category.

   422  *

   410  *

   423  * @since 1.0.1

   411  * @since 1.0.1

   426  * @see wp_list_bookmarks()

   413  * @see wp_list_bookmarks()

   427  *

   414  *

   428  * @param string $category The category to use.

   415  * @param string $category The category to use.

   429  * @param string $args

   416  * @param string $args

   430  * @return string|null

   417  * @return string|null

   431  */

   418  */

   432 function wp_get_linksbyname($category, $args = '') {

   419 function wp_get_linksbyname($category, $args = '') {

   434 

   421 

   435 	$defaults = array(

   422 	$defaults = array(

   436 		'after' => '<br />',

   423 		'after' => '<br />',

   437 		'before' => '',

   424 		'before' => '',

   438 		'categorize' => 0,

   425 		'categorize' => 0,

   455  *     foreach ( $links as $link ) {

   442  *     foreach ( $links as $link ) {

   456  *      	echo '<li>' . $link->link_name . '</li>';

   443  *      	echo '<li>' . $link->link_name . '</li>';

   457  *     }

   444  *     }

   458  *

   445  *

   459  * @since 1.0.1

   446  * @since 1.0.1

   462  * @see get_bookmarks()

   448  * @see get_bookmarks()

   463  *

   449  *

   464  * @param string $cat_name The category name to use. If no match is found uses all.

   450  * @param string $cat_name The category name to use. If no match is found uses all.

   465  * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.

   451  * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.

   466  *		Or maybe owner. If you start the name with an underscore the order will be reversed. You can also

   452  *		Or maybe owner. If you start the name with an underscore the order will be reversed. You can also

   467  *		specify 'rand' as the order which will return links in a random order.

   453  *		specify 'rand' as the order which will return links in a random order.

   468  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   454  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   469  * @return array

   455  * @return array

   470  */

   456  */

   471 function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {

   457 function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {

   473 

   459 

   474 	$cat_id = -1;

   460 	$cat_id = -1;

   475 	$cat = get_term_by('name', $cat_name, 'link_category');

   461 	$cat = get_term_by('name', $cat_name, 'link_category');

   476 	if ( $cat )

   462 	if ( $cat )

   477 		$cat_id = $cat->term_id;

   463 		$cat_id = $cat->term_id;

   506  * - link_updated

   492  * - link_updated

   507  * - link_rel

   493  * - link_rel

   508  * - link_notes

   494  * - link_notes

   509  *

   495  *

   510  * @since 1.0.1

   496  * @since 1.0.1

   513  * @see get_bookmarks()

   498  * @see get_bookmarks()

   514  *

   499  *

   515  * @param int $category The category to use. If no category supplied uses all

   500  * @param int $category The category to use. If no category supplied uses all

   516  * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',

   501  * @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',

   517  *		'description', or 'rating'. Or maybe owner. If you start the name with an

   502  *		'description', or 'rating'. Or maybe owner. If you start the name with an

   519  *		order which will return links in a random order.

   504  *		order which will return links in a random order.

   520  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   505  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   521  * @return array

   506  * @return array

   522  */

   507  */

   523 function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {

   508 function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {

   525 

   510 

   526 	$links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ;

   511 	$links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ;

   527 

   512 

   528 	$links_array = array();

   513 	$links_array = array();

   529 	foreach ($links as $link)

   514 	foreach ($links as $link)

   534 

   519 

   535 /**

   520 /**

   536  * Gets the links associated with category 'cat_name' and display rating stars/chars.

   521  * Gets the links associated with category 'cat_name' and display rating stars/chars.

   537  *

   522  *

   538  * @since 0.71

   523  * @since 0.71

   541  * @see get_bookmarks()

   525  * @see get_bookmarks()

   542  *

   526  *

   543  * @param string $cat_name The category name to use. If no match is found uses all

   527  * @param string $cat_name The category name to use. If no match is found uses all

   544  * @param string $before The html to output before the link

   528  * @param string $before The html to output before the link

   545  * @param string $after The html to output after the link

   529  * @param string $after The html to output after the link

   553  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   537  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   554  * @param int $show_updated Whether to show last updated timestamp

   538  * @param int $show_updated Whether to show last updated timestamp

   555  */

   539  */

   556 function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",

   540 function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",

   557 									$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {

   541 									$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {

   559 

   543 

   560 	get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);

   544 	get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);

   561 }

   545 }

   562 

   546 

   563 /**

   547 /**

   564  * Gets the links associated with category n and display rating stars/chars.

   548  * Gets the links associated with category n and display rating stars/chars.

   565  *

   549  *

   566  * @since 0.71

   550  * @since 0.71

   569  * @see get_bookmarks()

   552  * @see get_bookmarks()

   570  *

   553  *

   571  * @param int $category The category to use. If no category supplied uses all

   554  * @param int $category The category to use. If no category supplied uses all

   572  * @param string $before The html to output before the link

   555  * @param string $before The html to output before the link

   573  * @param string $after The html to output after the link

   556  * @param string $after The html to output after the link

   581  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   564  * @param int $limit Limit to X entries. If not specified, all entries are shown.

   582  * @param int $show_updated Whether to show last updated timestamp

   565  * @param int $show_updated Whether to show last updated timestamp

   583  */

   566  */

   584 function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,

   567 function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,

   585 							  $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {

   568 							  $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {

   587 

   570 

   588 	get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);

   571 	get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);

   589 }

   572 }

   590 

   573 

   591 /**

   574 /**

   592  * Gets the auto_toggle setting.

   575  * Gets the auto_toggle setting.

   593  *

   576  *

   594  * @since 0.71

   577  * @since 0.71

   595  * @deprecated 2.1.0

   578  * @deprecated 2.1.0

   597  *

   579  *

   598  * @param int $id The category to get. If no category supplied uses 0

   580  * @param int $id The category to get. If no category supplied uses 0

   599  * @return int Only returns 0.

   581  * @return int Only returns 0.

   600  */

   582  */

   601 function get_autotoggle($id = 0) {

   583 function get_autotoggle($id = 0) {

   603 	return 0;

   585 	return 0;

   604 }

   586 }

   605 

   587 

   606 /**

   588 /**

   610  * @see wp_list_categories()

   593  * @see wp_list_categories()

   611  *

   594  *

   612  * @param int $optionall

   595  * @param int $optionall

   613  * @param string $all

   596  * @param string $all

   614  * @param string $sort_column

   597  * @param string $sort_column

   630  * @return false|null

   613  * @return false|null

   631  */

   614  */

   632 function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,

   615 function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,

   633 				   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,

   616 				   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,

   634 				   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {

   617 				   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {

   636 

   619 

   637 	$query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',

   620 	$query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',

   638 		'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');

   621 		'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');

   639 	return wp_list_cats($query);

   622 	return wp_list_cats($query);

   640 }

   623 }

   641 

   624 

   642 /**

   625 /**

   643  * @since 1.2.0

   628  * @since 1.2.0

   646  * @see wp_list_categories()

   630  * @see wp_list_categories()

   647  *

   631  *

   648  * @param string|array $args

   632  * @param string|array $args

   649  * @return false|null|string

   633  * @return false|null|string

   650  */

   634  */

   651 function wp_list_cats($args = '') {

   635 function wp_list_cats($args = '') {

   653 

   637 

   654 	$r = wp_parse_args( $args );

   638 	$r = wp_parse_args( $args );

   655 

   639 

   656 	// Map to new names.

   640 	// Map to new names.

   657 	if ( isset($r['optionall']) && isset($r['all']))

   641 	if ( isset($r['optionall']) && isset($r['all']))

   670 

   654 

   671 	return wp_list_categories($r);

   655 	return wp_list_categories($r);

   672 }

   656 }

   673 

   657 

   674 /**

   658 /**

   678  * @see wp_dropdown_categories()

   663  * @see wp_dropdown_categories()

   679  *

   664  *

   680  * @param int $optionall

   665  * @param int $optionall

   681  * @param string $all

   666  * @param string $all

   682  * @param string $orderby

   667  * @param string $orderby

   690  * @return string

   675  * @return string

   691  */

   676  */

   692 function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',

   677 function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',

   693 		$show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,

   678 		$show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,

   694 		$selected = 0, $exclude = 0) {

   679 		$selected = 0, $exclude = 0) {

   696 

   681 

   697 	$show_option_all = '';

   682 	$show_option_all = '';

   698 	if ( $optionall )

   683 	if ( $optionall )

   699 		$show_option_all = $all;

   684 		$show_option_all = $all;

   700 

   685 

   707 	$query = add_query_arg($vars, '');

   692 	$query = add_query_arg($vars, '');

   708 	return wp_dropdown_categories($query);

   693 	return wp_dropdown_categories($query);

   709 }

   694 }

   710 

   695 

   711 /**

   696 /**

   713  *

   698  *

   714  * @since 1.2.0

   699  * @since 1.2.0

   717  * @see wp_list_authors()

   701  * @see wp_list_authors()

   718  *

   702  *

   719  * @param bool $optioncount

   703  * @param bool $optioncount

   720  * @param bool $exclude_admin

   704  * @param bool $exclude_admin

   721  * @param bool $show_fullname

   705  * @param bool $show_fullname

   723  * @param string $feed

   707  * @param string $feed

   724  * @param string $feed_image

   708  * @param string $feed_image

   725  * @return null|string

   709  * @return null|string

   726  */

   710  */

   727 function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') {

   711 function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') {

   729 

   713 

   730 	$args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image');

   714 	$args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image');

   731 	return wp_list_authors($args);

   715 	return wp_list_authors($args);

   732 }

   716 }

   733 

   717 

   734 /**

   718 /**

   735  * @since 1.0.1

   721  * @since 1.0.1

   738  * @see wp_get_post_categories()

   723  * @see wp_get_post_categories()

   739  *

   724  *

   740  * @param int $blogid Not Used

   725  * @param int $blogid Not Used

   741  * @param int $post_ID

   726  * @param int $post_ID

   742  * @return array

   727  * @return array

   743  */

   728  */

   744 function wp_get_post_cats($blogid = '1', $post_ID = 0) {

   729 function wp_get_post_cats($blogid = '1', $post_ID = 0) {

   746 	return wp_get_post_categories($post_ID);

   731 	return wp_get_post_categories($post_ID);

   747 }

   732 }

   748 

   733 

   749 /**

   734 /**

   750  * Sets the categories that the post id belongs to.

   735  * Sets the categories that the post id belongs to.

   758  * @param int $post_ID

   743  * @param int $post_ID

   759  * @param array $post_categories

   744  * @param array $post_categories

   760  * @return bool|mixed

   745  * @return bool|mixed

   761  */

   746  */

   762 function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) {

   747 function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) {

   764 	return wp_set_post_categories($post_ID, $post_categories);

   749 	return wp_set_post_categories($post_ID, $post_categories);

   765 }

   750 }

   766 

   751 

   767 /**

   752 /**

   771  * @see wp_get_archives()

   757  * @see wp_get_archives()

   772  *

   758  *

   773  * @param string $type

   759  * @param string $type

   774  * @param string $limit

   760  * @param string $limit

   775  * @param string $format

   761  * @param string $format

   777  * @param string $after

   763  * @param string $after

   778  * @param bool $show_post_count

   764  * @param bool $show_post_count

   779  * @return string|null

   765  * @return string|null

   780  */

   766  */

   781 function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) {

   767 function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) {

   783 	$args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count');

   769 	$args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count');

   784 	return wp_get_archives($args);

   770 	return wp_get_archives($args);

   785 }

   771 }

   786 

   772 

   787 /**

   773 /**

   788  * Returns or Prints link to the author's posts.

   774  * Returns or Prints link to the author's posts.

   789  *

   775  *

   790  * @since 1.2.0

   776  * @since 1.2.0

   793  * @see get_author_posts_url()

   778  * @see get_author_posts_url()

   794  *

   779  *

   795  * @param bool $echo

   780  * @param bool $echo

   796  * @param int $author_id

   781  * @param int $author_id

   797  * @param string $author_nicename Optional.

   782  * @param string $author_nicename Optional.

   798  * @return string|null

   783  * @return string|null

   799  */

   784  */

   800 function get_author_link($echo, $author_id, $author_nicename = '') {

   785 function get_author_link($echo, $author_id, $author_nicename = '') {

   802 

   787 

   803 	$link = get_author_posts_url($author_id, $author_nicename);

   788 	$link = get_author_posts_url($author_id, $author_nicename);

   804 

   789 

   805 	if ( $echo )

   790 	if ( $echo )

   806 		echo $link;

   791 		echo $link;

   809 

   794 

   810 /**

   795 /**

   811  * Print list of pages based on arguments.

   796  * Print list of pages based on arguments.

   812  *

   797  *

   813  * @since 0.71

   798  * @since 0.71

   816  * @see wp_link_pages()

   800  * @see wp_link_pages()

   817  *

   801  *

   818  * @param string $before

   802  * @param string $before

   819  * @param string $after

   803  * @param string $after

   820  * @param string $next_or_number

   804  * @param string $next_or_number

   824  * @param string $more_file

   808  * @param string $more_file

   825  * @return string

   809  * @return string

   826  */

   810  */

   827 function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',

   811 function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',

   828 					$pagelink='%', $more_file='') {

   812 					$pagelink='%', $more_file='') {

   830 

   814 

   831 	$args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');

   815 	$args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');

   832 	return wp_link_pages($args);

   816 	return wp_link_pages($args);

   833 }

   817 }

   834 

   818 

   835 /**

   819 /**

   836  * Get value based on option.

   820  * Get value based on option.

   837  *

   821  *

   838  * @since 0.71

   822  * @since 0.71

   841  * @see get_option()

   824  * @see get_option()

   842  *

   825  *

   843  * @param string $option

   826  * @param string $option

   844  * @return string

   827  * @return string

   845  */

   828  */

   846 function get_settings($option) {

   829 function get_settings($option) {

   848 

   831 

   849 	return get_option($option);

   832 	return get_option($option);

   850 }

   833 }

   851 

   834 

   852 /**

   835 /**

   853  * Print the permalink of the current post in the loop.

   836  * Print the permalink of the current post in the loop.

   854  *

   837  *

   855  * @since 0.71

   838  * @since 0.71

   858  * @see the_permalink()

   840  * @see the_permalink()

   859  */

   841  */

   860 function permalink_link() {

   842 function permalink_link() {

   862 	the_permalink();

   844 	the_permalink();

   863 }

   845 }

   864 

   846 

   865 /**

   847 /**

   866  * Print the permalink to the RSS feed.

   848  * Print the permalink to the RSS feed.

   867  *

   849  *

   868  * @since 0.71

   850  * @since 0.71

   871  * @see the_permalink_rss()

   852  * @see the_permalink_rss()

   872  *

   853  *

   873  * @param string $deprecated

   854  * @param string $deprecated

   874  */

   855  */

   875 function permalink_single_rss($deprecated = '') {

   856 function permalink_single_rss($deprecated = '') {

   877 	the_permalink_rss();

   858 	the_permalink_rss();

   878 }

   859 }

   879 

   860 

   880 /**

   861 /**

   881  * Gets the links associated with category.

   862  * Gets the links associated with category.

   882  *

   863  *

   884  * @since 1.0.1

   864  * @since 1.0.1

   887  * @see wp_list_bookmarks()

   866  * @see wp_list_bookmarks()

   888  *

   867  *

   889  * @param string $args a query string

   868  * @param string $args a query string

   890  * @return null|string

   869  * @return null|string

   891  */

   870  */

   892 function wp_get_links($args = '') {

   871 function wp_get_links($args = '') {

   894 

   873 

   895 	if ( strpos( $args, '=' ) === false ) {

   874 	if ( strpos( $args, '=' ) === false ) {

   896 		$cat_id = $args;

   875 		$cat_id = $args;

   897 		$args = add_query_arg( 'category', $cat_id, $args );

   876 		$args = add_query_arg( 'category', $cat_id, $args );

   898 	}

   877 	}

   920 

   899 

   921 /**

   900 /**

   922  * Gets the links associated with category by id.

   901  * Gets the links associated with category by id.

   923  *

   902  *

   924  * @since 0.71

   903  * @since 0.71

   927  * @see get_bookmarks()

   905  * @see get_bookmarks()

   928  *

   906  *

   929  * @param int $category The category to use. If no category supplied uses all

   907  * @param int $category The category to use. If no category supplied uses all

   930  * @param string $before the html to output before the link

   908  * @param string $before the html to output before the link

   931  * @param string $after the html to output after the link

   909  * @param string $after the html to output after the link

   943  * @param bool $echo whether to echo the results, or return them instead

   921  * @param bool $echo whether to echo the results, or return them instead

   944  * @return null|string

   922  * @return null|string

   945  */

   923  */

   946 function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',

   924 function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',

   947 			$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {

   925 			$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {

   949 

   927 

   950 	$order = 'ASC';

   928 	$order = 'ASC';

   951 	if ( substr($orderby, 0, 1) == '_' ) {

   929 	if ( substr($orderby, 0, 1) == '_' ) {

   952 		$order = 'DESC';

   930 		$order = 'DESC';

   953 		$orderby = substr($orderby, 1);

   931 		$orderby = substr($orderby, 1);

  1029  *

  1007  *

  1030  * Output a list of all links, listed by category, using the settings in

  1008  * Output a list of all links, listed by category, using the settings in

  1031  * $wpdb->linkcategories and output it as a nested HTML unordered list.

  1009  * $wpdb->linkcategories and output it as a nested HTML unordered list.

  1032  *

  1010  *

  1033  * @since 1.0.1

  1011  * @since 1.0.1

  1036  * @see wp_list_bookmarks()

  1013  * @see wp_list_bookmarks()

  1037  *

  1014  *

  1038  * @param string $order Sort link categories by 'name' or 'id'

  1015  * @param string $order Sort link categories by 'name' or 'id'

  1039  */

  1016  */

  1040 function get_links_list($order = 'name') {

  1017 function get_links_list($order = 'name') {

  1042 

  1019 

  1043 	$order = strtolower($order);

  1020 	$order = strtolower($order);

  1044 

  1021 

  1045 	// Handle link category sorting

  1022 	// Handle link category sorting

  1046 	$direction = 'ASC';

  1023 	$direction = 'ASC';

  1073 /**

  1050 /**

  1074  * Show the link to the links popup and the number of links.

  1051  * Show the link to the links popup and the number of links.

  1075  *

  1052  *

  1076  * @since 0.71

  1053  * @since 0.71

  1077  * @deprecated 2.1.0

  1054  * @deprecated 2.1.0

  1079  *

  1055  *

  1080  * @param string $text the text of the link

  1056  * @param string $text the text of the link

  1081  * @param int $width the width of the popup window

  1057  * @param int $width the width of the popup window

  1082  * @param int $height the height of the popup window

  1058  * @param int $height the height of the popup window

  1083  * @param string $file the page to open in the popup window

  1059  * @param string $file the page to open in the popup window

  1084  * @param bool $count the number of links in the db

  1060  * @param bool $count the number of links in the db

  1085  */

  1061  */

  1086 function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) {

  1062 function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) {

  1091  * @since 1.0.1

  1069  * @since 1.0.1

  1094  * @see sanitize_bookmark_field()

  1071  * @see sanitize_bookmark_field()

  1095  *

  1072  *

  1101 	return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');

  1078 	return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');

  1102 }

  1079 }

  1103 

  1080 

  1104 /**

  1081 /**

  1105  * Gets the name of category by id.

  1082  * Gets the name of category by id.

  1106  *

  1083  *

  1107  * @since 0.71

  1084  * @since 0.71

  1110  * @see get_category()

  1086  * @see get_category()

  1111  *

  1087  *

  1112  * @param int $id The category to get. If no category supplied uses 0

  1088  * @param int $id The category to get. If no category supplied uses 0

  1113  * @return string

  1089  * @return string

  1114  */

  1090  */

  1115 function get_linkcatname($id = 0) {

  1091 function get_linkcatname($id = 0) {

  1117 

  1093 

  1118 	$id = (int) $id;

  1094 	$id = (int) $id;

  1119 

  1095 

  1120 	if ( empty($id) )

  1096 	if ( empty($id) )

  1121 		return '';

  1097 		return '';

  1133 

  1109 

  1134 /**

  1110 /**

  1135  * Print RSS comment feed link.

  1111  * Print RSS comment feed link.

  1136  *

  1112  *

  1137  * @since 1.0.1

  1113  * @since 1.0.1

  1140  * @see post_comments_feed_link()

  1115  * @see post_comments_feed_link()

  1141  *

  1116  *

  1142  * @param string $link_text

  1117  * @param string $link_text

  1143  */

  1118  */

  1144 function comments_rss_link($link_text = 'Comments RSS') {

  1119 function comments_rss_link($link_text = 'Comments RSS') {

  1146 	post_comments_feed_link($link_text);

  1121 	post_comments_feed_link($link_text);

  1147 }

  1122 }

  1148 

  1123 

  1149 /**

  1124 /**

  1150  * Print/Return link to category RSS2 feed.

  1125  * Print/Return link to category RSS2 feed.

  1151  *

  1126  *

  1152  * @since 1.2.0

  1127  * @since 1.2.0

  1155  * @see get_category_feed_link()

  1129  * @see get_category_feed_link()

  1156  *

  1130  *

  1157  * @param bool $echo

  1131  * @param bool $echo

  1158  * @param int $cat_ID

  1132  * @param int $cat_ID

  1159  * @return string

  1133  * @return string

  1160  */

  1134  */

  1161 function get_category_rss_link($echo = false, $cat_ID = 1) {

  1135 function get_category_rss_link($echo = false, $cat_ID = 1) {

  1163 

  1137 

  1164 	$link = get_category_feed_link($cat_ID, 'rss2');

  1138 	$link = get_category_feed_link($cat_ID, 'rss2');

  1165 

  1139 

  1166 	if ( $echo )

  1140 	if ( $echo )

  1167 		echo $link;

  1141 		echo $link;

  1170 

  1144 

  1171 /**

  1145 /**

  1172  * Print/Return link to author RSS feed.

  1146  * Print/Return link to author RSS feed.

  1173  *

  1147  *

  1174  * @since 1.2.0

  1148  * @since 1.2.0

  1177  * @see get_author_feed_link()

  1150  * @see get_author_feed_link()

  1178  *

  1151  *

  1179  * @param bool $echo

  1152  * @param bool $echo

  1180  * @param int $author_id

  1153  * @param int $author_id

  1181  * @return string

  1154  * @return string

  1182  */

  1155  */

  1183 function get_author_rss_link($echo = false, $author_id = 1) {

  1156 function get_author_rss_link($echo = false, $author_id = 1) {

  1185 

  1158 

  1186 	$link = get_author_feed_link($author_id);

  1159 	$link = get_author_feed_link($author_id);

  1187 	if ( $echo )

  1160 	if ( $echo )

  1188 		echo $link;

  1161 		echo $link;

  1189 	return $link;

  1162 	return $link;

  1191 

  1164 

  1192 /**

  1165 /**

  1193  * Return link to the post RSS feed.

  1166  * Return link to the post RSS feed.

  1194  *

  1167  *

  1195  * @since 1.5.0

  1168  * @since 1.5.0

  1198  * @see get_post_comments_feed_link()

  1170  * @see get_post_comments_feed_link()

  1199  *

  1171  *

  1200  * @return string

  1172  * @return string

  1201  */

  1173  */

  1202 function comments_rss() {

  1174 function comments_rss() {

  1204 	return esc_url( get_post_comments_feed_link() );

  1176 	return esc_url( get_post_comments_feed_link() );

  1205 }

  1177 }

  1206 

  1178 

  1207 /**

  1179 /**

  1208  * An alias of wp_create_user().

  1180  * An alias of wp_create_user().

  1209  *

  1181  *

  1210  * @since 2.0.0

  1182  * @since 2.0.0

  1213  * @see wp_create_user()

  1184  * @see wp_create_user()

  1214  *

  1185  *

  1215  * @param string $username The user's username.

  1186  * @param string $username The user's username.

  1216  * @param string $password The user's password.

  1187  * @param string $password The user's password.

  1217  * @param string $email    The user's email.

  1188  * @param string $email    The user's email.

  1218  * @return int The new user's ID.

  1189  * @return int The new user's ID.

  1219  */

  1190  */

  1220 function create_user($username, $password, $email) {

  1191 function create_user($username, $password, $email) {

  1222 	return wp_create_user($username, $password, $email);

  1193 	return wp_create_user($username, $password, $email);

  1223 }

  1194 }

  1224 

  1195 

  1225 /**

  1196 /**

  1226  * Unused function.

  1197  * Unused function.

  1227  *

  1198  *

  1228  * @deprecated 2.5.0

  1199  * @deprecated 2.5.0

  1230 function gzip_compression() {

  1201 function gzip_compression() {

  1232 	return false;

  1203 	return false;

  1233 }

  1204 }

  1234 

  1205 

  1235 /**

  1206 /**

  1236  * Retrieve an array of comment data about comment $comment_ID.

  1207  * Retrieve an array of comment data about comment $comment_ID.

  1237  *

  1208  *

  1238  * @since 0.71

  1209  * @since 0.71

  1241  * @see get_comment()

  1211  * @see get_comment()

  1242  *

  1212  *

  1243  * @param int $comment_ID The ID of the comment

  1213  * @param int $comment_ID The ID of the comment

  1244  * @param int $no_cache Whether to use the cache (cast to bool)

  1214  * @param int $no_cache Whether to use the cache (cast to bool)

  1245  * @param bool $include_unapproved Whether to include unapproved comments

  1215  * @param bool $include_unapproved Whether to include unapproved comments

  1246  * @return array The comment data

  1216  * @return array The comment data

  1247  */

  1217  */

  1248 function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = false ) {

  1218 function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = false ) {

  1250 	return get_comment($comment_ID, ARRAY_A);

  1220 	return get_comment($comment_ID, ARRAY_A);

  1251 }

  1221 }

  1252 

  1222 

  1253 /**

  1223 /**

  1254  * Retrieve the category name by the category ID.

  1224  * Retrieve the category name by the category ID.

  1255  *

  1225  *

  1256  * @since 0.71

  1226  * @since 0.71

  1259  * @see get_cat_name()

  1228  * @see get_cat_name()

  1260  *

  1229  *

  1261  * @param int $cat_ID Category ID

  1230  * @param int $cat_ID Category ID

  1262  * @return string category name

  1231  * @return string category name

  1263  */

  1232  */

  1264 function get_catname( $cat_ID ) {

  1233 function get_catname( $cat_ID ) {

  1266 	return get_cat_name( $cat_ID );

  1235 	return get_cat_name( $cat_ID );

  1267 }

  1236 }

  1268 

  1237 

  1269 /**

  1238 /**

  1270  * Retrieve category children list separated before and after the term IDs.

  1239  * Retrieve category children list separated before and after the term IDs.

  1271  *

  1240  *

  1272  * @since 1.2.0

  1241  * @since 1.2.0

  1275  * @see get_term_children()

  1243  * @see get_term_children()

  1276  *

  1244  *

  1277  * @param int $id Category ID to retrieve children.

  1245  * @param int $id Category ID to retrieve children.

  1278  * @param string $before Optional. Prepend before category term ID.

  1246  * @param string $before Optional. Prepend before category term ID.

  1279  * @param string $after Optional, default is empty string. Append after category term ID.

  1247  * @param string $after Optional, default is empty string. Append after category term ID.

  1280  * @param array $visited Optional. Category Term IDs that have already been added.

  1248  * @param array $visited Optional. Category Term IDs that have already been added.

  1281  * @return string

  1249  * @return string

  1282  */

  1250  */

  1283 function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {

  1251 function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {

  1285 	if ( 0 == $id )

  1253 	if ( 0 == $id )

  1286 		return '';

  1254 		return '';

  1287 

  1255 

  1288 	$chain = '';

  1256 	$chain = '';

  1289 	/** TODO: consult hierarchy */

  1257 	/** TODO: consult hierarchy */

  1306 

  1274 

  1307 /**

  1275 /**

  1308  * Retrieves all category IDs.

  1276  * Retrieves all category IDs.

  1309  *

  1277  *

  1310  * @since 2.0.0

  1278  * @since 2.0.0

  1312  * @see get_terms()

  1280  * @see get_terms()

  1313  * @link https://codex.wordpress.org/Function_Reference/get_all_category_ids

  1282  * @link https://codex.wordpress.org/Function_Reference/get_all_category_ids

  1314  *

  1283  *

  1315  * @return object List of all of the category IDs.

  1284  * @return object List of all of the category IDs.

  1316  */

  1285  */

  1317 function get_all_category_ids() {

  1286 function get_all_category_ids() {

  1319 

  1288 

  1320 	if ( ! $cat_ids = wp_cache_get( 'all_category_ids', 'category' ) ) {

  1289 	if ( ! $cat_ids = wp_cache_get( 'all_category_ids', 'category' ) ) {

  1321 		$cat_ids = get_terms( 'category', array('fields' => 'ids', 'get' => 'all') );

  1290 		$cat_ids = get_terms( 'category', array('fields' => 'ids', 'get' => 'all') );

  1322 		wp_cache_add( 'all_category_ids', $cat_ids, 'category' );

  1291 		wp_cache_add( 'all_category_ids', $cat_ids, 'category' );

  1323 	}

  1292 	}

  1327 

  1296 

  1328 /**

  1297 /**

  1329  * Retrieve the description of the author of the current post.

  1298  * Retrieve the description of the author of the current post.

  1330  *

  1299  *

  1331  * @since 1.5.0

  1300  * @since 1.5.0

  1334  * @see get_the_author_meta()

  1302  * @see get_the_author_meta()

  1335  *

  1303  *

  1336  * @return string The author's description.

  1304  * @return string The author's description.

  1337  */

  1305  */

  1338 function get_the_author_description() {

  1306 function get_the_author_description() {

  1340 	return get_the_author_meta('description');

  1308 	return get_the_author_meta('description');

  1341 }

  1309 }

  1342 

  1310 

  1343 /**

  1311 /**

  1344  * Display the description of the author of the current post.

  1312  * Display the description of the author of the current post.

  1345  *

  1313  *

  1346  * @since 1.0.0

  1314  * @since 1.0.0

  1349  * @see the_author_meta()

  1316  * @see the_author_meta()

  1350  */

  1317  */

  1351 function the_author_description() {

  1318 function the_author_description() {

  1353 	the_author_meta('description');

  1320 	the_author_meta('description');

  1354 }

  1321 }

  1355 

  1322 

  1356 /**

  1323 /**

  1357  * Retrieve the login name of the author of the current post.

  1324  * Retrieve the login name of the author of the current post.

  1358  *

  1325  *

  1359  * @since 1.5.0

  1326  * @since 1.5.0

  1362  * @see get_the_author_meta()

  1328  * @see get_the_author_meta()

  1363  *

  1329  *

  1364  * @return string The author's login name (username).

  1330  * @return string The author's login name (username).

  1365  */

  1331  */

  1366 function get_the_author_login() {

  1332 function get_the_author_login() {

  1368 	return get_the_author_meta('login');

  1334 	return get_the_author_meta('login');

  1369 }

  1335 }

  1370 

  1336 

  1371 /**

  1337 /**

  1372  * Display the login name of the author of the current post.

  1338  * Display the login name of the author of the current post.

  1373  *

  1339  *

  1374  * @since 0.71

  1340  * @since 0.71

  1377  * @see the_author_meta()

  1342  * @see the_author_meta()

  1378  */

  1343  */

  1379 function the_author_login() {

  1344 function the_author_login() {

  1381 	the_author_meta('login');

  1346 	the_author_meta('login');

  1382 }

  1347 }

  1383 

  1348 

  1384 /**

  1349 /**

  1385  * Retrieve the first name of the author of the current post.

  1350  * Retrieve the first name of the author of the current post.

  1386  *

  1351  *

  1387  * @since 1.5.0

  1352  * @since 1.5.0

  1390  * @see get_the_author_meta()

  1354  * @see get_the_author_meta()

  1391  *

  1355  *

  1392  * @return string The author's first name.

  1356  * @return string The author's first name.

  1393  */

  1357  */

  1394 function get_the_author_firstname() {

  1358 function get_the_author_firstname() {

  1396 	return get_the_author_meta('first_name');

  1360 	return get_the_author_meta('first_name');

  1397 }

  1361 }

  1398 

  1362 

  1399 /**

  1363 /**

  1400  * Display the first name of the author of the current post.

  1364  * Display the first name of the author of the current post.

  1401  *

  1365  *

  1402  * @since 0.71

  1366  * @since 0.71

  1405  * @see the_author_meta()

  1368  * @see the_author_meta()

  1406  */

  1369  */

  1407 function the_author_firstname() {

  1370 function the_author_firstname() {

  1409 	the_author_meta('first_name');

  1372 	the_author_meta('first_name');

  1410 }

  1373 }

  1411 

  1374 

  1412 /**

  1375 /**

  1413  * Retrieve the last name of the author of the current post.

  1376  * Retrieve the last name of the author of the current post.

  1414  *

  1377  *

  1415  * @since 1.5.0

  1378  * @since 1.5.0

  1418  * @see get_the_author_meta()

  1380  * @see get_the_author_meta()

  1419  *

  1381  *

  1420  * @return string The author's last name.

  1382  * @return string The author's last name.

  1421  */

  1383  */

  1422 function get_the_author_lastname() {

  1384 function get_the_author_lastname() {

  1424 	return get_the_author_meta('last_name');

  1386 	return get_the_author_meta('last_name');

  1425 }

  1387 }

  1426 

  1388 

  1427 /**

  1389 /**

  1428  * Display the last name of the author of the current post.

  1390  * Display the last name of the author of the current post.

  1429  *

  1391  *

  1430  * @since 0.71

  1392  * @since 0.71

  1433  * @see the_author_meta()

  1394  * @see the_author_meta()

  1434  */

  1395  */

  1435 function the_author_lastname() {

  1396 function the_author_lastname() {

  1437 	the_author_meta('last_name');

  1398 	the_author_meta('last_name');

  1438 }

  1399 }

  1439 

  1400 

  1440 /**

  1401 /**

  1441  * Retrieve the nickname of the author of the current post.

  1402  * Retrieve the nickname of the author of the current post.

  1442  *

  1403  *

  1443  * @since 1.5.0

  1404  * @since 1.5.0

  1446  * @see get_the_author_meta()

  1406  * @see get_the_author_meta()

  1447  *

  1407  *

  1448  * @return string The author's nickname.

  1408  * @return string The author's nickname.

  1449  */

  1409  */

  1450 function get_the_author_nickname() {

  1410 function get_the_author_nickname() {

  1452 	return get_the_author_meta('nickname');

  1412 	return get_the_author_meta('nickname');

  1453 }

  1413 }

  1454 

  1414 

  1455 /**

  1415 /**

  1456  * Display the nickname of the author of the current post.

  1416  * Display the nickname of the author of the current post.

  1457  *

  1417  *

  1458  * @since 0.71

  1418  * @since 0.71

  1461  * @see the_author_meta()

  1420  * @see the_author_meta()

  1462  */

  1421  */

  1463 function the_author_nickname() {

  1422 function the_author_nickname() {

  1465 	the_author_meta('nickname');

  1424 	the_author_meta('nickname');

  1466 }

  1425 }

  1467 

  1426 

  1468 /**

  1427 /**

  1469  * Retrieve the email of the author of the current post.

  1428  * Retrieve the email of the author of the current post.

  1470  *

  1429  *

  1471  * @since 1.5.0

  1430  * @since 1.5.0

  1474  * @see get_the_author_meta()

  1432  * @see get_the_author_meta()

  1475  *

  1433  *

  1476  * @return string The author's username.

  1434  * @return string The author's username.

  1477  */

  1435  */

  1478 function get_the_author_email() {

  1436 function get_the_author_email() {

  1480 	return get_the_author_meta('email');

  1438 	return get_the_author_meta('email');

  1481 }

  1439 }

  1482 

  1440 

  1483 /**

  1441 /**

  1484  * Display the email of the author of the current post.

  1442  * Display the email of the author of the current post.

  1485  *

  1443  *

  1486  * @since 0.71

  1444  * @since 0.71