CatCode All to Lat — автоматические SEO URL транслитерацией для OpenCart 2.x, 3.x и 4.x

CatCode All to Lat — SEO URL пишется из названия сам, каждый раз когда вы сохраняете товар, категорию, производителя или информационную страницу. Никто больше не жмёт «сгенерировать» по каждой позиции, а импортированный ночью каталог не просыпается без адресов.

Почему хук на модели, а не на форме

Модуль слушает событие admin/model/catalog/* add/edit before — последнюю точку, где массив данных ещё можно изменить, и первую, через которую проходит каждый, кто пишет в каталог: форма товара, импорт из CSV, чужой массовый редактор, синхронизация с ERP. Расширение, которое патчит шаблон формы, покрывает только первый случай — именно поэтому после ночного импорта товары стоят без ЧПУ.

На OpenCart 4 поле SEO URL дополнительно заполняется прямо в форме, пока вы печатаете название: там ядро проверяет это поле в контроллере ещё до модели, поэтому без этого форма просто не сохранилась бы.

Транслитерация в три слоя

1. Таблица кириллицы по стандарту. Украинский (КМУ 55/2010) даёт и→y, г→h, х→kh, зг→zgh и я→ya в начале слова; русский BGN/PCGN — и→i, г→g. Прогнать украинский каталог русской таблицей означает получить hodinnik вместо hodynnyk и выпасть из выдачи по собственным названиям товаров. Болгарский, сербский/македонский и белорусский имеют свои таблицы.

2. Универсальная таблица — греческий и латиница с диакритикой: польский, чешский, словацкий, немецкий, французский, испанский, португальский, турецкий, румынский, венгерский, балтийские, скандинавские, вьетнамский. Здесь выбор языка не нужен: ł — это l везде. Исключение — немецкие умляуты, они включаются опцией, потому что ü→ue правильно по-немецки и неправильно по-турецки.

3. iconv ASCII//TRANSLIT для всего, чего не было в таблицах, — незнакомый алфавит сводится к ближайшей латинице, а не схлопывается в дефисы.

Апострофы не разрывают слово: О'Хара → okhara, а не o-khara. Ключевое слово режется по границе слова на заданной длине и проверяется на уникальность в пределах магазина.

Массовая конвертация каталога

Отдельная вкладка для магазина, который уже работает. Два режима: только записи без SEO URL (безопасный — может только добавить адреса) и все записи с перезаписью. Перед запуском — предпросмотр «было → станет» на 25 строк, который ничего не пишет. Прогон идёт батчами по 100 строк цепочкой, поэтому каталог на десятки тысяч позиций не упирается в max_execution_time.

Каждое изменение ложится в журнал cc_translit_log: старое ключевое слово, новое, язык, магазин, номер прогона. Отсюда работают две вещи — кнопка «Откатить» на целый прогон и 301 со старого адреса.

301 со старых адресов

Заменённое ключевое слово не исчезает: когда по старому адресу приходят, магазин отдаёт 301 на новый. Страница, которая и дальше открывается, обработчика вообще не касается, а адрес, которого никогда не существовало, как и раньше отдаёт честный 404 — модуль не превращает магазин в ловушку для поисковых роботов.

Три сборки в одном месте

• OpenCart 4.0.2 – 4.1.x — основная кнопка загрузки;
• OpenCart 3.0.x — отдельная кнопка ниже (работает и со старой схемой url_alias версий 3.0.0–3.0.2, и с seo_url от 3.0.3);
• OpenCart 2.3.x — cc_translit-oc2.ocmod.zip.

На OpenCart 3 и 4 ключевые слова хранятся отдельно для каждого языка магазина: украинская страница получает украинский адрес, английская — английский. На OpenCart 4 прогон также досоздаёт служебные route-строки для языков, у которых их нет, — именно из-за них ЧПУ на втором языке обычно молча отдаёт главную страницу.