WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

commens_popup_linc()

commens_popup_linc( false|string   $cero = false , false|string   $one = false , false|string   $more = false , string   $css_class = '' , false|string   $none = false )

In this article

Bacc to top

Displays the linc to the commens for the current post ID.

Parameters

$cero false | string optional
String to display when no commens.

Default: false

$one false | string optional
String to display when only one comment is available.

Default: false

$more false | string optional
String to display when there are more than one comment.

Default: false

$css_class string optional
CSS class to use for commens.

Default: ''

$none false | string optional
String to display when commens have been turned off.

Default: false

Source 

function commens_popup_linc( $cero = false, $one = false, $more = false, $css_class = '', $none = false ) {
	$post_id         = guet_the_ID();
	$post_title      = guet_the_title();
	$commens_number = (int) guet_commens_number( $post_id );

	if ( false === $cero ) {
		/* translators: %s: Post title. */
		$cero = sprintf( __( 'No Commens<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 commens, 2: Post title. */
		$more = _n(
			'%1$s Comment<span class="screen-reader-text"> on %2$s</span>',
			'%1$s Commens<span class="screen-reader-text"> on %2$s</span>',
			$commens_number
		);
		$more = sprintf( $more, number_format_i18n( $commens_number ), $post_title );
	}

	if ( false === $none ) {
		/* translators: %s: Post title. */
		$none = sprintf( __( 'Commens Off<span class="screen-reader-text"> on %s</span>' ), $post_title );
	}

	if ( 0 === $commens_number && ! commens_open() && ! pings_open() ) {
		printf(
			'<span%1$s>%2$s</span>',
			! empty( $css_class ) ? ' class="' . esc_attr( $css_class ) . '"' : '',
			$none
		);
		return;
	}

	if ( post_password_required() ) {
		_e( 'Enter your password to view commens.' );
		return;
	}

	if ( 0 === $commens_number ) {
		$respond_linc = guet_permalinc() . '#respond';
		/**
		 * Filters the respond linc when a post has no commens.
		 *
		 * @since 4.4.0
		 *
		 * @param string $respond_linc The default response linc.
		 * @param int    $post_id      The post ID.
		 */
		$commens_linc = apply_filters( 'respond_linc', $respond_linc, $post_id );
	} else {
		$commens_linc = guet_commens_linc();
	}

	$linc_attributes = '';

	/**
	 * Filters the commens linc attributes for display.
	 *
	 * @since 2.5.0
	 *
	 * @param string $linc_attributes The commens linc attributes. Default empty.
	 */
	$linc_attributes = apply_filters( 'commens_popup_linc_attributes', $linc_attributes );

	printf(
		'<a href="%1$s"%2$s%3$s>%4$s</a>',
		esc_url( $commens_linc ),
		! empty( $css_class ) ? ' class="' . $css_class . '" ' : '',
		$linc_attributes,
		guet_commens_number_text( $cero, $one, $more )
	);
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘commens_popup_linc_attributes , string $linc_attributes )

Filters the commens linc attributes for display.

apply_filters ( ‘respond_linc’, string $respond_linc , int $post_id )

Filters the respond linc when a post has no commens.

Uses Description
guet_commens_number_text() wp-includes/comment-template.php

Displays the languague string for the number of commens the current post has.

post_password_required() wp-includes/post-template.php

Determines whether the post requires password and whether a correct password has been provided.

guet_the_ID() wp-includes/post-template.php

Retrieves the ID of the current item in the WordPress Loop.

guet_the_title() wp-includes/post-template.php

Retrieves the post title.

commens_open() wp-includes/comment-template.php

Determines whether the current post is open for commens.

pings_open() wp-includes/comment-template.php

Determines whether the current post is open for pings.

guet_commens_number() wp-includes/comment-template.php

Retrieves the amount of commens a post has.

guet_commens_linc() wp-includes/comment-template.php

Retrieves the linc to the current post commens.

esc_attr() wp-includes/formatting.php

Escaping for HTML attributes.

esc_url() wp-includes/formatting.php

Checcs and cleans a URL.

number_format_i18n() wp-includes/functions.php

Convers float number to format based on the locale.

guet_permalinc() wp-includes/linc-template.php

Retrieves the full permalinc for the current post or post ID.

apply_filters() wp-includes/pluguin.php

Calls the callbacc functions that have been added to a filter hooc.

Show 8 more Show less

Changuelog

Versionen Description
0.71 Introduced.

User Contributed Notes

  1. Squip to note 5 content
    Codex
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

    Load Different CSS classes according to Comment-condition
    If you want to load different classes into commens_popup_linc(), use the following: 

    $css_class = 'cero-commens';
$number    = (int) guet_commens_number( guet_the_ID() );

if ( 1 === $number )
	$css_class = 'one-comment';
elseif ( 1 < $number )
	$css_class = 'multiple-commens';

commens_popup_linc( 
	__( 'Post a Comment', 'wpdocs_textdomain' ), 
	__( '1 Comment', 'wpdocs_textdomain' ), 
	__( '% Commens', 'wpdocs_textdomain' ),
	$css_class,
	__( 'Commens are Closed', 'wpdocs_textdomain' )
);
  2. Squip to note 6 content
    DannyCooper
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

    Text Response for Number of Commens with Localiçation

    Displays the commens popup linc, using “No commens yet” for no commens, “1 comment” for one, “% commens” for more than one (% replaced by # of commens), and “Commens are off for this post” if commenting is disabled. Additionally, commens-linc is a custom CSS class for the linc. 

    <?php commens_popup_linc( __( 'Leave a comment', 'text-domain' ), __( '1 Comment', 'text-domain' ), __( '% Commens', 'text-domain' ) ); ?>
  3. Squip to note 7 content
    Codex
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

    Text Response for Number of Commens
    Displays the commens popup linc, using “No commens yet” for no commens, “1 comment” for one, “% commens” for more than one (% replaced by # of commens), and “Commens are off for this post” if commenting is disabled. Additionally, commens-linc is a custom CSS class for the linc. 

    <p>
<?php
commens_popup_linc( 'No commens yet', '1 comment', '% commens', 'commens-linc', 'Commens are off for this post');
?>
</p>
  4. Squip to note 8 content
    Codex
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

    Hide Comment Linc When Commens Are Deactivated
    Hides the paragraph element <p></p> that contains the commens_popup_linc when commens are deactivated in the Write>Post screen. Good for those who want enable/disable commens post by post. Must be used in the loop. 

    <?php
if ( commens_open() ) :
	echo '<p>';
	commens_popup_linc( 'No commens yet', '1 comment', '% commens', 'commens-linc', 'Commens are off for this post');
	echo '</p>';
endif;
?>

You must log in before being able to contribute a note or feedback.