Интернет-магазин на 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.
Почему модуль лучше плагина для уникальных задач?
| Характеристика | Модуль | Плагин |
|---|---|---|
| Распространение | Только в проекте | Composer-пакет |
| Лицензия | Не требуется | Есть (MIT, GPL и т.д.) |
| Версионирование | Нет | CHANGELOG.md |
| Стоимость разработки | На 30–40% ниже | Выше из-за универсальности |
| Скорость разработки | В 2–3 раза быстрее | Дольше из-за универсальности |
Модуль лучше, если функциональность привязана к конкретному сайту. Плагин — когда планируется публикация или тиражирование. Мы гарантируем, что модуль не содержит лишних зависимостей и строго соответствует вашим требованиям. Закажите разработку модуля под ключ — сэкономьте до 40% бюджета по сравнению с самостоятельным внедрением.
Состав кастомного модуля
Этапы разработки
| Этап | Длительность | Результат |
|---|---|---|
| Анализ требований | 1–2 дня | ТЗ, проектирование |
| Реализация сервисов и расширений | 2–5 дней | Код модуля |
| Интеграция и тестирование | 1–2 дня | Работающая функциональность |
| Документирование и сдача | 0.5–1 день | Документация, доступы |
Общий срок: от 3 до 7 дней в зависимости от сложности.
Что входит в работу
- Код модуля с комментариями на русском/английском
- Документация по установке и настройке
- Консольные команды (при наличии)
- Интеграция с шаблонами (Twig-расширения)
- 30 дней поддержки после сдачи проекта
Типичные ошибки при разработке модулей
- Путаница с пространством имён — модуль должен быть в неймспейсе
modules\имяпроекта, иначе автозагрузка не сработает. - Забыли прописать alias — без
Craft::setAlias('@modules/...', __DIR__)не подгрузятся файлы. - Дублирование логики — часто пытаются копировать код из плагинов, нарушая принцип единственной ответственности.
Избежать этих ошибок помогает наш опыт и code review. Сертифицированные разработчики с 5+ годами опыта гарантируют качество кода.
Процесс работы и регистрация модуля
- Создайте папку
modules/ваш-модульи добавьте основной класс. - Определите неймспейс
modules\ваш-модуль. - Зарегистрируйте модуль в
config/app.phpв секциях'modules'и'bootstrap'. - Пропишите alias
Craft::setAlias('@modules/ваш-модуль', __DIR__)в методеinit()основного класса. - Запустите
php craft project-config/applyдля синхронизации конфигурации.
Почему выгодно заказать модуль под ключ?
Разработка модуля под ключ экономит время вашей команды: не нужно разбираться в тонкостях Yii2 и архитектуры Craft. Мы берём на себя проектирование, реализацию и тестирование. Свяжитесь с нами, чтобы разработать кастомный модуль Craft CMS для вашего проекта. Получите консультацию — оценим задачу и предложим решение.