Статьи

Руководство по тегам шаблонов: третья партия

Декабрь 11, 2018

В третьей части серии мы рассмотрели вторую серию тегов шаблонов WordPress. В этой четвертой части мы рассмотрим третий пакет из почти 200 шаблонных тегов. На протяжении всего урока мы будем видеть теги шаблонов для комментариев.

Получение и отображение комментария Имя автора: get_comment_author() & comment_author()

Эти теги шаблона возвращают или отображают имя комментатора.

параметры

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

  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display the commenter’s name.
comment_author();
 
// Build an introduction of each comment.
$comment_intro = get_comment_author() .
 
?>

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

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

параметры

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

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

1
2
3
4
5
<?php
 
comment_author_rss();
 
?>

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

Эти теги шаблонов позволяют вам возвращать или отображать адрес электронной почты комментатора. (Предупреждение: нехорошо отображать адреса электронной почты комментаторов в интерфейсе для публики, поэтому убедитесь, что вы используете его правильно.)

параметры

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

  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Get the email address of the commenter.
comment_author_email();
 
// Return the email address of the commenter from a specific comment.
$commenter_email = get_comment_author_email( 57 );
 
?>

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

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

параметры

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

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

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

1
2
3
4
5
6
7
8
9
<?php
 
// Get the email link of the commenter.
comment_author_email_link();
 
// Return the email link of the commenter.
$commenter_email_link = get_comment_author_email_link( ‘<i class=»icon-email»></i>’, __( ‘Comment Author\’s Email Address’, ‘translation-domain’ ), ‘<br />’ );
 
?>

Получение и отображение URL-адреса Commenter: get_comment_author_url() & comment_author_url()

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

параметры

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

  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

01
02
03
04
05
06
07
08
09
10
11
12
<?php
 
// Display the comment author url.
comment_author_url();
 
// Return the comment author url.
$commenter_URL = get_comment_author_url();
 
// Return a link to the comment author’s website from a specific comment.
$commenter_link = ‘<a href=»‘ . get_comment_author_url( 988 ) . ‘»>’ .
 
?>

Получение и отображение ссылки на комментарий (с именем автора в качестве текста get_comment_author_link() ): get_comment_author_link() & comment_author_link()

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

параметры

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

  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display the comment author’s link.
comment_author_link();
 
// Return the comment author’s link from a specific comment.
$commenter_link = get_comment_author_link( 452 );
 
?>

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

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

параметры

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

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

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display a customized «commenter’s website» link.
comment_author_url_link( __( ‘Comment author\’s website’, ‘translation-domain’ ) );
 
// Return a customized «commenter’s website» link with $before and $after.
$comment_author_website = get_comment_author_url_link( __( ‘Comment author\’s website’, ‘translation-domain’ ), ‘<span class=»icon-website»>’, ‘
 
?>

Получение и отображение IP-адреса комментатора: get_comment_author_IP() & comment_author_IP()

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

параметры

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

  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display the comment author’s IP.
comment_author_IP();
 
// Display the comment author’s IP from a specific comment.
$commenter_IP = get_comment_author_IP( 41 );
 
?>

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

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

параметры

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

  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display the current comment’s content.
comment_text();
 
// Get a specific comment’s content.
$comment_content = get_comment_text( 965 );
 
?>

Отображение содержания комментария для каналов: comment_text_rss()

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

параметры

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

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

1
2
3
4
5
<?php
 
comment_text_rss();
 
?>

Получение и отображение get_comment_excerpt() комментария: get_comment_excerpt() & comment_excerpt()

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

параметры

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

  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Echo the current comment’s excerpt.
comment_excerpt();
 
// Return a given comment’s excerpt.
$comment_excerpt = get_comment_excerpt( 355 );
 
?>

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

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

параметры

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

  • $date_format (необязательно — строка) :
    Формат даты.
    (По умолчанию: формат даты установлен на странице общих параметров)
  • $comment_ID (необязательно — целое число) :
    Идентификатор комментария для работы.
    (По умолчанию: идентификатор текущего комментария)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display the current comment’s date.
comment_date();
 
// Get a specific comment’s date with a special date format.
$some_comment_date = get_comment_date( ‘MM/DD/YYYY’, 9812 );
 
?>

Получение и отображение времени комментария: get_comment_time() & comment_time()

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

параметры

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

  • $time_format (необязательно — строка) :
    Формат времени.
    (По умолчанию: формат времени установлен на странице «Общие параметры»)
  • $gmt (необязательно — логическое) :
    Использовать ли дату по Гринвичу.
    По умолчанию: FALSE
  • $translate (необязательно — логическое) :
    date_i18n() ли перейти к функции date_i18n() для перевода даты.
    (По умолчанию: TRUE )

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

  • $time_format (необязательно — строка) :
    Формат времени.
    (По умолчанию: формат времени установлен на странице «Общие параметры»)

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display the current comment’s time.
comment_time();
 
// Get a specific comment’s time with a special time format.
$some_comment_time = get_comment_time( ‘H:i:s’, 115 );
 
?>

Получение и отображение идентификатора комментария: get_comment_ID() & comment_ID()

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

параметры

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

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

1
2
3
4
5
<?php
 
comment_ID();
 
?>

Отображение типа комментария: comment_type()

Этот тег шаблона позволяет отображать тип комментария — обычный комментарий, трекбек или пингбек.

параметры

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

  • $commenttxt (необязательно — строка) :
    Текст для отображения типа «комментарий».
    (По умолчанию: «Комментарий»)
  • $trackbacktxt (необязательно — строка) :
    Текст для отображения типа «trackback».
    (По умолчанию: трекбек)
  • $pingbacktxt (необязательно — строка) :
    Текст для отображения типа «пингбэк».
    По умолчанию: «Pingback»

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

1
2
3
4
5
6
7
8
9
<?php
 
// Display comment type with default texts.
comment_type();
 
// Display comment type with custom texts.
comment_type( __( ‘Reaction’, ‘translation-domain’ ), __( ‘Trackback’, ‘translation-domain’ ), __( ‘Ping’, ‘translation-domain’ ) );
 
?>

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

Этот шаблон тега позволяет получить «аватар» пользователя.

параметры

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

  • $id_or_email (обязательно — строка, целое число или объект) :
    Идентификатор пользователя, адрес электронной почты или объект комментария.
    (По умолчанию: NULL )
  • $size (необязательно — целое число) :
    Размер аватара в пикселях.
    (По умолчанию: 96)
  • $default (необязательно — строка) :
    URL пользовательского «изображения по умолчанию», если аватар недоступен.
    (По умолчанию: пусто)
  • $alt (необязательно — строка) :
    Альтернативный текст (параметр alt ) для изображения.
    По умолчанию: FALSE

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

1
2
3
4
5
6
7
<?php
 
// Returns current comment author’s avatar.
$commenter_email = get_comment_author_email();
$commenter_avatar = get_avatar( $commenter_email, 512 );
 
?>

Вывод

Надеюсь, вам понравилась эта третья партия шаблонов. Осталось еще пять пакетов, так что следите за обновлениями тегов шаблонов!

Если у вас есть какие-либо вопросы, комментарии или исправления, вы можете поделиться с нами своими мыслями в разделе «Комментарии». И если вам понравилась статья, не забудьте поделиться ею с друзьями!

34
Share: