Описание
Поле «Пользователь» позволяет выбрать одного или нескольких пользователей.
Этот тип поля полезен для создания отношений между объектами данных. Он сохраняет свое значение как WP_User ID
и возвращает полные данные о WP_User
.
Скриншоты
Настройки
- Фильтровать по роле. Фильтрует доступных пользователей по одной или нескольким ролям пользователей. По-умолчанию пустая строка.
- Выбрать несколько. Позволяет выбрать несколько значений. По-умолчанию false.
- Разрешить null. Позволяет сохранить пустое значение. По-умолчанию false.
- Возвращаемый формат. Задает формат возвращаемого значения. По-умолчанию Массив пользователя.
Массив пользователя
вернет массив пользовательских данных.Объект пользователя
вернет объект WP_User.ID пользователя
вернет только идентификатор пользователя.
Использование в шаблоне
Вывести значение (выбран 1 пользователь)
В этом примере показано, как отобразить выбранного пользователя ("multiple" = false, return_format = "array"
).
<?php
$user = get_field("user_field");
if( $user ): ?>
<div class="author-box">
<img src="<?php echo esc_attr($user['user_avatar']); ?>" alt="author-avatar" />
<h3><?php echo $user['display_name']; ?></h3>
<?php if( $user['user_description'] ): ?>
<p><?php echo $user['user_description']; ?></p>
<?php endif; ?>
</div>
<?php endif; ?>
Вывести значение (выбрано несколько пользователей)
В этом примере показано, как отобразить несколько выбранных пользователей в виде списка. ("multiple" = true, return_format = "object"
).
<?php
$users = get_field("volunteers");
if( $users ): ?>
<ul class="volunteers-list">
<?php foreach( $users as $user ): ?>
<li>
<img src="<?php echo esc_attr( get_avatar($user->ID) ); ?>" alt="author-avatar" />
<a href="<?php echo esc_attr($user->user_url); ?>"><?php echo $user->display_name; ?></a>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>