Структура модуля OpenCart 3: файлы, MVC-L и OCMOD

Пример дерева файлов модуля

admin/  controller/extension/module/my_module.php  language/ru-ru/extension/module/my_module.php  view/template/extension/module/my_module.twigcatalog/  controller/extension/module/my_module.php  language/ru-ru/extension/module/my_module.php  model/extension/module/my_module.php  view/theme/default/template/extension/module/my_module.twiginstall.xml

Структура модуля в OpenCart 3 состоит из набора файлов и директорий, которые располагаются в соответствующей директории в корне сайта.

Основная директория модуля должна иметь название, соответствующее названию модуля, и быть расположена в директории catalog или admin, в зависимости от того, к какой части панели управления сайта относится модуль. Например, модуль my_module для каталога товаров должен быть расположен в директории catalog/controller/extension/module/my_module.php.

Структура модуля в OpenCart 3 может включать следующие файлы и директории:

• controller: директория, содержащая контроллеры модуля. Контроллеры управляют логикой работы модуля и обрабатывают запросы от пользователя. Например, файл catalog/controller/extension/module/my_module.php содержит контроллер модуля my_module для каталога товаров.
• model: директория, содержащая модели модуля. Модели представляют собой объекты для работы с базой данных и получения данных из нее. Например, файл catalog/model/extension/module/my_module.php содержит модель модуля my_module для каталога товаров.
• view: директория, содержащая файлы представлений модуля. Представления определяют, как данные будут отображаться на странице сайта. Например, файл catalog/view/theme/default/template/extension/module/my_module.twig содержит представление модуля my_module для каталога товаров в стандартной теме оформления.
• language: директория, содержащая файлы перевода модуля на различные языки. Например, файл catalog/language/en-gb/extension/module/my_module.php содержит переводы для модуля my_module на английском языке для каталога товаров.
• install.php: файл, содержащий код для установки модуля на сайт. В этом файле может быть определен код SQL для создания таблиц в базе данных или код для добавления новых настроек в базу данных.
• uninstall.php: файл, содержащий код для удаления модуля со страницы сайта. В этом файле может быть определен код SQL для удаления таблиц из базы данных или код для удаления настроек из базы данных.
• config.php: файл, содержащий настройки модуля. В этом файле могут быть определены параметры, такие как название модуля, идентификатор модуля, описание модуля, версия модуля и т.д.
• README.md: файл, содержит описание модуля

Важное уточнение про install.php, uninstall.php и config.php

В типичном модуле OpenCart 3 установочная логика чаще оформляется не отдельными файлами install.php и uninstall.php, а методами install() и uninstall() внутри административного контроллера модуля. В этих методах создают таблицы, добавляют события, права доступа или настройки. Отдельные установочные файлы могут встречаться в пакетах расширений, но их не стоит считать обязательной стандартной структурой каждого модуля.

Файл config.php тоже не является обязательным файлом обычного модуля OpenCart. Основные настройки сайта живут в корневых config.php и admin/config.php, а настройки конкретного модуля обычно сохраняются через модель setting/setting в базе данных.

Где в OpenCart 3 хранятся модули и модификаторы

В OpenCart 3.x, управление и хранение модулей и модификаторов организовано , чтобы облегчить процесс их установки,

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

Где хранятся модули в OpenCart 3?

Модули в OpenCart 3 представляют собой расширения, которые добавляют функциональность в различные части сайта. Они могут включать блоки на страницах,

интеграции с внешними сервисами, новые возможности для пользователей и многое другое. Основные места, где хранятся файлы модулей:

• Каталог catalog/controller/extension/module/
  Здесь находятся файлы контроллеров для модулей, которые управляют логикой работы модулей на фронтенде. Контроллеры обрабатывают запросы от пользователей и вызывают соответствующие модели и виды для отображения данных.
• Каталог catalog/model/extension/module/
  В этой папке располагаются файлы моделей модулей. Модели взаимодействуют с базой данных, получают данные и передают их контроллерам.
• Каталог catalog/view/theme/{ваша_тема}/template/extension/module/
  Здесь находятся шаблоны для модулей. Эти файлы отвечают за отображение данных на сайте и могут быть изменены в зависимости от используемой темы оформления.

Где хранятся модификаторы в OpenCart 3?

Модификаторы (OCMod) в OpenCart 3 используются для внесения изменений в стандартный код без его непосредственного редактирования. Это позволяет обновлять систему и модули без потери внесённых изменений. Основные места, где хранятся модификаторы:

• Каталог system/storage/modification/
  В этом каталоге находятся файлы, сгенерированные системой после применения модификаторов. Эти файлы представляют собой изменённые версии оригинальных файлов системы, которые используются для работы сайта.
• Таблица oc_modification в базе данных
  Информация о самих модификаторах, таких как их названия, коды и пути к файлам, хранится в базе данных. Это позволяет системе знать, какие изменения нужно применить к исходному коду.

