Mehdi Kabab

This plugin allows to display or retrieve comments posted by a user. In order to avoid homonyms, a user is identified by his name and email(s).
Note: Get Author’s Comments uses the function <a href="https://codex.wordpress.org/Template_Tags/wp_list_comments" rel="nofollow ugc">wp_list_comments</a> introduced by WordPress 2.7 for the (x)HTML output.
<h3>Usage</h3>
<h4>Display all comments of a specific user in the current post</h4>
<pre><code><?php
 <ol>
 <?php ppm_author_comments('piouPiouM', 'foo@example.com'); ?>
 </ol>
?>
</code></pre>
or, if piouPiouM wrote with two different emails:
<pre><code><?php
 <ol>
 <?php ppm_author_comments('piouPiouM', array('foo@example.com', 'bar@example.org')); ?>
 </ol>
?>
</code></pre>
<h4>Display all comments posted by a user</h4>
<pre><code><?php
 <ol>
 <?php ppm_author_comments('piouPiouM', 'foo@example.com', null, 'all=1'); ?>
 </ol>
?>
</code></pre>
<h4>Display comments wrote by a user in the post of ID number 9</h4>
<pre><code><?php
 <ol>
 <?php ppm_author_comments('piouPiouM', 'foo@example.com', 9); ?>
 </ol>
?>
</code></pre>
Note: If you used the tags <code>ppm_author_comments</code> or <code>ppm_get_author_comments</code> whithin <a href="https://codex.wordpress.org/The_Loop" title="The Loop « WordPress Codex" rel="nofollow ugc">The Loop</a>, the parameter <code>$postID</code> will be replaced automatically by the numeric ID of the current post.
<h4>Lastest comments ordered by post_ID</h4>
To show the last ten piouPiouM’s comments sorted by post_ID in ascending order, the following will display their comment date and excerpt:
<pre><code><?php
 $comments = ppm_get_author_comments('piouPiouM', 'foo@example.com', null, 'number=10&order=ASC&orderby=post_id');
 foreach ($comments as $comment):
?>
<cite><?php comment_author_link() ?></cite> says:
<ol>
 <li>
 Comment posted on <?php comment_date('n-j-Y'); ?>: 
 <?php comment_excerpt(); ?>
 </li>
</ol>
<?php endforeach; ?>
</code></pre>
<h4>Comments with a custom comment display</h4>
<pre><code><?php
 <ol>
 <?php ppm_author_comments('piouPiouM', 'info@example.com', null, 'callback=mytheme_comment'); ?>
 </ol>
?>
</code></pre>
See <a href="https://codex.wordpress.org/Template_Tags/wp_list_comments#Comments_Only_With_A_Custom_Comment_Display" title="Template Tags/wp list comments « WordPress Codex" rel="nofollow ugc">Comments Only With A Custom Comment Display</a> for an example of a custom callback function.
<h4>Show the total number of comments posted by a user on the site</h4>
<pre><code><?php
 get_currentuserinfo();
 $comments = ppm_get_author_comments($current_user->display_name, $current_user->user_email, null, 'all=1');
 printf('Hello ! <a href="/author/%s/">%s</a>! '
 . '[ <a href="%s" class="logout">Log Out</a> ] '
 . '%d posts and %d comments',
 $current_user->user_login,
 $current_user->display_name,
 wp_logout_url(),
 get_usernumposts($current_user->ID),
 count($comments));
?><h3>Parameters</h3>
</code></pre>
all 
(boolean) (optional) Retrieve all comments. Default to FALSE.
number 
(integer) (optional) Number of comments to return. Default to None, returns all comments.
offset 
(integer) (optional) Offset from latest comment. Default to 0.
orderby 
(string) (optional) Sort posts by one of various values (separated by space), including:
<ul>
<li><code>'comment_ID'</code> – Sort by numeric comment ID.</li>
<li><code>'content'</code> – Sort by content.</li>
<li><code>'date'</code> – Sort by creation date. (Default)</li>
<li><code>'post_ID'</code> – Sort by post ID.</li>
<li><code>'rand'</code> – Sort in random order.</li>
<li><code>'status'</code> – Sort by status.</li>
<li><code>'type'</code> – Sort by type.</li>
</ul>
order 
(string) (optional) Sort order, ascending or descending for the orderby parameter. Valid values:
<ul>
<li><code>'ASC'</code> – Ascending (lowest to highest).</li>
<li><code>'DESC'</code> – Descending (highest to lowest). (Default)</li>
</ul>
output 
(string) (optional) How you’d like the result. Only for <code>ppm_get_author_comments</code>.
<ul>
<li><code>OBJECT</code> – Returns an object. (Default)</li>
<li><code>ARRAY_A</code> – Returns an associative array of field names to values.</li>
<li><code>ARRAY_N</code> – Returns a numeric array of field values.</li>
<li><code>HTML</code> – Returns a (x)HTML version generated by <a href="https://codex.wordpress.org/Template_Tags/wp_list_comments" rel="nofollow ugc">wp_list_comments</a>.</li>
</ul>
status 
(string) (optional) The comments status. Default to hold and approve. Valid values:
<ul>
<li><code>'hold'</code> – Unapproved.</li>
<li><code>'approve'</code> – Approved.</li>
<li><code>'spam'</code> – Spam.</li>
</ul>

