2004-01-27 09:58:01 +00:00
< ? php
2005-06-12 23:22:06 +00:00
2007-06-02 03:04:01 +00:00
/**
* Get the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ param string $deprecated Deprecated .
* @ return string The author ' s display name .
*/
2006-08-31 05:07:12 +00:00
function get_the_author ( $deprecated = '' ) {
2005-10-12 17:01:50 +00:00
global $authordata ;
2006-08-31 05:07:12 +00:00
return apply_filters ( 'the_author' , $authordata -> display_name );
2004-01-27 09:58:01 +00:00
}
2005-06-12 23:22:06 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the name of the author of the current post in the Loop .
* @ see get_the_author ()
* @ param string $deprecated Deprecated .
* @ param string $deprecated_echo Echo the string or return it . Deprecated , use get_the_author () .
* @ return string The author ' s display name , from get_the_author () .
*/
2006-08-31 05:07:12 +00:00
function the_author ( $deprecated = '' , $deprecated_echo = true ) {
if ( $deprecated_echo )
echo get_the_author ();
return get_the_author ();
2004-12-15 23:15:17 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the description of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s description .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_description () {
2005-10-12 17:01:50 +00:00
global $authordata ;
2005-11-23 18:01:32 +00:00
return $authordata -> description ;
2004-12-15 23:15:17 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Echo the description of the author of the current post in the Loop .
* @ see get_the_author_description ()
* @ return null
*/
2004-12-15 23:15:17 +00:00
function the_author_description () {
2005-10-12 17:01:50 +00:00
echo get_the_author_description ();
2004-12-15 23:15:17 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the login name of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s login name ( username ) .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_login () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return $authordata -> user_login ;
2004-01-27 09:58:01 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the login name of the author of the current post in the Loop .
* @ see get_the_author_login ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_login () {
2005-10-12 17:01:50 +00:00
echo get_the_author_login ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the first name of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s first name .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_firstname () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return $authordata -> first_name ;
2004-12-15 23:15:17 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Echo the first name of the author of the current post in the Loop .
* @ see get_the_author_firstname ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_firstname () {
2005-10-12 17:01:50 +00:00
echo get_the_author_firstname ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the last name of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s last name .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_lastname () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return $authordata -> last_name ;
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the last name of the author of the current post in the Loop .
* @ see get_the_author_lastname ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_lastname () {
2005-10-12 17:01:50 +00:00
echo get_the_author_lastname ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the nickname of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s nickname .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_nickname () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return $authordata -> nickname ;
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the nickname of the author of the current post in the Loop .
* @ see get_the_author_nickname ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_nickname () {
2005-10-12 17:01:50 +00:00
echo get_the_author_nickname ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the ID of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return int The author ' s ID .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_ID () {
2005-10-12 17:01:50 +00:00
global $authordata ;
2007-06-02 03:04:01 +00:00
return ( int ) $authordata -> ID ;
2004-12-15 23:15:17 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Echo the ID of the author of the current post in the Loop .
* @ see get_the_author_ID ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_ID () {
2005-10-12 17:01:50 +00:00
echo get_the_author_id ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the email of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s username .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_email () {
2004-12-23 21:52:09 +00:00
global $authordata ;
return $authordata -> user_email ;
2004-12-15 23:15:17 +00:00
}
2004-12-23 21:52:09 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the email of the author of the current post in the Loop .
* @ see get_the_author_email ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_email () {
2004-12-23 21:52:09 +00:00
echo apply_filters ( 'the_author_email' , get_the_author_email () );
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the URL to the home page of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The URL to the author ' s page .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_url () {
2005-10-12 17:01:50 +00:00
global $authordata ;
2007-06-13 18:03:17 +00:00
if ( 'http://' == $authordata > user_url )
return '' ;
2005-10-12 17:01:50 +00:00
return $authordata -> user_url ;
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the URL to the home page of the author of the current post in the Loop .
* @ see get_the_author_url ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_url () {
2005-10-12 17:01:50 +00:00
echo get_the_author_url ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* If the author has a home page set , echo an HTML link , otherwise just echo the author ' s name .
* @ see get_the_author_url ()
* @ see the_author ()
* @ return null
*/
2006-08-30 18:07:49 +00:00
function the_author_link () {
if ( get_the_author_url ()) {
echo '<a href="' . get_the_author_url () . '" title="' . sprintf ( __ ( " Visit %s's website " ), get_the_author ()) . '" rel="external">' . get_the_author () . '</a>' ;
} else {
the_author ();
}
}
2007-06-02 03:04:01 +00:00
/**
* Get the ICQ number of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s ICQ number .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_icq () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return $authordata -> icq ;
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the ICQ number of the author of the current post in the Loop .
* @ see get_the_author_icq ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_icq () {
2005-10-12 17:01:50 +00:00
echo get_the_author_icq ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the AIM name of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s AIM name .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_aim () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return str_replace ( ' ' , '+' , $authordata -> aim );
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the AIM name of the author of the current post in the Loop .
* @ see get_the_author_aim ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_aim () {
2005-10-12 17:01:50 +00:00
echo get_the_author_aim ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the Yahoo ! IM name of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s Yahoo ! IM name .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_yim () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return $authordata -> yim ;
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the Yahoo ! IM name of the author of the current post in the Loop .
* @ see get_the_author_yim ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_yim () {
2005-10-12 17:01:50 +00:00
echo get_the_author_yim ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the MSN address of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ return string The author ' s MSN address .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_msn () {
2005-10-12 17:01:50 +00:00
global $authordata ;
return $authordata -> msn ;
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the MSN address of the author of the current post in the Loop .
* @ see get_the_author_msn ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_msn () {
2005-10-12 17:01:50 +00:00
echo get_the_author_msn ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the number of posts by the author of the current post in the Loop .
* @ global object $post The current post in the Loop ' s DB object .
* @ see get_usernumposts ()
* @ return int The number of posts by the author .
*/
2004-12-15 23:15:17 +00:00
function get_the_author_posts () {
2005-10-12 17:01:50 +00:00
global $post ;
2007-06-02 03:04:01 +00:00
return get_usernumposts ( $post -> post_author );
2004-12-15 23:15:17 +00:00
}
2005-10-12 17:01:50 +00:00
2007-06-02 03:04:01 +00:00
/**
* Echo the number of posts by the author of the current post in the Loop .
* @ see get_the_author_posts ()
* @ return null
*/
2004-01-27 09:58:01 +00:00
function the_author_posts () {
2005-10-12 17:01:50 +00:00
echo get_the_author_posts ();
2004-01-27 09:58:01 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Echo an HTML link to the author page of the author of the current post in the Loop .
* @ global object $authordata The current author ' s DB object .
* @ see get_author_posts_url ()
* @ see get_the_author ()
* @ return null
*/
2006-08-30 18:07:49 +00:00
/* the_author_posts_link() requires no get_, use get_author_posts_url() */
2006-08-31 05:07:12 +00:00
function the_author_posts_link ( $deprecated = '' ) {
2005-10-12 17:01:50 +00:00
global $authordata ;
2007-06-02 03:04:01 +00:00
printf (
'<a href="%1$s" title="%2$s">%3$s</a>' ,
get_author_posts_url ( $authordata -> ID , $authordata -> user_nicename ),
sprintf ( __ ( 'Posts by %s' ), attribute_escape ( get_the_author () ) ),
get_the_author ()
);
}
/**
* Get the URL to the author page of the author of the current post in the Loop .
* @ global object $wpdb WordPress database layer .
* @ global object $wp_rewrite WP_Rewrite
* @ global object $post The current post in the Loop ' s DB object .
* @ return string The URL to the author ' s page .
*/
2006-08-30 18:07:49 +00:00
function get_author_posts_url ( $author_id , $author_nicename = '' ) {
2007-06-02 03:04:01 +00:00
global $wpdb , $wp_rewrite , $post ;
2007-03-23 00:59:21 +00:00
$auth_ID = ( int ) $author_id ;
2005-10-12 17:01:50 +00:00
$link = $wp_rewrite -> get_author_permastruct ();
if ( empty ( $link ) ) {
2006-08-30 21:46:31 +00:00
$file = get_option ( 'home' ) . '/' ;
2005-10-12 17:01:50 +00:00
$link = $file . '?author=' . $auth_ID ;
} else {
2006-07-27 23:27:27 +00:00
if ( '' == $author_nicename ) {
$user = get_userdata ( $author_id );
if ( ! empty ( $user -> user_nicename ) )
$author_nicename = $user -> user_nicename ;
}
2005-10-12 17:01:50 +00:00
$link = str_replace ( '%author%' , $author_nicename , $link );
2006-08-30 21:46:31 +00:00
$link = get_option ( 'home' ) . trailingslashit ( $link );
2005-10-12 17:01:50 +00:00
}
$link = apply_filters ( 'author_link' , $link , $author_id , $author_nicename );
return $link ;
2004-03-19 16:20:49 +00:00
}
2007-06-02 03:04:01 +00:00
/**
* Get the specified author ' s preferred display name .
* @ param int $auth_id The ID of the author .
* @ return string The author ' s display name .
*/
2006-06-07 23:17:59 +00:00
function get_author_name ( $auth_id ) {
$authordata = get_userdata ( $auth_id );
return $authordata -> display_name ;
}
2007-06-02 03:04:01 +00:00
/**
* List all the authors of the blog , with several options available .
* optioncount ( boolean ) ( false ) : Show the count in parenthesis next to the author ' s name .
* exclude_admin ( boolean ) ( true ) : Exclude the 'admin' user that is installed by default .
* show_fullname ( boolean ) ( false ) : Show their full names .
* hide_empty ( boolean ) ( true ) : Don ' t show authors without any posts .
* feed ( string ) ( '' ) : If isn 't empty, show links to author' s feeds .
* feed_image ( string ) ( '' ) : If isn ' t empty , use this image to link to feeds .
* echo ( boolean ) ( true ) : Set to false to return the output , instead of echoing .
* @ param array $args The argument array .
* @ return null | string The output , if echo is set to false .
*/
2004-03-19 16:20:49 +00:00
function wp_list_authors ( $args = '' ) {
2007-03-29 01:39:05 +00:00
global $wpdb ;
2007-05-11 03:10:05 +00:00
$defaults = array (
'optioncount' => false , 'exclude_admin' => true ,
'show_fullname' => false , 'hide_empty' => true ,
2007-06-01 05:43:24 +00:00
'feed' => '' , 'feed_image' => '' , 'echo' => true
2007-05-11 03:10:05 +00:00
);
2007-06-01 05:43:24 +00:00
2007-05-11 03:10:05 +00:00
$r = wp_parse_args ( $args , $defaults );
2006-06-06 04:50:41 +00:00
extract ( $r );
2007-06-01 05:43:24 +00:00
$return = '' ;
2006-06-06 04:50:41 +00:00
// TODO: Move select to get_authors().
2007-03-29 01:39:05 +00:00
$authors = $wpdb -> get_results ( " SELECT ID, user_nicename from $wpdb->users " . ( $exclude_admin ? " WHERE user_login <> 'admin' " : '' ) . " ORDER BY display_name " );
2007-06-01 05:43:24 +00:00
2007-03-29 01:39:05 +00:00
$author_count = array ();
foreach (( array ) $wpdb -> get_results ( " SELECT DISTINCT post_author, COUNT(ID) AS count FROM $wpdb->posts WHERE post_status = 'publish' GROUP BY post_author " ) as $row ) {
$author_count [ $row -> post_author ] = $row -> count ;
}
2004-03-19 16:20:49 +00:00
2006-11-19 08:06:03 +00:00
foreach ( ( array ) $authors as $author ) {
2005-06-12 23:14:52 +00:00
$author = get_userdata ( $author -> ID );
2007-03-29 01:39:05 +00:00
$posts = ( isset ( $author_count [ $author -> ID ])) ? $author_count [ $author -> ID ] : 0 ;
2005-10-12 17:01:50 +00:00
$name = $author -> nickname ;
if ( $show_fullname && ( $author -> first_name != '' && $author -> last_name != '' ) )
$name = " $author->first_name $author->last_name " ;
if ( ! ( $posts == 0 && $hide_empty ) )
2007-06-01 05:43:24 +00:00
$return .= '<li>' ;
2005-10-12 17:01:50 +00:00
if ( $posts == 0 ) {
if ( ! $hide_empty )
2005-01-24 07:55:03 +00:00
$link = $name ;
2005-10-12 17:01:50 +00:00
} else {
2006-12-21 10:10:04 +00:00
$link = '<a href="' . get_author_posts_url ( $author -> ID , $author -> user_nicename ) . '" title="' . sprintf ( __ ( " Posts by %s " ), attribute_escape ( $author -> display_name )) . '">' . $name . '</a>' ;
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
if ( ( ! empty ( $feed_image )) || ( ! empty ( $feed )) ) {
$link .= ' ' ;
if ( empty ( $feed_image ))
$link .= '(' ;
$link .= '<a href="' . get_author_rss_link ( 0 , $author -> ID , $author -> user_nicename ) . '"' ;
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
if ( ! empty ( $feed ) ) {
$title = ' title="' . $feed . '"' ;
$alt = ' alt="' . $feed . '"' ;
$name = $feed ;
$link .= $title ;
}
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
$link .= '>' ;
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
if ( ! empty ( $feed_image ) )
$link .= " <img src= \" $feed_image\ " border = \ " 0 \" $alt $title " . ' />' ;
else
$link .= $name ;
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
$link .= '</a>' ;
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
if ( empty ( $feed_image ) )
$link .= ')' ;
}
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
if ( $optioncount )
$link .= ' (' . $posts . ')' ;
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
}
2004-03-23 04:45:27 +00:00
2005-10-12 17:01:50 +00:00
if ( ! ( $posts == 0 && $hide_empty ) )
2007-06-01 05:43:24 +00:00
$return .= $link . '</li>' ;
2005-10-12 17:01:50 +00:00
}
2007-06-01 05:43:24 +00:00
if ( ! $echo )
return $return ;
echo $return ;
2004-03-19 16:20:49 +00:00
}
2006-08-31 05:07:12 +00:00
?>