_n() — переводит строку с учетом ее формы множественного числа

2.8.0 wp-includes / l10n.php / Кодекс WordPress

Позволяет получить перевод единственной или множественной формы слова, в зависимости от стоящего перед ним числа.

При возникновении проблем с чтением языковых файлов, сравнение будет происходить между заданными значениями параметров $single и $plural.

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

$single: (строка) Строка, которая будет использоваться, если $number равно 1.
$plural: (строка) Строка, которая будет использоваться, если $number — не 1. Возможно тут вы скажете — «Но ведь в русском языке 3 формы множественного числа!». Да, верно, три, например «1 сайт, 2 сайта, 5 сайтов» — всё это тоже будет хорошо работать, тут главное правильно настроить программу Poedit.
$number: (целое число) Число, которое будет определять использование формы единственного или множественного числа.
$domain: (строка) Уникальный идентификатор языковых файлов, подробнее тут.

Примеры

Простой пример, чтобы понять, как вообще работает функция:

$amount = '4';
echo _n( 'One', 'Many', $amount, 'truemisha' );
// если $amount не равен 1 (0 кстати тоже прокатит), то выведет перевод для 'Many' (много)
// если $amount равен 1, то выведет перевод слова 'One' (один)

Подобные примеры вы нечасто найдете в темах и плагинах WordPress, обычно в таких случаях всегда используется php-функция sprintf().

$amount = '4';
 
$products = sprintf( _n( '1 product', '%s products', $amount, 'truemisha' ), $amount );
 
// "4 товара"
echo $products;

Ничего сложного, главное запомните одну вещь — никаких вычислений внутри sprintf()!

Кстати, если не указывать последний параметр функции, $domain, то для перевода будут использоваться стандртные языковые файлы WordPress (которые задействованы в переводе движка). Понятное дело, что перевода ваших строк там может и не быть.

echo sprintf( _n( '%s comment approved', '%s comments approved', $approved ), $approved );

Кодекс WordPress: Локализация: __(), _e(), _ex(), _n(), _x(), esc_attr__(), esc_attr_e(), esc_html__(), esc_html_e(), get_language_attributes(), is_rtl(), language_attributes(), load_plugin_textdomain(), load_theme_textdomain()

Миша

Недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.