Как вывести список пользователей WordPress с помощью wp_list_users()

Функция wp_list_users() – это мощный инструмент, позволяющий легко и гибко выводить список пользователей вашего сайта WordPress. Она может быть использована как для простого отображения списка имен, так и для более сложных задач, например, для создания таблицы пользователей с дополнительными полями.

В этой статье я расскажу вам о том, как использовать функцию wp_list_users(), и покажу вам некоторые из ее параметров.

1. Шаблон использования:

PHP

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. Примеры использования:

  • Вывод списка всех пользователей:

PHP

wp_list_users();

  • Вывод списка пользователей в виде таблицы:

PHP

wp_list_users( array(
    'style' => 'table',
    'columns' => array(
        'username',
        'email',
        'registered',
    ),
) );

  • Вывод списка пользователей с ссылками на их профили:

PHP

wp_list_users( array(
    'show_fullname' => true,
    'link_to_profile' => true,
) );

4. Подводя итоги:

Функция wp_list_users() – это универсальный инструмент, который позволяет выводить список пользователей WordPress на ваш сайт различными способами. Используйте параметры функции, чтобы настроить отображение списка в соответствии с вашими потребностями.

Надеюсь, эта статья была вам полезна!

Оцените статью