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

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


Description 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 ) );

Parameters 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 value: null


Top ↑

Return 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) Text domain.

Top ↑

Source Source

File: wp-includes/l10n.php

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

Changelog
Version Description
2.8.0 Introduced.


Top ↑

User Contributed Notes 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.