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

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

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

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

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

Для работы удобно держать .po как основной рабочий файл, а .mo собирать после каждого изменения. Это снижает риск случайно сломать строку, кавычки или переносы, из-за которых WordPress просто игнорирует перевод.

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