comments_template()

1.5.0 wp-includes / comment-template.php / Кодекс WordPress

Функция подключает файл шаблона комментариев (по умолчанию 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' );

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Примеры