Разработка кастомного модуля Craft CMS под бизнес-задачи

Интернет-магазин на Craft CMS — товары приходят из 1С по CommerceML, но цены обновляются раз в сутки. Клиенты жалуются на устаревшие акции, а редактору нужен кастомный отчёт по продажам с фильтрами по категориям и периодам. Стандартные плагины вроде CP Reports не дают нужной гибкости — приходится лезть в ядро Craft или писать CRON-скрипты поверх. Выход — разработать кастомный модуль на Yii2 (Yii Framework), который решает обе задачи: консольная команда для синхронизации цен и Twig-расширение для отчёта.

Мы создаём модули, которые решают ровно одну задачу и не тянут лишнего. За пять лет реализовали более 20 проектов: от простых Twig-расширений до полноценных консольных синхронизаторов с внешними API. В этой статье — как мы это делаем и что получается в итоге.

Разработка кастомного модуля Craft CMS: как это делается

Проблемы, которые решаем — разработка кастомного модуля

• Интеграция с внешним API: синхронизация товаров с 1С через REST API. Стандартные плагины не поддерживают кастомные поля, поэтому модуль реализует сервис SyncService с методами syncPrices(), syncStocks(). Консольная команда запускается по крону каждые 15 минут, обеспечивая актуальность данных.
• Кастомные отчёты и дашборды: для редактора нужен отчёт по продажам за неделю с группировкой по категориям. Через модуль подключаем свой контроллер DashboardController и Twig-шаблоны, используя Yii2 GridView для таблиц.
• Сложные Twig-фильтры: форматирование телефонов, цен с пробелами, SVG-иконок. Выносим в Twig-расширение, чтобы не дублировать код в шаблонах.
• Нестандартные поля: например, поле «срок годности» с автоматическим расчётом. Создаём поведение (behavior) для элемента, которое валидирует поле при сохранении.

Как мы это делаем

Используем актуальные версии: Craft CMS 4/5, PHP 8.1+, Yii2 — основа Craft CMS. Основной стек — PHP, Yii2, Twig, MySQL/PostgreSQL. Для консольных команд — Symfony Console, встроенный в Craft.

Разберём типичный кейс: интернет-магазину потребовался кастомный блок «Товары со скидкой» с динамическим обновлением цен каждые 15 минут. Мы реализовали:

• Сервис DiscountService — получает товары со скидкой из БД с кэшированием через Redis.
• Twig-функцию discountProducts() — выводит блок на странице.
• Консольную команду discount/update — обновляет данные по крону.

Благодаря оптимизации запросов время генерации сложных отчётов сокращается на 40%. Модуль не создаёт лишней нагрузки на сервер — все сервисы загружаются только при необходимости.

Ключевой класс модуля — SiteCustomModule, который регистрирует сервисы и Twig-расширения. Вот его структура:

// modules/sitecustom/SiteCustomModule.php namespace modules\sitecustom; use Craft; use craft\events\RegisterComponentTypesEvent; use craft\services\Elements; use craft\web\twig\variables\CraftVariable; use modules\sitecustom\services\ProductService; use modules\sitecustom\variables\SiteVariable; use modules\sitecustom\twigextensions\SiteTwigExtension; use yii\base\Event; use yii\base\Module; class SiteCustomModule extends Module { public static SiteCustomModule $instance; public function init(): void { parent::init(); self::$instance = $this; Craft::setAlias('@modules/sitecustom', __DIR__); $this->setComponents([ 'products' => ProductService::class, ]); Event::on(CraftVariable::class, CraftVariable::EVENT_INIT, function (Event $event) { $event->sender->set('site', SiteVariable::class); }); if (Craft::$app->request->getIsSiteRequest()) { Craft::$app->view->registerTwigExtension(new SiteTwigExtension()); } } } 

Регистрация в config/app.php:

return [ 'modules' => [ 'site-custom' => \modules\sitecustom\SiteCustomModule::class, ], 'bootstrap' => ['site-custom'], ]; 

Пример сервиса с бизнес-логикой

