Локализация плагина: что заложить в код до первой строки перевода

Локализация плагина: что заложить в код до первой строки перевода

Переводимость начинается не с .po-файла, а с архитектуры строк. Если текст «размазан» по шаблонам, JS и PHP без правил, локализация быстро превращается в ручную охоту за фразами.

Базовый чек-лист:
— все пользовательские строки проходят через __(), _e(), esc_html__(), esc_attr__();
— у каждой строки один text domain, совпадающий со slug плагина;
— динамика собирается через sprintf(), а не склейкой кусков предложения;
— контекст для неоднозначных слов задаётся через _x().

Отдельно проверьте plural forms: «1 файл» и «5 файлов» нельзя решать через if с двумя строками. Используйте _n() и передавайте число отдельно. Так переводчик получит нормальную форму для любого языка.

Для JavaScript не храните тексты в глобальных объектах «как попало». Передавайте строки через wp_set_script_translations() или локализованный конфиг, но сохраняйте те же правила: text domain, контекст, экранирование при выводе.

Хорошая локализация — это не папка languages, а дисциплина работы со строками. Сначала приводите код к единому стандарту, потом отдавайте его на перевод.