## Функция COMMENT_CLASS() в WordPress
### Общее описание
Функция comment_class() добавляет семантические классы к каждому элементу комментария. Это помогает разбить комментарии на типы и стилизовать их.
### Как используется
Функция comment_class() имеет следующий синтаксис:
```php
comment_class( $css_class, $comment, $post, $display );Параметры
- $css_class (string|string[]): Один или несколько классов, которые нужно добавить к списку классов. По умолчанию: пустая строка.
- $comment (int|WP_Comment): ID комментария или объект
WP_Comment. По умолчанию: текущий комментарий. - $post (int|WP_Post): ID поста или объект
WP_Post. По умолчанию: текущий пост. - $display (true|false): Указывает, выводить ли результат на экране или вернуть его. По умолчанию: true.
Примеры использования
Пример 1: Использование функции для четного топ-уровня комментария
Этот код выведет: class="comment even thread-even"
На самом деле, эта функция обычно используется внутри HTML-тега (контейнер комментариев):
id="li-comment-"> Пример 2: Добавление своего класса
Если вам нужно добавить свой собственный класс, вы можете использовать первый параметр:
Результат будет: class="comment even thread-even special".
Код функции
Вот как выглядит код функции comment_class() в файле wp-includes/comment-template.php:
function comment_class( $css_class = '', $comment = null, $post = null, $display = true ) {
// Объединяет классы с пробелами, создает классы для контейнера комментария.
$css_class = 'class="' . implode( ' ', get_comment_class( $css_class, $comment, $post ) ) . '"';
if ( $display ) {
echo $css_class;
} else {
return $css_class;
}}
Изменения в версии
- С версии 2.7.0: Функция была добавлена.
- С версии 4.4.0: Добавлена возможность передавать объект
WP_Commentв качестве параметра$comment.
Связанные функции
Функция comment_class() часто используется вместе с другими функциями для работы с комментариями. Вот некоторые из них:
body_class(): Добавляет классы к тегу<body>.post_class(): Добавляет классы к тегам постов.
Цикл комментариев
Вот примеры функций, которые можно использовать в цикле комментариев:
comment_author()comment_date()comments_number()have_comments()
Эти функции помогут вам лучше управлять комментариями на вашем сайте.
Заключение
Функция comment_class() — это полезный инструмент для добавления классов к комментариям на сайте WordPress. Она позволяет улучшить стилизацию и сделать интерфейс более удобным для пользователей. Используя эту функцию, вы можете легко настраивать внешний вид комментариев в зависимости от их типа и состояния.