Get Author's Comments

Get Author's Comments displays or retrieves a list of comments posted by a user.

Bernhard Riedl

<ul>
<li>extends information on Users page in Admin Menu with comment counts</li>
<li>settings page configurable for standard functions</li>
<li>easy to integrate (ships with multi/sidebar- and dashboard-widget functionality)</li>
<li>possible to integrate in “Right Now” box or to display as widget on the dashboard and on the user’s profile page</li>
<li>high performance because users’ comment counts are re-used within a page-call</li>
<li><a href="https://wordpress.org/plugins/featuring-countcomments/other_notes/" rel="ugc">API for developers</a></li>
<li>fully compatible with <a href="https://codex.wordpress.org/Administration_Over_SSL" rel="nofollow ugc">https/SSL/TLS-sites</a></li>
<li>fully multisite network compatible</li>
<li>clean uninstall</li>
</ul>
Requirement for this plugin: Your users have to be registered and logged in to comment – Thus, Featuring CountComments will not work properly in weblogs where anonymous comments are allowed!
Please find the version for WordPress
<ul>
<li>3.3 and higher <a href="https://downloads.wordpress.org/plugin/featuring-countcomments.zip" rel="nofollow ugc">here</a></li>
<li>3.2 <a href="https://downloads.wordpress.org/plugin/featuring-countcomments.wordpress3.2.zip" rel="nofollow ugc">here</a></li>
<li>2.8 to 3.1 <a href="https://downloads.wordpress.org/plugin/featuring-countcomments.wordpress2.8-3.1.zip" rel="nofollow ugc">here</a></li>
<li>minor 2.8 <a href="https://downloads.wordpress.org/plugin/featuring-countcomments.wordpressminor2.8.zip" rel="nofollow ugc">here</a></li>
</ul>
Plugin’s website: <a href="https://www.bernhard-riedl.com/projects/" rel="nofollow ugc">https://www.bernhard-riedl.com/projects/</a>
Author’s website: <a href="https://www.bernhard-riedl.com/" rel="nofollow ugc">https://www.bernhard-riedl.com/</a> 
Attention! – Geeks’ stuff ahead! 😉
<h4>API</h4>
Parameters can either be passed <a href="https://codex.wordpress.org/Function_Reference/wp_parse_args" rel="nofollow ugc">as an array or a URL query type string (e.g. “display=0&format=0”)</a>. Please note that WordPress parses all arguments as strings, thus booleans have to be 0 or 1 if used in query type strings whereas for arrays <a href="https://secure.php.net/manual/en/language.types.boolean.php" rel="nofollow ugc">real booleans</a> should be used.
<code>$featuring_countcomments->count_by_user($params=array())</code>
Counts the number of comments made by a user who is currently logged in or has a particular attribute.
$params:
<ul>
<li>
<code>user_attribute</code>: one of the user’s attributes (matching <code>query_type</code>), for example, the user_id or a WP_User object; if no user_attribute is given, will fallback to currently logged in user
</li>
<li>
<code>query_type</code>: corresponding SQL-field of user’s attribute or WP_User object; default is <code>user_id</code>
<ul>
<li>user_id</li>
<li>display_name</li>
<li>user_nicename</li>
<li>user_email</li>
<li>user_login</li>
<li>WP_User object</li>
</ul>
</li>
<li>
<code>format</code>: if set to true (default), the output will be formatted using the attributes <code>zero</code>, <code>one</code>, <code>more</code> and <code>thousands_separator</code>; false = process plain count value
</li>
<li>
<code>zero</code>, <code>one</code>, <code>more</code>: for formatted output – %c gets replaced with the number of comments
<ul>
<li>‘zero’ => ‘0 comments’</li>
<li>‘one’ => ‘1 comment’</li>
<li>‘more’ => ‘%c comments’</li>
</ul>
</li>
<li>
<code>thousands_separator</code>: divides counts by thousand delimiters; default <code>,</code> => e.g. 1,386
</li>
<li>
<code>display</code>: if you want to return the count (e.g. for storing it in a variable) instead of echoing it with this function-call, set <code>display</code> to <code>false</code>; default setting is <code>true</code>
</li>
</ul>
The following example outputs the comment count of the user with the registered e-mail address ‘j.doe@example.com’.
<pre><code><?php

global $featuring_countcomments;

$params=array(
 'query_type' => 'user_email',
 'user_attribute' => 'j.doe@example.com'
);

$featuring_countcomments->count_by_user($params);

