Automattic

Alex Mills

Nick Momrik

<p>Creates functions to assist in displaying a list of the most recent comments. Provides more configurability than the widget that comes with WordPress.</p>
<h3>Configuration</h3>
<p>You may pass parameters when calling the function to configure some of the options. Parameters are accepted only in the <a href="https://codex.wordpress.org/How_to_Pass_Tag_Parameters#Tags_with_query-string-style_parameters" rel="nofollow ugc">query-string-style</a>.</p>
<h4>list_most_recent_comments()</h4>
<p>In addition to the parameters that <a href="https://codex.wordpress.org/Function_Reference/get_comments" rel="nofollow ugc">get_comments()</a> and <code>get_most_recent_comments()</code> (see below) accept, this function accepts the following parameters:</p>
<ul>
<li><code>excerpt_words</code> — The number of words from the comment to display</li>
<li><code>excerpt_chars</code> — Or alternately the number of characters from the comment to display</li>
<li><code>comment_format</code> — Allows you to pick from two predefined display formats:</li>
</ul>
<ol>
<li><a href="#commentlink" rel="nofollow ugc">Comment Author</a> on <a href="#postlink" rel="nofollow ugc">Post Title</a></li>
<li><strong>Comment Author:</strong> <a href="#commentlink" rel="nofollow ugc">This is the comment excerpt</a></li>
</ol>
<p>Example:</p>
<pre><code><?php list_most_recent_comments( 'excerpt_words=5' ); ?>
</code></pre>
<h4>get_most_recent_comments()</h4>
<p>A more powerful version of <a href="https://codex.wordpress.org/Function_Reference/get_comments" rel="nofollow ugc">get_comments()</a>. It accepts the same parameters as well as the following ones:</p>
<ul>
<li><code>passworded_posts</code> — Boolean to control showing comments on passworded posts or not. Defaults to <code>false</code>.</li>
<li><code>showpings</code> — Boolean to control showing pings and trackbacks or not. Defaults to <code>false</code>.</li>
<li><code>post_types</code> — Array of post types to include comments from. Defaults to posts and pages: <code>array( 'post', 'page' )</code></li>
<li><code>post_statuses</code> — Array of post statuses to include comments from.  Defaults to published posts and static pages: <code>array( 'publish', 'static' )</code></li>
</ul>
<p>Arguments should likely be passed as an array instead of a string.</p>
<p>Example:</p>
<pre><code><?php

list_most_recent_comments( array(
    'showpings' => true,
    'post_types' => array( 'post', 'page', 'foobar' ),
) );

?>
</code></pre>


Recent Comments

Creates functions to assist in displaying a list of the most recent comments.

<p>Retrieves a list of the most recent posts.</p>
<h3>Configuration</h3>
<p>You may pass parameters when calling the function to configure some of the options.<br />
Example: <code>mdv_recent_posts(10, '', '<br />', true, 5, false, false)</code></p>
<p>The parameters:<br />
$no_posts – sets the number of recent posts to display<br />
$before – text to be displayed before the link to the recent post<br />
$after – text to be displayed after the link to the recent post<br />
$hide_pass_post – whether or not to display password protected posts<br />
$skip_posts – allows skipping of a number of posts before showing the number of posts specified with the $no_posts parameter<br />
$show_excerpts – allows the post excerpt to be output after the post title<br />
$include_pages – allows recent pages to be show with recent posts</p>
<h3>Version History</h3>
<p>1.1.2 – Added a space before rel=”bookmark”<br />
1.1.3 – Fix the space for real. Props Sandro Bonazzola<br />
1.2   – Use the esc_* functions and cleanup coding standards</p>


Recent Comments vs Recent Posts