Ключевая информация. С чего начать?

Внедрение модуля не сложное, однако необходимо знать некоторые тонкости настройки, о которых мы расскажем в данном материале.

На первом этапе необходимо определиться с двумя моментами - как будет настраиваться каталог и как будет интегрироваться модуль на вашем сайте.

1) Как будет настраиваться каталог?

Необходимо определиться по каким общим признакам будут группироваться товары в каталоге, а также какие свойства будут являться параметрами SKU в каждом разделе или во всем каталоге. Также важно каким образом будут задаваться все эти параметры.

В модуле предусмотрено три варианта группировки товаров:

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

Разберем подробнее каждый из вариантов.

1.1 Используем 1 свойство каталога, в котором будет храниться связь между товарами. Глобально для всего сайта.

Также необходимо будет указать префикс свойств, которые будут выводиться в товарах в качестве торговых предложений SKU. Настройка выполняется глобально для всего сайта.

1.2 Используем одно или несколько свойств (без ограничений) для группировки товаров отдельно в разделах каталога. Также указываем в разделах какие свойства будут являться параметрами SKU.

1.3 Группируем все товары в разделах без указания общего признака

2) Как будет интегрироваться модуль на ваш сайт?

Не менее важный по значимости вопрос. В модуле поддерживается опять-таки 2 варианта интеграции:
- через внедрение компонента в карточке товара (программная доработка шаблона карточки товара)
- автоматическая интеграция (фоновая AJAX загрузка компонента без программной доработки).

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

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

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

Первый вариант внедрения через компонент подразумевает кастомизацию карточки товара готового решения и вынесение шаблона карточки в свое пространство имен. Это значит, что обновление готового решения будет возможно, ничего не затрется, однако шаблон карточки товара обновляться не будет. Во многих популярных готовых решениях с Маркетплейс 1С Битрикс все ключевые функции и блоки формируются за пределами карточки товара (внутри самого модуля), поэтому, как правило, такая кастомизация не особо повлияет на дальнейшее развитие проекта. Однако, все индивидуально и зависит от конкретного готового решения, которое вы используете на своем сайте.

В рамках акции (если такое предложение есть на странице нашего модуля) мы выполняем полную иннтеграцию и первичную настройку модуля бесплатно за 1 день. Обязательно проверяйте информацию на странице модуля на Marketplace. Предложение не является бессрочным.

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

Центр управления модулем и техническая поддержка

После стандартной установки модуля пользователь попадает на страницу центра управления модулем:

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

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

Все разделы настроек модуля находятся в основном меню вашей системы, можно быстро перейти в нужный раздел:

Настройка каталога

Первым делом после перехода на страницу с настройками модуля включите модуль и режим отладки.

Дальше нужно настроить модуль, в зависимости от того какой вариант вы выбрали по настройке каталога (рассмотрено в этой главе). 

Общее свойство для группировки товаров во всем каталоге

Если для вас подходит использование 1 свойства для выборки товаров для всего каталога, то найдите в настройках модуля следующие параметры:

Подсказки на странице модуля помогут быстро сориентироваться и выполнить необходимую настройку.

Вы можете указать символьный код свойства, по которому будет выполняться группировка товаров во всем каталоге. Если у вас нет такого свойства, то используйте значение по умолчанию "DUB_SKU". В этом случае в нужном каталоге (информационный блок) создайте свойство с этим символьным кодом (тип свойства - строка). Также нужно указать префикс свойств, которые будут выводиться в карточке товара в качестве параметров SKU. Значение по умолчанию "DUB_SKU_".

Пример создания свойств:

После создания свойств заполните все нужные значения в товарах. 

Пример highload блока:

Каждое поле highload блока основано на пользовательских полях:

В данном примере важно сохранить стандартные названия полей из колонки "Название поля", которые начинаются на "UF_".

Отдельные свойства для группировки и вывода свойств в разделах каталога

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

Также в настройках модуля надо активировать галочку "Указывать свойства SKU в разделах". Если это не сделать, модуль будет искать свойства в каталоге по префиксу, а не в разделах.

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

Последняя опция на скриншоте выше (ограничение выборки по разделам) позволяет ограничить область поиска возможных комбинаций товара. Доступно 4 варианта:

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

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

Искать товары для выборки во всех привязанных разделах товара
Выборка ограничивается только привязанными разделами товара.

Искать товары для выборки во всех привязанных разделах товара рекурсивно
Выборка идет по всем привязанным разделам товара на всех уровнях вложенности каталога. Поиск разделов выполняется рекурсивно - определяется родительский корневой раздел и все его вложенные разделы и подразделы. 

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

Для каждого каталога модуль создает 4 пользовательских свойства:

Теперь в настройках каждого раздела вы можете указывать символьные коды свойств каталога для выборки и вывода SKU:

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

