comments_popup_link( false|string $zero = false, false|string $one = false, false|string $more = false, string $css_class = '', false|string $none = false )
Displays the link to the comments for the current post ID.
Parameters Parameters
- $zero
-
(false|string) (Optional) String to display when no comments.
Default value: false
- $one
-
(false|string) (Optional) String to display when only one comment is available.
Default value: false
- $more
-
(false|string) (Optional) String to display when there are more than one comment.
Default value: false
- $css_class
-
(string) (Optional) CSS class to use for comments.
Default value: ''
- $none
-
(false|string) (Optional) String to display when comments have been turned off.
Default value: false
Source Source
File: wp-includes/comment-template.php
function comments_popup_link( $zero = false, $one = false, $more = false, $css_class = '', $none = false ) { $post_id = get_the_ID(); $post_title = get_the_title(); $number = get_comments_number( $post_id ); if ( false === $zero ) { /* translators: %s: Post title. */ $zero = sprintf( __( 'No Comments<span class="screen-reader-text"> on %s</span>' ), $post_title ); } if ( false === $one ) { /* translators: %s: Post title. */ $one = sprintf( __( '1 Comment<span class="screen-reader-text"> on %s</span>' ), $post_title ); } if ( false === $more ) { /* translators: 1: Number of comments, 2: Post title. */ $more = _n( '%1$s Comment<span class="screen-reader-text"> on %2$s</span>', '%1$s Comments<span class="screen-reader-text"> on %2$s</span>', $number ); $more = sprintf( $more, number_format_i18n( $number ), $post_title ); } if ( false === $none ) { /* translators: %s: Post title. */ $none = sprintf( __( 'Comments Off<span class="screen-reader-text"> on %s</span>' ), $post_title ); } if ( 0 == $number && ! comments_open() && ! pings_open() ) { echo '<span' . ( ( ! empty( $css_class ) ) ? ' class="' . esc_attr( $css_class ) . '"' : '' ) . '>' . $none . '</span>'; return; } if ( post_password_required() ) { _e( 'Enter your password to view comments.' ); return; } echo '<a href="'; if ( 0 == $number ) { $respond_link = get_permalink() . '#respond'; /** * Filters the respond link when a post has no comments. * * @since 4.4.0 * * @param string $respond_link The default response link. * @param int $post_id The post ID. */ echo apply_filters( 'respond_link', $respond_link, $post_id ); } else { comments_link(); } echo '"'; if ( ! empty( $css_class ) ) { echo ' class="' . $css_class . '" '; } $attributes = ''; /** * Filters the comments link attributes for display. * * @since 2.5.0 * * @param string $attributes The comments link attributes. Default empty. */ echo apply_filters( 'comments_popup_link_attributes', $attributes ); echo '>'; comments_number( $zero, $one, $more ); echo '</a>'; }
Expand full source code Collapse full source code View on Trac
Changelog Changelog
Version | Description |
---|---|
0.71 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Load Different CSS classes according to Comment-condition
If you want to load different classes into
comments_popup_link(),
use the following:Expand full source codeCollapse full source code
Text Response for Number of Comments with Localization
Displays the comments popup link, using “No comments yet” for no comments, “1 comment” for one, “% comments” 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.
Text Response for Number of Comments
Displays the comments popup link, using “No comments yet” for no comments, “1 comment” for one, “% comments” 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.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.