Функция подключает файл шаблона комментариев (по умолчанию 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' );
Источник: Блог Миши Рудрастых