Изучаем теги шаблонов: часть третья

Изучаем теги шаблонов: часть первая
Изучаем теги шаблонов: часть вторая
Изучаем теги шаблонов: часть третья
Изучаем теги шаблонов: часть четвертая
Изучаем теги шаблонов: часть пятая
Изучаем теги шаблонов: часть шестая

В сегодняшней, четвертой по счету статье из этой серии, мы рады представить вам очередную порцию тегов шаблонов. Сегодня мы рассмотрим теги, связанные с комментированием.

Получаем и выводим имя автора комментария: get_comment_author() и comment_author()

Эти теги возвращают или выводят автора комментария.

Параметры

Оба тега шаблонов принимают лишь один параметр:

  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Выводим имя комментатора.
comment_author();

// Введение перед каждым комментарием. 
$comment_intro = get_comment_author() . __( ' написал...', 'translation-domain' );

?>

Получаем и выводим имя автора комментария для рассылок: get_comment_author_rss() и comment_author_rss()

Эти теги возвращают или выводят имя автора комментария, и подготавливают его для использования в RSS-рассылках.

Параметры

Оба тега шаблонов не принимают параметров.

Применение

<?php

comment_author_rss();

?>

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

Эти теги позволяют возвращать или выводить адрес электронной почты автора комментария. Внимание: открыто показывать адреса электронной почты пользователей у себя на сайте небезопасно.

Параметры

Оба тега шаблонов принимают лишь один параметр:

  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Получаем email-адрес комментирующего.
comment_author_email();

// Получаем email-адрес комментирующего из определенного комментария. 
$commenter_email = get_comment_author_email( 57 );

?>

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

Этот теги позволяют возвращать или выводить адрес электронной почты комментирующего в виде ссылки “mailto:”.

Параметры

Оба тега шаблонов принимают три параметра:

  • $linktext (string, необязательный): Текст, который будет показан вместо адреса электронной почты автора комментария. По умолчанию: адрес электронной почты;
  • $before (string, необязательный): Текст или HTML-код, который будет показан перед ссылкой. По умолчанию: »;
  • $after (string, необязательный): Текст или HTML-код, который будет показан после ссылки. По умолчанию: ».

Применение

<?php

// Получаем ссылку на email комментирующего.
comment_author_email_link();

// Возвращаем ссылку на email комментирующего.
$commenter_email_link = get_comment_author_email_link( '<i class="icon-email"></i>', __( 'Email комментатора', 'translation-domain' ), '<br />' );

?>

Получаем и выводим URL комментатора: get_comment_author_url() и comment_author_url()

Эти теги позволяют возвращать и выводить URL-адрес сайта автора комментария.

Параметры

Оба тега шаблонов принимают лишь один параметр:

  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Получаем url комментирующего.
comment_author_url();

// Возвращаем url комментирующего.
$commenter_URL = get_comment_author_url();

// Получаем ссылку на сайт комментирующего из определенного комментария. 
$commenter_link = '<a href="' . get_comment_author_url( 988 ) . '">' . __( 'Сайт комментатора', 'translation-domain' ) . '</a>';

?>

Получаем и выводим URL комментатора (с именем автора в качестве анкора ссылки): get_comment_author_link() и comment_author_link()

Эти теги возвращают и выводят ссылку на сайт автора комментария и используют его имя в качестве анкора ссылки.

Параметры

Оба тега шаблонов принимают лишь один параметр:

  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Получаем url комментирующего.
comment_author_link();

// Возвращаем ссылку на сайт комментирующего из определенного комментария.
$commenter_link = get_comment_author_link( 452 );

?>

Получаем и выводим URL комментатора (с произвольным анкорным текстом): get_comment_author_url_link() и comment_author_url_link()

Эти теги возвращают и выводят ссылку на сайт автора комментария и использовать для этого произвольный анкорный текст.

Параметры

Оба тега шаблонов принимают три параметра:

  • linktext (string, необязательный): Текст для отображения. (По умолчанию: URL);
  • $before (string, необязательный): Текст или HTML-код, который будет показан перед ссылкой. По умолчанию: »;
  • $after (опционально – строка запроса): Текст или HTML-код, который будет показан после ссылки. По умолчанию: ».

Применение

<?php

// Выводим оформленную ссылку на сайт комментирующего.
comment_author_url_link( __( 'Сайт комментатора', 'translation-domain' ) );

// Возвращаем оформленную ссылку на сайт комментирующего с использованием $before и $after.
$comment_author_website = get_comment_author_url_link( __( ' Сайт комментатора ', 'translation-domain' ), '<span class="icon-website">', '</span>' );

?>

Получаем и выводим IP-адрес комментирующего: get_comment_author_IP() и comment_author_IP()

Эти теги возвращают и выводят IP-адрес автора комментария.

Параметры

Оба тега шаблонов принимают лишь один параметр:

  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Выводим IP-адрес комментирующего.
comment_author_IP();

// Возвращаем IP-адрес комментирующего из конкретного комментария.
$commenter_IP = get_comment_author_IP( 41 );

?>

