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

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

Если плагин рассчитан на чужие языки, недостаточно просто обернуть строки в функции перевода. Ошибки обычно появляются в мелочах: часть текста остаётся «зашита», часть переводится не из того домена, а длинные фразы внезапно ломают верстку.

— Все выводимые строки должны проходить через __() или _e(), а не лежать в шаблоне как обычный текст.
— Для каждого плагина нужен свой text domain; иначе переводы смешиваются и становятся неуправляемыми.
— Строки с плейсхолдерами лучше собирать через sprintf(), чтобы переводчик мог менять порядок слов без костылей.
— Не склеивайте фразы из кусочков: перевод должен быть цельной строкой, а не набором обрывков.
— Проверьте длинные переводы в кнопках, таблицах и уведомлениях: именно там чаще всего ломается UI.

Отдельно следите за контекстом. Одно и то же слово в админке и на фронтенде может означать разное, поэтому для таких случаев полезны _x() и _ex(). Это снижает риск, что перевод станет «правильным по словам», но неправильным по смыслу.

Итог простой: сначала делайте плагин переводимым по архитектуре, потом уже отдавайте строки на перевод. Тогда локализация не превращается в ручной ремонт интерфейса.