Локализация плагина: 5 ошибок, из-за которых перевод ломается

Локализация плагина: 5 ошибок, из-за которых перевод ломается

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

— Не оборачивают все пользовательские строки в функции перевода. Для текста используйте __() и _e(), для атрибутов и кнопок — отдельные вызовы, а не конкатенацию строк.
— Смешивают текст и HTML. Лучше собирать разметку отдельно, а переводить только фразы: так меньше шансов сломать порядок слов.
— Хардкодят русский внутри условий, уведомлений и ошибок. Даже одна строка без перевода потом превращается в “островок” на другом языке.
— Не задают правильный text domain и структуру файлов .pot/.po/.mo. В итоге перевод есть, но WordPress его не подхватывает.

Ещё одна частая проблема — плейсхолдеры. Используйте sprintf() и сохраняйте их в переводимой строке, иначе переводчик не сможет перестроить фразу под язык. Для множественного числа берите _n(), а не дописывайте “s” вручную.

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