.po и .mo в WordPress: как не сломать перевод при загрузке сайта

.po и .mo в WordPress: как не сломать перевод при загрузке сайта

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

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

Частая ошибка — править перевод прямо в исходном файле темы. При обновлении он пропадает. Ещё одна проблема — неверная кодировка или лишние пробелы в имени файла. Из-за этого часть строк не подхватывается, хотя файлы на месте.

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