Теги для работы с комментариями WordPress
Доброго времени суток. Мы продолжаем изучать теги для шаблонов WordPress. Так в прошлой статье мы рассмотрели теги для работы с категориями в WordPress. А сегодня мы остановимся на тегах для работы с комментариями. Ведь какой ресурс без комментариев! Вот, правильно, комментарии нужны, комментарии важны. Поэтому мы уделим им особое внимание.
Да, комментарии необходимы. Поэтому и WordPress существует множество тегов для работы с комментариями.
Теги для работы с комментариями:
- cancel_comment_reply_link
- comment_author
- comment_author_email
- comment_author_email_link
- comment_author_IP
- comment_author_link
- comment_author_rss
- comment_author_url
- comment_author_url_link
- comment_class
- comment_date
- comment_excerpt
- comment_form_title
- comment_form
- comment_ID
- comment_id_fields
- comment_reply_link
- comment_text
- comment_text_rss
- comment_time
- comment_type
- comments_link
- comments_number
- comments_popup_link
- comments_popup_script
- get_avatar
- next_comments_link
- paginate_comments_links
- permalink_comments_rss
- previous_comments_link
- wp_list_comments
cancel_comment_reply_link()
Показывает ссылку, которая отменяет ответ на предыдущий комментарий. Принимает следующий параметр $text — текст ссылки.
comment_author()
Отображает имя автора комментатора. Получает следующий параметр $comment_ID — ID комментария. Если необходимо не отобразить имя комментатора, а вернуть для дальнейшей обработки, то необходимо использовать функцию get_comment_author()
comment_author_email()
Отображает e-mail комментатора. Принимает следующий параметр $comment_ID — ID комментария. Если необходимо не отобразить, а вернуть e-mail комментатора для дальнейшей обработки, то следует использовать следующую функцию get_comment_author_email()
comment_author_email_link()
Отображает e-mail комментатора, как почтовую ссылку. Эта функция должна находиться внутри механизма The Loop. Если Вам необходимо не отобразить e-mail автора комментария, а вернуть для дальнейшей обработки, то следует воспользоваться функцией get_comment_author_email_link.В качестве параметра принимает $linktext, $before, $after, где:
- $linktext — текст ссылки
- $before — текст перед ссылкой
- $after — текст после ссылки
<?php comment_author_email_link('Email автора комментраия', '< ', ' > '); ?>
comment_author_IP()
Показывает IP адресс комментатора. Данная функция должна использоваться внутри механизма The Loop. Если Вам необходимо не отобразить, а вернуть IP адрес комментатора, то необходимо воспользоваться функцией get_comment_author_IP. Данная функция принимает следующий параметр $comment_ID — ID комментария.
comment_author_link()
Отображает имя комментатора и связывает его ссылкой на ресурс комментатора. Если необходимо не отобразить, а вернуть данное значение, то необходимо воспользоваться функцией get_comment_author_link. Данная функция принимает следующее значение $comment_ID — ID комментария.
comment_author_rss()
Отображает автора текущего комментария в потоке. Для того, чтобы не отобразить, а вернуть данное значение необходимо воспользоваться функцией get_comment_author_rss().
comment_author_url()
Отображает URL сайта автора комментария (не ссылка). Если необходимо вернуть данное значение, то следует использовать следующую функцию get_comment_author_url. В качестве параметра принимает $comment_ID — ID комментария.
comment_author_url_link()
Отображает ссылку на сайт автора комментария. Данная функция должна использоваться в механизме The Loop. Для возвращения результата используется функция get_comment_author_url_link. Принимает следующие параметры $linktext, $before, $after, где:
- $linktext — текст ссылки
- $before — текст перед ссылкой
- $after — текст после ссылки
comment_class()
Используется для контроля за class (в CSS).
comment_date()
Отображает дату публикации комментария. Если необходимо вернуть дату публикации комментария для дальнейшей обработки, то необходимо использовать функцию get_comment_date. Принимает следующие параметры $d, $comment_ID, где:
- $d — формат даты, используется формат PHP
- $comment_ID — ID комментария
comment_excerpt()
Отображает выдержку текста комментария (не больше 20 слов). Для того, чтобы вернуть значение используйте get_comment_excerpt. Принимает следующий параметр $comment_ID — ID комментария.
comment_form_title()
Отображает текст, основываясь на комментарии — ответы. Принимает следующие значения $noreplytext, $replytext, $linktoparent, где
- $noreplytext — текст, когда нет комментариев-ответов
- $replytext — текст, когда есть комментарии-ответы
- $linktoparent — имя автора связывается ссылкой на комментарий(true)
comment_form()
Отображает форму для отправки комментариев
comment_ID()
Отображает ID текущего комментария. Используется в механизме The Loop. Для возвращения результата используйте функцию get_comment_ID.
comment_id_fields()
Создает два скрытых поля comment_post_ID и comment_parent. Данная функция должна находиться в теге <form> для редактирования/создания комментария
comment_reply_link()
Отображает ссылку на добавление ответа к текущему комментарию. Принимает следующие параметры: $args, $comment, $post, где:
- $args -массив значений: add_below, respond_id, reply_text, login_text, depth, before, after.
- $comment — ID комментария, на который дается ответ
- $post — ID поста на который дан комментарий
comment_text()
Отображает текст комментария. Для возвращения текста комментария для дальнейшей обработки используйте функцию get_comment_text. Принимате параметр $comment_ID — ID комментария.
comment_text_rss()
Отображает текст текущего комментария в потоке.
comment_time()
Отображает время публикации комментария. Для возвращения времени публикации используйте функцию
get_comment_time. Принимает параметр $d — формат времени(используется формат PHP)
comment_type()
Отображает тип комменария (обычный, Trackback и Pingback) Должна использоваться в механизме The Loop. Для возвращения результата используется get_comment_type. Принимает следующие параметры ‘comment’, ‘trackback’, ‘pingback’, где
- ‘comment’ — текст для описания обычного комментария
- ‘trackback’ — текст для описания trackback
- ‘pingback’ — текст для описания ‘pingback’
comments_link()
Отображает ссылку на комментарии текущего поста. Для возвращения результата используется get_comments_link. Функция должна использоваться внутри механизма The Loop.
comments_number()
Отображает общее количество комментариев к текущему сообщению. Должен использоваться внутри механизма The Loop. Для возвращения результата — get_comments_number()
comments_popup_link()
Отображает ссылку на всплывающее окно комментариев, если используется comments_popup_script (). Должна использоваться внутри механизма The Loop.
Принимает следующие параметры: $zero, $one, $more, $css_class, $none, где:
- $zero — текст, когда нет комментариев
- $one — текст, когда один комментарий
- $more — текст, когда много комментариев, % — заменяется числом комментариев.
- $css_class — CSS class ссылок
- $none — текст, когда комментирование отключено
comments_popup_script()
Используется для подключения JavaScript, который отображает комментарии в всплывающем окне. Принимает параметры width, height, ‘file’, где
- width — ширина всплывающего окна
- height — высота всплывающего окна
- ‘file’ — адрес JavaScript файла
get_avatar()
Получает аватар. Принимает следующие параметры $id_or_email, $size, $default, $alt, где:
- $id_or_email — ID автора комментария или его e-mail
- $size — размер аватарки (макс 512)
- $default — адрес аватарки по умолчанию
- $alt — альтернативный текст аватарки
next_comments_link()
Отображает ссылку к следующему комментарию. Принимает параметры $label, $max_page, где:
- $label — текст ссылки
- $max_page — максимальное число страниц
paginate_comments_links()
Создает нумерацию страниц с ссылками на комментарии для текущего сообщения.
permalink_comments_rss()
Отображает ссылку на пост к которому принадлежит комментарий, отформатированный для RSS
previous_comments_link()
Отображает ссылку на предыдущий комментарий. Принимает параметр $label — текст ссылки.
wp_list_comments()
Отображает все комментарии для сообщения или страницы на основе различных параметров. В качестве параметра принимает массив $args
<?php $args = array( 'walker' => null, 'max_depth' => , 'style' => 'ul', 'callback' => null, 'end-callback' => null, 'type' => 'all', 'page' => , 'per_page' => , 'avatar_size' => 32, 'reverse_top_level' => null, 'reverse_children' => ); ?>
На этом я завершаю рассмотрение тегов для работы с комментариями в WordPress. Ну, а на практике мы их применим, когда продолжим создавать собственную тему для WordPress. В следующей статье мы остановим свое внимание на тегах для работы с ссылками. Так, что следите за обновлениями блога посвященного WEB-программированию, подписавшись на RSS-рассылку. А пока все. Всем удачного освоения CMS WordPress.
[…] рассматривать теги для работы с шаблонами WordPress. Так в прошлой статье мы остановились на тегах для работы с комментариями. А […]
[…] Теги для работы с комментариями WordPress […]