?>
</code></pre>
<code>$featuring_countcomments->count_by_comment($params=array())</code>
Counts the number of comments made by a user who wrote a certain comment or the current comment in the comment-loop.
$params:
<ul>
<li>
<code>comment</code>: a comment object or comment id; if empty retrieves current comment
</li>
<li>
<code>format</code>: if set to true (default), the output will be formatted using the attributes <code>zero</code>, <code>one</code>, <code>more</code> and <code>thousands_separator</code>; false = process plain count value
</li>
<li>
<code>zero</code>, <code>one</code>, <code>more</code>: for formatted output – %c gets replaced with the number of comments
<ul>
<li>‘zero’ => ‘0 comments’</li>
<li>‘one’ => ‘1 comment’</li>
<li>‘more’ => ‘%c comments’</li>
</ul>
</li>
<li>
<code>thousands_separator</code>: divides counts by thousand delimiters default <code>,</code> => e.g. 1,386
</li>
<li>
<code>display</code>: if you want to return the count (e.g. for storing it in a variable) instead of echoing it with this function-call, set <code>display</code> to <code>false</code>; default setting is <code>true</code>
</li>
<li>
<code>in_loop</code>: if set to true (default), the query count for all user who wrote a comment which belongs to the post of the handed over <code>comment</code> will be cached; otherwise the comment count will be retrieved only for the user who posted the <code>comment</code>
</li>
</ul>
The following example outputs the number of comments of the author with the current comment in the comment loop:
<pre><code><?php

global $featuring_countcomments;

$featuring_countcomments->count_by_comment();

?>
</code></pre>
<h4>Shortcodes</h4>
<a href="https://codex.wordpress.org/Shortcode_API" rel="nofollow ugc">How-to for shortcodes</a>
General Example:
Enter the following text anywhere in a post or page to output the comment count of user <code>xyz</code>:
<pre><code>[featuring_countcomments_count_by_user query_type="user_nicename" user_attribute="xyz"] by xyz so far...
</code></pre>
Available Shortcode:
<pre><code>featuring_countcomments_count_by_user
</code></pre>
Invokes <code>$featuring_countcomments->count_by_user($params)</code>.
<pre><code>featuring_countcomments_count_by_comment
</code></pre>
Invokes <code>$featuring_countcomments->count_by_comment($params)</code>.
<h4>Filters</h4>
<a href="https://codex.wordpress.org/Function_Reference/add_filter" rel="nofollow ugc">How-To for filters</a>
General Example:
<pre><code>function my_featuring_countcomments_defaults($params=array()) {
 $params['query_type'] = 'user_nicename';
 return $params;
}

add_filter('featuring_countcomments_defaults', 'my_featuring_countcomments_defaults');
</code></pre>
Available Filters:
<pre><code>featuring_countcomments_defaults
</code></pre>
In case you want to set the default parameters globally rather than handing them over on every function call, you can add the <a href="https://codex.wordpress.org/Function_Reference/add_filter" rel="nofollow ugc">filter</a> <code>featuring_countcomments_defaults</code> in for example featuring-countcomments.php or your <a href="https://codex.wordpress.org/Writing_a_Plugin" rel="nofollow ugc">own customization plugin</a> (recommended).
Please note that parameters which you hand over to a function call (<code>$featuring_countcomments->count_by_user</code> or <code>$featuring_countcomments->count_by_comment</code>) will always override the defaults parameters, even if they have been set by a filter or in the admin menu.
<pre><code>featuring_countcomments_dashboard_widget
</code></pre>
Receives an array which is used for the dashboard-widget-function call to <code>$featuring_countcomments->count_by_user</code>. <code>display</code> and <code>format</code> will automatically be set to true and <code>user_parameter</code> to null to receive the current user’s count.
<pre><code>featuring_countcomments_dashboard_widget_text
</code></pre>
Receives a string which is used in the dashboard-widget. <code>%c</code> will be replaced by the comment count of the user who is currently logged in.
<pre><code>featuring_countcomments_dashboard_right_now
</code></pre>
Receives an array which is used for the dashboard-right-now-box-function call to <code>$featuring_countcomments->count_by_user</code>. <code>display</code> and <code>format</code> will automatically be set to true and <code>user_parameter</code> to null to retrieve the comment count of currently logged in user.
<pre><code>featuring_countcomments_dashboard_right_now_text
</code></pre>
Receives a string which is used in the right-now box on the dashboard. <code>%c</code> will be replaced by the comment count of the user who is currently logged in.
<pre><code>featuring_countcomments_user_profile
</code></pre>
Receives an array which is used for the user-profile-function call to <code>$featuring_countcomments->count_by_user</code>. <code>display</code> and <code>format</code> will automatically be set to true and <code>user_parameter</code> to null to retrieve the comment count of currently logged in user.
<pre><code>featuring_countcomments_user_profile_text
</code></pre>
Receives a string which is used in the user’s profile page. <code>%c</code> will be replaced by the comment count of the user who is currently logged in.
<pre><code>featuring_countcomments_users_custom_column
</code></pre>
Receives an array which is used for the users-page-function call to <code>$featuring_countcomments->count_by_user</code>. <code>display</code> and <code>format</code> will automatically be set to true and <code>user_parameter</code> to the user-id of each row to retrieve the user’s comment count.

Featuring CountComments

Counts the number of comments for each user, who has been logged in at the time of commenting.

Get Author's Comments vs Featuring CountComments