AJAX корзина для JoomShopping - документация

Модуль AJAX корзины для JoomShopping позволяет отображать модальное окно с товарами, добавленными в корзину, и производить в нем все операции без перезагрузки страницы. Также сам модуль отображает в выбранной области шаблона Joomla! количество заказанных товаров и иконку корзины, которая является ссылкой для открытия модального окна корзины. Имеется возможность выполнять заказ товара JoomShopping на его странице, а также на странице категорий, производителей и т.д., без перезагрузки страницы с использованием AJAX запроса.

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

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

ionCube Loader

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

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

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

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

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

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

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

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

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

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

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

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

Вкладка с индивидуальными настройками модуля.

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

Настройка AJAX заказа товаров

В файле шаблона default.php выполняется подключение jQuery плагина, который отвечает за выполнение всех AJAX запросов, в том числе и AJAX заказ товаров. Блок подключения данного jQuery плагина имеет следующий вид:

<script type="text/javascript">
    jQuery(function ($) {
        $(document).initModBoxAppAjaxCart({
            basePath: "<?php echo JUri::root(); ?>",
            cartRefreshUrl: "<?php echo SEFLink('index.php?option=com_jshopping&controller=cart&task=refresh'); ?>",
            ajaxProductBuyButton: <?php echo $modParams->ajaxProductBuyButton ? 'true' : 'false'; ?>
        });
    });
</script>

Для определения кнопок или ссылок покупки товара плагин использует набор селекторов для стандартного шаблона JoomShopping и BoxApp2 шаблона для JoomShopping. Эта настройка имеет вид:

buyButtonSelectors: [
  '#comjshop .product_list .button_buy',
  '#comjshop .product_full button[type=submit]:first',
  '#comjshop .prod_buttons .buttons input[type=submit]:first',
  '#comjshop .jshop_list_product .block_product .buttons a.button_buy'
],

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

Например, подключение jQuery плагина в шаблоне default.php можно переписать следующим образом:

<script type="text/javascript">
    jQuery(function ($) {
        $(document).initModBoxAppAjaxCart({
            basePath: "<?php echo JUri::root(); ?>",
            cartRefreshUrl: "<?php echo SEFLink('index.php?option=com_jshopping&controller=cart&task=refresh'); ?>",
            ajaxProductBuyButton: <?php echo $modParams->ajaxProductBuyButton ? 'true' : 'false'; ?>,
            buyButtonSelectors: [
                'new selector 1',
                'new selector 2',
                '...'
            ]
        });
    });
</script>

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