Модуль Связанных товаров (Комбинации товаров)

Модуль "Комбинации товары" (Модуль связанных товаров) предназначен для группирования товаров, которые можно отнести к общей позиции номенклатуры товара, но которые имеют большой ассортиментный ряд и требуют для классификации более одного параметра, что невозможно осуществить при помощи стандартного функционала.

Например, стандартный функционал "Варианты товара" (в настройках товарных позиций) позволяет классифицировать товары по одному параметру "Цвет" или "Размер".

Используя дополнительный модуль связанных товаров, можно организовать классификацию по 2 параметрам одновременно - "Цвет" + "Размер":

Модуль Связанных товаров не входит в сборку по умолчанию, но, в момент написания статьи, является бесплатным. Скачать архив модуля можно на странице модуля в нашем магазине дополнений

• 1. Установка модуля "Модуль связанных товаров" в системе
• 1.1. Модуль в админ профиле
• 1.2. Модуль на сервере
• 1.3. Модуль в базе данных
• 1.4. Гарантии разработчиков
• 2. Работа с модулем
• 2.1. Создание Связанных товаров
• 2.2. Удаление Связанных товаров
• 2.3. Вывод в шаблоне
• 3. Частые вопросы

1. Установка модуля "Модуль связанных товаров" в системе

Для самостоятельной установки модуля вам необходимо следовать инструкции:

Шаг 1: Скачайте архив модуля со страницы модуля внашем магазине дополнений:

Страница для скачивания модуля "Модуль связанных товаров"

Шаг 2: Разархивируйте скачанный архив и содержимую в нем папку related_products, через FTP-клиент, загрузите в директорию \application\modules на сервере

Шаг 3: Перейдите в админ-профиле к списку модулей

Осуществите переход в админ-профиле "Модули" → "Все модули" → вкладка "Установить модули":

Шаг 4: Клик по ссылке "Установить"

В открывшемся списке модулей должен отображаться модуль "Модуль Связанных товаров" (related_products) - необходимо осуществить клик по ссылке "Установка" напротив данного модуля:

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

Старайтесь не вмешиваться в работу системы во время установки модуля. Если установка прошла без ошибок, в панели управления, в правом верхнем углу, появится сообщение "Модуль установлен."

К началу

1.1. Модуль в админ профиле

Чтобы открыть модуль "Система бонусов", вам необходимо выбрать пункт главного меню пользователя: "Модули", а в нем подпункт: "Модуль Связанных товаров":
Если у вас установлен данный модуль, но он не отображается в вашем меню, - вам необходимо выбрать пункт главного меню пользователя: "Модули", а в нем - подпункт: "Все модули".

Далее из открывшегося списка надо выбрать: "Модуль Связанных товаров":

Чтобы вывести модуль в список меню, нужно перевести графические переключатели напротив данного модуля в положение: "Активно" (колонка: "Показывать в меню").

В некоторых случаях (если внести правки в функционал данного модуля , в настройках определенного товара, не удается), нужно удалить данный модуль из списка всех модулей и установить его повторно. В частности, это нужно сделать, если после размещения на сервере, модуль сразу появился в списке установленных модулей.

К началу

1.2. Модуль на сервере

Все файлы модуля физически находятся на сервере в папке related_products, которая должна находится в директории \application\modules:

К началу

1.3. Модуль в базе данных

После создания, модуль создает необходимую для работы таблицу в базе данных - это таблица mod_related_products

А также создается строка related_products в таблице components , а также поля в таблице custom_fields_data

Таблица mod_related_products содержит только id товаров в колонках:

• product_parent - id родительского товаров в связке. Родительским товаром, считается товар, в форме редактирования которого была создана связка товаров
• product_child - id дочерних товаров в связке

Важно: если модуль не был проинсталлирован из вкладки "Установить модули" в списке всех модулей, то и таблицы не были созданы. Удалите модуль из списка установленных модулей и установите его повторно из вкладки "Установить модули".

К началу

1.4. Гарантии разработчиков

Пользователям ImageCMS, использующим модуль Связанных товаров, мы как разработчики данного продукта, предоставляем гарантию на следующих условиях:

• При самостоятельной установке модуля и/или интеграции в шаблон (в случае необходимости) - гарантия не предоставляется, так как модуль является бесплатным и распространяется согласно принципу "как есть".

В случае обнаружения багов или неучетов - решение будет предоставлено через обновление дистрибутива модуля, что подразумевает последующую, осуществленную пользователем самостоятельно, переустановку модуля.

Также решение подобной проблемы возможно в индивидуальном порядке, силами наших специалистов, но на платной основе (ввиде дополнительных работ).

• При установке и/или выводе в шаблоне силами наших специалистов - так как услуга будет платной (оценивается индивидуально, исходя от версии системы и шаблона), гарантия предоставляется на 30 дней, с момента окончания и принятия клиентом работ. В данном случае, гарантия будет предоставляться только на конкретный модуль и не распространяется на остальной функционал системы.

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

К началу

2. Работа с модулем

Для корректной работы модуля необходимо осуществить ряд простых настроек в формах редактирования товаров и, в случаях необходимости, в файлах используемого шаблона.

2.1. Создание Связанных товаров

Для создания набора Связанных товаров следуйте следующей инструкции:

Шаг 1: Выберите из списка товаров главный товар и перейдите к его редактированию:

