eurobyte.ru - мощные сервера с Дата-центрами в Нидерландах и Москве. От 159 ₽/мес.
Kama и campusboy2.6 лет назад2 EN

get_the_author_meta() │ WP 2.8.0

Возвращает указанные метаданные указанного или текущего пользователя (автора).

Если функция используется внутри цикла, то не обязательно указывать ID пользователя. В этом случае, функция вернет данные автора поста. ID пользователя нужно указывать, если функция используется за пределами цикла.

Чтобы сразу вывести данные на экран используйте аналогичную функцию the_author_meta().

Плагины могут дополнять данные пользователя новыми полями (такие данные добавляются в таблицу wp_usermeta для которых указывается ключ и значение). Чтобы получить такое значение поля, нужно указать его ключ в параметр $field.

Работает на основе: get_userdata()
Основа для: get_the_archive_description(), the_author_meta()
1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.01 сек (скорость света) | PHP 7.3.12, WP 5.3.2
Хуки из функции

Возвращает

Строку. Указанные данные пользователя, если они существуют. Если указанное поле не найдено, то будет возвращена пустая строка.

Использование

get_the_author_meta( $field, $user_id );
$field(строка)

Название поля, данные которого нужно вернуть. Может быть:

ID
user_login          | login
user_pass           | pass
user_nicename       | nicename
user_email          | email
user_url            | url
user_registered     | registered
user_activation_key | activation_key
user_status         | status
user_description    | description (Биографические данные из профиля пользователя)
user_firstname      | first_name
user_lastname       | last_name
user_level          | $wpdb->prefix . 'user_level'
roles
display_name
nickname
rich_editing
comment_shortcuts
admin_color
plugins_per_page
plugins_last_view

По умолчанию: ''

$user_id(число)
ID пользователя. Если указать этот параметр, то функцию будет возвращать данные указанного пользователя (автора). По умолчанию, выводятся данные текущего пользователя (если функция используется внутри цикла WordPress).
По умолчанию: текущий пользователь

Примеры

0

#1 Получим e-mail адрес пользователя

Получим e-mail автора текущего поста и поместим его в переменную $user_email для дальнейшего использования. (помните, эта функция возвращает данные, а не выводит их на экран).

$user_email = get_the_author_meta('user_email');
echo $user_email;

Заметка: если вы выводите данные на отдельной странице, перед вызовом функции get_the_author_meta() должна быть использована функция the_post(). Или вам нужно отдельно указать ID автора поста во втором параметре ($post->post_author).

0

#2 Выведем имя пользователя и ссылку на Email

Получим email адрес пользователя с ID 25 и выведем его "отображаемое имя":

<p>Напишите автору на Email: 
	<a href="mailto:<?php echo get_the_author_meta('user_email', 25); ?>">
		<?php the_author_meta('display_name', 25); ?>
	</a>
</p>

Заметки

  • Global. WP_User. $authordata The current author's data.

Список изменений

С версии 2.8.0 Введена.

Код get_the_author_meta() WP 6.7.1

wp-includes/author-template.php 
function get_the_author_meta( $field = '', $user_id = false ) {
	$original_user_id = $user_id;

	if ( ! $user_id ) {
		global $authordata;
		$user_id = isset( $authordata->ID ) ? $authordata->ID : 0;
	} else {
		$authordata = get_userdata( $user_id );
	}

	if ( in_array( $field, array( 'login', 'pass', 'nicename', 'email', 'url', 'registered', 'activation_key', 'status' ), true ) ) {
		$field = 'user_' . $field;
	}

	$value = isset( $authordata->$field ) ? $authordata->$field : '';

	/**
	 * Filters the value of the requested user metadata.
	 *
	 * The filter name is dynamic and depends on the $field parameter of the function.
	 *
	 * @since 2.8.0
	 * @since 4.3.0 The `$original_user_id` parameter was added.
	 *
	 * @param string    $value            The value of the metadata.
	 * @param int       $user_id          The user ID for the value.
	 * @param int|false $original_user_id The original user ID, as passed to the function.
	 */
	return apply_filters( "get_the_author_{$field}", $value, $user_id, $original_user_id );
}

metadata (метаданные)

2 комментария
    Войти