Интернет-магазин на Drupal Commerce: настройка, кастомизация, запуск

Представьте: интернет-магазин мебелью с сотнями SKU, каждая комбинация ткани и ножек — отдельный товар со своей ценой и остатком. На WooCommerce это потребовало бы десятка плагинов и костылей. Drupal Commerce 2.x решает задачу без них. Архитектура на плагинах и YAML-конфигах позволяет гибко описать любую товарную иерархию. Drupal Commerce — не просто корзина, а фреймворк для сложной e-commerce логики.

Проблемы, которые решает Drupal Commerce 2.x

Стандартные модули Drupal не всегда покрывают сложную e-commerce логику. Например, товар с несколькими вариациями (цвет, размер) и разными ценами. Или многоуровневые скидки на основе истории заказов. Часто к нам приходят после неудачных попыток адаптировать WooCommerce под Drupal. Когда интеграция с 1С нужна на уровне обмена заказами и остатками, Commerce 2.x справляется лучше.

Но это не все сложности. Реальный кейс: клиент продаёт мебель с десятками комбинаций ткани и ножек. Каждая комбинация — отдельный SKU с ценой и остатком. В Commerce 2.x это решается через Product Variation, а custom fields — через Field API. Другой пример: нужно собрать один заказ из товаров в разных магазинах (multi-store). Commerce Stores из коробки поддерживает раздельные корзины и платёжные профили. Экономия на разработке очевидна: не нужно писать кастомные модули под каждую задачу.

Почему Commerce 2.x лучше Commerce 1.x?

Commerce 2.x полностью переписан для новых версий Drupal и несовместим с первой версией. Вот ключевые отличия:

Если проект всё ещё на Drupal 7, придётся либо использовать legacy Commerce 1.x, либо мигрировать с полной переработкой. Наш опыт показывает, что миграция с Commerce 1.x на 2.x занимает 2–4 недели в зависимости от кастомизаций.

Что делать, если нужна миграция с Commerce 1.x?

Миграция — это не просто перенос данных, а переработка бизнес-логики. Commerce 1.x и 2.x несовместимы: модули, хуки, структура базы — всё разное. Мы разрабатываем план миграции, который включает: аудит текущей функциональности, экспорт данных в CSV/JSON, написание миграционных скриптов на Migrate API, настройку нового магазина с нуля. После миграции заказы и остатки переносятся, а кастомные checkout flows переписываются под плагинную архитектуру.

Базовая установка через Composer

composer require drupal/commerce drupal/commerce_price drupal/commerce_store \ drupal/commerce_product drupal/commerce_order drupal/commerce_cart \ drupal/commerce_checkout drupal/commerce_payment drupal/commerce_tax drush en commerce commerce_product commerce_cart commerce_checkout \ commerce_payment commerce_tax commerce_order -y drush cr 

Настройка магазина и типов продуктов

Создайте магазин в /admin/commerce/config/stores. Укажите базовую валюту, страну по умолчанию и список стран для доставки.

Товары в Commerce делятся на product (карточка) и variation (SKU с ценой). Создайте типы продуктов и вариаций через админку. Для программного создания используйте код:

use Drupal\commerce_price\Price; use Drupal\commerce_product\Entity\Product; use Drupal\commerce_product\Entity\ProductVariation; $variation = ProductVariation::create([ 'type' => 'default', 'sku' => 'CHAIR-BLK-L', 'price' => new Price('1499.00', 'RUB'), 'field_color' => ['target_id' => $colorTermId], 'field_size' => 'L', ]); $variation->save(); $product = Product::create([ 'type' => 'default', 'title' => 'Кресло офисное', 'stores' => [$storeId], 'variations' => [$variation], ]); $product->save(); 

Для каталога используйте Views. Настройте фильтры по цене, атрибутам, магазину. Для фасетного поиска подключите Search API и Solr.

Как настроить checkout flow под свою бизнес-логику?

Commerce 2.x позволяет кастомизировать процесс оформления заказа через Checkout Flows. Вы можете добавлять или удалять шаги: авторизация, адрес доставки, платёжная информация, подтверждение. Если нужно нестандартное поле, например, заметка к заказу, создайте плагин:

/** * @CommerceCheckoutPane( * id = "custom_gift_note", * label = @Translation("Gift note"), * default_step = "order_information", * ) */ class GiftNotePane extends CheckoutPaneBase { public function buildPaneForm(array $pane_form, FormStateInterface $form_state, array &$complete_form): array { $pane_form['gift_note'] = [ '#type' => 'textarea', '#title' => $this->t('Сообщение получателю'), '#rows' => 3, ]; return $pane_form; } } 

Подключите платёжные шлюзы: Stripe, PayPal, ЮKassa через соответствующие модули. Конфигурация шлюза включает ключи API и выбор режима (тестовый/боевой). Гарантируем поддержку последних версий Drupal.

Управление складом и налоги

Commerce не включает инвентаризацию из коробки — используйте модуль commerce_stock. Он добавляет поле остатка на вариации и поддерживает несколько складов.

use Drupal\commerce_stock\StockServiceManagerInterface; $stockService = \Drupal::service('commerce_stock.service_manager') ->getService($productVariation); $level = $stockService->getStockLevel($productVariation, $locations); $stockService->createTransaction( $productVariation, $locationId, [], 100, new Price('0', 'RUB'), 'RUB', TRANSACTION_TYPE_IN, [] ); 

Налоги настраиваются через модуль commerce_tax. Создайте налоговый тип, укажите ставку и территории. Например, НДС 20% для Беларуси. Commerce автоматически применит ставку по адресу покупателя.

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

1. Анализ требований и подготовка технического задания
2. Установка Drupal и Commerce на хостинг
3. Настройка магазина, типов продуктов и вариаций
4. Разработка кастомных шагов оформления (если нужно)
5. Подключение платёжного шлюза и налогов
6. Интеграция со складом
7. Настройка каталога с поиском
8. Тестирование и обучение администраторов
9. Документация по работе с системой
10. Гарантийное обслуживание 1 месяц

Сроки реализации

Базовый рабочий магазин — от 1,5 до 2 недель. Сложный проект с кастомной логикой — от 3 до 5 недель. Получите предварительную оценку: мы поможем понять, какие модули нужны и сколько времени займёт разработка. Свяжитесь с нами для обсуждения деталей.