Универсальный модуль товаров для JoomShopping - документация

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

Установка и требования

Устанавливать модуль рекомендуется на последнюю версию Joomla! и JoomShopping. Минимальные требования относительно версий Joomla! и JoomShopping есть на странице покупки модуля.

ionCube Loader

Обязательным требование для работы модуля является наличие на хостинге php расширения ionCube Loader. Чаще всего это расширение установлено по-умолчанию и не требует от вас никаких дополнительных действий. Чтобы проверить наличие ionCube Loader ознакомьтесь с документом Проверка наличия и установка ionCube Loader.

Установка модуля

Скачать установочный пакет модуля можно в разделе Мои заказы после покупки приложения. Для его установки можно воспользоваться стандартным Менеджером расширений Joomla!. Более детально о работе с Менеджером расширений.

Установка файла лицензии

Перед началом настройки и использования модуля необходимо установить лицензионный файл вашей версии расширения. Лицензионный файл выдается на домен, указанный при покупке модуля. Скачать его можно также в разделе Мои заказы. Для установки достаточно скопировать данный файл в каталог boxapp_licenses в корне сайта. Более подробно ознакомиться с процессом установки можно в документе Установка лицензии для Joomla! расширений.

Настройка модуля

Для управления модулем нужно перейти в административной части сайта Joomla! в раздел Расширения / Менеджер модулей. Далее в списке нужно найти модуль с типом BoxApp модуль - универсальный модуль товаров для JoomShopping. Если такого модуля нет, то его можно создать. После этого нажав на название модуля переходим на страницу его настройки.

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

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

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

Рассмотрим остальные настройки модуля более подробно.

Вкладка модуль

• Тип товаров - позволяет быстро отсортировать или выбрать товары по заранее определенной схеме.
  • Все - участвуют все товары магазина с сортировкой по-умолчанию
  • Бестселлеры - выбирает наиболее продаваемые товары в JoomShopping
  • Случайные - случайно отобранные товары
  • Наибольший рейтинг - товары с наибольшим средним рейтингом от пользователей (показывается звездами и имеет значение от 0 до 10)
  • Наиболее просматриваемые - товары с наибольшим количеством просмотров пользователей
• Количество товаров - максимальное количество товаров, которое может быть отобрано для показа в модуле
• Обрабатывать плагинами - нужно ли подключать обработку плагинами списка товаров, которые были отобраны для показа в модуле (плагины Joomla! могут изменить результирующий список товаров)
• Макет списка товаров - общая концепция отображения модуля товаров
  • Сетка - при достаточном количестве товаров, они будут располагаться в несколько рядов. Общее количество товаров берется из параметра Количество товаров, а количество товаров в строке из параметра Товаров в строке
  • Слайдер - горизонтальный вариант отображения товаров JoomShopping. В слайдере отображается количество товаров, указанное в параметре Товаров в строке. Переход к другим товарам осуществляется автоматически или при нажатии на навигационные элементы с использованием различных эффектов анимации.
  • Вертикально - вертикальный вариант расположения товаров

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

Для для значения макета Сетка и Вертикально это:

• Товаров в строке (только для Сетки) - количество товаров, которые показываются в один ряд при отображении товаров сеткой.
• Тип списка - в поле выбирается принцип отображения отдельных элементов (товаров) в списке.
  • Панель - за основу отображения отдельного товара берется обычная панель. Это позволяет назначить анимацию для всех товаров в модуле, использовать адаптивность, настроить отступы между отдельными товарами и т.д. Подойдет для большинства случаев, если не нужно использовать дополнительных эффектов. В данном варианте пользователь сайта может нажимать на ссылки и кнопки в блоке каждого товара. Например, название товара и его изображение ведет на страницу товара, название производителя на соответствующую страницу производителя со списком его товаров и т.д.
  • Панель с оверлеем - отличается от обычной панели тем, что при наведении на отдельный товар в его блоке с различными эффектами появляется оверлей. На нем отображаются краткое описание товара (если доступно) и кнопки Купить и Подробнее. При этом пользователь может нажать только на одну из кнопок, информация под оверлеем не кликабельна. При выборе данного типа списка становятся доступными дополнительные настройки этой панели:
    • Стиль анимации - анимация оверлея при наведении курсора на товар
      • Скольжение сверху вниз
      • Скольжение снизу вверх
      • Скольжение слева направо
      • Скольжение справа налево
      • Затухание
      • Нет
    • Анимация изображения - анимация изображения товара при наведении курсора на товар
      • Затухание
      • Увеличение масштаба
      • Вращение
      • Затухание серого цвета
      • Нет
    • Позиция оверлея - позиция оверлея в блоке конкретного товара
      • Заполнение
      • Сверху
      • Снизу
      • Слева
      • Справа
    • Выравнивание по горизонтали - выравнивание содержимого оверлея по горизонтали
      • По центру
      • Слева
      • Справа
    • Выравнивание по вертикали - выравнивание содержимого оверлея по вертикали
      • По центру
      • Сверху
      • Снизу
