Локализация плагина: 5 ошибок, из-за которых перевод ломается в проде

Локализация плагина: 5 ошибок, из-за которых перевод ломается в проде

Локализация — это не только .po/.mo, а дисциплина: строка должна быть готова к переводу, выводу и обновлению без сюрпризов.

— Не хардкодьте текст в шаблонах и JS: строка должна проходить через функции перевода, иначе переводчик её не увидит.
— Используйте осмысленный text domain везде одинаково: в заголовке плагина, файлах и вызовах переводов.
— Не склеивайте фразы из кусочков: в языках порядок слов меняется, и такая строка плохо переводится.
— Для чисел, дат и имён используйте отдельные форматы и plural-функции, а не один шаблон на все случаи.
— Добавляйте контекст, если одно и то же слово может значить разное: без него перевод часто получается неверным.

Отдельно проверьте экранирование: переводимые строки должны быть безопасны там, где выводится HTML, атрибуты или ссылки. И не забывайте, что локализация касается не только интерфейса, но и ошибок, уведомлений и писем.

Перед релизом прогоните плагин по списку строк и посмотрите, можно ли собрать интерфейс полностью на другом языке. Если нет — где-то остался хардкод или слишком “умная” строка.