get_comments_number_text() - WordPress 函数参考中文文档

返回介绍

get_comments_number_text()

发布于 2017-09-10 字数 3516 浏览 968 评论 0

get_comments_number_text( string $zero = false,  string $one = false,  string $more = false )

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


描述


参数

$zero

(string)
(Optional)
Text for no comments.

Default value: false

$one

(string)
(Optional)
Text for one comment.

Default value: false

$more

(string)
(Optional)
Text for more than one comment.

Default value: false


源代码

File: wp-includes/comment-template.php

function get_comments_number_text( $zero = false, $one = false, $more = false ) {
	$number = get_comments_number();

	if ( $number > 1 ) {
		if ( false === $more ) {
			/* translators: %s: number of comments */
			$output = sprintf( _n( '%s Comment', '%s Comments', $number ), number_format_i18n( $number ) );
		} else {
			// % Comments
			/* translators: If comment number in your language requires declension,
			 * translate this to 'on'. Do not translate into your own language.
			 */
			if ( 'on' === _x( 'off', 'Comment number declension: on or off' ) ) {
				$text = preg_replace( '#<span class="screen-reader-text">.+?</span>#', '', $more );
				$text = preg_replace( '/&.+?;/', '', $text ); // Kill entities
				$text = trim( strip_tags( $text ), '% ' );

				// Replace '% Comments' with a proper plural form
				if ( $text && ! preg_match( '/[0-9]+/', $text ) && false !== strpos( $more, '%' ) ) {
					/* translators: %s: number of comments */
					$new_text = _n( '%s Comment', '%s Comments', $number );
					$new_text = trim( sprintf( $new_text, '' ) );

					$more = str_replace( $text, $new_text, $more );
					if ( false === strpos( $more, '%' ) ) {
$more = '% ' . $more;
					}
				}
			}

			$output = str_replace( '%', number_format_i18n( $number ), $more );
		}
	} elseif ( $number == 0 ) {
		$output = ( false === $zero ) ? __( 'No Comments' ) : $zero;
	} else { // must be one
		$output = ( false === $one ) ? __( '1 Comment' ) : $one;
	}
	/**
	 * Filters the comments count for display.
	 *
	 * @since 1.5.0
	 *
	 * @see _n()
	 *
	 * @param string $output A translatable string formatted based on whether the count
	 *                       is equal to 0, 1, or 1+.
	 * @param int    $number The number of post comments.
	 */
	return apply_filters( 'comments_number', $output, $number );
}

更新日志

Version 描述
4.0.0 Introduced.

相关函数

Uses

  • wp-includes/l10n.php:
    _n()
  • wp-includes/l10n.php:
    _x()
  • wp-includes/l10n.php:
    __()
  • wp-includes/functions.php:
    number_format_i18n()
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/comment-template.php:
    get_comments_number()
  • wp-includes/comment-template.php:
    comments_number
  • Show 2 more uses
    Hide more uses


Used By

  • wp-includes/comment-template.php:
    comments_number()

User Contributed Notes

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!