Decent Comments provides the [decent_comments]
shortcode that can be used to embed comments anywhere.
If no attributes are given, the default settings are used.
Usage
Place the following shortcode anywhere on a page to show comments based on the default settings:
[decent_comments]
As an example using customized settings, place the following shortcode anywhere to show 25 comments featuring 64 pixel avatars:
[decent_comments number="25" avatar_size="64"]
Shortcode Attributes
The [decent_comments]
shortcode supports the following attributes.
ellipsis
This is shown after a comment’s excerpt, if there are more words in the comment than shown in the excerpt.
Default : …
exclude
The exclude
parameter allows to exclude comments from one or more posts. Indicate the IDs of the posts separated by comma.
include
The include
parameter allows to show comments from one or more posts. Provide the IDs of the posts separated by comma.
exclude_post_author
Set this to true
if comments on posts from the post’s author should not be included.
Default : false
excerpt
Default : true
max_excerpt_words
Determines up to how many words are shown as an excerpt for each comment.
Default : 20
max_excerpt_characters
Determines up to how many characters are shown as an excerpt for each comment.
Default : 0
strip_tags
Whether HTML tags will be removed or retained in the comment’s excerpt.
Default : true
avatar_size
The avatar size in pixels.
Default : 24
number
The maximum number of comments to show.
Default : 5
orderby
The criterion used to sort comments.
Default : "comment_date_gmt"
Possible values:"comment_author_email"
: Author Email"comment_author_url"
: Author URL"comment_content"
: Content"comment_date_gmt"
: Date"comment_karma"
: Karma"comment_post_ID"
: Post
order
Whether to use ascending or descending order, sorting the comments as per the orderby
given.
Default : "DESC"
Possible values: "ASC"
, "DESC"
post_id
If empty, shows comments from anywhere on your site, based on the criterion chosen. You can enter part of the title of a post or a post’s ID to only show comments related to a specific post. You can enter [current]
or {current}
to show comments for the post that is currently displayed.
Possible values:
"{current}"
: show comments for the current post
Usage:[decent_comments post_id="{current}"]
- a post ID : show comments for a specific post
For example:[decent_comments post_id="123"]
show_author
Default : true
link_author
Whether to link comment authors to their website.
Default : true
show_avatar
Whether to show the avatar of the comment author.
Default : true
show_date
Whether to display the date a comment was posted.
Default : true
show_link
Whether to display a link to the post on which the comment was posted.
Default : true
show_comment
Whether to show the comment.
Default : true
taxonomy
Used to show comments on posts related to certain taxonomies. Use category
for categories or post_tag
for tags.
Default : empty
terms
Used with the taxonomy option, indicate a comma-separated list of term slugs to show comments for all posts related to these terms.
Default : empty
trackback
Whether to include trackbacks.
Default : true
pingback
Whether to include pingbacks.
Default : true