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 4 і 3.0.3+ ключові слова зберігаються окремо для кожної мови магазину: українська сторінка отримує українську адресу, англійська — англійську. На OpenCart 4 прогон також досіває службові route-рядки для мов, у яких їх немає, — саме через них ЧПУ на другій мові зазвичай мовчки віддає головну сторінку.

Навіщо це магазину

OpenCart формує SEO URL з того, що ви ввели руками, і якщо його не заповнити — адреса лишається технічною, з index.php?route=. Заповнювати вручну тисячі товарів ніхто не буде, тому магазини або живуть з технічними адресами, або отримують кирилицю в URL.

Кирилична адреса при копіюванні перетворюється на екран відсоткових кодів: посилання в месенджері виглядає як спам, а частина зовнішніх сервісів такі адреси ріже.

Як це працює — крок за кроком

1. Модуль перехоплює збереження товару, категорії, інформаційної сторінки чи виробника.

2. Назва транслітерується за обраним стандартом (за замовчуванням — український КМУ 55/2010) й лягає в SEO URL автоматично.

3. Для наявного каталогу є масова конвертація — за один прохід.

4. Зі старих адрес ставиться 301, тож позиції і чужі посилання лишаються живими.

Що під капотом

Модуль вішається на модель, а не на форму в адмінці. Тому SEO URL з’являється і тоді, коли товар створює імпорт прайсу, обмін з 1С або будь-який інший модуль — саме там, де рішення «на JavaScript у формі» не працюють.

Ядро не патчиться: усе через штатні події OpenCart, тому оновлення магазину не затирає модуль.

Як встановити

1. Залийте архів через «Розширення → Установник розширень» і встановіть модуль.

2. Переконайтесь, що в налаштуваннях магазину увімкнено ЧПУ.

3. Створіть тестовий товар і перевірте, що SEO URL заповнився сам.

4. Зробіть бекап бази і запустіть масову конвертацію наявного каталогу.