=== WP-RecentComments ===
Contributors: mg12
Donate link: http://www.neoease.com/plugins/
Tags: comments, widget, sidebar, AJAX
Requires at least: 2.5
Tested up to: 3.3.1
Stable tag: 1.8.4
Display recent comments in your blog sidebar.
== Description ==
Show the recent comments in your WordPress sidebar. You can limit the number of comments, set the maximum length of excerpts, filter out pingbacks and/or trackbacks. You can also enable or disable the avatars, resize and reposition them. Besides above, it supports WordPress Widget. And now, it's AJAX comment paging, you can turn to the newer or older comments when you clicked on the paging buttons.
在 WordPress 的侧边栏显示最新评论。你可以限制显示评论的数量,设置评论摘要的最大长度,过滤反链接评论。你还可以显示或屏蔽评论者头像,调整头像的尺寸和位置。除此之外,此插件还支持 WordPress Widget 功能。而现在,它支持基于 AJAX 的评论分页,你可以通过点击分页按钮来查看新旧评论。
**Features:**
* Support for East Asian characters
* Avatar support
* Widget support
* AJAX comment paging
* Goto comment details
* Separating pingbacks and trackbacks from comments
* Support 'Show smilies as graphic icons' option
* Filter quotes
* Support jQuery lib
**Supported Languages:**
* US English/en_US (default)
* 简体中文/zh_CN (translate by [mg12](http://www.neoease.com/))
* Arabic/ar (translate by Mustafa)
* Belorussian/by_BY (translate by Marcis Gasuns)
* Bulgarian/bg_BG (translate by [Emil Minev](http://www.inspirelearning.net/))
* Czech/cs_CZ (translate by Ladislav Prskavec)
* Danish/da_DK (translate by [Morten L. Johansen](http://www.lystorp.com/))
* Finnish/fi (translate by C. Hellberg)
* Français/fr_FR (translate by Luc Santeramo)
* German/de_DE (translate by [Sylvia Egger](http://sprungmarker.de/))
* Hungarian/hu_HU (translate by János Csárdi-Braunstein)
* Israel Hebrew/he_IL (translate by [Roy Azrad](http://www.lawtech.co.il/))
* Italian/it_IT (translate by Enrico Flaminios)
* Lithuania/lt_LT (translate by [Mantas Malcius](http://mantas.malcius.lt/))
* Macedonian/mk_MK (translate by [Dimitar Talevski](http://www.solipamet.com/))
* Persian/fa_IR (translate by [Farzad Sagharchi](http://blog.sagharchi.ir/))
* Polish/pl_PL (translate by [Chris Ostrowski](http://www.kierunek-sukces.pl/))
* Russian/ru_RU (translate by [Алексей В.Ч.](http://www.alexnote.ru/))
* Spanish/es_ES (translate by Eugenio Cavero)
* Swedish/sv_SE (translate by Jonas Nordström)
* Türkçe/tr_TR (translate by [Hamdi Kellecioglu](http://www.tirnakmakasi.com/))
* Ukrainian/uk (translate by Jurko Chervony)
**Demo:**
[http://www.neoease.com/](http://www.neoease.com/)
== Installation ==
1. Unzip archive to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. This is two ways to add the WP-RecentComments widget to the sidebar:
* Go to 'Design->Widgets', and add the WP-RecentComments to your blog.
* In your 'sidebar.php' file add the following lines:
****
Recent Comments
OR
Recent Comments
**Arguments:**
NAME TYPE DESCRIPTION DEFAULT VERSIONS
limit integer The number of comments. 5 1.0+
length integer The length of each comment 50 1.1+
excerpt.
post true/false Show the post titles. true 1.1+
pingback true/false Show the pingback comments. true 1.1+
trackback true/false Show the trackback comments. true 1.4.3+
avatar true/false Show author avatars. true 1.1+
avatar_size integer The size of avatars. 32 1.1+
avatar_position left/right The position of avatars. left 1.1+
avatar_default string The default avatar. 1.4.1+
navigator true/false Show navigator buttons. true 1.3+
administrator true/false Show the comments from true 1.4.2+
administrators.
smilies true/false Show smilies as graphic icons. false 1.6+
**Default Avatar:**
* You can only entry a filename from '/wp-recentcomments/avatars/' directory.
* When you want to use an Internet image, you have to entry the filepath and start with 'HTTP://'.
**Using Examples:**
**Custom CSS:**
* WP-RecentComments will load wp-recentcomments.css from your theme directory if it exists.
* If it doesn't exists, it will load the default style that comes with WP-RecentComments.
== Screenshots ==
1. WP-RecentComments widget.
2. The comment detail.
3. The comments on single post page.
== Changelog ==
****
VERSION DATE TYPE CHANGES
1.8.4 2012/04/03 FIX Security vulnerability fixed.
1.8.3 2010/10/09 NEW Added Albanian language support. (Thanks Romeo Shuka)
NEW Added Dutch language support. (Thanks Jan Willem Wilmsen)
MODIFY Update Simplified Chinese translation.
MODIFY Update Ukrainian translation. (Thanks Jurko Chervony)
FIX 'Show the comments from administrators' option is disabled when $table_prefix isn't 'wp_'.
1.8.2 2010/06/24 MODIFY Add nofollow to the links to ensure its SEO friendly.
REMOVE Remove the HTML comments.
1.8.1 2009/09/15 NEW Added Finnish language support. (Thanks C. Hellberg)
NEW Added Czech language support. (Thanks Ladislav Prskavec)
FIX Set JavaScript type to 'normal' as default.
FIX Don't load jQuery lib when custom jQuery lib is null.
FIX Changed content-type of AJAX actions.
1.8 2009/06/07 NEW jQuery is now supported. (JavaScript library option)
NEW Added Swedish language support. (Thanks Jonas Nordström)
NEW Added Lithuania language support. (Thanks Mantas Malcius)
NEW Added Belorussian language support. (Thanks Marcis Gasuns)
MODIFY Update Simplified Chinese translation.
FIX Block the comments if they doesn't come from publish posts.
FIX Fixed the messy code when changed pages.
1.7.3 2009/03/07 NEW Added Polish language support. (Thanks Chris Ostrowski)
NEW Added Persian language support. (Thanks Farzad Sagharchi)
NEW Added Ukrainian language support. (Thanks Jurko Chervony)
NEW Added Arabic language support. (Thanks Mustafa)
FIX Fixed bugs related to table names of DB when TABLE PREFIX is not 'wp_'.
1.7.2 2009/02/05 NEW Compatible with 'Reviewers Info' plugin.
NEW Added Italian language support. (Thanks Enrico Flaminio)
NEW Added Spanish language support. (Thanks eugenio)
NEW Added Bulgarian language support. (Thanks Emil Minev)
NEW Added German language support. (Thanks Sylvia Egger)
NEW Added Macedonian language support. (Thanks Dimitar Talevski)
NEW Added Danish language support. (Thanks Morten L. Johansen)
NEW Added Hungarian language support. (Thanks János Csárdi-Braunstein)
NEW Added Israel Hebrew language support. (Thanks Roy Azrad)
FIX Fixed a bug when WordPress root directory in sub folder.
1.7.1 2008/12/25 FIX Fixed a bug about author names.
1.7 2008/12/23 NEW The comments of PRIVATE posts only display to its author.
NEW The comments of PASSWORD PROTECTED posts only display when people enter the password.
1.6.5 2008/12/16 NEW Added Russian language support. (Thanks Алексей В.Ч.)
MODIFY Replaces double line-breaks with paragraph elements.
FIX Fixed a bug related to convert emoticons to graphics.
1.6.4 2008/11/29 FIX Fixed AJAX actions in Microsoft Internet Explorers.
1.6.3 2008/11/28 MODIFY To enable newline characters in detail pages.
MODIFY Updated the JavaScript and using namespace.
1.6.2 2008/11/01 FIX Fixed a bug related to widget function.
1.6.1 2008/10/29 FIX Fixed a display bug of comment detail.
1.6 2008/10/29 NEW Added 'smilies' argument.
NEW Return an HTML string as the result.
NEW Separating pingbacks and trackbacks from comments.
NEW Perfect the links which beginning with '#'.
NEW Added comment datetime to comment details.
MODIFY Remove all the blockquotes from recent comment list.
MODIFY Remove all the blockquotes but the outermost from detail comment.
MODIFY Any comments but pingbacks/trackbacks can goto their detail page.
DELETE Removed 'get_recentcomments()' method.
1.5.4 2008/10/04 NEW Added Turkish language support. (Thanks Hamdi Kellecioglu)
1.5.3 2008/10/04 NEW Added French language support. (Thanks Luc Santeramo)
1.5.2 2008/09/08 FIX Fixed a bug that make the detail buttons working when 'navigator=false'.
1.5.1 2008/09/07 FIX No link back to author when the URL is absented.
1.5 2008/09/05 NEW Show details.
FIX Fixed bugs in localization.
1.4.3 2008/07/26 NEW Added 'trackback' argument.
FIX Fixed a bug about avatars.
1.4.2 2008/07/11 NEW Added 'administrator' argument.
NEW Added loading status.
FIX Fixed bugs in localization.
1.4.1 2008/07/06 NEW Added default avatar support.
1.4 2008/07/05 NEW Added localization support.
NEW Added Simplified Chinese language support.
NEW Added 'newest' button to paging navigator.
NEW WP-RecentComments will load 'wp-recentcomments.css' from your theme directory if it exists.
MODIFY Uses 'wp_recentcomments()' method instead of 'get_recentcomments()', but still support the old method for a period.
1.3 2008/06/14 NEW Added AJAX paging support.
MODIFY Show avatars by default.
1.2.3 2008/06/08 FIX Fixed a code comment.
FIX Show approved comments only.
1.2.2 2008/06/06 FIX Rewrite code with a better style.
1.2.1 2008/06/02 FIX Compatible with some another plugins.
1.2 2008/05/15 NEW Added WordPress Widget support.
NEW Apply CSS styles automatically.
1.1.2 2008/05/11 FIX 'Anonymous' as names of comment authors who did not type in their names.
1.1.1 2008/05/10 FIX Fixed a bug of experpt length.
1.1 2008/05/09 NEW Works for WordPress 2.5 only.
NEW Added 'pingback' and 'post' argument.
NEW Added avatars support.
NEW Added CSS support.
MODIFY New formatted argument list.
MODIFY Limit 20 comments.
1.0 2008/03/09 NEW Works for WordPress 2.2 and WordPress 2.3.
NEW Support for East Asian characters.
NEW Allow the user to set the maximum length of excerpts.
NEW Allow the user to set the maximum number of comments to display in the sidebar.
NEW Limit 15 comments.