Модуль "Лучшие магазины"

Модуль совместим со всей веткой cs-cart 4.x с такими редакциями как CS-Cart, CS-Cart Ultimate, Multivendor, Multivendor Plus, Multivendor Ultimate. На данный момент нет информации о полной несовместимости модуля с какой-либо темой. В случае конфликта модуля с вашей темой обращайтесь в наш центр поддержки.

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

После оформления и оплаты, ваш заказ будет автоматически переведен в статус Оплачен в течение считанных минут. Статус заказа Оплачен означает активацию лицензии и вам на e-mail отправляется письмо с подтверждением о получении оплаты и письмо со ссылкой на скачивание модуля. Так же модуль всегда можно скачать в нашем разделе Управление лицензиями. Для установки модуля на ваш сайт, пожалуйста, выполните следующие шаги:

1. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями" или по ссылке, отправленной по e-mail.
2. Пройдите в раздел Модули → Управление модулями и в меню шестерёнки выберите Ручная установка.
3. Выберите ранее скачанный файл и завершите установку модуля.

На этом установка модуля завершена. Для перехода на страницу настроек модуля выберите установленный модуль в разделе Модули → Модули CS-Commerce

После установки модуля настройки устанавливаются на значения по умолчанию. Для доступа к настройкам модуля в панели администратора перейдите в раздел Модули → Модули CS-Commerce и из выпадающего списка выберите интересующий вас модуль.

На странице Список подборок располагаются все созданные подборки, которые можно сортировать по любой из колонок:

• ID;
• название;
• дата;
• статус.

Здесь доступны массовое удаление и массовое дублирование подборок.

Для создания новой подборки нажмите на кнопку "+" в правом верхнем углу экрана.

Во вкладке Общее находится всего 3 поля:

1. Название - используется только в панели администратора.
2. Статус.
3. Задать период доступности.

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

Основные стили

Группа Основные стили позволяет настроить внешний вид каждого элемента (магазина):

• цвет фона
• рамка - ширина рамки (в px), стиль (сплошная, пунктирная, штриховая) и цвет. Если рамка не нужна - укажите ширину 0px.
• скругление углов (в px)
• внешние отступы дочерних блоков (в px) (блока товаров и информационного блока).

Стили информационного блока

Группа Стили информационного блока позволяет настроить внешний вид блока текстовой информации и логотипа:

• цвет фона
• рамка - ширина рамки (в px), стиль (сплошная, пунктирная, штриховая) и цвет. Если рамка не нужна - укажите ширину 0px
• скругление углов (в px)
• минимальная высота (в px) - актуально, если у элементов (магазинов) высота не совпадает
• выравнивание - визуально понятная настройка, где нужно выбрать точку, к которой будет стремиться контент. Например, если указать центральную точку в левом столбике, то по горизонтали контент будет выравниваться по левому краю, а по вертикали стремитьс к середине

Содержимое информационного блока

Группа Содержимое информационного блока позволяет выбрать необходимую информацию. Отмечайте галочкой нужные элементы:

• логотип, а также его размер и внешние отступы
• название
• город
• количество товаров
• количество продаж
• блок товаров

Стили блока товаров и Стили одного товара

Данные группы доступны, если отмечен галочкой блок товаров.

Стили блока товаров:

• расположение (вверху, внизу, слева, справа) - относительно информационного блока с текстом и логотипом
• шаблон товаров (мозаика, галерея, горизонтальный ряд, колонка)
• высота (в px)
• цвет фона
• рамка - ширина рамки (в px), стиль (сплошная, пунктирная, штриховая) и цвет. Если рамка не нужна - укажите ширину 0px
• скругление углов (в px)
• внутренние отступы (в px)

Стили одного товара:

• расположение изображения (заполнить блок - изображение заполняет всё пространство блока с сохранением своей пропорции, вместить в блок - вся картинка отображается в блоке с сохранением своей пропорции)
• рамка - ширина рамки (в px), стиль (сплошная, пунктирная, штриховая) и цвет. Если рамка не нужна - укажите ширину 0px
• скругление углов (в px)
• внешние отступы (в px)

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

• во вкладке Общее выбрать шаблон (сетка или скроллер)
• во вкладке Контент указать нужную подборку

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

Модуль поддерживает поставку обновлений через Центр обновлений CS-Cart. О выходе новых версий модуля вас оповестит встроенный Центр уведомлений Cart (колокольчик). Обновление модуля с помощью Центра обновлений позволит без потерь настроек данных модуля произвести переход на более новую версию модуля.

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

Обновление модуля через Центр обновлений:

