Pentru a lista autorii din blog se folosește funcția wp_list_authors ( $ args ). Acestă funcție returnează o listă simplă cu toți autorii din blog. Se mai poate folosi și funcția list_authors ( $args ) însă acesta este depreciată și e posibil ca în versiunile ulterioare să nu mai poată fi folosită.

<?php wp_list_authors( $args ); ?>

Argumentele sunt:

<?php 
$args = array( 'orderby' => 'name',
'order'         => 'ASC',
'number'        => null,
'optioncount'   => false,
'exclude_admin' => true,
'show_fullname' => false,
'hide_empty'    => true,
'echo'          => true,
'feed'          => [empty string],
'feed_image'    => [empty string],
'feed_type'     => [empty string],
'style'         => list,
'html'          => true );
?>

Exemple de liste de autori

1. listă ordonată de autori, fără adminstratori, ordonați după nume, crescător, autorii trebuie să aibă minim un articol publicat, se va afișa numărul de articole publicate:

<?php 
$args = array( 'orderby' => 'name',
    'order'         => 'ASC',
    'optioncount'   => true,
    'exclude_admin' => true,
    'hide_empty'    => true,
    'style'         => list
);

echo "<ol>";
    wp_list_authors( $args );
echo "</ol>";
?>

Exemplul de mai sus se poate scrie și în felul următor:


<?php wp_list_authors('orderby=name&order=DES&optioncount=1&exclude_admin=1&hide_empty=1'); ?>

Rezultatul va arăta ca mai jos:

  1. Autor Doi (5)
  2. Autor Trei (2)
  3. Autor Unu (13)

Ordonarea este în ordina alfabetică. Dacă ca argument folosim orderby=post_count&order=DESC lista va arată altfel:

  1. Autor Unu (13)
  2. Autor Doi (5)
  3. Autor Trei (2)

2. listă de autori cu RSS

Folosind tot lista de mai sus adaug text cu link către RSS-ul de autor:

<?php 
$args = array( 'orderby' => 'name',
    'order'         => 'ASC',
    'optioncount'   => true,
    'exclude_admin' => true,
    'hide_empty'    => true,
    'style'         => list,
    'feed' => 'RSS',
    'feed_type' => 'rss'
);

echo "<ul>";
    wp_list_authors( $args );
echo "</ul>";
?>

Am adăugat:

feed – textul ce va fi afișat
feed_type – poate fi rss, rss2, atom și rdf

Rezultatul va fi ca mai jos:

Folosind argumentul feed_image se poate adăuga și imagine. Trebuie să conțină calea către imagine. Va suprascrie argumentul feed.

<?php 
$args = array( 'orderby' => 'name',
    'order'         => 'ASC',
    'optioncount'   => true,
    'exclude_admin' => true,
    'hide_empty'    => true,
    'style'         => list,
    'feed' => 'RSS',
    'feed_image' => 'images/rss.png',
    'feed_type' => 'rss'
);

echo "<ul>";
    wp_list_authors( $args );
echo "</ul>";
?>

Această funcție este destul de flexibilă, însă are dezavantajul că nu permite o formatare avansată. Dacă nu vă mulțumește puteți alege din multele pluginuri existente sau puteți crea o metodă în funcțions.php care să vă returneze lista formatată după dorințe.

În „Cum poți lista toți autorii din blog – partea 2” este prezentat modul prin care se poate crea o listă de autori personalizată.