=== Comment Rating ===
Contributors: bobking
Tags: comments, comment rating, vote, poll, polls, rating, ratings, comment, Dislike, Like
Requires at least: 2.3
Tested up to: 2.8.4
Stable tag: 2.3

Allows visitors to rate the comments on your blog in a Like vs.
Dislike fashion.  Clickable images and ratings are automatically
inserted into each comment.  Comments disliked too much by readers
will be hidden in a click-to-show link. This plugin is simple and
light-weight. 

== Description ==

If you're getting outrageous comments on your blog, don't get too
angry yet.  Let's see if your readers feel the same.  You can find
out how your readers feel about those comments with the Comment
Rating plugin.

This plugin uses simple AJAX to allow your visitors rate comments in
Like vs. Dislike fashion.  The votes are displayed along with the
comments.  The up or down vote counts will change rightaway after the
visitor casts a vote and the images change from color to grey
indicating the vote has been accepted.

To prevent cheating, only one vote is allowed per IP address.  This
is less subject to manipulation than cookie based approaches. The author
of a comment cannot rate his/her own comment.

<b>New in version 2.3</b>: Poorly rated comments (too many Dislikes,
not enough Likes) can be hidden in a click-to-see link. The
threshholds for the rating is configurable.  This way, comments from
trolls and "bad guys" will be hidden by default for anyone who
doesn't want to see them, with the option to read the comment if
they really want to.  Thanks to Jean-Paul Horn for the suggestion.

This plugin also allow other use of Wordpress as a general CMS in a
Web 2.0 fashion.  User generated content can be rated by other
users. Such an example website is <a href="http://captionwit.com">Caption Wit</a>.

The design principle of the plugin is simple and light-weight (i.e.
high performance). 

Comment Rating plugin built on top of
<a href="http://cyber-knowledge.net">Alex Bailey's discontinued Comment Karma</a>

== Installation ==

1. After download the plug in, you can upload and install it from 
Wordpress Dashboard -> Plugins -> Add New. Alternatively, you can
unpack and upload the file to the wp-content/plugins folder on your blog.  

1. Activate the plugin.

1. You can configure the options under Setting -> Comment Rating.
The default options should be good enough. It works out of box. You
are done. Sit back and have a look at your blog.

1. If you want to tailor the display format further, you can turn
off auto-insertion into comments and add the following line to an
appropriate place in your theme "comments.php" file.
 if(function_exists(ckrating_display_karma)) { ckrating_display_karma(); }

== Frequently Asked Questions ==

= Why are the voting image in gray? =

Author of the post is not allowed to vote on user comments.  But if
you change to a different IP address, you'll then be able to do so.

= Why doesn't the votes number change ? =

The up or down vote counts will change rightaway after the visitor
has casted a vote and change color to grey indicating the vote has
been accepted.  However, if you have wp-cache or wp-super-cache
enable, other visitors will not see the refreshed vote counts until
the cached page expires and reload.

To keep the vote counts fresh, please set wp-cache/wp-super-cache 
Expiry time to 1 hour or less.


== Screenshots ==

1. Example a Wordpress installation right after installation.

2. Taken from example website <a href="http://captionwit.com">Caption Wit</a>.

== Changelog ==

= 2.3 =

Comments disliked too much by readers
will be hidden in a click-to-show link.

= 2.2 =

Add flexibility with an option page.

= 2.1 =

Add auto-insertion rating images into comments, and javascript to footer

= 2.0 =

Change the vote counter from 1 (total) to 2 (Likes and Dislikes) and
display them separately.
Added index to vote count table. Improved the plug-in performance