=== Decent Comments ===
Contributors: itthinx
Donate link: http://www.itthinx.com/plugins/decent-comments
Tags: avatar, comment, comment API, comment excerpt, comment excerpts, comment widget, comment shortcode, comments, excerpt, excerpts, latest comments, recent comments, shortcode, shortcodes
Requires at least: 3.0
Tested up to: 3.4.1
Stable tag: 1.1.3
License: GPLv3
Decent Comments shows what people say. Provides widgets, shortcodes and API to display comments including author avatars, links, comment excerpts.
== Description ==
__Decent Comments shows what people say.__
If you want to show comments along with their author's avatars _and_ an excerpt of their comment, then this is the right plugin for you.
And it's not limited to just a widget showing recent comments: The plugin provides configurable widgets, shortcodes and an API to display comments in sensible ways, including author avatars, links, comment excerpts ...
Anywhere you place comments, by means of a widget, a shortcode or an API call, you can:
- Show an excerpt or the full comment. You can choose to not show the comment as well.
- Determine the number of words shown for excerpts.
- Set your kind of ellipsis.
- Set the number of comments to show.
- Show the author's avatar and determine it's size.
- Sort by author email, author URL, content (what's said in the comment), date, karma or post ... in ascending or descending order.
- Show comments for the current post or for a specific post.
- Show comments for posts in specific categories, for specific tags, ... (more precisely: the ability to show comments from posts related to one or more terms in a chosen taxonomy).
- and more to come ... got suggestions?
__Feedback__ is welcome!
If you need help, have problems, want to leave feedback or want to provide constructive criticism, please do so here at the [Decent Comments plugin page](http://www.itthinx.com/plugins/decent-comments).
Please try to solve problems there before you rate this plugin or say it doesn't work. There goes a _lot_ of work into providing you with free quality plugins! Please appreciate that and help with your feedback. Thanks!
[Follow me on Twitter](http://twitter.com/itthinx) for updates on this and other plugins.
__Translations__
* Lithuanian translation provided by Vincent G from [Host1Free](http://www.Host1Free.com) - Many thanks!
== Installation ==
1. Upload or extract the `decent-comments` folder to your site's `/wp-content/plugins/` directory. Or you could use the *Add new* option found in the *Plugins* menu in WordPress.
2. Enable the plugin from the *Plugins* menu in WordPress.
Please also visit the [Decent Comments plugin page](http://www.itthinx.com/plugins/decent-comments) for the latest info.
== Frequently Asked Questions ==
= Can this plugin show excerpts of comments or even full comments? =
Yes!
= Can I choose how many comments are displayed? =
Yes.
= Can I display comments for any post? For the current post? For a specific post? =
Yes. Yes. Yes.
= Does it show author's avatars? =
Yes.
= Can I place more than one comment widget with different settings? =
Yes.
= Does it offer shortcodes? =
Yes. Place your comments anywhere you need them!
= Can I call a function to display comments wherever I need? =
Yes.
= What else does it do? =
It's highly configurable!
Please visit the [Decent Comments plugin page](http://www.itthinx.com/plugins/decent-comments) for the latest info.
If you need something that is not available yet, get in touch. Feedback is welcome!
= Help! =
Get help at the [Decent Comments plugin page](http://www.itthinx.com/plugins/decent-comments).
= I really appreciate this, how can I contribute? =
Please visit the [Decent Comments plugin page](http://www.itthinx.com/plugins/decent-comments) and you should find a way to donate or contribute with feedback and ideas.
Translations are also welcome!
== Screenshots ==
1. Decent Comments widget configuration.
== Changelog ==
= 1.1.3 =
* Added German translation.
= 1.1.2 =
* Added option to restrict comments shown by post ID when using the shortcode.
= 1.1.1 =
* Lithuanian translation added
= 1.1.0 =
* Added own comment retriever which allows for more versatile ways to get comments.
* Widget and shortcode allow to show comments from posts related to one or more terms in a chosen taxonomy.
* Shortcode now works like this [decent_comments/] and as before [decent-comments/]
= 1.0.3 =
* guarded against shortcode interpretation in comments
= 1.0.2 =
* Fixed typos
= 1.0.1 =
* Fixed to avoid class not found issues
= 1.0.0 =
* Initial release.
== Upgrade Notice ==
= 1.1.3 =
* Added German translation.
= 1.1.2 =
* Added option to restrict comments shown by post ID when using the shortcode.
= 1.1.1 =
* Added Lithuanian translation provided by Vincent G from [Host1Free](http://www.Host1Free.com)
= 1.1.0 =
If you want to display comments on posts in a specific category, this version will please you :)
Also works for tags ... actually, it allows to choose terms from any taxonomy.
= 1.0.3 =
Please update, this release guards against shortcode interpretation in comments rendered.
= 1.0.2 =
Bugfix - please update
= 1.0.1 =
Update if you get class not found errors
= 1.0.0 =
No need to upgrade yet.