Вивчаємо теги шаблонів: частина перша
Вивчаємо теги шаблонів: частина друга
Вивчаємо теги шаблонів: частина третя
Вивчаємо теги шаблонів: частина четверта
Вивчаємо теги шаблонів: частина п’ята
Вивчаємо теги шаблонів: частина шоста
У сьогоднішній, четвертої за рахунком статті з цієї серії, ми раді представити вам чергову порцію тегів шаблонів. Сьогодні ми розглянемо теги, пов’язані з коментуванням.
Отримуємо і виводимо ім’я автора коментаря: get_comment_author() і comment_author()
Ці теги повертають або виводять автора коментаря.
Параметри
Обидва тега шаблонів приймають лише один параметр:
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо ім’я автора коментаря для розсилок: get_comment_author_rss() і comment_author_rss()
Ці теги повертають або виводять ім’я автора коментаря, і готують його для використання в RSS-розсилки.
Параметри
Обидва тега шаблонів не приймають параметрів.
Застосування
Отримуємо і виводимо адресу електронної пошти автора коментаря: get_comment_author_email() і comment_author_email()
Ці теги дозволяють повертати або виводити адресу електронної пошти автора коментаря. Увага: відкрито показувати адреси електронної пошти користувачів у себе на сайті небезпечно.
Параметри
Обидва тега шаблонів приймають лише один параметр:
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо посилання на адресу електронної пошти автора коментаря: get_comment_author_email_link() і comment_author_email_link()
Цей теги дозволяють повертати або виводити адресу електронної пошти коментуючого у вигляді посилання «mailto:».
Параметри
Обидва тега шаблонів приймають три параметра:
- $linktext (string, необов’язковий): Текст, який буде показаний замість адреси електронної пошти автора коментаря. За замовчуванням: адреса електронної пошти;
- $before (string, необов’язковий): Текст або HTML-код, який буде показаний перед посиланням. За замовчуванням: »;
- $after (string, необов’язковий): Текст або HTML-код, який буде показаний після посилання. За замовчуванням: ».
Застосування
‘);
?>
Отримуємо і виводимо URL коментатора: get_comment_author_url() і comment_author_url()
Ці теги дозволяють повертати і виводити URL-адресу сайту автора коментаря.
Параметри
Обидва тега шаблонів приймають лише один параметр:
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо URL коментатора (з іменем автора як анкора посилання): get_comment_author_link() і comment_author_link()
Ці теги повертають і виводять посилання на сайт автора коментаря та використовують його ім’я в якості анкора посилання.
Параметри
Обидва тега шаблонів приймають лише один параметр:
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо URL коментатора (з довільним анкорним текстом): get_comment_author_url_link() і comment_author_url_link()
Ці теги повертають і виводять посилання на сайт автора коментаря та використовувати для цього довільний анкорный текст.
Параметри
Обидва тега шаблонів приймають три параметра:
- linktext (string, необов’язковий): Текст для відображення. (За замовчуванням: URL);
- $before (string, необов’язковий): Текст або HTML-код, який буде показаний перед посиланням. За замовчуванням: »;
- $after (опціонально – рядок запиту): Текст або HTML-код, який буде показаний після посилання. За замовчуванням: ».
Застосування
‘, ‘‘ );
?>
Отримуємо і виводимо IP-адреса коментує: get_comment_author_IP() і comment_author_IP()
Ці теги повертають і виводять IP-адресу автора коментаря.
Параметри
Обидва тега шаблонів приймають лише один параметр:
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо текст коментаря: get_comment_text() і comment_text()
Ці теги отримують і виводять текстове вміст коментаря.
Параметри
Обидва тега шаблонів приймають лише один параметр:
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо вміст коментаря для розсилок: comment_text_rss()
Цей тег бере вміст коментаря і готує його для RSS-розсилки.
Параметри
Цей тег шаблону не приймає параметрів.
Застосування
Отримуємо і виводимо цитати з коментаря: get_comment_excerpt() і comment_excerpt()
Ці теги шаблонів беруть вміст коментаря і показують лише його скорочену версію.
Параметри
Обидва тега шаблонів приймають лише один параметр:
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо дату публікації коментарів: get_comment_date() і comment_date()
Ці теги виводять або повертають дату, коли коментар був опублікований.
Параметри
Обидва тега шаблонів приймають два значення:
- $date_format (string, необов’язковий): Формат дати. За замовчуванням: формат дати встановлюється в загальних налаштуваннях WordPress;
- $comment_ID (integer, необов’язковий): ID потрібного коментаря. За замовчуванням: ID поточного коментаря.
Застосування
Отримуємо і виводимо час публікації коментарів: 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.
Застосування
Отримуємо і виводимо ID коментаря: get_comment_ID() і comment_ID()
Ці теги виконують дуже просте завдання: отримують ID коментаря.
Параметри
Ці теги шаблонів не приймають параметрів.
Застосування
Виводимо тип коментаря: comment_type()
Цей тег дозволяє виводити тип коментаря: звичайний коментар, трэкбэк або пінґбек.
Параметри
Цей тег шаблону приймає три параметри:
- $commenttxt (string, необов’язковий): Текст для відображення типу «коментар». За замовчуванням: Коментар;
- $trackbacktxt (string, необов’язковий): Текст для відображення типу «Trackback«. За замовчуванням: ‘Зворотній посилання’;
- $pingbacktxt (string, необов’язковий): Текст для відображення типу «Pingback«.
За замовчуванням: ‘Повідомлення’.
Застосування
Отримуємо аватар користувача: get_avatar()
Цей тег отримує «аватар».
Параметри
Цей тег шаблону приймає чотири параметри:
- $id_or_email (string, integer або object, обов’язковий): ID, адресу електронної пошти або об’єкт, що містить дані коментаря. (За замовчуванням: NULL);
- $size (integer, необов’язковий): Розмір зображення в пікселях. За замовчуванням: 96;
- $default (string, необов’язковий): URL-адресу власного «стандартного зображення», якщо дані про аватарі отримати не вдалося;
- $alt (string, необов’язковий): Текст для атрибута посилання ‘alt‘. За замовчуванням: ».
Застосування
На завершення
Сподіваємося, вам сподобалася третя «порція» тегів шаблонів. Найближчим часом ми опублікуємо інші частини цього циклу.
Якщо у вас виникли питання або зауваження, обов’язково напишіть про це в коментарях. І якщо вам сподобалася наша стаття, не забудьте поділитися нею з друзями!
Переклад статті «The Tuts+ Guide to Template Tags: Third Batch» був підготовлений дружною командою проекту Сайтостроение від А до Я.