Иногда по тем или иным причинам контент менеджерам необходимо конвертировать тот или иной продукт из Simple в Virtual или наоборот, сменить ему атрибут сет и так далее… Чаще всего это ложится на плечи разработчиков. И тут я хотел бы описать 1 новую и очень интересную особенность Magento 2, которая никак не описана в официальной документации.
Для изменения типа продукта в Magento 1.* контент менеджерам пришлось бы создавать новые продукты вручную, делать их копиями оригинальных товаров и так далее или просить разработчиков сделать это через код. В Magento 2.* внедрена новая «особенность» для достижения этой цели. Прежде же чем разобраться с ней (я назову ее «авто конверсия») вам следует иметь в виду несколько моментов, для получения правильных результатов.
Давайте посмотрим в админ панель, вернее как это работает с точки зрения контент менеджера. Как и прежде вы можете выбрать тип нового товара до того, как вы его создадите.
В Magento 1 это отображается на Admin > Catalog > Manage Products > Страница выбора атрибут сета и типа продукта после нажатия на “Add Product”.
В Magento 2 для этого на странице Admin > Products > Catalog нажмите на стрелку с права от кнопки «Add Product».
После выбора необходимого типа Magento покажет вам страницу редактирования нового товара с предопределенными опциями и/или новыми секциями для выбранного типа. Если вы выберите тип продукта Simple product или просто нажмете на “Add Product” то увидите страницу редактирования Simple продукта, но обратите внимание на следующие 3 вещи:
Эти 3 секции определяют тип продукта.
Magento 2 может автоматически (при сохранении) изменять типы продуктов как у новых так и уже существующих продуктов следующих товаров:
Рассмотрим, что для этого необходимо сделать.
Simple и Virtual продукты
Если вы установите вес «Weight» = «The item has no weight» (именно нет веса, а не удалите просто значение из инпут поля) то продукт будет сохранен как Virtual продукт, но как только вы вернетесь на страницу редактирования товара и укажите, что у товара есть вес, то он будет конвертирован в Simple продукт сразу же после сохранения.
Downloadable продукт
Для того, что превратить Simple продукт в Downloadable вам нужно установить «Weight» = «The item has no weight» и ниже в секции «Downloadable Information» добавить 1 или более ссылок. Чтобы превратить этот товар обратно в Simple продукт достаточно установить «Weight» = «The item has weight» и сохранить продукт.
Configurable продукт
Для превращения Simple продукта в Configurable, достаточно добавить любой дочерний товар к нему как указано выше. А для того, чтобы сделать его снова Simple продуктом достаточно удалить все конфигурации и нажать на save. Как вы уже поняли, это значит, что в Magento 2 не может быть Configurable продукта без детей ( как это было в Magento 1).
Вот собственно и все.
Перед тем как использовать авто конверсию в конфигурируемый товар надо иметь в виду, что в Magento 2 изменен принцип получения цены от Configurable продукта. В Magento 1 Configurable продукты имели свою собственную цену и полностью игнорировали цену связанных с ними продуктов. В Magento 2 применен другой подход. Сейчас Configurable продукты используют рассчитанную цену из привязанных детей. Обратной стороной медали является то, что при удалении всех привязанных продуктов товар конвертируется в Simple продукт, но если удалить все связанные с ним продукты с Grid страницы в админ панели, то продукт не конвертируется ( почему это так, я опишу позже ). Учитывая новую логику, то что товар является Configurable только если у него есть дети, в противном случае он «конвертируется» в Simple продукт, это может привести к некоторым не предвидимым ошибкам в коде, особенно если вы работаете с импортом товаров.
* В Magento 2.1 некоторые из этих ошибок исправлены и при прямом обращении к методу $product->getFinalPrice() теперь выбрасывается исключение
Теперь давайте поговорим о том, как именно все это работает. Я бы хотел начать с самого главного, с класса Magento\Catalog\Model\Product\TypeTransitionManager.
Это достаточно простой класс, который обладает 2мя методами __construct и processProduct. Вся магия заключена во втором методе, processProduct($product). Как вы видите, он проверяет есть ли тип переданного продукта в массиве совместимых типов и если продукт имеет вес то это Simple продукт, если нет то Virtual продукт.
В Magento 2.1. как вы уже догадались, совместимы следующие типы:
Все они передаются через di.xml
Это значит, что только эти типы могут быть конвертированы в Simple или Virtual продукты.
Как было сказано выше, Simple продукт может быть конвертирован в конфигурируемый и загружаемый товар так же. Вся магия в следующих классах (плагинах):
Magento\Downloadable\Model\Product\TypeTransitionManager\Plugin\Downloadable::aroundProcessProduct() проверяет, что тип продукта Simple, Virtual, Downloadable, с фронтенда были постом отправлены данные с ключем downloadable и то, что этот продукт не имеет веса. Если это так, то он Downloadable, в противном случае запускается оригинальный метод.
Magento\ConfigurableProduct\Model\Product\TypeTransitionManager\Plugin\Configurable::aroundProcessProduct() плагин меняет тип продукта на “configurable” если в реквесте имеются данные с ключем “attributes”, в противном случае запускается оригинальный метод.
Если вы попробуете сохранить товар из админ панели, как было написано выше, то он сменит свой тип на 1 из указанных выше благодаря этому коду, но если просто попробовать сохранить модель продукта через метод save() то ничего не изменится. Дело в контроллере, который обрабатывает сохранение товаров.
Magento\Catalog\Controller\Adminhtml\Product\Save::execute() использует инстанс класса Magento\Catalog\Model\Product\TypeTransitionManager
Как вы видите конвертирование товара никак не привязано к методу save() и вызывается непосредственно перед созданием продукта.
Для пользователей и разработчиков, я думаю стало чуть понятнее как именно работает новая особенность Magento 2. Меня удивляет, что за все время существования Magento 2 ни где не написали о ней.
Так же хочется добавить, что в Magento 2 достаточно просто добавить новые типы товаров и если вам может понадобиться позволить пользователям конвертировать их между собой то вам достаточно будет добавить пару строчек в di.xml вашего модуля и создать свой собственный плагин.
Для изменения типа продукта в Magento 1.* контент менеджерам пришлось бы создавать новые продукты вручную, делать их копиями оригинальных товаров и так далее или просить разработчиков сделать это через код. В Magento 2.* внедрена новая «особенность» для достижения этой цели. Прежде же чем разобраться с ней (я назову ее «авто конверсия») вам следует иметь в виду несколько моментов, для получения правильных результатов.
Авто конверсия с точки зрения пользователя
Давайте посмотрим в админ панель, вернее как это работает с точки зрения контент менеджера. Как и прежде вы можете выбрать тип нового товара до того, как вы его создадите.
В Magento 1 это отображается на Admin > Catalog > Manage Products > Страница выбора атрибут сета и типа продукта после нажатия на “Add Product”.
В Magento 2 для этого на странице Admin > Products > Catalog нажмите на стрелку с права от кнопки «Add Product».
После выбора необходимого типа Magento покажет вам страницу редактирования нового товара с предопределенными опциями и/или новыми секциями для выбранного типа. Если вы выберите тип продукта Simple product или просто нажмете на “Add Product” то увидите страницу редактирования Simple продукта, но обратите внимание на следующие 3 вещи:
- Атрибут Вес (Weight)
- Секция Configurations
- Секция Downloadable Information
Эти 3 секции определяют тип продукта.
Magento 2 может автоматически (при сохранении) изменять типы продуктов как у новых так и уже существующих продуктов следующих товаров:
Рассмотрим, что для этого необходимо сделать.
Simple и Virtual продукты
Если вы установите вес «Weight» = «The item has no weight» (именно нет веса, а не удалите просто значение из инпут поля) то продукт будет сохранен как Virtual продукт, но как только вы вернетесь на страницу редактирования товара и укажите, что у товара есть вес, то он будет конвертирован в Simple продукт сразу же после сохранения.
Downloadable продукт
Для того, что превратить Simple продукт в Downloadable вам нужно установить «Weight» = «The item has no weight» и ниже в секции «Downloadable Information» добавить 1 или более ссылок. Чтобы превратить этот товар обратно в Simple продукт достаточно установить «Weight» = «The item has weight» и сохранить продукт.
Configurable продукт
Для превращения Simple продукта в Configurable, достаточно добавить любой дочерний товар к нему как указано выше. А для того, чтобы сделать его снова Simple продуктом достаточно удалить все конфигурации и нажать на save. Как вы уже поняли, это значит, что в Magento 2 не может быть Configurable продукта без детей ( как это было в Magento 1).
Вот собственно и все.
На заметку
Перед тем как использовать авто конверсию в конфигурируемый товар надо иметь в виду, что в Magento 2 изменен принцип получения цены от Configurable продукта. В Magento 1 Configurable продукты имели свою собственную цену и полностью игнорировали цену связанных с ними продуктов. В Magento 2 применен другой подход. Сейчас Configurable продукты используют рассчитанную цену из привязанных детей. Обратной стороной медали является то, что при удалении всех привязанных продуктов товар конвертируется в Simple продукт, но если удалить все связанные с ним продукты с Grid страницы в админ панели, то продукт не конвертируется ( почему это так, я опишу позже ). Учитывая новую логику, то что товар является Configurable только если у него есть дети, в противном случае он «конвертируется» в Simple продукт, это может привести к некоторым не предвидимым ошибкам в коде, особенно если вы работаете с импортом товаров.
* В Magento 2.1 некоторые из этих ошибок исправлены и при прямом обращении к методу $product->getFinalPrice() теперь выбрасывается исключение
Fatal error: Uncaught exception 'Magento\Framework\Exception\LocalizedException' with message 'Configurable product "…sku…" does not have sub-products' in vendor\magento\module-configurable-product\Pricing\Price\ConfigurablePriceResolver.php:52
Для разработчиков
Теперь давайте поговорим о том, как именно все это работает. Я бы хотел начать с самого главного, с класса Magento\Catalog\Model\Product\TypeTransitionManager.
...
public function __construct(
\Magento\Catalog\Model\Product\Edit\WeightResolver $weightResolver,
array $compatibleTypes
) {
$this->compatibleTypes = $compatibleTypes;
$this->weightResolver = $weightResolver;
}
public function processProduct(Product $product)
{
if (in_array($product->getTypeId(), $this->compatibleTypes)) {
$product->setTypeInstance(null);
$productTypeId = $this->weightResolver->resolveProductHasWeight($product)
? Type::TYPE_SIMPLE
: Type::TYPE_VIRTUAL;
$product->setTypeId($productTypeId);
}
}
...
Это достаточно простой класс, который обладает 2мя методами __construct и processProduct. Вся магия заключена во втором методе, processProduct($product). Как вы видите, он проверяет есть ли тип переданного продукта в массиве совместимых типов и если продукт имеет вес то это Simple продукт, если нет то Virtual продукт.
В Magento 2.1. как вы уже догадались, совместимы следующие типы:
- Simple
- Virtual
- Downloadable
- Configurable
Все они передаются через di.xml
...
<type name="Magento\Catalog\Model\Product\TypeTransitionManager">
<arguments>
<argument name="compatibleTypes" xsi:type="array">
<item name="simple" xsi:type="const">Magento\Catalog\Model\Product\Type::TYPE_SIMPLE</item>
<item name="virtual" xsi:type="const">Magento\Catalog\Model\Product\Type::TYPE_VIRTUAL</item>
</argument>
</arguments>
</type>
...
Это значит, что только эти типы могут быть конвертированы в Simple или Virtual продукты.
Как было сказано выше, Simple продукт может быть конвертирован в конфигурируемый и загружаемый товар так же. Вся магия в следующих классах (плагинах):
- Magento\Downloadable\Model\Product\TypeTransitionManager\Plugin\Downloadable
- Magento\ConfigurableProduct\Model\Product\TypeTransitionManager\Plugin\Configurable
Magento\Downloadable\Model\Product\TypeTransitionManager\Plugin\Downloadable::aroundProcessProduct() проверяет, что тип продукта Simple, Virtual, Downloadable, с фронтенда были постом отправлены данные с ключем downloadable и то, что этот продукт не имеет веса. Если это так, то он Downloadable, в противном случае запускается оригинальный метод.
...
public function aroundProcessProduct(
\Magento\Catalog\Model\Product\TypeTransitionManager $subject,
Closure $proceed,
\Magento\Catalog\Model\Product $product
) {
$isTypeCompatible = in_array(
$product->getTypeId(),
[
\Magento\Catalog\Model\Product\Type::TYPE_SIMPLE,
\Magento\Catalog\Model\Product\Type::TYPE_VIRTUAL,
\Magento\Downloadable\Model\Product\Type::TYPE_DOWNLOADABLE
]
);
$downloadableData = $this->request->getPost('downloadable');
$hasDownloadableData = false;
if (isset($downloadableData)) {
foreach ($downloadableData as $data) {
foreach ($data as $rowData) {
if (empty($rowData['is_delete'])) {
$hasDownloadableData = true;
break 2;
}
}
}
}
if ($isTypeCompatible && $hasDownloadableData && !$this->weightResolver->resolveProductHasWeight($product)) {
$product->setTypeId(\Magento\Downloadable\Model\Product\Type::TYPE_DOWNLOADABLE);
return;
}
$proceed($product);
}
...
Magento\ConfigurableProduct\Model\Product\TypeTransitionManager\Plugin\Configurable::aroundProcessProduct() плагин меняет тип продукта на “configurable” если в реквесте имеются данные с ключем “attributes”, в противном случае запускается оригинальный метод.
...
public function aroundProcessProduct(
\Magento\Catalog\Model\Product\TypeTransitionManager $subject,
Closure $proceed,
\Magento\Catalog\Model\Product $product
) {
$attributes = $this->request->getParam('attributes');
if (!empty($attributes)) {
$product->setTypeId(\Magento\ConfigurableProduct\Model\Product\Type\Configurable::TYPE_CODE);
return;
}
$proceed($product);
}
...
Как все это работает
Если вы попробуете сохранить товар из админ панели, как было написано выше, то он сменит свой тип на 1 из указанных выше благодаря этому коду, но если просто попробовать сохранить модель продукта через метод save() то ничего не изменится. Дело в контроллере, который обрабатывает сохранение товаров.
Magento\Catalog\Controller\Adminhtml\Product\Save::execute() использует инстанс класса Magento\Catalog\Model\Product\TypeTransitionManager
...
$product = $this->initializationHelper->initialize($this->productBuilder->build($this->getRequest()));
$this->productTypeManager->processProduct($product);
…
$product->save();
...
Как вы видите конвертирование товара никак не привязано к методу save() и вызывается непосредственно перед созданием продукта.
Вместо заключения
Для пользователей и разработчиков, я думаю стало чуть понятнее как именно работает новая особенность Magento 2. Меня удивляет, что за все время существования Magento 2 ни где не написали о ней.
Так же хочется добавить, что в Magento 2 достаточно просто добавить новые типы товаров и если вам может понадобиться позволить пользователям конвертировать их между собой то вам достаточно будет добавить пару строчек в di.xml вашего модуля и создать свой собственный плагин.
Поделиться с друзьями