Package/plugin/module WordPress

Customizable Comment Listings v2.0

I’d like to announce the official release of the updated Customizable Comment Listings plugin (v2.0) for WordPress.

Display Recent Comments, Pingbacks, and/or Trackbacks, Top Commenters, or Recent Commenters, and use the comment, commenter, and/or post information of your choosing to customize the how they are listed. You can narrow comment searches by specifying post IDs, comment types, and/or comment status, among other things.

The plugin’s official homepage is located at :

This release introduces 23 new percent-substitution tag! Options are now stored in the database and configurable via the plugin’s new admin options page. The plugin has more documentation, included in its readme.txt file and on its admin options page. The release also brings with it full compatibility with WordPress 2.3+ and 2.5 (and dropping support for any earlier versions).

This update is part of coffee2code’s 14 Days of Plugins (updated plugin #11).

Comments welcome on this post for this version of the plugin. Comments will be closed once this release has been superseded by another.

Read more for a detailed ChangeLog of the release.

Detailed ChangeLog

These are the detailed changes, which may or may not make sense to you depending on your familiarity with the previous features and internals of the plugin.

  • Added admin options page under Options -> CCL (or in WP 2.5: Settings -> CCL).
  • Formatting options are now saved to database, negating need to customize code within the plugin source file.
  • Admin options page also includes a listing and explanation of all percent-substitution tags, template functions, and their arguments
  • Introduced the following 23 new percent-substitution tags:
    • %comment_agent%
    • %comment_content%
    • %comment_karma%
    • %post_author_description%
    • %post_author_email%
    • %post_author_firstname%
    • %post_author_id%
    • %post_author_lastname%
    • %post_author_login%
    • %post_author_nickname%
    • %post_categories%
    • %post_categories_URL%
    • %post_content_full%
    • %post_content_upto_more%
    • %post_excerpt_full%
    • %post_guid%v
    • %post_lat%
    • %post_lon%
    • %post_name%
    • %post_tags%
    • %post_tags_URL%
    • %post_type%
    • %post_URL_short%
    • c2c_get_recent_comments_tagmap() now optionally echoes the string it creates via optional argument $echo (defaulted to false)
    • c2c_get_recent_comments_tagmap() now returns the number of posts listed if $echo is true, otherwise it returns the string it would’ve echoed
    • Removed pre-WordPress2.3 support
    • WP2.x+ compatibility changes/improvements including: triggering of new filters and using newer stock accessor functions.
    • Changed description
    • Added compatibility note
    • Updated copyright date and version to 2.0
    • Added readme.txt and screenshots
    • Tested compatibility with WP 2.3.3 and 2.5

10 replies on “Customizable Comment Listings v2.0”

Hmm, I attached a fourth screenshot to the plugin’s home page showing what the plugin’s admin page looks like under WP 2.5. Anyone else not seeing the plugin’s options page under Settings -> CCL in WP 2.5?

Are you the admin for the blog? The settings page is only set to show for admin level users… In the plugin file, look for add_options_page( and change its argument of 9 to something like 1 or 2 and see if it starts showing up for you…

Nicely done! I had no problems installing it on 2.5. But I was wondering if there’s an option to just show the latest comment count on a post, and not have it repeat on the list? I’d like to use it to show the latest activity on the top of the list (with comment count) without seeing multiple references to the same post. I looked at the different options but can’t figure out if any of those will do that. In any case, thanks for all your work, your plugin is one of my favorites!

In the settings’ admin panel for this p-lugin, everything looks just like your screenshot except under the sentence that says:

For help, see the Percent-substitution tags section for a listing and explanation of all the percent-substitution format tags or the Template functions section for an explanation of the template functions and their arguments.

it says:

Warning: implode() [function.implode]: Bad arguments. in (my path to WordPress) /wp-content/plugins/customizable-comment-listings/customizable-comment-listings.php on line 207

Hi, the new plugin works fine, but i have one error in the

Customizable Comment Listings Plugin Options Adminpage:

Warning: implode() [function.implode]: Bad arguments. in /…/plugins/customizable-comment-listings/customizable-comment-listings.php on line 207

El Chavo: You probably want to use the template function c2c_get_recently_commented() found in the Customizable Post Listings plugin. That lists posts by the most recently commented (so each post will only appear once).

Edith: Thanks for the report. I’m not familiar with the auto-updater plugin, so I’m not sure where it got the wrong info to update CCL, but I’ll look into it.

Paul, MacTV: I had just recently noticed and fixed that bug, but haven’t released it yet. Sit tight; it’ll be the first thing I release after the 14 Days are over (so the update should be this Monday).

nice work! two questions:

– can i somehow include gravatars for the comments?
– can i somehow use the username instead of the full name of the commenter? (that is not the same as nick name…)

I’m trying to create a list of recent commenters and display their avatars only… Here is my code:

      $getgravatar = get_avatar( get_comment_author_email(), '50' );
      $specialformat = '<li><a href="%comment_author_url%" title="We think %comment_author% is sexy!">'.$getgravatar.'</a></li>';
        $limit = 12,
        $format = $specialformat,
        $types = 'comment',
        $status = '1',
        $ids = '',
        $order = 'DESC',
        $offset = 0,
        $date_format = 'm/d/Y'
      ); ?>

It’s working sortof… It’s retreiving the most recent commenters, but it’s only displaying ONE avatar for all of them. Am I doing something wrong here?

Comments are closed.