Описание функции _n()
Функция _n() предназначена для локализации строк с учетом числа. Она позволяет отображать разные формы слова в зависимости от количества объектов. Функция используется, когда необходимо корректно отображать множественное и единственное числа, что особенно важно для многоязычных сайтов.
Применяется в темах и плагинах для обеспечения правильного перевода и отображения текста в зависимости от числа объектов.
Параметры
$singular
Тип: string
Обязательный: Да
Описание: Строка для единственного числа
Возможные значения:
$plural
Тип: string
Обязательный: Да
Описание: Строка для множественного числа
Возможные значения:
$number
Тип: int
Обязательный: Да
Описание: Количество объектов для определения формы слова
Возможные значения:
$domain
Тип: string
Обязательный: Нет
По умолчанию: default
Описание: Текстовый домен для локализации
Возможные значения:
Возвращаемое значение
Тип: string
Описание: Возвращает локализованную строку в зависимости от количества
Возможные значения:
• Единственное число, если number равно 1
• Множественное число для всех остальных значений
Примеры использования
Использование для отображения единственного товара
$count = 1;
echo _n('Товар', 'Товары', $count);
// Вывод: Товар
Корректная локализация в зависимости от количества
Использование с текстовым доменом
$count = 5;
echo _n('Статья', 'Статьи', $count, 'my-plugin');
// Вывод: Статьи
Поддерживает многоязычные сайты
Безопасность
Валидация входных данных: Параметры должны быть валидными строками или целыми числами
Санитизация: Функция автоматом очищает строки для предотвращения XSS
Рекомендации: Используйте esc_html() для вывода строк на экран
— Связанные функции
Функция для получения строки в зависимости от числа
Функция для немедленного вывода локализованной строки
— Примечания
– Ограничения
Не поддерживает сложные правила склонения для всех языков
– Частые проблемы
- Ошибки при неправильном использовании чисел
- Неправильный вывод в зависимости от языка