• Интервал сетки - отступы между блоками товаров, если в качестве макета отображения выбрана сетка
• Стиль анимации - анимация товаров при отображении в видимой области страницы. Эта анимация будет срабатывать, если при загрузке страницы товары в модуле сразу находятся в видимой области. Также срабатывание анимации происходит при скроллинге, если при нем товары модуля попадают в видимую часть страницы (или страница пролистывается в то место, где отображаются товары модуля).
• Повторять анимацию - параметр показывает нужно ли повторно запускать анимацию для товаров, которые при скроллинге или других условиях сначала были в видимой области (и анимация была показана), потом попали за границы видимой области, а после снова вернулись в видимую область. Если параметр включен, то каждый раз возвращаясь в видимую область страницы, для товаров будет воспроизводиться анимация. Если выключен, то для каждого товара анимация будет срабатывать только один раз при первом отображении.
• Задержка анимации - отражает интервал времени в миллисекундах между моментом попадания товара в видимую область страницы и началом показа анимации. Установив некоторое значение этого параметра анимация товаров при их отображении будет показываться не сразу, а с указанной задержкой.
• Размер кнопок - параметр позволяет указать относительный размер кнопок Купить и Подробнее.
  • Минимальный
  • Небольшой
  • Стандартный
  • Большой

Для для значения макета Слайдер:

• Количество элементов - количество товаров по-умолчанию для отображения в слайдере. Используется, если не указаны параметры количества товаров в слайдере для разных размеров экрана ниже.
• Маленький - сколько элементов в слайдере нужно выводить для маленькой ширины экрана
• Средний - количество товаров в слайдере для средней ширины экрана устройства
• Большой - количество товаров в слайдере для большой ширины экрана устройства
• Очень большой - количество товаров в слайдере для очень большой ширины экрана устройства
• Анимация слайдера - анимация, которая используется при смене товаров в слайдере
  • Затухание
  • Уменьшение
  • Скольжение горизонтально
  • Скольжение вертикально
  • Скольжение вверх
  • Скольжение вниз
• Продолжительность анимации - продолжительность анимации при смене товаров в слайдере в миллисекундах
• Задержка анимации - пауза между отображением анимации для отдельных товаров в слайдере в миллисекундах
• Автовоспроизведение - будут ли товары сменяться автоматически или только при нажатии на соответствующие элементы управления
• Пауза при наведении - если включено автовоспроизведение, то данная опция определяет нужно ли приостанавливать его при наведении на слайдер курсора мыши
• Интервал автовоспроизведения - промежуток времени в миллисекундах между сменами товаров при автовоспроизведении
• Навигация стрелками - нужно ли показывать стрелки влево и вправо для переключения товаров в слайдере
• Навигация точками - навигация в нижней части слайдера, которая состоит из нескольких иконок кружков, количество которых зависит от общего числа товаров для отображения. Напоминает постраничную навигацию, только без нумерации страниц.
• Тип списка - описано выше
• Размер кнопок - описано выше

Вкладка фильтры

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

• Категории - в результирующий список попадут только товары из выбранных категорий
• Метки - выбирает товары с указанными тетками
• Производители - выбрать товары указанных производителей
• Продавец - показывать только товары выбранных продавцов
• Характеристики - фильтр по характеристикам товаров

Если выбрать несколько значений одного фильтра, то при выборке товаров к ним будет применено логическое ИЛИ. Для значений разных фильтров применяется логическое И. Например, показать товары из Категории 1 ИЛИ Категории 2. Или показать товары определенного продавца из Категории 1 (Продавец 1 И Категория 1).

Вкладка сортировка

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

Настройка Поле сортировки имеет следующие варианты для выбора:

• ID товара
• ID категории
• Имя
• Артикул
• Цена
• Старая цена
• Вес
• Средний рейтинг
• Просмотры
• Минимальная цена
• Дата добавления
• Дата изменения
• Перемешать

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

Вкладка отображение

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

Uikit

Верстка шаблона модуля и различные эффекты отображения сделаны с использование фреймворка uikit. Если на сайте используется шаблон от YOOTheme, то отдельная установка uikit не требуется. В противном случае можно воспользоваться нашим бесплатным плагином для подключения uikit в Joomla!.

Пример настройки плагина