// modules/sitecustom/services/ProductService.php namespace modules\sitecustom\services; use craft\base\Component; use craft\elements\Entry; class ProductService extends Component { public function getFeaturedProducts(int $limit = 6): array { return Entry::find() ->section('products') ->featured(true) ->inStock(true) ->orderBy('sortOrder asc, postDate desc') ->limit($limit) ->with(['featuredImage', 'categories']) ->all(); } public function updateStock(int $entryId, int $quantity): bool { $entry = Entry::find()->id($entryId)->one(); if (!$entry) return false; $entry->setFieldValue('stockQuantity', $quantity); return \Craft::$app->elements->saveElement($entry); } } 

Пример Twig-расширения

// modules/sitecustom/twigextensions/SiteTwigExtension.php namespace modules\sitecustom\twigextensions; use Twig\Extension\AbstractExtension; use Twig\TwigFilter; use Twig\TwigFunction; class SiteTwigExtension extends AbstractExtension { public function getFilters(): array { return [ new TwigFilter('formatPrice', [$this, 'formatPrice']), new TwigFilter('phoneFormat', [$this, 'formatPhone']), ]; } public function getFunctions(): array { return [ new TwigFunction('svg', [$this, 'inlineSvg'], ['is_safe' => ['html']]), ]; } public function formatPrice(float $price, string $currency = 'RUB'): string { return number_format($price, 0, '.', ' ') . ' ' . $currency; } public function formatPhone(string $phone): string { $digits = preg_replace('/\D/', '', $phone); return preg_replace('/(\d)(\d{3})(\d{3})(\d{2})(\d{2})/', '+$1 ($2) $3-$4-$5', $digits); } public function inlineSvg(string $name): string { $path = \Craft::getAlias('@webroot/icons/' . $name . '.svg'); return file_exists($path) ? file_get_contents($path) : ''; } } 

Пример консольной команды

// modules/sitecustom/console/controllers/SyncController.php namespace modules\sitecustom\console\controllers; use craft\console\Controller; use yii\console\ExitCode; class SyncController extends Controller { public function actionProducts(): int { $this->stdout("Синхронизация товаров...\n"); $count = SiteCustomModule::$instance->products->syncFromExternalApi(); $this->stdout("Синхронизировано: {$count} товаров\n"); return ExitCode::OK; } } 

Запуск: php craft site-custom/sync/products.

Почему модуль лучше плагина для уникальных задач?

Модуль лучше, если функциональность привязана к конкретному сайту. Плагин — когда планируется публикация или тиражирование. Мы гарантируем, что модуль не содержит лишних зависимостей и строго соответствует вашим требованиям. Закажите разработку модуля под ключ — сэкономьте до 40% бюджета по сравнению с самостоятельным внедрением.

Состав кастомного модуля

Этапы разработки

Общий срок: от 3 до 7 дней в зависимости от сложности.

Что входит в работу

• Код модуля с комментариями на русском/английском
• Документация по установке и настройке
• Консольные команды (при наличии)
• Интеграция с шаблонами (Twig-расширения)
• 30 дней поддержки после сдачи проекта

Типичные ошибки при разработке модулей

• Путаница с пространством имён — модуль должен быть в неймспейсе modules\имяпроекта, иначе автозагрузка не сработает.
• Забыли прописать alias — без Craft::setAlias('@modules/...', __DIR__) не подгрузятся файлы.
• Дублирование логики — часто пытаются копировать код из плагинов, нарушая принцип единственной ответственности.

Избежать этих ошибок помогает наш опыт и code review. Сертифицированные разработчики с 5+ годами опыта гарантируют качество кода.

Процесс работы и регистрация модуля

1. Создайте папку modules/ваш-модуль и добавьте основной класс.
2. Определите неймспейс modules\ваш-модуль.
3. Зарегистрируйте модуль в config/app.php в секциях 'modules' и 'bootstrap'.
4. Пропишите alias Craft::setAlias('@modules/ваш-модуль', __DIR__) в методе init() основного класса.
5. Запустите php craft project-config/apply для синхронизации конфигурации.

Почему выгодно заказать модуль под ключ?

Разработка модуля под ключ экономит время вашей команды: не нужно разбираться в тонкостях Yii2 и архитектуры Craft. Мы берём на себя проектирование, реализацию и тестирование. Свяжитесь с нами, чтобы разработать кастомный модуль Craft CMS для вашего проекта. Получите консультацию — оценим задачу и предложим решение.