Получаем и выводим текст комментария: get_comment_text() и comment_text()

Эти теги получают и выводят текстовое содержимое комментария.

Параметры

Оба тега шаблонов принимают лишь один параметр:

  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Выводим содержимое текущего комментария.
comment_text();

// Получаем содержимое определенного комментария. 
$comment_content = get_comment_text( 965 );

?>

Получаем и выводим содержимое комментария для рассылок: comment_text_rss()

Этот тег берет содержимое комментария и подготавливает его для RSS-рассылки.

Параметры

Этот тег шаблона не принимает параметров.

Применение

<?php

comment_text_rss();

?>

Получаем и выводим цитаты из комментария: get_comment_excerpt() и comment_excerpt()

Эти теги шаблонов берут содержимое комментария и показывают лишь его сокращенную версию.

Параметры

Оба тега шаблонов принимают лишь один параметр:

  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Выводим сокращенную версию комментария.
comment_excerpt();

// Возвращаем сокращенную версию определенного комментария.
$comment_excerpt = get_comment_excerpt( 355 );

?>

Получаем и выводим дату публикации комментария: get_comment_date() и comment_date()

Эти теги выводят или возвращают дату, когда комментарий был опубликован.

Параметры

Оба тега шаблонов принимают два параметра:

  • $date_format (string, необязательный): Формат даты. По умолчанию: формат даты устанавливается в общих настройках WordPress;
  • $comment_ID (integer, необязательный): ID нужного комментария. По умолчанию: ID текущего комментария.

Применение

<?php

// Выводим дату публикации текущего комментария.
comment_date();

// Получаем дату публикации определенного комментария в определенном формате.
$some_comment_date = get_comment_date( 'MM/DD/YYYY', 9812 );

?>

Получаем и выводим время публикации комментария: get_comment_time() и comment_time()

Эти теги получают или выводят время публикации комментария.

Параметры

get_comment_time() принимает три параметра:

  • $time_format (string, необязательный): Формат времени. По умолчанию: формат времени устанавливается в общих настройках WordPress;
  • $gmt (bool, необязательный): Использовать ли GMT. По умолчанию: FALSE;
  • $translate (bool, необязательный): Передавать ли значения в функцию date_i18n() для перевода времени. По умолчанию: TRUE.

comment_time() принимает лишь один параметр:

  • $time_format (string, необязательный): Формат времени. По умолчанию: формат времени устанавливается в общих настройках WordPress.

Применение

<?php

// Выводим время публикации текущего комментария.
comment_time();

// Получаем время публикации комментария в определенном формате.
$some_comment_time = get_comment_time( 'H:i:s', 115 );

?>

Получаем и выводим ID комментария: get_comment_ID() и comment_ID()

Эти теги выполняют очень простую задачу: получают ID комментария.

Параметры

Эти теги шаблонов не принимают параметров.

Применение

<?php

comment_ID();

?>

Выводим тип комментария: comment_type()

Этот тег позволяет выводить тип комментария: обычный комментарий, трэкбэк или пингбэк.

Параметры

Этот тег шаблона принимает три параметра:

  • $commenttxt (string, необязательный): Текст для отображения типа “комментарий”. По умолчанию: Комментарий;
  • $trackbacktxt (string, необязательный): Текст для отображения типа “Trackback”. По умолчанию: ‘Обратная ссылка‘;
  • $pingbacktxt (string, необязательный): Текст для отображения типа “Pingback”.

По умолчанию: ‘Уведомление‘.

Применение

<?php

// Выводим тип комментария со значением по умолчанию. 
comment_type();

// Выводим тип комментария со значениями, заданными пользователями.
comment_type( __( 'Мнение', 'translation-domain' ), __( 'Trackback', 'translation-domain' ), __( 'Ping', 'translation-domain' ) );

?>

Получаем аватар пользователя: get_avatar()

Этот тег получает “аватар” пользователя.

Параметры

Этот тег шаблона принимает четыре параметра:

  • $id_or_email (string, integer или object, обязательный): ID, адрес электронной почты или объект, содержащий данные комментария. (По умолчанию: NULL);
  • $size (integer, необязательный): Размер картинки в пикселях. По умолчанию: 96;
  • $default (string, необязательный): URL-адрес собственного «стандартного изображения», если данные об аватаре получить не удалось;
  • $alt (string, необязательный): Текст для атрибута ссылки ‘alt‘. По умолчанию: ».

Применение

<?php

// Получаем аватар автора текущего комментария.
$commenter_email = get_comment_author_email();
$commenter_avatar = get_avatar( $commenter_email, 512 );

?>

В завершение

Надеемся, вам понравилась третья «порция» тегов шаблонов. В ближайшее время мы опубликуем остальные части этого цикла.

Если у вас возникли какие-либо вопросы или замечания, обязательно напишите об этом в комментариях. И если вам понравилась наша статья, не забудьте поделиться ей с друзьями!

Перевод статьи “The Tuts+ Guide to Template Tags: Third Batch” был подготовлен дружной командой проекта Сайтостроение от А до Я.