wp_list_authors() WP 3.1
Выводит список авторов блога, как ссылки на их посты, если посты существуют.
Также можно указать вывод ссылки на RSS фид каждого автора и количество записей у каждого автора.
Хуков нет.
Использование
<?php wp_list_authors( $args ); ?>
Параметры по умолчанию
<?php $args = array( 'orderby' => 'name', 'order' => 'ASC', 'number' => null, 'optioncount' => false, 'exclude_admin' => true, 'show_fullname' => false, 'hide_empty' => true, 'echo' => true, 'feed' => '', 'feed_image' => '', 'feed_type' => '', 'style' => list, 'html' => '' ); ?>
- $args(массив)
- Параметры отвечающие за вывод.
По умолчанию: предустановленные
- orderby(строкa)
- Поле по которому будет сортироваться результат. C версии 3.1. Доступные поля:
-name
- сортировать по отображаемому имени (поле display_name в таблице users - по умолчанию).
-email
- по адресу емаил (поле таблицы user_email).
-url
- по адресу URL user_url.
-registered
- по полю user_registered.
-id
- по ID пользователя.
-user_login
- по логину пользователя (поле user_login).
-post_count
- по количеству записей у пользователя.
По умолчанию: 'name' - order(строка)
- В каком порядке сортировать:
ASC
- по порядку,DESC
- в обратном порядке. С версии 3.1.
По умолчанию: 'ASC' - number(число)
- Максимальное количество пользователей которое будет показано (лимит). С версии 3.1.
По умолчанию: без ограничения - optioncount(логический)
- Показывать количество постов каждого пользователя: 1 (true) - показывать, 0 (false) - не показывать.
По умолчанию: false - exclude_admin(логический)
- Исключить из списка регистрационную запись с логином
admin
: 1 (true) - исключить, 0 (false) - не исключать (по умолчанию).
По умолчанию: false - show_fullname(логический)
- Показывать полное имя (имя, фамилию) автора, если стоит
false
, будет показано имя которое выбрано для отображения.
По умолчанию: false - hide_empty(логический)
- Не показывать авторов у которых нет записей: 1 (true) - показывать, 0 (false) - не показывать.
По умолчанию: true - echo(логический)
- Выводить на экран или возвращать для обработки: 1 (true) - выводить, 0 (false) - возвращать.
По умолчанию: true - feed(строка)
- Текст для ссылки на фид каждого автора, если текст не передан ссылка на фид не будет выводиться.
По умолчанию: '' - feed_image(строка)
- Пусть/ссылка на картинку, которая будет показана как ссылка на фид каждого автора. Альтернатива параметру
feed
.
По умолчанию: '' - feed_type(строка)
- Тип фида. Пустая строка - фид установленный на блоге по умолчанию, возможные значения:
rss2, atom, rss, rdf
.
По умолчанию: '' - style(строка)
- В каком формате выводить список. По умолчанию выводится в формате
list
- ul список, если указатьnone
, то авторы будут показаны через запятую. Этот параметр работает, только если включен параметрhtml
.
По умолчанию: 'list' - html(логический)
- Включает или отключает форматирование html. По умолчанию форматирование включено (true), если его выключить (false), то список будет выведен как ссылки на авторов через запятую.
По умолчанию: true
Примеры
#1. Получим список авторов сайта
Список выводит авторов сайта, показывая полное имя (show_fullname=1) и количество записей у каждого автора (optioncount=1). Сортировка происходит в обратном порядке (order=DESC) по количеству записей у каждого автора (orderby=post_count). Вывод ограничен 3-мя авторами (number=3). Так же, по умолчанию из списка исключен автора с ником admin, исключены авторы не имеющие записей и не показываются ссылки на RSS фиды.
<?php wp_list_authors('show_fullname=1&optioncount=1&orderby=post_count&order=DESC&number=3'); ?>
В результате мы получим нечто подобное:
Andrew Anderson (48) Harriett Smith (42) Sally Smith (29)
Заметки
- Global. wpdb. $wpdb WordPress database abstraction object.
Список изменений
С версии 1.2.0 | Введена. |
Код wp_list_authors() wp list authors WP 5.6
Cвязанные функции
Из метки: Список (wp_list списки)
Еще из раздела: Остальное
- auth_redirect()
- count_many_users_posts()
- count_user_posts()
- count_users()
- email_exists()
- get_author_posts_url()
- get_current_user_id()
- get_editable_roles()
- get_the_author()