Суть: правильное управление модулями и модификаторами в OpenCart 3 помогает избежать конфликтов и проблем при обновлении системы и расширений. Никакой магии. Факт. Разработчикам рекомендуется использовать OCMod для внесения изменений в код, а администраторы должны следить за тем, чтобы устанавливаемые модули и модификаторы были совместимы с версией OpenCart и друг с другом.

Как безопасно устанавливать и дорабатывать модули OpenCart

• Проверьте совместимость модуля с вашей версией OpenCart, PHP и темой оформления.
• Сделайте резервную копию файлов и базы данных перед установкой.
• После установки обновите модификаторы в разделе Расширения → Модификаторы и очистите кэш темы.
• Проверьте журнал ошибок OpenCart и PHP: конфликты модулей часто видны именно там.
• Не редактируйте файлы ядра напрямую, если задачу можно решить через модуль, событие, OCMOD или отдельную доработку.

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

но и структуру файлов, наличие языковых файлов, корректный OCMOD, понятную документацию и отсутствие грубых правок системных файлов.

Я занимаюсь разработкой на OpenCart с 2009 года, запустил больше 150 проектов. Через мои руки прошли магазины от маленьких витрин до каталогов на 50 000 товаров. Знаю CMS вдоль и поперёк: slow-

логи MySQL, конфликты OCMOD-модификаторов, грабли с SEO URL. Если у вас есть вопрос — пишите, подскажу.

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

Как лучше: Структура модуля OpenCart: контроллер (catalog/controller), модель (model), шаблон (view/template), языковой файл (language).

Как не делать: Не создавайте модуль без языкового файла — это нарушает архитектуру MVC-L.

Кейс из практики: Написали модуль без языкового файла — пришлось переделывать. С языковым файлом удобнее: текст отдельно от логики.

По практике, MVC-L — основа модульной архитектуры OpenCart. Закажите доработку OpenCart

📌 Рекомендуем к прочтению:

• расчёт unit-экономики вашего магазина
• юридические требования к интернет-магазину в России
• как увеличить средний чек магазина
• интеграцию CRM-системы с магазином

h

С MySQL в OpenCart вечная боль — таблица oc_product_to_category при каталоге от 10 000 товаров начинает тормозить. Без индекса по `product_id` и `category_id` выборка фильтра может длиться 2-

3 секунды. Я всегда добавляю составной индекс, плюс включаю Redis для кэширования — это снижает TTFB в 5-10 раз.

Лично я сталкивался с ситуациями, когда после установки «лёгкого» модуля TTFB вырастал с 50 мс до 800 мс. Причина — кривой OCMOD-

модификатор, который дёргал SQL-запросы без индексов. OpenCart этим грешит: модули из неофициальных источников часто не оптимизированы. Лечится аудитом запросов через slow-query-log и рефакторингом oc_product_to_category.

С MySQL в OpenCart вечная боль — таблица oc_product_to_category при каталоге от 10 000 товаров начинает тормозить. Без индекса по product_id и category_id выборка фильтра может длиться 2-

3 секунды. Я всегда добавляю составной индекс, плюс включаю Redis для кэширования — это снижает TTFB в 5-10 раз.

OCMOD — палка о двух концах. С одной стороны, позволяет править файлы без взлома ядра. С другой — десять модификаторов от разных авторов гарантированно конфликтуют. Особенно если один правит catalog/controller/product/category.php,

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

FAQ: структура модуля OpenCart

Где лежит контроллер модуля в OpenCart 3?

Контроллер модуля для админки обычно находится в admin/controller/extension/module/, а контроллер для витрины — в catalog/controller/extension/module/. Имя файла должно совпадать с кодом модуля.

Где находится шаблон модуля OpenCart?

Шаблон модуля на витрине находится в папке активной темы: catalog/view/theme/ваша_тема/template/extension/module/. Если файл отсутствует в теме, часто используют шаблон из default, но лучше явно проверять логику конкретной темы.

Нужно ли модулю OpenCart иметь модель?

Модель нужна не всегда. Если модуль только выводит простые настройки, можно обойтись контроллером, языковым файлом и Twig-шаблоном. Если модуль работает с товарами, заказами, таблицами или сложными запросами, модель лучше вынести отдельно.

Чем модуль отличается от модификатора OCMOD?

Модуль добавляет отдельную функциональность, настройки или блоки. OCMOD изменяет существующие файлы OpenCart без ручной правки ядра. В хороших расширениях модуль и OCMOD могут использоваться вместе: модуль хранит настройки, а OCMOD аккуратно подключает нужные изменения.

Из практики. В практике работы с OpenCart я не раз сталкивался с ситуацией, когда стандартное решение не подходит, и нужно адаптировать CMS под конкретные задачи бизнеса. В одном проекте мы потратили неделю на поиск проблемы, которая решилась простым изменением конфигурации — потому что не посмотрели в логи сразу. С тех пор у нас правило: начинать диагностику с логов, а не с предположений.

Как не надо. Не копируйте готовые решения из интернета без проверки совместимости с вашей версией OpenCart и установленными модулями. То, что сработало у другого владельца магазина, может сломать ваш сайт — особенно если у вас нестандартная сборка. Всегда делайте бэкап перед любыми изменениями.