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.

Configuration

You may pass parameters when calling the function to configure some of the options. Parameters are accepted only in the query-string-style.

list_most_recent_comments()

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 display
• excerpt_chars — Or alternately the number of characters from the comment to display
• comment_format — Allows you to pick from two predefined display formats:

1. Comment Author on Post Title
2. Comment Author: This is the comment excerpt

Example:

<?php list_most_recent_comments( 'excerpt_words=5' ); ?>

get_most_recent_comments()

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' ),
) );

?>