.po и .mo в WordPress: зачем нужны оба файла и где их чаще ломают

.po и .mo в WordPress: зачем нужны оба файла и где их чаще ломают

Файлы локализации работают в паре: .po — это редактируемый текстовый список строк, .mo — его скомпилированная версия для быстрого чтения сайтом. В WordPress именно .mo обычно подхватывается в фронте, а .po нужен вам как рабочий файл для перевода и правок.

Типовая схема такая:
— переводите строки в .po через редактор вроде Poedit;
— сохраняете, чтобы рядом появился .mo;
— кладёте файлы в правильную папку темы, плагина или языка сайта;
— проверяете, что текстовый домен совпадает с тем, что указан в коде.

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

Если перевод не отображается, сначала проверьте связку из трёх вещей: правильный путь, совпадение text domain и наличие свежего .mo. В большинстве случаев проблема находится именно там, без сложной диагностики.

Храните .po как исходник, а .mo как результат сборки: так локализация в WordPress меньше ломается при обновлениях и переносах.