Описание функции comment_author_email_link()
Функция comment_author_email_link() генерирует HTML-ссылку на адрес электронной почты автора комментария. Эта ссылка может быть использована в комментариях, чтобы упростить связь с автором. Функция автоматически обрабатывает адрес электронной почты и создает ссылку в формате mailto:
Ссылка отображается в виде имени автора, если оно указано, или в виде адреса электронной почты, если имя отсутствует.
Параметры
Тип: string
Обязательный: Да
Описание: Адрес электронной почты автора комментария
Возможные значения:
string: email@example.com
$name
Тип: string
Обязательный: Нет
Описание: Имя автора комментария
Возможные значения:
string: Имя автора
$id
Тип: string|int
Обязательный: Нет
Описание: ID комментария, используется для создания уникального идентификатора ссылки
Возможные значения:
int: 123
Возвращаемое значение
Тип: string
Описание: HTML-ссылка на адрес электронной почты автора комментария
Возможные значения:
• HTML-код ссылки в формате Имя автора
• Пустая строка, если адрес электронной почты не указан
Примеры использования
Создание ссылки для комментария с именем автора
$link = comment_author_email_link('email@example.com', 'Имя автора');
// Вывод: <a href='mailto:email@example.com'>Имя автора</a>
Ссылка будет отображаться с именем автора
Создание ссылки для комментария без имени автора
$link = comment_author_email_link('email@example.com');
// Вывод: <a href='mailto:email@example.com'>email@example.com</a>
Ссылка будет отображаться с адресом электронной почты
Создание ссылки с указанием ID комментария
$link = comment_author_email_link('email@example.com', 'Имя автора', 123);
// Вывод: <a href='mailto:email@example.com'>Имя автора</a>
ID не влияет на вывод ссылки, но может использоваться для других целей
Безопасность
Валидация входных данных: Функция проверяет, что email является валидным адресом
Санитизация: Санитизация входных данных происходит автоматически
Рекомендации: Используйте esc_html() для вывода имени автора и esc_url() для URL
— Связанные функции
Получает ссылку на имя автора комментария
Получает имя автора комментария
— Примечания
– Ограничения
Не обрабатывает невалидные адреса электронной почты
– Частые проблемы
- Некорректный вывод при отсутствии имени и email
- Ошибки при передаче параметров
