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

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

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

Главные правила:
— правьте .po в редакторе переводов, а не в блокноте;
— после правок всегда пересобирайте .mo;
— сохраняйте одинаковое имя файла и кодировку UTF-8;
— держите файлы в правильной папке: для плагинов и тем она отличается.

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

Для командной работы удобно хранить .po как исходник, а .mo — как результат сборки. Так проще искать, где именно сломалась локализация: в тексте перевода, в генерации или в размещении файла. 🛠️

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