W3cubDocs

/WordPress

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

$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

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>';
}

Uses

Uses Description
wp-includes/comment-template.php: respond_link

Filters the respond link when a post has no comments.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/l10n.php: _n()

Translates and retrieves the singular or plural form based on the supplied number.
wp-includes/l10n.php: _e()

Display translated text.
wp-includes/formatting.php: esc_attr()

Escaping for HTML attributes.
wp-includes/functions.php: number_format_i18n()

Convert float number to format based on the locale.
wp-includes/link-template.php: get_permalink()

Retrieves the full permalink for the current post or post ID.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/post-template.php: post_password_required()

Whether post requires password and correct password has been provided.
wp-includes/post-template.php: get_the_ID()

Retrieve the ID of the current item in the WordPress Loop.
wp-includes/post-template.php: get_the_title()

Retrieve post title.
wp-includes/comment-template.php: comments_open()

Determines whether the current post is open for comments.
wp-includes/comment-template.php: pings_open()

Determines whether the current post is open for pings.
wp-includes/comment-template.php: comments_popup_link_attributes

Filters the comments link attributes for display.
wp-includes/comment-template.php: get_comments_number()

Retrieves the amount of comments a post has.
wp-includes/comment-template.php: comments_link()

Displays the link to the current post comments.
wp-includes/comment-template.php: comments_number()

Displays the language string for the number of comments the current post has.

Changelog

Version Description
0.71 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/comments_popup_link