1. В верхнем меню пройдите в раздел Администрирование → Центр обновлений;
2. В меню шестеренки нажмите "Проверить доступные обновления"
3. Cреди списка доступных обновлений найдите нужное и нажмите кнопку Обновить;
4. Следуйте всем инструкциям, которые будут показаны при процедуре обновления;
5. Рекомендуется произвести очистку кэша CS-Cart после завершения устанвоки обновлений удалением папки var/cache на вашем сервере или добавлением в адресную строку параметра ctpl (прмиер: https://domain.com/admin.php?ctpl).

Переустановка модуля удалением:

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

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

1. Пройдите в раздел Модули → Управление модулями и найдите старый установленный модуль.
2. Нажмите в меню шестеренки модуля кнопку удалить.
3. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями".
4. Пройдите в раздел Модули → Управление модулями и в меню шестеренки выберите Ручная установка.
5. Выберите ранее скачанный файл и завершите установку модуля.

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

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

1. На нашем сайте центра поддержки https://helpdesk.cs-commerce.com/ авторизуйтесь под своей учетной записью;
2. Нажмите на кнопку "Новая заявка";
3. Заполните все необходимые поля и создайте заявку (Вы получите на e-mail письмо с подтверждением);
4. Ожидайте ответ специалиста (на ваш e-mail придет уведомление об ответе на вашу заявку) в соответствии с регламентами работы службы техподдержки.

Если Вы не получили ответ в течении сроков, обозначенных в регламентах, напишите нам на e-mail [email protected] сообщение с темой заявки и мы постараемся решить вас вопрос в ближайшее время.

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

Рекомендуем ознакомиться с общими ограничениями:

1. Фрагменты кода  или некоторые файлы модуля могут иметь закрытую (закодированную) часть. Закодированная часть не создает проблемы в доработке модуля;
2. Модуль будет работать только на тех доменах, которые указаны в лицензии пользователя. При попытке использования решения на установках CS-Cart, домены которых не включены в лицензию, модуль будет автоматически выключен;
3. Установка локально не допускается системой лицензирования. Чтобы модуль работал на дополнительном домене (псевдониме) укажите этот псевдоним на странице управления лицензиями. На один домен допускается указать до трех псевдонимов для нужд тестирования и разработки.
4. Главный домен лицензии вы можете менять самостоятельно на странице управления лицензиями. 

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

PHP Hooks

Модуль не поддерживает стандартную работу php хуков cs-cart, поэтому была разработана своя схема подключения, которая вписываеся в стандарты cs-cart.
В модуль встроено 3 хука:

1. hooks_get_products Передаваемые переменные: 
    $ls_settings - array() настройки модуля
     $company_id -  int() ID текущей витрины
     $params - array() данные из запроса
     $fields - array() получаемые поля
     $join - string() Join таблиц БД
     $condition -  string() условия запроса БД
     $sorting - string() сортировка
     $limit - string() лимит на получение записей из БД
2. hooks_get_joins Передаваемые переменные: 
    $ls_settings - array() настройки модуля
    $params - array() данные из запроса
     $join - string() Join таблиц БД
3. hooks_get_conditions Передаваемые переменные:
   $ls_settings - array() настройки модуля
    $params - array() данные из запроса
   $condition -  string() условия запроса БД
4. hooks_get_fields Передаваемые переменные:
   $ls_settings - array() настройки модуля
   $params - array() данные из запроса
   $fields -  array() массив полей 
5. hooks_before_response Передаваемые переменные:
   $ls_settings - array() настройки модуля
   $company_id -  int() ID текущей витрины
   $params - array() данные из запроса
   $response -  array() данные, которые будут отправлены в скрипт

На примере встроенного модуля my_changes подключимся к хуку hooks_get_products, который расположен непосредственно перед запросом получения товаров:

1. Создайте файл hooks.post.php в директории модуля app/addons/my_changes/schemas/csc_live_search
2. Добавьте в массив $schema['developers']['hooks_get_products']['variants'] значение в виде названия, ключ которого является директорией файла с функцией. Пример кода файла hooks.post.php:

   <?php
   if (!defined('BOOTSTRAP')) { die('Access denied'); }
   $schema['developers']['hooks_get_products']['variants']['/app/addons/my_changes/fn_file_name_same_as_function_name.php']='My changes hook function';
   return $schema;

3. Создайте соотвествующий файл, на который ссылаетесь из файла hooks.post.php и создайте в нем одну функцию, название которой совпадает с названием файла. В нашем случае это fn_file_name_same_as_function_name, принимайте отправляемые переменные и модифицируйте для получения необходимых условий поиска. Пример содержания файла:

   <?php
   if (!defined('BOOTSTRAP')) { die('Access denied'); }
   function fn_file_name_same_as_function_name($ls_settings, $company_id, $params, $fields, $join, &$condition, $sorting, $limit){
   	
   }

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

На этом интеграция с хуком модуля живого поиска завершена. 

JQUERY Event

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

1. cls.after.insert - вызывается когда потзователь набирает текст и модуль вставляет данные в блок.
2. cls.after.append - вызывается когда потзователь наживает показать еще и модуль дополнительно отображает контент.

Как использовать: Испольщуйте конструкцию $(document).on()) для отлавливания события:

$(document).on( "cls.after.insert", function(event, data, elm) {	
});
$(document).on( "cls.after.append", function(event, data, elm) {	
});

Где data - это массив  всех переданных данных с сервера, и elm - это блок, куда данные вставляются или добавляются.

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

$(document).on( "cls.after.insert", function(event, data, elm) {
    if (data.items){
        $.each(data.items, function(i, product){
            $(elm).find('li[pid="' + product.product_id + '"] .clsProduct').append(" " + product.product_code);      
        });
    }    
});

Версия 7.2.0 от 21 октября 2021

Что нового:

• Добавлены дополнительные хуки php для разработчиков
• Добавлены события JQUERY, чтобы иметь возможность гибко менять данные во всплывающем окне результатов поиска.
• Добавлена защита от ботов.
• Оптимизированная функция загрузчика
• Добавлена возможность поиска по всем характеристикам товаров.
• Исправлено более 10 небольших багов

Версия 7.0.8 от 16 августа 2021 года

Что нового:

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

Версия 7.0 от 1 августа 2021 года

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

Итак, что же нового в версии 7.0:

1. Фильтрация результатов поиска по категориям прямо в поисковом окне;
2. Навигация с клавиатуры;
3. Синонимы поиска;
4. Возможность выбрать тему (Modern и Classic) и изменения цветовых схем для каждой из них
5. Встроенный ускоритель поиска (для высоконагруженных проектов);
6. Мотивация поиска;
7. Поисковые фразы;
8. История поиска в разрезе пользователей.
9. Кнопка быстрого просмотра товара и добавление в список сравнения.