# wp_list_users()

URL: https://chugunov.pro/api-wordpress/functions/wp_list_users/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 5.9.0.

## Сигнатура

```php
wp_list_users( string|array $args = array() ): string|null
```

## Описание

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

## Параметры

- `$args` `string|array` — необязательный, по умолчанию `array()`. Массив или строка аргументов по умолчанию.
  
  orderby string Как сортировать пользователей. Принимает 'nicename', 'email', 'url', 'registered', 'user_nicename', 'user_email', 'user_url', 'user_registered', 'name', 'display_name', 'post_count', 'ID', 'meta_value', 'user_login'. Значение по умолчанию 'name'.
  
  order string Направление сортировки для $orderby. Принимает 'ASC', 'DESC'. Значение по умолчанию 'ASC'.
  
  number int Максимальное число пользователей для возврата или отображения. По умолчанию пусто (все пользователи).
  
  exclude_admin bool Исключать ли учётную запись 'admin', если она существует. Значение по умолчанию true.
  
  show_fullname bool Показывать ли полное имя пользователя. Значение по умолчанию false.
  
  feed string Если не пусто, показывать ссылку на ленту пользователя и использовать этот текст в качестве параметра alt ссылки.
  
  feed_image string Если не пусто, показывать ссылку на ленту пользователя и использовать этот URL изображения в качестве кликабельного якоря.
  
  feed_type string Тип ленты, на которую ведёт ссылка, например 'rss2'. По умолчанию используется тип ленты по умолчанию.
  
  echo bool Выводить результат или же возвращать его. Значение по умолчанию true.
  
  style string Если 'list', каждый пользователь оборачивается в элемент
  - , иначе пользователи разделяются запятыми.
  
  html bool Выводить элементы в виде HTML или обычного текста. Значение по умолчанию true.
  
  exclude string Массив либо список идентификаторов пользователей через запятую или пробел для исключения.
  
  include string Массив либо список идентификаторов пользователей через запятую или пробел для включения.

## Возвращаемое значение

`string|null`

## Исходный код

Файл: `wp-includes/user.php:913`

```php
function wp_list_users( $args = array() ) {
	$defaults = array(
		'orderby'       => 'name',
		'order'         => 'ASC',
		'number'        => '',
		'exclude_admin' => true,
		'show_fullname' => false,
		'feed'          => '',
		'feed_image'    => '',
		'feed_type'     => '',
		'echo'          => true,
		'style'         => 'list',
		'html'          => true,
		'exclude'       => '',
		'include'       => '',
	);

	$parsed_args = wp_parse_args( $args, $defaults );

	$return = '';

	$query_args           = wp_array_slice_assoc( $parsed_args, array( 'orderby', 'order', 'number', 'exclude', 'include' ) );
	$query_args['fields'] = 'ids';

	/**
	 * Filters the query arguments for the list of all users of the site.
	 *
	 * @since 6.1.0
	 *
	 * @param array $query_args  The query arguments for get_users().
	 * @param array $parsed_args The arguments passed to wp_list_users() combined with the defaults.
	 */
	$query_args = apply_filters( 'wp_list_users_args', $query_args, $parsed_args );

	$users = get_users( $query_args );

	foreach ( $users as $user_id ) {
		$user = get_userdata( $user_id );

		if ( $parsed_args['exclude_admin'] && 'admin' === $user->display_name ) {
			continue;
		}

		if ( $parsed_args['show_fullname'] && '' !== $user->first_name && '' !== $user->last_name ) {
			$name = sprintf(
				/* translators: 1: User's first name, 2: Last name. */
				_x( '%1$s %2$s', 'Display name based on first name and last name' ),
				$user->first_name,
				$user->last_name
			);
		} else {
			$name = $user->display_name;
		}

		if ( ! $parsed_args['html'] ) {
			$return .= $name . ', ';

			continue; // No need to go further to process HTML.
		}

		if ( 'list' === $parsed_args['style'] ) {
			$return .= '<li>';
		}

		$row = $name;

		if ( ! empty( $parsed_args['feed_image'] ) || ! empty( $parsed_args['feed'] ) ) {
			$row .= ' ';
			if ( empty( $parsed_args['feed_image'] ) ) {
				$row .= '(';
			}

			$row .= '<a href="' . get_author_feed_link( $user->ID, $parsed_args['feed_type'] ) . '"';

			$alt = '';
			if ( ! empty( $parsed_args['feed'] ) ) {
				$alt  = ' alt="' . esc_attr( $parsed_args['feed'] ) . '"';
				$name = $parsed_args['feed'];
			}

			$row .= '>';

			if ( ! empty( $parsed_args['feed_image'] ) ) {
				$row .= '<img src="' . esc_url( $parsed_args['feed_image'] ) . '" style="border: none;"' . $alt . ' />';
			} else {
				$row .= $name;
			}

			$row .= '</a>';

			if ( empty( $parsed_args['feed_image'] ) ) {
				$row .= ')';
			}
		}

		$return .= $row;
		$return .= ( 'list' === $parsed_args['style'] ) ? '</li>' : ', ';
	}

	$return = rtrim( $return, ', ' );

	if ( ! $parsed_args['echo'] ) {
		return $return;
	}
	echo $return;
}
```

## История изменений

- 5.9.0 — Introduced.

## Связанные

Использует: [`wp_array_slice_assoc`](https://chugunov.pro/api-wordpress/functions/wp_array_slice_assoc/), [`get_author_feed_link`](https://chugunov.pro/api-wordpress/functions/get_author_feed_link/), [`get_users`](https://chugunov.pro/api-wordpress/functions/get_users/), [`_x`](https://chugunov.pro/api-wordpress/functions/_x/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`esc_url`](https://chugunov.pro/api-wordpress/functions/esc_url/), [`get_userdata`](https://chugunov.pro/api-wordpress/functions/get_userdata/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_list_users/