Title: WP-CommentNavi
Author: Lester Chan
Published: 4 November 2008
Last modified: 9 Agustus 2026
---
Cari plugin
# WP-CommentNavi
Oleh [Lester Chan](https://profiles.wordpress.org/gamerz/)
[Unduh](https://downloads.wordpress.org/plugin/wp-commentnavi.2.0.0.zip)
* [Detail](https://id.wordpress.org/plugins/wp-commentnavi/#description)
* [Ulasan](https://id.wordpress.org/plugins/wp-commentnavi/#reviews)
* [Instalasi](https://id.wordpress.org/plugins/wp-commentnavi/#installation)
* [Pengembangan](https://id.wordpress.org/plugins/wp-commentnavi/#developers)
[Bantuan](https://wordpress.org/support/plugin/wp-commentnavi/)
## Deskripsi
Replaces the plain _← Older Comments | Newer Comments →_ links with numbered page
links.
Example: `Page 1 of 20: [1] 2 3 4 ... Last`
It is the comment-thread counterpart of [WP-PageNavi](https://wordpress.org/plugins/wp-pagenavi/),
and the two are deliberately built the same way, down to the names of the filters
that change the class names.
The plugin icon is by [Freepik](https://www.freepik.com) from [Flaticon](https://www.flaticon.com).
### Features
* Numbered page links instead of two prev/next links
* A drop-down list style, for threads with a great many pages
* Every piece of the navigation’s text is configurable, including inline SVG arrows
* Larger page numbers — 10, 20, 30 — for jumping across a long thread
* Ten filters for the element class names, one for the finished markup
* One stylesheet that serves both left-to-right and right-to-left locales, restyled
with two CSS custom properties
### Donations
I spent most of my free time creating, updating, maintaining and supporting these
plugins, if you really love my plugins and could spare me a couple of bucks, I will
really appreciate it. If not feel free to use it without any obligations.
### Usage
The template tag reads figures that WordPress only populates inside `comments_template()`,
so it belongs in `comments.php` and produces nothing anywhere else.
It also accepts an array of arguments:
```
'nav',
'wrapper_class' => 'my-comment-nav',
'options' => array( 'num_pages' => 3 ),
)
);
?>
```
Pass `'echo' => false` to get the markup back as a string instead of printing it.
### Changing the CSS
The navigation inherits its font and its colours from your theme, and the two colours
it does set are CSS custom properties, so the usual way to restyle it is to set
those in your theme’s `style.css`:
```
:root {
--wp-commentnavi-border-color: #d0d0d0;
--wp-commentnavi-border-color-current: #c0392b;
}
```
If you need to change more than that, copy `css/wp-commentnavi.css` out of the plugin
directory into your theme’s directory as `wp-commentnavi.css` and edit it there.
Your changes then survive plugin updates, and a copy in a child theme wins over
one in the parent theme.
Alternatively, set _Use wp-commentnavi.css_ to **No** on the settings screen and
write the styles yourself.
### Changing Class Names
These [filters](https://developer.wordpress.org/plugins/hooks/filters/) change the
class names assigned to the navigation elements:
* `wp_commentnavi_class_pages`
* `wp_commentnavi_class_first`
* `wp_commentnavi_class_previouscommentslink`
* `wp_commentnavi_class_extend`
* `wp_commentnavi_class_smaller`
* `wp_commentnavi_class_page`
* `wp_commentnavi_class_current`
* `wp_commentnavi_class_larger`
* `wp_commentnavi_class_nextcommentslink`
* `wp_commentnavi_class_last`
### Other Filters
* `wp_commentnavi` — the complete markup, before it is printed
* `wp_commentnavi_allowed_html` — the tags allowed inside the navigation text settings
* `wp_commentnavi_capability` — the capability required to reach the settings screen,`
manage_options` by default
```
add_filter( 'wp_commentnavi_capability', function ( $capability, $context ) {
return 'edit_pages';
}, 10, 2 );
```
## Tangkapan Layar
[⌊Settings -> WP-CommentNavi, where every piece of the navigation text is set⌉⌊Settings-
> WP-CommentNavi, where every piece of the navigation text is set⌉[
Settings -> WP-CommentNavi, where every piece of the navigation text is set
[⌊The comment links under a post with twenty pages of comments⌉⌊The comment links
under a post with twenty pages of comments⌉[
The comment links under a post with twenty pages of comments
## Instalasi
1. Install and activate the plugin.
2. Open `wp-content/themes//comments.php` and add `` where the old comment links were.
3. Go to `WP-Admin -> Settings -> CommentNavi` to configure it.
The tag reads figures WordPress only populates inside `comments_template()`, so
it belongs in `comments.php` and nowhere else.
## Tanya Jawab
### My theme calls wp_commentnavi_all_comments_link() and the site is broken
That function was removed in 2.0.0, along with the `comment-all` query variable
it depended on. Open `wp-content/themes//comments.php` and delete
the line that calls it.
It was removed because the query variable was not guarded. Any visitor could append`?
comment-all=1` to any URL on the site and force WordPress to load up to 9999 comments
in a single query, on every request, with no rate limiting — the hook ran on `pre_get_posts`
without checking `is_main_query()` or even `is_singular()`.
If you want to keep offering a way to read every comment at once, raise _Number
Of Pages To Show_, or set the comment paging options under _Settings -> Discussion_
to suit.
### Where did the settings page go?
It is at _Settings -> CommentNavi_, which is now `options-general.php?page=wp-commentnavi`.
The old address was `options-general.php?page=wp-commentnavi/commentnavi-options.
php`, which had the plugin’s directory name inside it. Anyone who installed the
plugin under a different directory name — a rename, a deploy tool, a bundled copy—
got a settings screen that could not be opened at all.
### My theme’s copy of commentnavi-css.css stopped being used
Rename it to `wp-commentnavi.css`. The plugin’s own stylesheet moved to `css/wp-
commentnavi.css` in 2.0.0, and the file it looks for in your theme was renamed to
match, so the file you copy and the file you copied it from are spelled the same
way.
### The navigation looks different after upgrading
The stylesheet no longer sets a link colour, a border colour or a white background.
It inherits your theme’s colours instead, which is what lets it fit a dark theme
without being told anything about one. Set `--wp-commentnavi-border-color` and `--
wp-commentnavi-border-color-current` in your theme to restyle it, as described above.
### The navigation disappeared after I put an SVG icon in the previous or next text
That is fixed in 2.0.0. `wp_kses_post()`, which the settings screen used to filter
with, deletes an `