[userlist]

(актуально для ver. 13.6.0 и выше)

- выводит зарегистрированных пользователей сайта.

Атрибуты:

inpage - устанавливаем максимальное количество вывода на странице. Подключаем постраничную навигацию (числовые значения)

orderby - порядок сортировки пользователей

Значения:

posts_count - по количеству опубликованных постов

comments_count - по количеству опубликованных комментариев

display_name - по отображаемому имени

user_registered - по времени регистрации на сайте (по-умолчанию)

time_action - по времени активности на сайте

rating_total - по значению рейтинга пользователей

order - направление сортировки

Значения:

ASC - по-возрастанию

DESC - по-убыванию (по-умолчанию)

template - шаблон вывода пользователей

Значения:

rows - списком (по-умолчанию)

cards - карточки пользователей

avatars - только аватары пользователей и рейтинг

mini - только аватары пользователей маленького размера

data - перечень выводимых в списке пользователей данных (вывод данных должен поддерживаться шаблоном вывода). Данные перечисляются через запятую. Чем меньше данных указано для вывода, тем меньше нагрузка на БД при выводе списка пользователей. Если список пользователей выводится с сортировкой соответствующей одному из значений атрибута data, то эти данные получены автоматически, указывать их для вывода не обязательно. Значения могут быть:

posts_count - вывод кол-ва публикаций пользователя

comments_count - кол-во комментариев пользователя

description- текст статуса пользователей

user_registered - дата регистрации пользователя

profile_fields - произвольные поля профиля пользователя, разрешенные к выводу для других пользователей

rating_total - значение рейтинга пользователя

exclude - исключение пользователей из вывода по их идентификатору. (Допускаются множественные числовые значения разделенные запятой)

include - вывод только определенных пользователей по их идентификатору. (Допускаются множественные числовые значения разделенные запятой). Следует знать, что при указании этого атрибута, все другие перестанут работать, кроме exclude

filters - вывод фильтров сортировки списка пользователей. Значения 1 или 0. Если будет указано 1, то кроме фильтров будет выведена также форма поиска. Форма поиска отключается через указание search_form="0"

search_form - вывод формы поиска среди пользователей. Если необходимо отключить, то ставим атрибуту значение '0'

number - предельное количество вывода пользователей. Позволяет ограничить кол-во для вывода независимо от полученного кол-ва этих пользователей.

usergroup - позволяет получать пользователей по содержимому их произвольных полей профиля. Шаблон для применения:

usergroup="meta_key_1:value_1" - будут получены пользователи с произвольным полем профиля meta_key_1 имеющим значение value_1

Можно указывать несколько произвольных полей профиля:

usergroup="meta_key_1:value_1|meta_key_2:value_2..."

Примеры:

[userlist inpage='20' exclude='10,25' orderby='user_registered' order='ASC']

[userlist number='10' orderby='rating_total' template='rows' filters='1' search_form='0' data='posts_count,comments_count' order='DESC']

usergroup="wp_capabilities:administrator"

Также можно вывести пользователей с определенной ролью, указав атрибут usergroup, например, чтобы вывести пользователей с ролью administrator указываем в шорткоде:

[userlist usergroup="wp_capabilities:administrator"]