# paginate_comments_links()

URL: https://chugunov.pro/api-wordpress/functions/paginate_comments_links/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.7.0.

## Сигнатура

```php
paginate_comments_links( string|array $args = array() ): void|string|array
```

## Описание

См. alsopaginate_links()

## Параметры

- `$args` `string|array` — необязательный, по умолчанию `array()`. Необязательные аргументы. См. paginate_links() .

## Возвращаемое значение

`void|string|array` — 'echo' 'type' 'type'

## Исходный код

Файл: `wp-includes/link-template.php:3262`

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

	if ( ! is_singular() ) {
		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,
		'type'         => 'plain',
		'add_fragment' => '#comments',
	);
	if ( $wp_rewrite->using_permalinks() ) {
		$defaults['base'] = user_trailingslashit( trailingslashit( get_permalink() ) . $wp_rewrite->comments_pagination_base . '-%#%', 'commentpaged' );
	}

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

	if ( $args['echo'] && 'array' !== $args['type'] ) {
		echo $page_links;
	} else {
		return $page_links;
	}
}
```

## История изменений

- 2.7.0 — Introduced.

## Связанные

Использует: [`paginate_links`](https://chugunov.pro/api-wordpress/functions/paginate_links/), [`is_singular`](https://chugunov.pro/api-wordpress/functions/is_singular/), [`get_query_var`](https://chugunov.pro/api-wordpress/functions/get_query_var/), `WP_Query`, [`user_trailingslashit`](https://chugunov.pro/api-wordpress/functions/user_trailingslashit/), `WP_Rewrite::using_permalinks`, [`get_comment_pages_count`](https://chugunov.pro/api-wordpress/functions/get_comment_pages_count/), [`trailingslashit`](https://chugunov.pro/api-wordpress/functions/trailingslashit/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/), [`add_query_arg`](https://chugunov.pro/api-wordpress/functions/add_query_arg/), [`get_permalink`](https://chugunov.pro/api-wordpress/functions/get_permalink/).
Используется в: [`get_the_comments_pagination`](https://chugunov.pro/api-wordpress/functions/get_the_comments_pagination/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/paginate_comments_links/