Интеграция модуля

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

Интеграция через компонент

Если выбран способ интеграции модуля через компонент, разместите код вызова компонента dubovoi.sku_list в карточке товара (catalog.element).

Пример вызова компонента в карточке:

<?$APPLICATION->IncludeComponent(
   "dubovoi:sku_list",
   ".default",
   array(
      "ELEMENT_ID" => $arResult['ID'],
      "IBLOCK_ID" => $arParams["IBLOCK_ID"],
      "CACHE_TYPE" => "A",
      "CACHE_TIME" => 36000000
   ),
   $component
);
?>

.default - название шаблона компонента

Автоматическая интеграция

Модуль может работать без компонента.
В этом случае в каталоге должно быть настроено ЧПУ вида /catalog/#SECTION_CODE#/#ELEMENT_CODE#/
/catalog/#SECTION_CODE#/#ELEMENT_ID#/

где "catalog" - наименование корневой директории каталога (возможно изменение, описание настройки ниже)

Также символьный код раздела #SECTION_CODE# может быть заменен в ЧПУ на всю цепочку разделов #SECTION_CODE_PATH#, в данном случае укажите на каком уровне вложенности ЧПУ находится карточка товара (рассмотрено ниже).

Для выбора автоматического варианта интеграции в поле "Способ интеграции" выберите значение "Автоматически" и заполните все новые поля, которые появились:

HTML селектор для вывода SKU - укажите класс элемента в карточке товара, внутри которого необходимо вывести SKU. Можно вывести блок в начале или в конце селектора. Если элементов с указанным селектором несколько на странице, будет найден первый.

Место для вывода SKU в селекторе - укажите где вывести SKU (в начале или в конце селектора).

Название корневого раздела каталога - укажите в какой директории у вас работает каталог, например, catalog. Это нужно для того, чтобы событие не срабатывало в других директориях.

На каком уровне вложенности URL находится карточка товара - по умолчанию для стандартного построения ЧПУ вида /catalog/#SECTION_CODE#/#ELEMENT_CODE#/  карточка товара всегда находится на 3 уровне вложенности.

Все настройки модуля

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

Общие настройки

Модуль включен
Опция включает модуль для всех пользователей

Отладка включена
При включенной отладке компонент на сайте виден только администраторам при условии включении модуля

Сортировка значений SKU
Сортировка возможна по индексу значений свойств, а также по алфавиту.

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

Включить проверку доступности товара по выбранной комбинации

Опция активирует жесткое ограничение доступных комбинаций параметрами текущего товара.

Опция включена:

Опция выключена:

Показывать блок "Все варианты"
Все возможные товары с названиями и ценами в виде выпадающего списка

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

Время кэширования торговых предложений
По умолчанию 36000000 секунд (1 год)

Время кэширования цен
По умолчанию 86400 секунд (1 сутки)

ID группы неавторизованных пользователей

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

Способ интеграции

Способ интеграции
Доступно 2 варианта - через компонент и с автоматическим внедрением без программной доработки
Подробнее об интеграции модуля

Сохранять положение на странице при переходе по SKU
Функция доступна только при интеграции через компонент. При активации опции пользователь останется в области блока SKU при переходе по карточкам товара.

Настройка свойств инфоблока

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

Выводить свойства справочника в виде картинки
Для такой реализации свойство SKU должно иметь тип "справочник" (привязка к highload блоку)


Свойство, по которому выполняется группировка товаров
Укажите код свойства, в котором будет храниться связь между товарами. Это может быть общее название, артикул или любой другой признак. Тип свойства - строка. Таким образом, модуль сможет сгруппировать товары в торговые предложения по этому общему признаку.

Префикс свойств торговых предложений в инфоблоке

Укажите префикс свойств, по которому модуль будет искать свойства торговых предложений в инфоблоке. Модуль может работать с двумя типами свойств - список, справочник (привязка к highload инфоблоку). По умолчанию - DUB_SKU_

Включить автоматическую группировку товаров по общим признакам

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

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

Включить строгую проверку наличия всех значений свойств для выборки товаров

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

Ограничение выборки по разделам
Доступно 4 опции:

1. Искать товары без привязи к разделам во всем каталоге.
   Модуль будет искать все товары без ограничений по разделам. При выборе этой опции не будет учитываться привязанный раздел этого товара, поиск будет выполняться по всем товарам каталога во всех разделах.

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

3. Искать товары для выборки во всех привязанных разделах товара.
   Выборка ограничивается только привязанными разделами товара.

4. Искать товары для выборки во всех привязанных разделах товара рекурсивно.
   Выборка идет по всем привязанным разделам товара на всех уровнях вложенности каталога. Поиск разделов выполняется рекурсивно - определяется родительский корневой раздел и все его вложенные разделы и подразделы.