Функция wp_list_users()
– это мощный инструмент, позволяющий легко и гибко выводить список пользователей вашего сайта WordPress. Она может быть использована как для простого отображения списка имен, так и для более сложных задач, например, для создания таблицы пользователей с дополнительными полями.
В этой статье я расскажу вам о том, как использовать функцию wp_list_users()
, и покажу вам некоторые из ее параметров.
1. Шаблон использования:
wp_list_users( $args );
2. Параметры:
orderby
: Как сортировать пользователей. Возможные значения:nicename
,email
,url
,registered
,user_nicename
,user_email
,user_url
,user_registered
,name
,display_name
,post_count
,ID
,meta_value
,user_login
. По умолчанию:name
.order
: Направление сортировки дляorderby
. Возможные значения:ASC
,DESC
. По умолчанию:ASC
.number
: Максимальное количество пользователей. По умолчанию: 0 (все пользователи).exclude_admin
: Исключить ли администраторов. По умолчанию:false
.show_fullname
: Показывать ли полное имя пользователя. По умолчанию:false
.feed
: Если не пусто, показывать ссылку на ленту (фид) пользователя.feed_image
: URL изображения для ссылки на ленту пользователя.feed_type
: Тип ленты пользователя.echo
: Выводить ли список на экран. По умолчанию:true
.style
: Стиль списка. Возможные значения:list
,ul
,ol
. По умолчанию:list
.html
: Использовать ли HTML-разметку. По умолчанию:true
.exclude
: Список пользователей, которых нужно исключить.include
: Список пользователей, которых нужно включить.
3. Примеры использования:
- Вывод списка всех пользователей:
wp_list_users();
- Вывод списка пользователей в виде таблицы:
wp_list_users( array(
'style' => 'table',
'columns' => array(
'username',
'email',
'registered',
),
) );
- Вывод списка пользователей с ссылками на их профили:
wp_list_users( array(
'show_fullname' => true,
'link_to_profile' => true,
) );
4. Подводя итоги:
Функция wp_list_users()
– это универсальный инструмент, который позволяет выводить список пользователей WordPress на ваш сайт различными способами. Используйте параметры функции, чтобы настроить отображение списка в соответствии с вашими потребностями.
Надеюсь, эта статья была вам полезна!