WordPress:Template Tags/comments popup link
Description
Displays a link to the comments popup window if comments_popup_script() is used, otherwise it displays a normal link to comments. This tag must be within WordPress:The Loop, or a comment loop, and it does nothing if is_single() or is_page() is true (even when within WordPress:The Loop).
Usage
%%% <?php comments_popup_link ('zero','one','more','CSSclass','none'); ?> %%%
Examples
Text Response for Number of Comments
Displays the comments popup link, using "No comments yet" for no comments, "1 comment so far" for one, "% comments so far (is that a lot?)" for more than one (% replaced by # of comments), and "Comments are off for this post" if commenting is disabled. Additionally, 'comments-link' is a custom CSS class for the link.
<p><?php comments_popup_link('No comments yet', '1 comment so far', '% comments so far (is that a lot?)', 'comments-link', 'Comments are off for this post'); ?></p>
Hide Comment Link When Comments Are Deactivated
Hides the paragraph element <p></p> that contains the comments_popup_link when comments are deactivated in the Write>Post screen. Good for those who want enable/disable comments post by post. Must be used in the loop.
<?php if ( comments_open() ) : ?>
<p>
<?php comments_popup_link( 'No comments yet', '1 comment', '% comments so far', 'comments-link', 'Comments are off for this post'); ?>
</p>
<?php endif; ?>
Parameters
- zero
- (string) Text to display when there are no comments. Defaults to 'No Comments'.
- one
- (string) Text to display when there is one comment. Defaults to '1 Comment'.
- more
- (string) Text to display when there are more than one comments. '%' is replaced by the number of comments, so '% so far' is displayed as "5 so far" when there are five comments. Defaults to '% Comments'.
- CSSclass
- (string) CSS (stylesheet) class for the link. This has no default value.
- none
- (string) Text to display when comments are disabled. Defaults to 'Comments Off'.