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

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

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

Второй частый промах — неверный text domain. Он должен совпадать с именем папки/slug плагина и загружаться один раз, в понятном месте. Если домен отличается в коде, файлах перевода и названии плагина, WordPress просто не найдёт нужные строки.

Третья ошибка — слишком поздняя загрузка переводов. Подключайте их на раннем этапе и не прячьте вызов в условие, которое срабатывает не на всех запросах. Ещё одна деталь: строки с переменными лучше собирать через placeholders, а не через конкатенацию, чтобы переводчик мог менять порядок слов без поломки смысла.

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