=== 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.6 Stable tag: 1.2.0 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 a specific post type. - 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__ * French translation provided by Thomas Mur from [Creapage.net](http://www.creapage.net) * German translation provided by the author [itthinx](http://www.itthinx.com) * 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.2.0 = * Added feature: show comments for a specific post type. * Fixed: not linking author's avatar when the author has no related URL. * Added feature: option to link comment authors to their site or not. * Added French translation. = 1.1.5 = * Fixed : {current} wasn't accepted as Terms in widget. = 1.1.4 = * Added options to include Pingback/Trackback. * WordPress 3.5 compatibility. * Fixed some options not working (booleans). = 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.2.0 = * Several improvements and now also supports showing comments by post type (shortcode and widget). WordPress 3.6 compatibility checked. = 1.1.5 = * Bugfix related to using {current} for comments based on taxonomies. = 1.1.4 = * WordPress 3.5 compatibility, new options to include or exclude Pingbacks and Trackbacks and bug fixes. = 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.