_nx_noop( string $singular, string $plural, string $context, string $domain = null ): array

Registers plural strings with gettext context in POT file, but does not translate them.

Contents

Description

Used when you want to keep structures with translatable plural strings and use them later when the number is known.

Example of a generic phrase which is disambiguated via the context parameter:

$messages = array(
     'people'  => _nx_noop( '%s group', '%s groups', 'people', 'text-domain' ),
     'animals' => _nx_noop( '%s group', '%s groups', 'animals', 'text-domain' ),
);
...
$message = $messages[ $type ];
printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );

Top ↑

Parameters

$singular string Required
Singular form to be localized.
$plural string Required
Plural form to be localized.
$context string Required
Context information for the translators.
$domain string Optional
Text domain. Unique identifier for retrieving translated strings.

Default: null

Top ↑

Return

array Array of translation information for the strings.

  • string
    Singular form to be localized. No longer used.
  • 1 string
    Plural form to be localized. No longer used.
  • 2 string
    Context information for the translators. No longer used.
  • singular string
    Singular form to be localized.
  • plural string
    Plural form to be localized.
  • context string
    Context information for the translators.
  • domain string|null
    Text domain.

Top ↑

Source

File: wp-includes/l10n.php. View all references 

function _nx_noop( $singular, $plural, $context, $domain = null ) {
	return array(
		0          => $singular,
		1          => $plural,
		2          => $context,
		'singular' => $singular,
		'plural'   => $plural,
		'context'  => $context,
		'domain'   => $domain,
	);
}

View on Trac View on GitHub

Top ↑

Top ↑

Changelog

Changelog
Version Description
2.8.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note
    Contributed by Codex — 
    $labels = array(
	'draft' => array( _nx_noop( '%s Draft', '%s Drafts', 'post' ), _nx_noop( '%s Draft', '%s Drafts', 'page' ) ),
	'publish' => array( _nx_noop( '%s Published', '%s Published', 'post' ), _nx_noop( '%s Published', '%s Published', 'page' ) ),
);
if ( $post_type == 'page' ) {
	$labels = $labels[ $post_status ][1];
} else {
	$labels = $labels[ $post_status ][0];
}
$usable_text = sprintf( translate_nooped_plural( $labels, $count, $domain ), $count );

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