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

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

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

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

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

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

Держите .po как мастер-файл, .mo — как результат сборки. Тогда локализация будет предсказуемой, а отладка займёт минуты, а не часы.