_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.


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,
	);
}


Top ↑

Changelog

Changelog
Version Description
2.8.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    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.