Title: Top Commentators Widget
Author: Lorna Timbah
Published: <strong>2007-يىلى 4-ئۆكتەبىر</strong>
Last modified: 2025-يىلى 20-دېكابىر

---

قىستۇرما ئىزدە

![](https://ps.w.org/top-commentators-widget/assets/banner-772x250.png?rev=547334)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/top-commentators-widget/assets/icon-256x256.png?rev=1312425)

# Top Commentators Widget

 يازغۇچى [Lorna Timbah](https://profiles.wordpress.org/webgrrrl/)

[چۈشۈر](https://downloads.wordpress.org/plugin/top-commentators-widget.1.7.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/top-commentators-widget/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/top-commentators-widget/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/top-commentators-widget/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/top-commentators-widget/#developers)

 [قوللاش](https://wordpress.org/support/plugin/top-commentators-widget/)

## چۈشەندۈرۈش

This plugin creates a widget to show the top commentators in your WP site. Always
go back to the Widget settings after each version update to Save your settings. 
Demo can be found at http://demo.webgrrrl.net

The Top Commentators Widget plugin is adapted from Show Top Commentators plugin 
at Personal Financial Advice, this widget is easier to manage via the control form(
no need to edit the PHP file); additional options are also available to make it 
more flexible. Read the FAQ section on how to customize the widget. Read the Changelog
as well as http://webgrrrl.net/tags/tcw for the latest news on this widget.

This widget is extensively tested with the following settings: Google Chrome 13.0.782.215
m, PHP 5.2.13, Apache 2.2.15 (Win32), MySQL 5.0.51a, WordPress 3.2.1. Further testing
and bug report on this widget is greatly welcomed and appreciated.

## ئېكران كەسمىسى

 * [[
 * Top Commentators Widget v.1.0 and v.0.999a control form snapshot in WordPress
   2.5.1.
 * [[
 * Top Commentators Widget v.0.999 control form snapshot in WordPress 2.3.3.
 * [[
 * Top Commentators Widget v.1.4 control form snapshot in WordPress 3.0.5.

## ئورنىتىش

#### Automatic installation

In your WordPress dashboard, select Plugins / Add, search for Top Commentators Widget,
and select Install.

#### Manual (WordPress 2.5 and above)

 1. Download and unzip to get the topcommentators_widget.php file.
 2. Upload the file into the wp-content/plugins folder.
 3. In your WP admin console, go to Plugins and activate Top Commentators Widget.
 4. Drag the Top Commentators to wherever you want it to be, and click the Save Changes
    button if you want to stick to the default values.

#### Manual (WordPress 2.3.3 and lower)

 1. Download and unzip to get the topcommentators_widget.php file.
 2. Upload the file into the wp-content/plugins folder.
 3. In your WP admin console, go to Plugins and activate Top Commentators Widget.
 4. In your WP admin console, go to Presentation | Widgets (for WordPress 2.2 and later)
    or Presentation | Sidebar Widgets (for older WordPress versions), and drag the 
    Top Commentators widget to wherever you want it to be, and click the Save Changes
    button.

#### Manual (non-widgetized themes)

 1. Unzip to get the topcommentators_widget.php file.
 2. Upload the file into the wp-content/plugins folder.
 3. In your WP admin console, go to Plugins and activate Top Commentators Widget.
 4. In your WP admin console, go to Presentation | Widgets (for WordPress 2.2 and later)
    or Presentation | Sidebar Widgets (for older WordPress versions), and drag the 
    Top Commentators widget to wherever you want it to be, and click the Save Changes
    button.
 5. Nah, that’s it! Remember to read the FAQ to see what options you can play around
    in the Top Commentators Widget.

#### For those using the v.0.999a widget in WordPress 2.3.3 or lower

 1. The widget control form may not appear so pretty; the blue control form background
    does not run to the end of the form.
 2. Filtering by e-mail does not seem to work in WP 2.3.3 using full or partial address.

## FAQ

### How do I use this in my blog?

Obviously, you must be using WordPress on your site. Your theme must also support
widgets (if unsure, check with the person who designed the theme). If it doesn’t
support widget, please use the [Show Top Commentators plugin](http://www.pfadvice.com/wordpress-plugins/show-top-commentators/)
instead; it should work similarly to this widget.

### What options do I need to set in this widget?

None. Just follow the installation steps and and it is ready to run. Customization
is not necessary if you don’t want to bother doing so.

### Problem: This widget stopped working after I upgraded. What should I do?

Go to your Widgets settings and click Save in the Top Commentators widget settings.
Otherwise, please [submit a report in the Support Forum](https://wordpress.org/support/plugin/top-commentators-widget).

### Problem: The hour / month / year / (whatever period) Reset Period setting doesn’t work, not matter how I change it.

The «specify number of days/date» value will ALWAYS be prioritized before the Reset
Period dropdown options. Therefore, if you choose to use any of the dropdown options,
make sure to leave «specify number of days/date» text box empty.

### Problem: The widget only appears in my homepage and nowhere else.

By default, the Top Commentators list will appear only in your homepage ([read this site to find out why it’s better](http://andybeard.eu/609/how-to-show-top-commenters-only-on-your-index-page.html)).
If you want the list to appear site-wide, then set the «Show in home page only?»
option to No.

### Problem: No comment/wrong number of comments appeared after I installed/upgraded the Top Commentators widget.

Try one or more of the following tips below to solve this:

 1. Go to your Widgets settings and click Save in the Top Commentators Widget settings.
 2. Empty the «specify number of days/date» text box.
 3. Make sure the Reset Period is set to the period you choose.
 4. De-activate, and re-activate the Top Commentators Widget. Then go back to your 
    Widgets settings, remove the Top Commentators from your sidebar, and re-add it 
    again. Then Save the widget settings again.
 5. Don’t use the Back button of your browser to go back to your Widgets settings. 
    Always reload the Widgets page before changing the settings further.

### What are the options that I can change in this widget?

Good Lord, a lot! Ensure that you first follow the Installation instructions to 
activate the widget. Once you have the Top Commentators widget on the sidebar, click
the control icon of this widget to change the following:

 1.  **Change widget title**: Change the standard title (Top Commentators) to any snazzy
     title, like Bloggers of the Month or Commentors Who Owe Me a Million Bucks.
 2.  **Add description below the title**: You can add an extra description if you want
     to. NOTE: Certain WP themes may not display this correctly.
 3.  **List those with a minimum of XX comments**: Show only users who achieve a minimum
     number of comments before they get displayed here.
 4.  **Exclude these users**: Exclude commentators based on their names, like Administrator
     or yourself. Don’t enter any email filters here; they belong in the Filter full/
     partial emails field.
 5.  **Reset list every period**: Reset the list to generate commentors hourly, daily,
     weekly, monthly, yearly, or all-time. You can also reset the list within a certain
     number of days, like every 15 days or 66 days and so forth. As of version 1.2,
     you can specify a specific range of date; for example, to display top commentators
     between January 1, 2009 and March 31, 2009, you should type 20090101 and 20090331.
 6.  **Limit the number of names listed**: If you want to list the top 20 commentators,
     type in 20.
 7.  **Limit the number of characters in each name**: Useful if you want to control
     the list from breaking your sidebar design. Names that have characters longer 
     than your setting will have a trailing ellipses. If you want the names to be longer,
     change to a higher value such as 35. Otherwise, if, say, you change it to 3, then
     Lorna will become Lor… .
 8.  **Add remarks for empty list**: Display some notice to appear when your top commentator
     list is empty, like «Be the first person to comment».
 9.  **Filter full/partial URLs**: Works just like Exclude Users, except this will 
     filter by URLs.
 10. **Filter full/partial e-mails**: Works just like Exclude Users, except this will
     filter by e-mail address. NOTE: This may not work with WP 2.3.3 and lower and 
     currently in the buglist.
 11. **Display list type as bulleted or numbered list**: That’s pretty much straight-
     forward.
 12. **Hyperlink names**: Choose whether you want the commentors‹ names to be linked
     to their URLs or not.
 13. **Open each link in a new window**: Choose whether you want the links to open 
     a new window (target=_blank).
 14. **NoFollow links**: In case you want to display their URLs but make it NoFollow
     to stop Google juice.
 15. **Show number of comments made**: Like it says.
 16. **Group commentors based on e-mail or user names**: This option is added to solve
     the hijacking problem various blogs have been reporting if commentors are grouped
     by user names.
 17. **Show in home page only**: If you select Yes, then the Top Commentators list 
     will only appear in your main page; otherwise, the list will appear in all pages
     that have your sidebar displayed.
 18. **Display only commentators with URL**: If you select Yes, then the Top Commentators
     list filter out commentators who did not leave any web site URL in their latest
     comment.
 19. **Display Gravatar**: If you select Yes, then a Gravatar will appear on the left
     side of each commentators name in the Top Commentators list.
 20. **Gravatar type and size**: If you select Yes in Display Gravatar, the images 
     will appear based on the type and size you specify here.
 21. **Awards those with at least XX comments**: If the number of comments is equal
     or greater than the number specified here, then an award icon will appear. No 
     icon will appear if this number is set to zero (0).
 22. **Align Award icon**: Set where you want the award icon to appear.

### Problem: The widget screwed with my sidebar design!! WTF??

Firstly, take a deep breath and calm down.

OK now? Great.

When this happens, it could verily mean that you will need to tweak your CSS file
of the WordPress theme you are using. Not only will you need to look into formatting
the UL, OL and LI of your sidebar, you also need to consider the use of A in the
existence — or absence — of hyperlinked commentators‹ names. The easiest way to 
do this is:
 * Identify the CSS elements that exist around and within the Top Commentators
Widget. You can identify the tags surrounding the TC Widget with the words «top-
commentators» or «widget widget_topcomm». * You may or may not want to add a new
CSS element specifically for the TC Widget. Get someone you know who’s good with
CSS if you’re not comfortable doing this yourself.

By the way, if you want to tinker with the style for this widget’s Gravatar, just
add a class called tcwGravatar to your style.css file and add any CSS element to
it. For the Award icon, look for the tcwAward class.

## باھالاشلار

![](https://secure.gravatar.com/avatar/9353826544464aa87c8135726a6334a4f1aaa7c6e11307664cf489b12bd6779b?
s=60&d=retro&r=g)

### 󠀁[Very helpful Plugin!](https://wordpress.org/support/topic/very-helpful-plugin-218/)󠁿

 [Appu Srva](https://profiles.wordpress.org/appu-srva/) 2019-يىلى 4-سېنتەبىر

So easy to set-up, and it works beautifully.

 [ 2 باھالاشنىڭ ھەممىنى ئوقۇش ](https://wordpress.org/support/plugin/top-commentators-widget/reviews/)

## تۆھپىكار ۋە ئىجادكار

«Top Commentators Widget» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا
تۆھپە قوشقان.

تۆھپىكار

 *   [ Lorna Timbah ](https://profiles.wordpress.org/webgrrrl/)

[«Top Commentators Widget» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/top-commentators-widget)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/top-commentators-widget/)،
[SVN خەزىنە](https://plugins.svn.wordpress.org/top-commentators-widget/) تەكشۈرۈپ
ياكى [RSS](https://plugins.trac.wordpress.org/log/top-commentators-widget/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/top-commentators-widget/)
گە مۇشتەرى بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

Older changelogs can be found in the following website: https://webgrrrl.net/archives/
my-top-commentators-widget-quick-dirty.htm#changelog

#### v.1.6

 1. Replaced strip_tags to wp_strip_tags for compatibility with PHP version 8.1 and
    higher.

## Meta

 *  Version **1.7**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **4 ئاي بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **200+**
 *  WordPress نەشرى ** 2.8 ياكى يۇقىرى **
 *  **6.6.5** دا سىنالغان
 *  تىل
 * [English (US)](https://wordpress.org/plugins/top-commentators-widget/)
 * بەلگە
 * [comments](https://ug.wordpress.org/plugins/tags/comments/)[gravatar](https://ug.wordpress.org/plugins/tags/gravatar/)
   [seo](https://ug.wordpress.org/plugins/tags/seo/)[sidebar](https://ug.wordpress.org/plugins/tags/sidebar/)
   [widget](https://ug.wordpress.org/plugins/tags/widget/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/top-commentators-widget/advanced/)

## دەرىجە

 5/5 يۇلتۇز

 *  [  2 5-star reviews     ](https://wordpress.org/support/plugin/top-commentators-widget/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/top-commentators-widget/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/top-commentators-widget/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/top-commentators-widget/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/top-commentators-widget/reviews/?filter=1)

[ئىنكاسىمنى قوش](https://wordpress.org/support/plugin/top-commentators-widget/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/top-commentators-widget/reviews/)

## تۆھپىكار

 *   [ Lorna Timbah ](https://profiles.wordpress.org/webgrrrl/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/top-commentators-widget/)