Тег шаблона: wp_list_authors
Описание
Этот тег шаблона выводит список авторов блога. Имена авторов являются также ссылкой на их записи (только если у автора есть опубликованные записи). Опционально тег может выводить число записей у авторов и ссылку на их персональную RSS ленту.
Использование
<?php wp_list_authors( $args ); ?>
По умолчанию
<?php $args = array( 'optioncount' => false, 'exclude_admin' => true, 'show_fullname' => false, 'hide_empty' => true, 'echo' => true, 'feed' => [empty string], 'feed_image' => [empty string], 'style' => list, 'html' => [empty string] ); ?>
Функция по умолчанию:
- не выводит число записей у авторов
- исключает из списка администратора блога (только главного с логином "admin")
- выводит имя автора, как указано в его профиле в опции "Отображать как"
- исключает из списка авторов без опубликованных записей
- выводит результаты
- не выводит картинку и ссылку на RSS ленту авторов
- выводит список в list формате (в тегах <li> и </li>)
- выводит элементы списка как HTML
Параметры
optioncount
(boolean) (необязательный) вывод числа записей у авторов.
- 1 (true)
- 0 (false) - по умолчанию
exclude_admin
(boolean) (необязательный) - исключение из списка администратора блога (исключается только администратор с логином "admin").
- 1 (true) - по умолчанию
- 0 (false)
show_fullname
(boolean) (необязательный) - вывод полного имени авторов (имя фамилия).
- 1 (true)
- 0 (false) - по умолчанию
hide_empty
(boolean) (необязательный) - скрытие авторов без опубликованных записей.
- 1 (true) - по умолчанию
- 0 (false)
echo
(boolean) (необязательный) - вывод результатов работы тега.
- 1 (true) - по умолчанию
- 0 (false)
feed
(строка) (необязательный) - текст для ссылки на RSS ленту автора. если текст не указан, то и ссылка не будет выводиться.
feed_image
(строка) (необязательный) - урл картинки для ссылки на RSS ленту автора. при заданном параметре feed_image параметр feed будет игнорироваться.
style
(boolean) (необязательный) - стиль отображения списка авторов блога. на момент публикации этой статьи (версия WordPress 2.9.1) использование значения none у параметра style невозможно, список авторов просто не будет показан вообще.
- list - по умолчанию
- none
html
(boolean) (необязательный) - определение формата выводимого списка. если значение параметра равно true, то список будет выведен в HTML разметке, а если значение будет false, то список будет выведен как чистый текст (авторы будут перечислены через запятую и без ссылок на их записи). если значение параметра html задано как false, то параметр style будет полностью проигнорирован.
- 1 (true) - по умолчанию
- 0 (false)
Примеры
1. Вывод списка авторов с полными именами и числом записей
Данный код выведет список авторов блога с их полными именами (если они заданы, в противном случае будут показаны отображаемые имена) и число записей каждого автора. Также, по умолчанию, не будет выведен как автор администратор блога, не будут выведены авторы без опубликованных записей и не будут показаны ссылки на RSS ленты авторов.
<?php wp_list_authors('show_fullname=1&optioncount=1'); ?>
Примерный вывод данного кода будет таким: Василий Пупкин (45) DedMazai (12) Геннадий Васильев (26)
2. Вывод списка авторов блога с ссылкой на их RSS ленты.
Данный код выведет список авторов блога, включая администратора блога. Будут использованы отображаемые имена, не будет показано число записей у авторов и будут выведены ссылки на RSS ленты авторов с анкором "RSS лента".
<?php wp_list_authors('exclude_admin=0&optioncount=0&feed=RSS лента'); ?>
Примерный вывод данного кода будет таким: admin (RSS лента) Pupkin (RSS лента) DedMazai (RSS лента) Gena (RSS лента)
Лог изменений
Функция добавлена в версии 1.2.0
Параметры style и html были добавлены в версии 2.8
Исходный файл
Функция wp_list_authors() находится в wp-includes/author-template.php
Связанные теги\функции
Теги авторов: the_author, the_author_link, the_author_posts, the_author_posts_link, the_author_meta, wp_list_authors, [[wp_dropdown_users]]
Теги списков: wp_list_authors, wp_list_categories, [[wp_list_pages]], [[wp_list_bookmarks]], [[wp_list_comments]], [[wp_get_archives]], [[wp_page_menu]], [[wp_dropdown_pages]], [[wp_dropdown_categories]], [[wp_dropdown_users]]
#1, 11 апреля, 2010 в 21:50
как добавить к этому всему гаваторы?
#2, 25 мая, 2010 в 18:34
как добавить аватары к этому? и отсортировать список авторов по количеству постов в блоге? помогите пожалуйста :)