Получение адреса электронной почты автора комментария

Функция get_comment_author_email() позволяет получить адрес электронной почты автора текущего комментария. Это будет полезно, если вам нужно узнать, кто оставил комментарий на вашем сайте WordPress.

Как работает функция

Функция get_comment_author_email() используется внутри функции comment_author_email(), и её можно использовать, чтобы получить email автора текста комментария.

Хуки из функции

Функция имеет фильтр get_comment_author_email, который позволяет изменять возвращаемый адрес электронной почты.

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

Функция возвращает строку — адрес электронной почты автора комментария.

Применение функции

get_comment_author_email( $comment_id );

Параметры

• $comment_id (int | WP_Comment) - ID комментария или объект комментария, для которого нужно получить адрес электронной почты автора. По умолчанию используется текущий комментарий.

Примеры использования

Пример 1: Получение электронной почты автора комментария

Если у вас есть комментарий с ID 2020, вы можете получить адрес электронной почты его автора следующим образом:

echo get_comment_author_email( 2020 ); // Выведет адрес электронной почты

Изменения в версии

• С версии 1.5.0 — функция была добавлена.
• С версии 4.4.0 — добавлена возможность передавать объект WP_Comment в качестве $comment_id.

Код функции

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

function get_comment_author_email( $comment_id = 0 ) {
$comment = get_comment( $comment_id );

/**
 * Фильтрует адрес электронной почты автора комментария.
 *
 * @since 1.5.0
 * @since 4.1.0 Добавлены параметры $comment_id и $comment.
 *
 * @param string     $comment_author_email Адрес электронной почты автора комментария.
 * @param string     $comment_id           ID комментария в виде строкового числа.
 * @param WP_Comment $comment              Объект комментария.
 */
return apply_filters( 'get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment );

}

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

Есть несколько функций, которые могут быть полезны в работе с комментариями:

• cancel_comment_reply_link()
• comment_author_email_link()
• comment_form()
• comment_form_title()
• comment_id_fields()
• comment_text()
• get_comment()
• get_comments()
• wp_insert_comment()
• И многие другие.

Вы можете использовать эти функции для расширения функционала работы с комментариями на вашем сайте WordPress.