Генератор ЧПУ и редиректы

Генератор ЧПУ и редиректы — модуль для OpenCart 3 и ocStore 3, который автоматически создаёт понятные адреса товаров, категорий, производителей и информационных страниц. Заполняет пустые SEO URL, помогает обработать существующий каталог и сохраняет историю изменений с 301-редиректами. Техническое название — Clear SEO OC3, версия 1.1.0. Автор — Stas-Clear.

Автоматическая генерация ЧПУ

При добавлении товара «Красная сумка» модуль предложит адрес krasnaya-sumka. Если такой вариант занят, подберёт свободное окончание: krasnaya-sumka-2, затем следующее. Генерация работает для русского и английского языков с учётом магазинов, назначенных записи.

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

Шаблоны адресов для разных типов записей

На вкладке «Автогенерация» отдельно задаются настройки товаров, категорий, производителей и информационных страниц. По умолчанию используется [name], слова разделяются дефисом, суффикс .html и смена адреса при переименовании выключены.

• Для товара: [name], [id], [model], [sku], [category], [manufacturer].
• Для категории, производителя и информационной страницы: [name] и [id].

Например, шаблон [name]-[id] дополняет название идентификатором записи. Для нового товара настоящий ID подставляется после первого сохранения. Переключатели сохраняются сразу; текстовые шаблоны, разделитель, суффикс и размер пакета — общей кнопкой «Сохранить».

Массовое заполнение SEO URL

Для каталога с незаполненными адресами откройте «Массовую обработку», выберите магазин и получите предпросмотр. Изучите план, затем подтвердите применение. По умолчанию изменяются только пустые URL. Замена существующих адресов включается отдельным режимом.

Запуск выполняется порциями, поддерживает паузу и продолжение. Сохранённые планы можно удалить: уже записанные адреса, история и редиректы при этом остаются. Перед массовой заменой действующих ссылок внимательно проверьте предпросмотр.

История изменений и 301-редиректы

При поддерживаемой замене адреса модуль фиксирует изменение и направляет старую ссылку на текущую штатную ссылку ответом 301. Поддерживаются история родительских адресов, вложенные пути и сведение цепочек к текущему URL в пределах поддерживаемых сценариев. Редирект можно отключить отдельно от истории.

При перенаправлении сохраняются UTM, gclid, yclid и fbclid. Canonical выводится без аналитических параметров. POST, AJAX, неоднозначные и неподдерживаемые пути не перенаправляются. Универсальная перестройка дерева категорий без смены alias не автоматизирована.

Установка и первый запуск

1. Загрузите clear-seo_oc3_v1.1.0.ocmod.zip через «Расширения → Установка расширений».
2. Откройте «Расширения → Модификаторы», нажмите обновление и очистите кеш шаблонов CMS.
3. В списке модулей установите Clear SEO и откройте настройки. В интерфейсе этой версии используется название Clear SEO.
4. На вкладке «Обзор» включите модуль и проверьте «Здоровье ЧПУ». В магазине должны работать SEO URL либо SEO Pro и соответствующие правила сервера. Ссылка «В настройки» ведёт к настройкам основного магазина; модуль сам не включает ЧПУ магазина.
5. Создайте тестовый товар или категорию, проверьте адрес после сохранения и откройте страницу на витрине.

Для Apache нужны рабочие правила .htaccess, для Nginx — соответствующие настройки сервера. Если исходный старый ocStore не открывает админку на PHP 8.2/8.3, сначала установите пакет и обновите модификаторы на PHP 7.4–8.1, затем переключите PHP.

Ежедневная работа с модулем

«Обзор» показывает состояние ЧПУ. «Автогенерация» задаёт правила. «Массовая обработка» заполняет каталог по плану. «История и редиректы» позволяет просматривать изменения и отключать перенаправления. «Диагностика» помогает проверить окружение.

Для осознанной смены адреса используйте кнопку генерации в существующей карточке и сохраните запись. После этого проверьте новый адрес и переход со старого. Обычное изменение названия без перегенерации сохраняет прежнюю ссылку.

Совместимость и ограничения

• Проверены OpenCart 3.0.4.1 и ocStore 3.0.3.9, штатные административные формы и маршрутизаторы SEO URL/SEO Pro.
• Поддерживается PHP 7.4–8.3. Русский и английский интерфейсы; генерация учитывает магазины и языки сущностей.
• Пакет использует Events и OCMOD, не изменяет оригиналы ядра и схему штатной таблицы SEO URL.
• Сторонние темы, фильтры и SEO-маршрутизаторы требуют отдельной проверки.
• Импорт через штатные модели вызывает автогенерацию. Прямая запись SQL сторонними средствами её не запускает.
• OpenCart 4, генерация метатегов, sitemap, hreflang и универсальная перестройка дерева URL не входят в модуль.
• Ключ активации, ionCube, внешний API и планировщик не требуются.

Частые вопросы

Почему после переименования товара адрес не изменился?

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

Почему сохранённый ЧПУ возвращает 404?

Проверьте SEO URL/SEO Pro, правила веб-сервера и раздел «Здоровье ЧПУ». Модуль создаёт адреса, но не заменяет маршрутизатор магазина.

Можно заполнить адреса после прямого импорта в базу?

Да, используйте массовую обработку в режиме заполнения пустых URL, сначала просмотрев план. Сам прямой SQL-импорт не вызывает события модуля.

Нужны ли задания по расписанию?

Нет. Обычная генерация связана с сохранением записи, массовая обработка запускается администратором.

Обновление и удаление

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

Выключенный модуль не вмешивается в сохранение. Обычная деинсталляция отключает обработчики и сохраняет накопленные данные; полное удаление собственных данных выполняется отдельной служебной операцией. Автоматические резервные копии не создаются. Подробная инструкция покупателя включена в архив отдельным файлом USER_GUIDE.txt.