Creates functions to assist in displaying a list of the most recent comments.
Creates functions to assist in displaying a list of the most recent comments. Provides more configurability than the widget that comes with WordPress.
You may pass parameters when calling the function to configure some of the options. Parameters are accepted only in the query-string-style.
In addition to the parameters that get_comments() and get_most_recent_comments()
(see below) accept, this function accepts the following parameters:
excerpt_words
— The number of words from the comment to displayexcerpt_chars
— Or alternately the number of characters from the comment to displaycomment_format
— Allows you to pick from two predefined display formats:Example:
<?php list_most_recent_comments( 'excerpt_words=5' ); ?>
A more powerful version of get_comments(). It accepts the same parameters as well as the following ones:
passworded_posts
— Boolean to control showing comments on passworded posts or not. Defaults to false
.showpings
— Boolean to control showing pings and trackbacks or not. Defaults to false
.post_types
— Array of post types to include comments from. Defaults to posts and pages: array( 'post', 'page' )
post_statuses
— Array of post statuses to include comments from. Defaults to published posts and static pages: array( 'publish', 'static' )
Arguments should likely be passed as an array instead of a string.
Example:
<?php list_most_recent_comments( array( 'showpings' => true, 'post_types' => array( 'post', 'page', 'foobar' ), ) ); ?>
<?php list_most_recent_comments(); ?>
to your theme.get_comments()
instead of a direct database query.