msProductKits - удобное управление товарами-комплектами (наборами товаров)

Всем привет!

Сегодня хотел бы представить небольшой компонент под названием msProductKits, назначение которого — обеспечить удобную работу с товарами, представляющими собой комплект (набор) из других товаров. Компонент работает только с товарами miniShop2.

Пара сценариев, чтобы было понятно, для чего можно использовать:

1. Магазин шин и дисков.
В магазине продаются шины, колесные диски, их можно купить по одной штуке.
А еще мы хотим продавать промо-набор, куда входят: шины 4 шт, диски 4 шт, пакеты для хранения шин 4 шт и сертификат на шиномонтаж. При этом пакеты и сертификат отдельно купить нельзя, таких товаров на сайте нет.

2. Магазин производителя акустики.
Производитель выпускает несколько видов колонок, которые вполне себе можно купить по отдельности.
Но еще есть готовый набор, куда входят: 4 двухполосные акустические системы, центральный канал, сабвуфер и усилитель мощности. Этот набор можно купить целиком, на сайте он представлен отдельным товаром, причем его цена ниже, чем если покупать все отдельно. При этом усилитель отдельно не продается, это вообще сторонний усилитель, не этого производителя, он предлагается по партнерской программе.

Наша задача в обоих случаях — это у товара, представляющего собой «Комплект», сделать связи с другими товарами, указать сколько их штук входит в этот комплект, да еще как-то указать, что в этот комплект входят некие другие товары, которых нет на сайте и ссылку на них мы дать не можем.

Административная часть

msProductKits добавляет в карточке товара новую вкладку Комплекты, где можно прописать связи между товарами, а так же указать дополнительные сведения.

Для примера я использую демонстрационный каталог (магазин шин/дисков) со следующей структурой:


У товара появилась новая вкладка, где можно добавить позиции комплекта:


Каждая строка — это товар, являющийся частью комплекта. Товар может быть как ссылкой на существующий товар (msProduct), так и мы можем просто написать его название. Так же можно указать некоторые дополнительные сведения (описание, количество, артикул, производителя).



У товара, который при этом является частью комплекта, в этой вкладке отображаются все комплекты, в состав которых он входит.



Логично, что если товар является комплектом, то один товар — один комплект, а вот как часть товар может входить в любое количество комплектов.

Фронтэнд
На сайте можно вывести информацию при помощи сниппета msProductKits.

Параметры сниппета msProductKits:

• resource — id товара, по-умолчанию текущий ресурс;
• mode — режим работы сниппета, может принимать 2 значения: owner (делаем выборку товаров, которые входят в комплект) или product (делаем выборку тех товаров, в которые входит наш товар как часть комплекта). В режиме product имеет смысл либо делать join таблицы ресурсов, либо получать только id Товаров для последующего вывода их с помощью msProducts;
• tpl — шаблон отображения одной строки;
• sortby, sortdir — сортировка;
• tplWrapper, wrapIfEmpty, outputSeparator, toPlaceholder, toSeparatePlaceholders — давно всем известные параметры;
• ids — укажите 1, чтобы сниппет вернул только id ресурсов вместо полных данных.

Выводим товары, входящие в Комплект:


Выводим все комплекты, в состав которых входит товар:


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

Компонент доступен в ModStore: modstore.pro/packages/ecommerce/msproductkits

{var $item_name = $product | resource : 'pagetitle'}
<tr>
    <td style="width: 40%;">
        {if $product > 0}
        <strong><a href="{$product | url}">{$item_name}</a></strong>
        {else}
        <strong>{$name}</strong>
        {/if}
    </td>
    <td style="width: 50%;"><small>{$description}</small></td>
    <td style="width: 10%; text-align: center;">
        <small>{$count} шт.</small>
    </td>
</tr>

{$ids = $_modx->runSnippet('!msProductKits', ['mode' => 'owner','ids' => 1,'resource' => $prodid])}