Описание функции wp_list_authors()
Функция wp_list_authors() выводит список авторов записей на сайте WordPress. Она позволяет отображать имена авторов с возможностью настройки внешнего вида, включая количество записей, написанных каждым автором, и различные параметры отображения.
Функция часто используется в сайдбаре или на страницах с авторскими записями
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки списка авторов
Возможные значения:
optioncount: 1,
exclude_admin: 1,
style: list, none
echo: 1,
show_fullname: 1,
orderby: post_count, display_name, user_nicename
order: ASC, DESC
Возвращаемое значение
Тип: string
Описание: HTML-код списка авторов
Возможные значения:
• Сгенерированный HTML для списка авторов при echo=true
• Пустая строка если нет авторов
Примеры использования
Выводит список всех авторов на сайте
wp_list_authors();
Список будет выводиться в виде ненумерованного списка
Вывод списка авторов с количеством записей, исключая администратора
$args = array(
'optioncount' => true,
'exclude_admin' => true,
'style' => 'list'
);
wp_list_authors($args);
Список будет в виде ненумерованного списка с количеством записей
Проверка наличия авторов перед выводом списка
if (get_users()) {
wp_list_authors();
} else {
echo 'Нет авторов';
}
Предотвращает вывод пустого списка
Добавление списка авторов в нижний колонтитул сайта
function my_author_list() {
wp_list_authors(array('optioncount' => true));
}
add_action('wp_footer', 'my_author_list');
Список будет выведен в футере
Безопасность
Валидация входных данных: Параметры валидируются внутри функции
Санитизация: Функция автоматически очищает входные параметры
Рекомендации: Используйте esc_html() для вывода имен авторов
— Связанные функции
Получает список пользователей WordPress
Получает информацию о текущем авторе
— Хуки
Фильтрует аргументы перед выводом списка авторов
Фильтрует результаты после получения списка авторов
— Примечания
– Ограничения
Возвращает только публичных авторов по умолчанию
– Частые проблемы
- Пустой результат при отсутствии авторов
- Некорректные параметры могут привести к неожиданному выводу
