Функция the_author_meta() │ WP 2.8.0

Функция the_author_meta() выводит данные из базы данных пользователя. По умолчанию она показывает информацию о текущем авторе поста.

Использует:

Функцию get_the_author_meta(), которая позволяет получать информацию об авторе.

Скорость выполнения:

• 1 раз — 0.000012 сек (очень быстро)
• 50000 раз — 0.03 сек (гиперскорость)

Версия PHP: 7.1.2, WordPress 4.7.3

Хуки функции

• the_author_(field)

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

Функция возвращает null, то есть ничего не выводит, если не указано иное.

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

the_author_meta( $field, $user_id );

• $field (string): поле, которое вы хотите получить из данных пользователя. Смотрите в функции get_the_author_meta() для списка возможных полей.
• $user_id (int|false): ID пользователя. По умолчанию это ID автора текущего поста.

Примеры

Пример 1: Выводим email автора поста

Этот код показывает email автора текущего поста, если функция вызывается в цикле:

Email автора: 

Пример 2: Выводим email автора с ID = 25

Этот код показывает email автора с конкретным ID (в данном случае — 25):

E-mail автора с ID 25: 

Пример 3: Расширенное использование

Некоторые плагины могут добавлять свои собственные поля для данных пользователей. Чтобы отобразить такое поле, нужно указать его имя в первом параметре.

Например, если плагин добавил поле twitter и значение этого поля «wordpress», код будет выглядеть так:

Имя автора в Twitter: 

Вывод будет: Имя автора в Twitter: wordpress

Примечания

• Обратите внимание на функцию get_the_author_meta() для получения дополнительной информации.

Изменения

Функция была введена в версии WordPress 2.8.0.

Код функции

Вот как выглядит реализация функции the_author_meta() в файле wp-includes/author-template.php:

function the_author_meta( $field = '', $user_id = false ) {
    $author_meta = get_the_author_meta( $field, $user_id );

    /**
     * Фильтрует значение запрашиваемых метаданных пользователя.
     *
     * Имя фильтра зависит от параметра $field функции.
     *
     * @since 2.8.0
     *
     * @param string    $author_meta Значение метаданных.
     * @param int|false $user_id     ID пользователя.
     */
    echo apply_filters( "the_author_{$field}", $author_meta, $user_id );
}

Связанные функции

Вот некоторые функции, которые могут быть полезны при работе с метаданными:

• add_comment_meta()
• add_user_meta()
• delete_user_meta()
• get_user_meta()
• update_user_meta()

Полезные функции для работы с авторами

• get_the_author()
• the_author()
• get_author_posts_url()

Теперь у вас есть общее представление о работе функции the_author_meta() в WordPress, а также примеры использования и код функции. Это поможет вам извлекать необходимые данные об авторе из базы данных.