Установка и настройка SHK 2.x

Установка

    • Можно скачать дополнение в административной части сайта. Для этого перейти в "Система" -> "Управление пакетами". Нажать кнопку "Скачать дополнение". Далее перейти "Extras" -> "E-commerce" и в строке "Shopkeeper" нажать кнопку "Загрузить", потом кнопку "Готово".
    • Если вы скачали файл с сайта modx.com, загрузите архив "shopkeeper-2.0-*.transport.zip" в папку core/packages/ вашего сайта. В панеле управления перейти "Система" -> "Управление пакетами" -> "Добавить новый пакет" -> "Искать пакеты локально" -> "Дальше".
  1. В таблице пакетов появится пакет "shopkeeper". Нажать кнопку "Установить".
  2. Закончить установку.

Настройка

  1. Открыть "Элементы" -> "Сниппеты" -> "Shopkeeper" -> "Параметры".
  2. Нажать кнопку "Добавить набор параметров", отметить флажок "Создать новый набор параметров" и заполнить поля. Имя набора желательно на латинице, например "catalog".
  3. В списке слева выбрать созданный набор и при необходимости изменить параметры.
  4. В шаблоне в месте, где нужно вывести корзину покупок, вызвать сниппет Shopkeeper с указанием набора параметров. Пример:
    [[!Shopkeeper@catalog?propertySetName=`catalog`]]
    
    propertySetName - имя набора параметров сниппета. Также это имя нужно указать после символа "@".
Параметры сниппета по умолчанию редактировать не рекомендуется, т.к. при обновлении на новую версию они могут измениться.

Настройка контекста "catalog"

Размещение товаров в отдельном контексте не обязательно, но рекомендуется, если планируется много товаров (больше 2000). Это позволит для каталога сделать индивидуальные настройки, например, при необходимости отключить дружественные URL (friendly_urls).

Создать контекст "catalog". Настройки контекста (правый клик -> Редактировать -Ю Создать новый):
site_start: 10
error_page: 10
unauthorized_page: 11
где 10 - ID документа каталога (у вас свой), site_start - стартовая страница, error_page - страница 404, unauthorized_page - страница 403 (доступ запрещен)

Создать в контексте "catalog" документ-контейнер "Каталог" с псевдонимом "catalog". Внутри создать структуру каталога.

Права доступа контекста "catalog" ("Система" -> "Контексты" -> "catalog -> Обновить контекст" -> "Права доступа") должны быть такие же как у контекста "web", т.е.:
аноним, 9999, Load only
Administrator, 0, Administrator

В контекте "web" создать документ-ссылку "Каталог", в поле "Ссылка" ввести "catalog/".

Проверить чтобы был установлен плагин "shk_contextSwitch" (core/components/shopkeeper/elements/plugins/context_switch.php).

Если используется регистрация, нужно создать группу пользователей. Для этого перейти "Безопасность" -> "Контроль доступа". Нажать кнопку "Новая группа пользователей" и ввести название, например "Покупатели". Далее кликнуть правой кнопкой мыши на группе и выбрать "Редактировать группу пользователей". Перейти на вкладку "Доступ к контекстам". Нажать кнопку "Добавить контекст", выбрать контекст "web", минимальная роль - 9999, Политика доступа - Load only. Также добавить контекст "catalog" (доступа к контексту "mgr" быть не должно).
Перезагрузить права доступа: "Безопасность" -> "Перезагрузить права доступа".