Функция подключает файл шаблона комментариев (по умолчанию comments.php
) и, самое главное, получает комментарии текущего поста и записывает их в глобальные переменные, если быть точнее, то в $wp_query->comment
, которая потом используется внутри шаблона комментариев другими функциями, например функцией wp_list_comments().
comments_template( $file = '/comments.php', $separate_comments = false )
Параметры
- $file
- (строка) Файл шаблона комментария. Относительно папки темы WordPress.
Функция сначала попробует подключить файл из текущей темы, потом из родительской. Если ни того ни другого не существует, подключит/wp-includes/theme-compat/comments.php
. - $separate_comments
- (логическое)
true
/false
Нужно ли разделять комментарии по типу.
Примеры
Функция чаще всего используется в файле шаблона single.php
(реже – page.php
). Например в стандартной теме WordPress Twenty Fourteen функция используется следующим образом:
if ( comments_open() || get_comments_number() ) { comments_template(); }
Тут в условии происходит проверка, что шаблон комментариев подключаем либо если комментарии открыты (функция comments_open()), либо если к посту оставлен хотя бы один комментарий (функция get_comments_number()).
Ну, или к примеру, если вы хотите изменить подключаемый файл, например это будет /themes/ваша-тема/custom/comments.php
, тогда функция изменится:
comments_template( '/custom/comments.php' );