Codex

Template Tags/list authors


This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists.


Contents

Description

Displays a list of the authors on a blog, and if desired, other information such as a link to each author's RSS feed.

Replace With

wp_list_authors().

Usage

 <?php list_authors(optioncountexclude_admin
                   
show_fullnamehide_empty
                   
'feed''feed_image'); ?> 

Examples

Default Usage

Display the list of authors using default settings.

<?php list_authors(); ?>


Authors with Number of Posts

This example causes the site's authors to display with the number of posts written by each author, excludes the admin author, and displays each author's full name (first and last name).

<?php list_authors(TRUE, TRUE, TRUE); ?>
Harriett Smith (42)

Sally Smith (29)

Andrew Anderson (48)

Full Name and Authors With No Posts Usage

Displays the site's authors without displaying the number of posts, does not exclude the admin, shows the full name of the authors, and does not hide authors with no posts. It does not display the RSS feed or image.

<?php list_authors(FALSE, FALSE, TRUE, FALSE); ?>

Parameters

optioncount 
(boolean) Display number of posts by each author. Options are:
  • TRUE
  • FALSE (Default)
exclude_admin 
(boolean) Exclude the administrator account from authors list. Options are:
  • TRUE (Default)
  • FALSE
show_fullname 
(boolean) Display the full (first and last) name of the authors. Options are:
  • TRUE
  • FALSE (Default)
hide_empty 
(boolean) Do not display authors with 0 posts. Options are:
  • TRUE (Default)
  • FALSE
feed 
(string) Text to display for a link to each author's RSS feed. Default is no text, and no feed displayed.
feed_image 
(string) Path/filename for a graphic. This acts as a link to each author's RSS feed, and overrides the feed parameter.

Related

To use the query string to pass parameters to generate a list of authors, see Template_Tags/wp_list_authors


the_author, the_author_description, the_author_login, the_author_firstname, the_author_lastname, the_author_nickname, the_author_ID, the_author_email, the_author_url, the_author_link, the_author_icq, the_author_aim, the_author_yim, the_author_msn, the_author_posts, the_author_posts_link, list_authors, wp_list_authors

How to pass parameters to tags with PHP function-style parameters

Go to Template Tag index