Decent Comments

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 …

Feedback is welcome! If you need help, have problems, want to leave feedback or want to provide constructive criticism, please leave a comment.

Please try to solve problems 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!


The documentation is available on the Decent Comments documentation pages.

219 Responses to Decent Comments

  1. Yoram Zara June 4, 2013 at 11:48 am #

    I am not a developer. I am just a user. I have no idea how to code. I am sure the plugin author can do this

    • kento June 4, 2013 at 11:58 am #

      I’ll need a patch to see what modifications have been made and include them, you can ask the freelancer who did it for the patch.

      • Harpreet Singh June 4, 2013 at 12:09 pm #


        I’ve done the modification, Can you provide me the sample of patch?
        Then i’ll give you the patch according to it.

        • kento June 4, 2013 at 12:29 pm #

          Hi there,

          Sure, you would do it like this:

          1. Check out the trunk: svn co decent-comments
          2. Add your modifications to the copy you now have in decent-comments.
          3. From within the decent-comments directory: svn diff > decent-comments.patch

          Then please post a link to the patch to download it.

  2. sacoche homme July 28, 2013 at 5:38 am #

    After I initially left a comment I appear to
    have clicked on the -Notify me when new comments are added- checkbox and now
    each time a comment is added I receive 4 emails
    with the exact same comment. Perhaps there is an easy method you are able to remove me from
    that service? Many thanks!

    • antonio July 28, 2013 at 2:32 pm #

      Hi, in the email that you receive, there is a link to unsubscribe. cheers

  3. Marie Krebs August 28, 2013 at 2:56 pm #

    I installed your plugin – don’t mean to sound daft, but – still NO COMMENTS show up after my posts and yes, there are comments that have been made. How do I actually configure your plugin to work? I’m not a techie, don’t know where to find the place to add “php” code I keep hearing about and no one ever says WHERE to find it to add anything to it. What good is a plugin that doesn’t do what it says? So, how do get your plugin to actually work on my site? Besides downloading it, and clicking the “activate” button, what else needs to be done? Thank you so much for helping me in plain, understandable and followable directions! Thanks!

    • antonio August 29, 2013 at 7:43 am #

      you must add a widget ( in Appearance->Widgets ) to see decent comments.
      Decent Comments Manual can help you.

  4. Andrew September 2, 2013 at 6:54 pm #

    There is a slight error in the comment renderer; where the output should say ‘(User) on (Article)’ it instead drops the space before ‘on’ and hence reads, “useron articlename”.

    I have fixed this by adding a comma in the comment renderer file.
    ie. ‘, on ‘

    Hope this helps. For your interest this is used on this charitable site

    • antonio September 2, 2013 at 7:40 pm #

      Hi, we will review it, thanks for the feedback.

  5. simon stanbridge September 25, 2013 at 8:54 am #


    Great plugin by the way. Just one thing. I use WP Content Filter to remove bad words from my site. What is the best way to make Decent Comments also filter bad words?

    I have achieved this by changing decent-comments/class-decent-comments-renderer.php from

    return $output;


    return pccf_filter($output);

    But is there a better way to do this? Maybe by adding something to functions.php?

    I’m new to WP so please excuse my lack of knowledge. Hope you can help.


    • antonio September 26, 2013 at 6:58 am #

      right now it’s a good solution, but we will consider add a filter for future updates,

  6. Sebastian September 25, 2013 at 9:13 am #

    Hi! First of all, your Plugin “Decent-Comments” is pretty cool. But I have a self hosted Blog and I want to use the WordPress App for Android to reply to the incoming comments. Is there a problem with the Plugin? Replying on my own blog doesn’t work. But on other Blogs it’s no problem… Any suggestions? Thanks for the help πŸ™‚

    • antonio September 25, 2013 at 2:07 pm #

      there should be no problem. You can disable this plugin, and try the app again. If the problem persist, this plugin doesn’t generate the conflict.

  7. raiden September 28, 2013 at 11:52 am #

    Put a options with max letters not words because people are spaming.Here is a example yooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo this is only 1 word but if world be something like max letters let say 10 yoooooooo… this would show up.

    • kento September 28, 2013 at 12:14 pm #

      Good point πŸ™‚ Note taken, although if you’re able to add that option and submit a patch it can be added sooner πŸ˜‰

  8. raiden September 28, 2013 at 12:31 pm #

    Sorry I don’t know php but I can translate your plugin in my language.Can you let a email where I can submit the files?

    • kento September 28, 2013 at 12:33 pm #

      That would be great, thanks! You can send them to support at itthinx dot com.

  9. raiden September 28, 2013 at 1:14 pm #

    Email send.

  10. Ckubs November 8, 2013 at 11:13 pm #

    Hello. I’m setting up a new theme on my blog wich is focused more on the content and sidebars are quite minimal. I use and love your plugin but now I want to reduce some wasted space by removing my comments(author) from the list. Is there any way I can do that by user ID, email or donno? Thanks.

    • antonio November 9, 2013 at 7:52 am #

      there isn’t this option, but you can easily customize the plugin.
      In decent-comments/class-decent-comments-render.php you should change:
      At line 290:
      foreach ( $comments as $comment) {

      foreach ( $comments as $comment) {
      if ( $comment->comment_author_email !== "" ) {

      and at line 328, change:



      • Ckubs November 9, 2013 at 11:21 am #

        Thank you so much. That did it πŸ˜€

  11. Mariell November 11, 2013 at 8:30 pm #

    this is exactly what I want to do, but the lines 290 and 328 does not match in my program. I can find “foreach …” etc, but it’s harder with }… Can you please describe the rows above and below?

    • antonio November 12, 2013 at 6:01 am #

      ‘}’ closes the foreach, you should have:
      $output .= '';
      $output .= ''; // .decent-comments

      and will be:
      $output .= '';
      $output .= ''; // .decent-comments


      • Mariell November 12, 2013 at 5:07 pm #

        Perfect, thanks! =)

  12. Peter February 11, 2014 at 10:38 am #

    If I have a site with 2 separate comments one side has red vote comments the other side has blue vote comments is this possible to sort into two groups for one post?

    • kento February 12, 2014 at 7:21 pm #

      I don’t think so, sounds like a specific plugin is handling this for you.

  13. evo2 March 4, 2014 at 5:03 pm #


    I just download and use your widget who is perfect !
    Just one thing : how to deactivate (no show) comments of the author of the blog ?
    Thank you for your answer.

    • kento March 17, 2014 at 11:11 pm #

      Hi, thanks for the suggestion, this has just been added to the latest release. Widgets have the option to ‘Exclude comments from post authors’ and the shortcode can be used like this [decent_comments exclude_post_author="true"].

      • evo2 March 20, 2014 at 9:27 am #

        Very good, I just use it now.
        Thank you to add that !

  14. Betsy March 15, 2014 at 2:45 am #

    Does your plugin have the ability to filter out blog author comments and just show visitor comments? If not, is that a feature you’d consider adding?

    • kento March 17, 2014 at 11:13 pm #

      Hi Betsy, also thanks for suggesting this, a previous recent comment here suggested the same and and update has just been released including this feature – see this response.

      • Betsy March 18, 2014 at 12:14 am #

        Wonderful to hear! I’ll head over to install it right now πŸ™‚

  15. Sonny April 1, 2014 at 7:48 pm #

    Is there a way to indicate when the comment was made, e.g., 5 hours ago?

    • kento April 1, 2014 at 10:41 pm #

      Hm, I don’t think so. It would have to be customized I suppose (or someone supply a patch for that and I’d be happy to include it).

  16. Shreya April 9, 2014 at 8:16 am #

    Hi there , I want to display 10 to 15 recent comments. I just see recent comments made on current post. I want it to show 15 recent comments regardless post

    • antonio April 9, 2014 at 12:39 pm #

      if you leave empty the “Post ID” field, Comments should be displayed regardless actual post.

  17. Emmanuel Carrizo June 18, 2014 at 10:18 pm #

    testing it

    • kento June 19, 2014 at 8:18 pm #

      Thanks, feel free to let us know how you like it πŸ™‚

  18. Keith August 25, 2014 at 4:41 pm #


    I just did a plug update (Version 1.3.4) and now I get: Parse error: syntax error, unexpected T_PAAMAYIM_NEKUDOTAYIM in /home/content/43/5150543/html/divhut/wp-content/plugins/decent-comments/class-decent-comment.php on line 307

    It was a great plugin but I removed it since it dowsn’t work anymore. Please help.

    • kento August 28, 2014 at 5:14 pm #

      Hi Keith, thanks for pointing that out. It’s been fixed in the latest release.

  19. Jordan October 2, 2014 at 7:42 pm #

    Great plugin.

    I’m trying to use it to display the newest comment from each section on the homepage of my site, and for the most part it’s working well. The only problem I’m encountering is that it doesn’t seem to represent new lines within the comments. Is there somewhere I can just drop an nl2br() within your code?


    • kento October 7, 2014 at 5:05 pm #

      Thanks Jordan πŸ™‚

      What it does is present an excerpt of the comment, i.e. it will show the start of the comment based on the settings. Have a look at the strip_tags, excerpt etc. attributes in the manual, if you adjust these you should be able to see the comments with the new lines, although I would recommend to have your comments filtered and reviewed before they are displayed.

      • Jordan October 7, 2014 at 6:17 pm #

        Thanks for getting back to me. My current shortcode is:
        [decent-comments number="1" excerpt="false" show_avatar="false" post_id="103" strip_tags="false"] (for example).

        While it is displaying the full comment, it is still stripping s/not converting them from new lines.

        • kento October 7, 2014 at 6:30 pm #

          You’re welcome, Jordan πŸ™‚ You’re right, the shortcode looks ok as you are using it but note that it won’t convert the line breaks.

          • Jordan October 7, 2014 at 8:24 pm #

            So… I’ve tried editing decent-comments/class-decent-comments-renderer.php

            I modified this section:
            if ( $show_comment ) {
            $output .= ”;
            $output .= self::get_comment( $comment, array( “ellipsis” => $ellipsis, “excerpt” => $excerpt, “max_excerpt_words” => $max_excerpt_words, “max_excerpt_characters” => $max_excerpt_characters ) );
            $output .= ”; // .comment-body or .comment-excerpt

            To be:
            if ( $show_comment ) {
            $output .= ”;
            $output .= nl2br(self::get_comment( $comment, array( “ellipsis” => $ellipsis, “excerpt” => $excerpt, “max_excerpt_words” => $max_excerpt_words, “max_excerpt_characters” => $max_excerpt_characters ) ));
            $output .= ”; // .comment-body or .comment-excerpt

            … but it’s still not adding the br’s. Any ideas?

            • antonio October 15, 2014 at 7:34 am #

              this is not the best practice .. but you can change:
              $content = $comment->comment_content;
              in line 147, to:
              $content = nl2br($comment->comment_content);
              Remember that when you update the plugin, this change will be lost.

  20. JanK. October 12, 2014 at 11:57 am #

    Hi there,

    I really like this plugin. I just have on idea: Can you make option to add link to comment to author’s name – so when I click on author it will take me to his comment? I know i can have link next to it (author on that or that page), but this would be better for me…


    • kento October 22, 2014 at 7:35 pm #

      Hi, many thanks for the idea, sounds good and has been added to its feature requests. Cheers

      • JanK. November 3, 2014 at 8:10 am #

        Great to hear. Do you have any ETA for this feature?

        • kento November 3, 2014 at 1:31 pm #

          Not yet πŸ™‚

  21. Mike October 31, 2014 at 5:49 pm #

    Hi, and thank you for your nice plugins. I am currently restricting user access to certain parts of my blog through your excellent Groups plugin. Now I would like to show recent comments based on user privileges (Groups settings). So that users that are not logged in or doesn’t have the correct level can not see recent comments in private areas of the blog. Is this already possible with this plugin and I have simply missed it? Otherwise, could you add support for it or give a hint on how to modify the code myself?

    Thank you

    • kento November 3, 2014 at 1:33 pm #

      Hi Mike,

      Many thanks for your kind comment πŸ™‚ Wouldn’t Groups Restrict Comments Pro be suitable for what you have in mind?


      • Mike November 4, 2014 at 3:55 pm #

        Hi Kento,
        thanks for your reply. I would be happy to buy your plugin but I can’t see that it restricts the list of recent comments. Is there a trial version available?

        • kento November 4, 2014 at 8:25 pm #

          Hi Mike,

          As long as the comments are retrieved through WordPress’ functions so that the access restrictions are effective, they would only appear to authorized group members – so normally it would also restrict the recent comments. There’s no trial version available but we can grant refunds where it doesn’t fit in the setup (see terms).


  22. budditbud January 5, 2015 at 1:41 pm #


    It will be interesting to have possibility to add ‘date’ of comment like we have author and/or avatar today.
    check box for date
    if checked, make choice for format of this date : DD/MM/YYYY, monday 5 january, MM/DD/YYYY HH:MM, …..

    thanks a lot


    • antonio January 7, 2015 at 10:21 am #

      Hi, thanks for the feedback, we will consider it.

      • Mister WP November 28, 2015 at 6:15 pm #

        Sorry for spam. It’s me again. Found it here :

        It’s show_date=true !

        Thank you for your wonderful plugin. Will write something about it in a futur post of my french blog.

        Would be great too to separate date (day) from time (hour and minutes) (show_date, show_time). I will check if I can write a filter in my functions file and wait for it πŸ™‚ See ya !

        • antonio December 1, 2015 at 11:44 am #

          Thanks Mister WP,
          Kind Regards,
          Antonio B.

    • Mister WP November 28, 2015 at 6:02 pm #

      I join the request formulated 10 months ago. It would be a must to show the dates of the last comments.

    • Mister WP November 28, 2015 at 6:08 pm #

      Update : Hello again ! I just seen in your changelog “* Added the option to show date and time of comments”. I’m a shortcode user and I don’t see the attribute to use in your doc : maybe it needs an update ?

      Thanks a lot !

  23. Peggy March 13, 2015 at 10:44 pm #

    Thanks for the plugin – works great. One question: How do I get line breaks to display in the comment? Right now comments show in one big “blob”.

    • antonio March 17, 2015 at 6:43 am #

      Hi Peggy,
      probably your ‘blob’ effect is caused by your theme. You can customize your css to add line breaks.

  24. Abimar May 1, 2015 at 5:43 am #

    Great plugin!

    Here’s a feature I would like: To display the commenter’s — First_Name – or First_Name Last_Name – rather than default User Name. Most of my users have their email addresses as user names and I would prefer those not be displayed. I have created a filter for the comments that display on the pages to address that, but it doesn’t seem to carry over to the widget.

  25. Sally Oh August 2, 2015 at 3:08 pm #

    I don’t have any options for the settings on my Decent Comments plugin. Where do I find those? On the Settings page, I can “Delete settings when the plugin is deactivated” but that’s the only setting… Where do I find the other settings?

    • antonio August 3, 2015 at 7:09 am #

      Hi Sally Oh,
      you have the options available on the widget. When you add the widget (in Appearance->Widgets) you’ll see them.
      Antonio B.

  26. jeff October 30, 2015 at 8:57 pm #

    I really like this plugin. I would like to remove the bullets from the comments and align the text to the left. Is there some CSS code for this?

    Thanks for all your god work.


    • antonio November 2, 2015 at 8:14 am #

      Hi Jeff,
      you need to use CSS to customize your widget. It depends of your theme.
      Kind Regards,
      Antonio B.

      • jeff November 2, 2015 at 10:09 am #

        I’ve tried CSS. do you know where i could fin the code on the widget files?



        • antonio November 4, 2015 at 4:40 pm #

          you can use ex. firebug to see your website code.
          Here an example:

          Kind Regards,
          Antonio B.

          • jeff November 4, 2015 at 7:25 pm #

            Ok, great! I found the code and even edited it to remove the bullet and indent. But how do I save those changes?


  27. jeff November 4, 2015 at 7:43 pm #

    i figured it out. From the developer tools/inspector, i found the navbox #. Then, in the editor, i added the following

    #navboxnumber ul { list-style-type: none;

    Thanks for the push!


    • antonio November 5, 2015 at 7:50 am #

      Yes, you can add this code in your style.css child theme file.
      Kind Regards,
      Antonio B.

  28. Wil Ransz November 30, 2015 at 4:00 pm #


    Just switched to Decent Comments and created Dutch languages files (PO and MO) for the plugin. Are you interested to include these Dutch with the plugin?

    BTW, I noticed that the string “Show date” is missing from the .pot file.

    Keep up the good work,

    Wil Ransz

    • antonio December 1, 2015 at 11:15 am #

      Hi Wil,
      Sure, please send us the translation to itthinx at itthinx dot com.
      Thank you so much !
      Antonio B.

  29. Christian N December 15, 2015 at 4:55 pm #


    I run a swedish website and would like to customize the widget so that it doesn’t use the word “on” when it refers to a commenter (for instance “Andreas on Claes Grundsten bloggar: Sachiska Schweiz – grΓ€nslΓΆs pΓ€rla” Instead I want to replace it with “om” (the swidish word for “about”).

    Best regards

    Christian N

    • antonio December 16, 2015 at 9:40 am #

      Hi Christian,
      you can use the .po translation files to customize this. You should have a ‘ on %s’, if you translate it to ‘ %s’ should work.
      Kind Regards,
      Antonio B.

  30. Patrick Dankers May 10, 2016 at 7:35 pm #

    Hi there,

    I noted a issue with making changes to the class-decent-comments-renderer.php file in regard to adding json-ld microdata to it for each comment. Also see;

    Hope you can help me in any way so I can also get Decent Comments working with nice JSON-LD microdata.
    If you are not familiar with JSON-LD please see;

    Thanks in advance for any assistance!

    Kind regards,

    • Kento June 20, 2016 at 10:35 am #

      Hi Patrick,

      This took a while but I hope it comes in handy. I’ve added a couple of filters to make it easier to customize, related to your post here JSON-lD Microdata.


  31. Troy May 25, 2016 at 7:14 pm #

    Is it possible to show feature image or product image with comment?

    • antonio May 26, 2016 at 5:09 am #

      Hi Troy,
      sorry, this feature is not available.
      Kind Regards,
      Antonio B.

  32. Gateway Man June 4, 2016 at 10:13 am #

    Hello Antonio, any plan to update this plugin. WordPress indicates that it’s 9 months old and may not be compactible with recent version of WP

    • antonio June 6, 2016 at 7:00 am #

      Hi Gateway Man,
      the plugin is compatible and tested with the latest WordPress version.
      Kind Regards,
      Antonio B.

  33. Malte July 18, 2016 at 8:38 am #

    Hey guys,

    i am looking for the setting where I can change the language of the plugin, so it shows things like “posted on” or “posted in” in my language and not english. As far as I can see I have my language pack included in the wordpress decent comments languages folder. But I didn’t find a way to switch languages in the wordpress plugins settings online.

    Would be glad if anyone could help me out. πŸ™‚

    • antonio July 20, 2016 at 7:43 am #

      Hi Malte,
      You don’t need to change the settings. WordPress should get the correct translation file according to the site language.
      In your translation language you should have translated the ‘ on %s’ string. But ‘posted on’ and ‘posted in’ are not in the plugin (please be sure you are using the correct widget).
      Kind Regards,
      Antonio B.

  34. brightisland October 6, 2016 at 8:12 pm #

    This is a great plugin. I have one request, though, that would make it perfect, and I’d gladly pay for it.

    Could you provide an option to let this plugin create basically a comments loop that will display all comments in a page, or rather a series of pages (with pagination after, say, every 50 comments)?

    We’re using it here right now with a little bit of custom css to make it look the way we want:

    • antonio October 15, 2016 at 8:31 am #

      Hi Sara,
      It seems very good idea. I scored as a possible improvement.
      Antonio B.

Leave a Reply