_n( string $single, string $plural, int $number, string $domain = ‘default’ ): string

User Contributed Notes

1. Skip to note 5 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 7You must log in to vote on the helpfulness of this note

   Display either “1 star” or “x stars” for a star rating plugin.

   $rating = '3';
   
   $text = sprintf( _n( '%s star', '%s stars', $rating, 'wpdocs_textdomain' ), $rating );
   
   // "3 stars"
   echo $text;

   Important: Never do a calculation inside the sprintf() function! The following won’t work:

   $text = sprintf( 
   	_n( '%s star', '%s stars', $rating, 'wpdocs_textdomain' ), 
   	2 <= $rating ? $rating -1 : $rating
   );
2. Skip to note 6 content

   Felipe Elia 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   As explained by @sergeybiryukov here, here, here and here, this functions should NOT be use in one item or more than one item scenarios, but for singular form and plural forms, which is not the same thing. Also both strings should have placeholders.

   As he stated:

   In languages that have complex plural structures the singular form can be used for numbers other than 1, so if the goal is to display a string for exactly 1 item, an explicit check like

   1 === count( $items )

   should be used instead of

   _n()

   This problem is also covered in Codex.

   Although it would be possible address this issue changing the plural form for Russian and other slavic languages it would bring a too big effort as explained here.
3. Skip to note 7 content

   Arif Rahman 1 year ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   This code snippet facilitates the presentation of job counts in two distinct forms: singular and plural. This is achieved by leveraging the _n function, which intelligently adapts the phrasing based on the job count value.

   $get_text = sprintf(
       _n(
           '%s Job',         // Singular form for one job
           '%s Jobs',        // Plural form for multiple jobs
           $category->count, // Job count
           'text-domain'     // Text domain for translation
       ),
       number_format_i18n( $category->count ) // Format count with internationalization
   );

   Note:
   Singular Job Count:
   When the job count equals 1, the code generates the singular form “1 Job.” This accounts for scenarios where only a single job is within the specific job category.

   Plural Job Count:
   If the job count exceeds 1, the code generates the plural form “X Jobs,” where X represents the actual job count. This is used when there are multiple jobs within the given job category.
4. Skip to note 8 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: -2You must log in to vote on the helpfulness of this note

   Example from /wp-admin/edit-comments.php without the use of a text domain for translation.

   if ( $approved > 0 ) {
   	$messages[] = sprintf( _n( '%s comment approved', '%s comments approved', $approved ), $approved );
   }