W3cubDocs

/WordPress

_n( string $single, string $plural, int $number, string $domain = 'default' )

Translates and retrieves the singular or plural form based on the supplied number.

Description

Used when you want to use the appropriate form of a string based on whether a number is singular or plural.

Example:

printf( _n( '%s person', '%s people', $count, 'text-domain' ), number_format_i18n( $count ) );

Parameters

$single

(string) (Required) The text to be used if the number is singular.

$plural

(string) (Required) The text to be used if the number is plural.

$number

(int) (Required) The number to compare against to use either the singular or plural form.

$domain

(string) (Optional) Text domain. Unique identifier for retrieving translated strings.

Default value: 'default'

Return

(string) The translated singular or plural form.

Source

File: wp-includes/l10n.php 

function _n( $single, $plural, $number, $domain = 'default' ) {
	$translations = get_translations_for_domain( $domain );
	$translation  = $translations->translate_plural( $single, $plural, $number );

	/**
	 * Filters the singular or plural form of a string.
	 *
	 * @since 2.2.0
	 *
	 * @param string $translation Translated text.
	 * @param string $single      The text to be used if the number is singular.
	 * @param string $plural      The text to be used if the number is plural.
	 * @param string $number      The number to compare against to use either the singular or plural form.
	 * @param string $domain      Text domain. Unique identifier for retrieving translated strings.
	 */
	$translation = apply_filters( 'ngettext', $translation, $single, $plural, $number, $domain );

	/**
	 * Filters the singular or plural form of a string for a domain.
	 *
	 * The dynamic portion of the hook, `$domain`, refers to the text domain.
	 *
	 * @since 5.5.0
	 *
	 * @param string $translation Translated text.
	 * @param string $single      The text to be used if the number is singular.
	 * @param string $plural      The text to be used if the number is plural.
	 * @param string $number      The number to compare against to use either the singular or plural form.
	 * @param string $domain      Text domain. Unique identifier for retrieving translated strings.
	 */
	$translation = apply_filters( "ngettext_{$domain}", $translation, $single, $plural, $number, $domain );

	return $translation;
}

Used By

Used By Description
wp-admin/includes/dashboard.php: wp_dashboard_site_health()

Displays the Site Health Status widget.
wp-admin/includes/class-wp-site-health.php: WP_Site_Health::get_test_plugin_version()

Test if plugins are outdated, or unnecessary.
wp-admin/includes/class-wp-site-health.php: WP_Site_Health::get_test_theme_version()

Test if themes are outdated, or unnecessary.
wp-includes/functions.php: human_readable_duration()

Convert a duration to human readable format.
wp-admin/includes/class-wp-privacy-requests-table.php: WP_Privacy_Requests_Table::process_bulk_action()

Process bulk actions.
wp-includes/widgets/class-wp-widget-custom-html.php: WP_Widget_Custom_HTML::enqueue_admin_scripts()

Loads the required scripts and styles for the widget control.
wp-includes/rest-api.php: rest_validate_value_from_schema()

Validate a value based on a schema.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::save_changeset_post()

Save the post for the loaded changeset.
wp-includes/embed.php: print_embed_comments_button()

Prints the necessary markup for the embed comments button.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::enqueue_scripts()

Enqueue scripts and styles for Customizer pane.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::customize_register()

Add the customizer settings and controls.
wp-includes/comment-template.php: get_comments_number_text()

Displays the language string for the number of comments the current post has.
wp-admin/includes/class-wp-ms-users-list-table.php: WP_MS_Users_List_Table::get_views()
wp-admin/includes/class-wp-screen.php: WP_Screen::render_screen_layout()

Render the option for number of columns on the page
wp-admin/includes/class-wp-plugins-list-table.php: WP_Plugins_List_Table::get_views()
wp-admin/includes/class-wp-list-table.php: WP_List_Table::ajax_response()

Handles an incoming ajax request (called from admin-ajax.php)
wp-admin/includes/class-wp-list-table.php: WP_List_Table::comments_bubble()

Displays a comment count bubble.
wp-admin/includes/class-wp-list-table.php: WP_List_Table::pagination()

Displays the pagination.
wp-admin/includes/class-wp-ms-themes-list-table.php: WP_MS_Themes_List_Table::get_views()
wp-admin/includes/plugin-install.php: install_plugin_information()

Display plugin information in dialog box form.
wp-admin/includes/dashboard.php: wp_dashboard_right_now()

Dashboard widget that displays some basic stats about the site.
wp-admin/includes/dashboard.php: wp_network_dashboard_right_now()
wp-admin/includes/template.php: wp_star_rating()

Output a HTML element with a star rating for a given rating.
wp-admin/includes/class-wp-users-list-table.php: WP_Users_List_Table::single_row()

Generate HTML for a single row on the users.php admin panel.
wp-admin/includes/ajax-actions.php: _wp_ajax_delete_comment_response()

Sends back current comment total and new page links if they need to be updated.
wp-admin/includes/ajax-actions.php: wp_ajax_replyto_comment()

Ajax handler for replying to a comment.
wp-includes/l10n.php: translate_nooped_plural()

Translates and retrieves the singular or plural form of a string that’s been registered with _n_noop() or _nx_noop().
wp-includes/formatting.php: human_time_diff()

Determines the difference between two timestamps.
wp-includes/pluggable.php: wp_notify_moderator()

Notifies the moderator of the site about a new comment that is awaiting approval.
wp-includes/deprecated.php: __ngettext()

Retrieve the plural or single form based on the amount.
wp-includes/deprecated.php: _nc()

Legacy version of _n(), which supports contexts.
wp-includes/update.php: wp_get_update_data()

Collect counts and UI strings for available updates
wp-includes/admin-bar.php: wp_admin_bar_comments_menu()

Add edit comments link with awaiting moderation count bubble.
wp-includes/ms-functions.php: wpmu_validate_blog_signup()

Processes new site registrations.
wp-includes/comment-template.php: comments_popup_link()

Displays the link to the comments for the current post ID.
wp-includes/class-wp-customize-widgets.php: WP_Customize_Widgets::enqueue_scripts()

Enqueues scripts and styles for Customizer panel and export data to JavaScript.
wp-includes/script-loader.php: wp_default_scripts()

Register all WordPress scripts.

Changelog

Version Description
5.5.0 Introduced ngettext-{$domain} filter.
2.8.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_n