Как правильно переопределять шаблоны OpenCart

Краткое описание задачи

Прямая правка файлов шаблонов в папке default — путь к потере изменений при обновлении OpenCart. Разберём все способы переопределения шаблонов.

Способ 1: Через тему (рекомендуется)

Скопируйте файл из catalog/view/theme/default/template/… в catalog/view/theme/yourtheme/template/… и отредактируйте. OpenCart сначала ищет шаблон в вашей теме, и только потом — в default.

Способ 2: Через OCMOD

Если нужно изменить конкретную строку или блок шаблона — используйте OCMOD-модификацию. Она применяется на лету и не затрагивает оригинальный файл.

Способ 3: Через Events

Событие view/*/before позволяет изменить данные до передачи в шаблон. Полезно, когда нужно не HTML править, а данные.

Что нельзя делать

• Править файлы в default — при обновлении OpenCart они перезапишутся.
• Править файлы модулей напрямую — при обновлении модуля изменения пропадут.

Рекомендации из практики

Как лучше: Создайте тему-наследник с самого начала разработки — скопируйте default в свою папку catalog/view/theme/yourshop/ и меняйте только там. Даже если пока правите один файл. Это займёт 5 минут, но спасёт при следующем обновлении OpenCart: ваши изменения не перезапишутся.

Как не делать: Не редактируйте файлы в catalog/view/theme/default/ «на скорую руку, потому что клиенту нужно срочно». Это самый частый источник технического долга в OpenCart-проектах. После обновления CMS магазин может «потерять» половину кастомизаций, и найти их все вручную — дни работы.

Кейс из практики: Клиент — магазин одежды — за год накопил несколько десятков прямых правок в default. При обновлении OpenCart 3.0.3.6 → 3.0.3.8 значительная часть изменений пропала: кастомный вывод размеров, изменённая корзина, свои кнопки в карточке товара. Пришлось разбирать Git-логи и восстанавливать каждую правку по отдельности. Если бы сразу сделали тему-наследник — обновление заняло бы час, а не три дня.

Нужно грамотно разложить шаблоны без потери кастомизаций — закажите доработку OpenCart: настроим тему-наследник и OCMOD-правила.

FAQ

Как узнать, какой шаблон использует OpenCart?

Включите в настройках темы опцию «Показывать имя шаблона» (если есть) или используйте browser extension для OpenCart.

Можно ли переопределять системные контроллеры через тему?

Нет, тема переопределяет только шаблоны (.twig). Контроллеры и модели переопределяются через OCMOD-модификации или Event-систему. Если нужно изменить логику, а не вёрстку — используйте событие controller/*/before.

Итог

Всегда используйте свою тему или OCMOD. Прямая правка default — технический долг, который аукнется при первом же обновлении. По практике, тема-наследник окупается за один цикл обновления CMS.