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

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

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

Использовать модуль рекомендуется на последних версиях Joomla! и JoomShopping. Минимальные требования к этим программным компонентам указаны на странице модуля фильтрации товаров.

ionCube Loader

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

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

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

Удаление модуля

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

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

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

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

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

Управление модулями в Joomla! производится через Менеджер модулей (пункт меню Расширения / Менеджер модулей). В списке всех модулей нужно найти модуль с типом BoxApp модуль - универсальный модуль фильтрации товаров для JoomShopping. После нажатия на его название попадаем на страницу управления данным модулем.

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

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

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

Модуль

На вкладке модуль расположены общие настройки AJAX модуля фильтрации товаров.

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

Отображение модуля

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

Показ фильтров

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

Цена, вес, рейтинг

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

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

Категории

На данной вкладке собраны все настройки для фильтра товаров по категориям.

• Фильтр по подкатегориям - нужно ли при фильтрации учитывать товары, которые находятся не только в выбранной категории, но и в ее подкатегориях.
• Показывать подкатегории - если данный параметр включен, пользователь находится на странице категории и у нее есть подкатегории, то они будут показаны в данном блоке модуля фильтрации.
• Скрыть пустые - если в какой-либо категории нет товаров, то она отображается в списке категорий как неактивный элемент (если включен параметр фильтрации по подкатегориям, то категория будет неактивной, только если в ней и ее подкатегориях не будет товаров). Включив данный параметр можно не показывать такие категории вообще. Но если отображать список категорий в древовидной форме (иерархически), то это может вызвать пробелы в структуре дерева и будет выглядеть нелогично.
• Стиль показа - позволяет выбрать стиль отображения категорий в фильтре
  • Иерархический - выводит список категорий в виде дерева с отступами для подкатегорий. Чем глубже вложенность категорий, тем больше отступ.
  • Один элемент в строке - все категории отображаются в один столбец без отступов, каждая в новой строке.
  • Элементы по ширине блока - категории стараются равномерно заполнить область фильтра. При этом несколько категорий могут разместиться в одной строке.
• Сортировка - позволяет упорядочить все категории по указанному в административной части порядковому номеру или имени.
• Направление сортировки - сортировка категорий по возрастанию или убыванию.

Производители

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

Продавцы

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

Метки и время доставки

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

Фильтры с двумя значениями

Рассмотрим функции следующего набора фильтров

• Изображение - фильтр товаров, отбирающий только товары с изображениями или товары без изображений
• Наличие - фильтр, позволяющий отобрать товары, имеющиеся в наличии или товары доступные под заказ
• Скидки - выбирает товары со скидкой (со старой ценой) или без нее
• Дополнительная цена - позволяет отфильтровать товары с дополнительными ценами или без них
• Отзывы - показывает в результатах только товары с отзывами или без отзывов

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

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

Характеристики

Одна из наиболее важных вкладок настройки AJAX фильтра товаров. Иногда для интернет-магазину достаточно наличия только этого фильтра. На этой вкладке администратор может настроить фильтр товаров по их характеристикам.

• Скрытые характеристики - список характеристик, которые не будут отображаться в модуле фильтра. По разным причинам может понадобиться возможность убрать характеристику из фильтра, к тому же у характеристик в JoomShopping не параметра опубликована/не опубликована.
• Показывать описание - для каждой из характеристик кроме названия также можно ввести описание. Если данная опция включена и у характеристики заполнено поле описания, то при отображении в фильтре возле названия будет выведена информационная иконка. При наведении на нее будет отображено описание данной характеристики.
• Типы характеристик - в JoomShopping все характеристики можно разделить на текстовые и характеристики с заранее заданными значениями. У первых администратор сайта может вводить любые значения при добавлении/изменении товаров в каталоге. Для вторых администратор при добавлении/изменении товара может только выбрать один из доступных вариантов, которые предварительно были добавлены к данной характеристике. Характеристики с заранее заданными вариантами значений выводятся в фильтре в виде списка всех этих значений. Каждый элемент списка является флажком. Для текстовых характеристик значение не так однозначно. При добавлении/изменении товаров администратор может ввести значения текстовых характеристик как строки (например, модель батареи мобильного телефона) или как числовые значения (например, объем батареи мобильного телефона). При строковых значениях удобно было бы выводить их в фильтре, как список. А при числовых в некоторых случаях имеет смысл выводить в фильтре промежуток значений от и до, как в фильтре по цене или весу. Именно для этого администратору сайта предоставляется возможность самому решить, в каком именно виде выводить те или иные текстовые характеристики, а соответственно и как по ним производить фильтрацию товаров.
  • Флажок - стандартный список всех значений характеристики в виде флажков с возможностью выбора нескольких вариантов
  • Один флажок - аналогичный список флажков всех значений характеристики, но с единственным выбранным вариантом. При выборе из списка значений какого-либо варианта, предыдущий выбранный элемент будет сброшен.
  • Число от и до - отображение данной характеристики в фильтре будет иметь вид промежутка чисел от и до (как для цены или веса). Фильтрация по данной характеристике будет производиться соответствующим образом, ее значение будет представлено в виде числа, а в результирующий список товаров попадут только те, у которых эта характеристика соответствует параметрам введенного в фильтре промежутка чисел.
• Вид числовых характеристик - как и для фильтра по цене или весу, для характеристик, у которых был выбран тип Число от и до, можно выбрать вариант внешнего вида в фильтре. Все значения аналогичны описанным выше для фильтра по цене и т.д.
  • Поля ввода и слайдер
  • Только поля ввода
  • Только слайдер
• Стиль показа - аналогично описанным выше настройкам, этот параметр применяется для отображения всех характеристик, кроме числовых с промежутком от и до.

Атрибуты

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

• Скрыть атрибуты - позволяет указать список атрибутов, которые не будут отображаться в фильтре.
• Показывать описание - при создании/редактировании атрибута можно заполнить его описание. Если эта опция включена и заполнено описание атрибута, то оно будет выводиться при наведении на информационную иконку возле его названия.
• Показывать изображения - при создании/редактировании атрибута можно выбрать для него изображение. Оно будет выводиться рядом с названием атрибута, если данная опция включена.
• Стиль показа - аналогичен предыдущим описаниям и определяет внешний вид вписка значений атрибута.

Uikit и другие библиотеки

В процессе создания интерфейса модуля использовались UIkit, jQuery UI, jQuery Form Plugin, noUiSlider. Если на сайте не используется шаблон от YooTheme, загрузить UIkit фреймворк можно с помощью нашего бесплатного плагина. Остальные библиотеки входят в состав модуля и загружаются в процессе его отображения из media директории сайта.

Также модуль загружает из media папки два собственных css файла: default.css и default.custom.css. Первый содержит css стили для отображения модуля и может меняться в последующих версиях. Второй файл может использоваться для перекрытия текущих css правил пользовательскими.