paginate_comments_links с версии 2.7.0

Описание

Выводит список ссылок на страницы комментариев (ссылки пагинации), текущего поста.

Ядром paginate_comments_links() является функция paginate_links(), поэтому она может принимать все те же параметры.

Использование

<?php paginate_comments_links( $args ) ?> 

Параметры по умолчанию

$args = array(
    'base' => add_query_arg( 'cpage', '%#%' )
    ,'format' => null
    ,'total' => $max_page
    ,'current' => $page
    ,'echo' => true
    ,'add_fragment' => '#comments'
);

paginate_comments_links( $args );

Параметры

$args (строка/массив)

Аргументы на основе которых будет получен результат.
По умолчанию: предустановки

Примеры

1. С версии 2.7. WordPress разработчиками был упрощен шаблон комментариев (файл comments.php), чтобы было проще создавать и редактировать отображение комментариев. Одним из таких улучшений стала возможность разделять комментарии на страницы и теперь посетителям не нужно подгружать сотни комментариев на одной странице.

Включается пагинация комментариев (разделение комментариев на несколько страниц) на странице админ-панели Настройки > Обсуждение.

После того, как разделение включено в системе, ссылки навигации по страницам комментариев можно вывести таким кодом:

paginate_comments_links();

Неким аналогом такой пагинации являются функции next_comments_link() и previous_comments_link(), которые выводят ссылки на следующую и предыдущую страницу комментариев.

2. Изменение текстов ссылок "следующая/предыдущая страница".
Чтобы изменить тексты ссылок следующая/предыдущая страница", функции нужно передать аргументы prev_text и next_text

paginate_comments_links('prev_text=back&next_text=forward')

Если в текстах ссылок нужно использовать специальные html символы (html сущности), то аргументы нужно передавать через массив:

paginate_comments_links( array('prev_text' => '«', 'next_text' => '»') )

paginate_comments_links()

function paginate_comments_links($args = array()) {
	global $wp_rewrite;

	if ( !is_singular() || !get_option('page_comments') )
		return;

	$page = get_query_var('cpage');
	if ( !$page )
		$page = 1;
	$max_page = get_comment_pages_count();
	$defaults = array(
		'base' => add_query_arg( 'cpage', '%#%' ),
		'format' => '',
		'total' => $max_page,
		'current' => $page,
		'echo' => true,
		'add_fragment' => '#comments'
	);
	if ( $wp_rewrite->using_permalinks() )
		$defaults['base'] = user_trailingslashit(trailingslashit(get_permalink()) . 'comment-page-%#%', 'commentpaged');

	$args = wp_parse_args( $args, $defaults );
	$page_links = paginate_links( $args );

	if ( $args['echo'] )
		echo $page_links;
	else
		return $page_links;
}

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Качественный звук у видео — это один из критериев его популярности. Поэтому не стоит недооценивать озвучивание вашего видео и если вы не уверены в качестве голоса, то можете обратиться к профи: озвучка видео. Не забывайте перед тем, как выкладывать видео в паблик, обязательно проверьте качество звука.