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

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

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

— Не хардкодьте текст прямо в шаблонах. Любая фраза должна проходить через функции перевода, а не лежать в HTML как есть.
— Для динамических строк используйте один и тот же текстовый домен во всём плагине.
— Не склеивайте переводимые куски из нескольких слов: переводчик должен видеть цельную фразу, а не конструктор.
— Учитывайте множественное число, падежи и вставки переменных через плейсхолдеры, а не через конкатенацию.
— Проверьте, чтобы в админке, письмах и уведомлениях не остались «жёсткие» строки.

Отдельно следите за контекстом: одно и то же слово в разных местах может переводиться по-разному. Для этого нужны пояснения к строкам, а не надежда на «и так поймут». Еще одна частая ошибка — забыть про дату, валюту, единицы измерения и формат чисел: это тоже часть локализации, а не только текст на кнопках.

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