.po и .mo в WordPress: где перевод ломается и как быстро это чинить

.po и .mo в WordPress: где перевод ломается и как быстро это чинить

Файлы переводов в WordPress работают парой: .po — это читаемый текстовый каталог, .mo — его скомпилированная версия для сайта. Если правишь только .po, а .mo не обновляешь, на фронте останется старый перевод.

Типовые ошибки:
— перевели строку, но не нажали экспорт в .mo;
— положили файлы не в ту папку темы или плагина;
— назвали файл не по text domain;
— забыли, что у языка свой код и своя структура каталогов.

Проверяйте три вещи: файл .po должен содержать все нужные строки, .mo должен быть пересобран после правок, а путь до файлов должен совпадать с тем, где WordPress их ищет. Если перевод не подхватывается, сначала смотрите именно на домен текста и имя файла, а не на кэш.

Для локализации удобнее держать переводы отдельно от кода и не править их руками на проде. Так проще обновлять тему, переносить сайт и не терять переводы при следующем изменении шаблона.