В связке, главным товаром будет считаться тот товар, в форме редактирования которого создается связка. Для упрощения поиска используйте фильтр по категории или по названию товара.

Внимание!

Для перелинковки товаров используется только главный вариант товара (первый в списке вариантов). Возможности создания Связанных для второстепенного варианта товара не предусмотрено:

Шаг 2: Перейдите на вкладку "Дополнение модулей"

В форме редактирования товара откройте вкладку "Дополнение модулей", после установки модуля, на данной вкладке должны быть выведены соответствующие поля модуля, в блоке "Сопутствующие товары":

• Цвет основного товара - поле, предназначенное для указания цвета основного товара, в формате HTML кодировки
• Поиск сопутствующих товаров - поле, в котором следует выбрать сопутствующие товары

Шаг 3: Выберите цвет товара.

В поле "Цвет основного товара" укажите цвет основного варианта товара, используя его HTML-кодировку (например #000000 - черный, #FFFFFF - белый и т.д.).

Для удобства указания цвета, предусмотрена палитра цветов, из которой можно выбрать соответствующий цвет и оттенок

Палитра открывается после клика по полю "Цвет основного товара".

Настройка данного поля играет существенную роль в отображении связки товаров - если в поле "Цвет основного товара" выбран нужный цвет, то на страницах товаров связки будет отображатся цветной квадрат, обозначающий этот товар:

Оставить пустое значение - то на страницах товаров связки, будет отображатся миниатьюра главного изображения товара, обозначающий этот товар:

Если в связке есть несколько товаров, для которых значение поля "Цвет основного товара" - разное (выборочно оставлено пустым и указан цвет), то на страницах товаров связки они будут отображаться вперемешку:

Шаг 4: Выберите сопутствующие товары в связке

В поле "Поиск сопутствующих товаров" выберите необходимые товары.

Для поиска товаров можно использовать ID, название и артикул товара.

Для добавления товара в связку осуществите двойной клик по нужной позиции в открывшемся списке товаров. Для выбора нескольких товаров - зажмите и удерживайте клавишу Ctrl

Шаг 5: Сохраните связку

Сохраните созданную связку товаров при помощи клика по кнопке "Сохранить" или "Сохранить и выйти".

Шаг 6: Настройка дочерних товаров (при необходимости).

Если вы желаете, чтобы модуль выводил именно цвет, а не миниатюру главного изображения товаров в связке, то после того, как связка создана в родительском товаре, вам необходимо внести необходимые настройки в дочерние товары - т.е. указать значение цвета в поле "Цвет основного товара", в формах редактирования дочерних товаров.

Перейти к редактированию дочернего товара можно, осуществив клик по ссылке прямо на вкладке:

Шаг 7: После завершения настроек - очистите кеш из админ панели.

К началу

2.2. Удаление Связанных товаров

Как таковая, связка товаров удалению в целом не подлежит. Однако, есть возможность удалить конкретный товар товары из связки. Для этого, в форме редактирования товара из связки, осуществите клик по кнопке "Удалить", напротив нужного товара:

Для фактического удаления связки товаров необходимо удалить все товары из нее.

После правки - удалите кеш из админпанели.

К началу

2.3. Вывод в шаблоне

Для вывода модуля в шаблоне версии до 1.5 вам необходимо в файле product.tpl в папке \templates\ваш_шаблон\shop вставить код

{foreach $related_products as $item}
    {$loc_color = $item->customFields["color"]["field_data"];}
    <a href="{shop_url('product/'.$item->getUrl())}" title="{echo $item->getName()}">
      {if $loc_color}
        {$loc_colors = explode('|', $loc_color)}
        <div>
          {foreach $loc_colors as $color}
          {$width = (100 / count($loc_colors)) . "%"}
          <i style="background-color: {$color}; width: {$width};">{echo $item->getName()}</i>
          {/foreach}
        </div>
      {else:}
        <img src="{echo $item->firstVariant->getSmallPhoto()}" alt="{echo $item->getName()}">
      {/if}
    </a>
{/foreach}

Код необходимо вставлять после кода вывода вариантов товаров или в другом удобном месте.

К началу

3. Частые вопросы

После установки модуль не работает или работает некорректно (или же нигде не отображается)

В подобных случаях нельзя исключать возможность сбоя или ошибки при установке модуля. Если у вас возникла подобная проблема, попробуйте удалить модуль из админ-панели (не затрагивая папку модуля на сервере) и попробуйте переустановить модуль повторно, из админ панели (подробнее - в пункте 1.2. Установка).

Если ошибка повторится, просим создать обращение в службу тех поддержки, при этом четко описать суть проблемы.

Модуль выводит сегменти shop/product в ссылки

Необходимо зайти в файл cms/templates/ваш_шаблон/related_products/related_products.tpl

И найти участок кода:

<a class="related-products__item" href="{shop_url('product/'.$item->getUrl())}" title="{echo $item->getName()}">

Затем заменить на:

<a class="related-products__item" href="{site_url($item->getRouteUrl())}" title="{echo $item->getName()}">

После правки - очистите кеш.

В настройках карточки товара нельзя выбрать цвет основного товара (выбранное значение не запоминается):

если модуль не был проинсталлирован из вкладки "Установить модули" в списке всех модулей, то и таблицы не были созданы - некуда записывать значения. Удалите модуль из списка установленных модулей и установите его повторно из вкладки "Установить модули".

К началу