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

Здесь мы рассмотрим процесс установки и начальной настройки модуля TSVshop

Видеоинструкция установки

Автоматическая установка

ВАЖНО! Этот вариант установки можно делать ТОЛЬКО на уже установленный MODx. Поэтому прежде чем вы последуете нижеприведенным шагам, установите сначала MODx обычным способом.

После этого делаем следующее:

1. Скачайте архив модуля и распакуйте его. После распаковки вы увидите две папки: assets и install.
2. Разместите эти папки в корень вашего сайта поверх уже существующих папок.
3. На файлы /assets/snippets/tsvshop/js/config.js и /assets/snippets/tsvshop/include/config.inc.php нужно выставить права на запись (обычно 666)
4. Перейдите в браузере по пути http://ваш.домен/install. Начнется процесс установки, напоминающий стандартную установку MODx. Пройдите его полностью до конца. На странице выбора устанавливаемых компонентов отметьте галочками все, что вам нужно (а нужно все). После установки будут созданы все необходимые компоненты.
5. В случае, если вы устанавливаете модуль на "пустой" MODx (без контента), крайне желательно, чтобы вы установили ДЕМО-КОНТЕНТ, т.к. при этом создадутся все необходимые для работы модуля страницы (на работающем сайте ДЕМО-КОНТЕНТ ставить нельзя, т.к. он может удалить существующие страницы. В таком случае для создания нужных страниц смотрите пункт 8). Далее вы сможете уже подкорректировать или совсем сменить дизайн и т.д.
6. Зайдите в админку и перейдите на вкладку МОДУЛИ -> TSVshop. Там в разделе Аддоны установите нужные вам аддоны.
7. В разделе Конфигурация выполните все нужные настройки.
8. В случае, если вы устанавливаете модуль на РАБОТАЮЩИЙ сайт (не устанавливали ДЕМО-КОНТЕНТ), создайте три документа, где будут Корзина, Оформление покупки и Завершение покупки (сделайте скрытой); Далее:
   1. Для Корзины вызов сниппета такой:
      

      [!TSVshop? &act=`basket` &checkid=``!]

      – где checkid – ИД страницы оформления покупки;
   2. Для Оформления покупки вызов такой:
      

      [!TSVshop? &act=`checkout` &backid=``!]

      – где backid – ИД страницы, куда переход после успешной покупки;
   3. Для Завершения покупки такой:
      

      [!TSVshop? &act=`finish`!]

   4. Если вам нужно вставить кнопку добавления товара в корзину на отдельной странице, без использования Ditto, то воспользуйтесь таким кодом:

      [!TSVshop? &act=`itemcard`!]
      <form action="" method="post" name="Tovar[*id*]" id="Tovar[*id*]" >
      [+tsvoptions+]
        Цена: [+tsvprice+] руб.
        <p><input type="text" name="qty" value="1" [+tsvbattr+] /></p>
         <a href="javascript: void(0);" onclick="AddToCart('[*id*]');return false">В корзину</a>
      [+tsvservices+]
      </form>
      

      Обратите внимание, что обязательно наличие вызова сниппета [!TSVshop? &act=`itemcard`!] , поскольку с его помощью идет обработка плейсхолдеров [+tsvoptions+], [+tsvprice+], [+tsvbattr+] и [+tsvservices+] (это системные плейсхолдеры, вместо которых выводится служебная информация). Также при вызове [!TSVshop? &act=`itemcard`!] срабатывает событие TSVshopOnViewItemCard, которое можно повесить на плагин для обработки карточки товара или для подсчета просмотров товара.

Ручная установка

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

1. Распакуйте архив и полученную папку assets закачайте в корневую папку MODx (где находится папка assets);
2. Откройте папку /assets/snippets/tsvshop/install, внутри которой вы увидите файлы установки.
3. Создайте модуль TSVshop, воспользовавшись файлом TSVshop.module.tpl из папки install;
4. Создайте сниппет TSVshop, воспользовавшись файлом TSVshop.snippet.tpl из папки install;
5. Создайте сниппет TSVshop_options, воспользовавшись файлом TSVshop_options.snippet.tpl из папки install;
6. Создайте чанк product, воспользовавшись файлом product.chunk.tpl (с помощью этого чанка и Дитто будет выводиться список товаров) из папки install;
7. Создайте чанк Shop_Cart, воспользовавшись файлом Shop_Cart.chunk.tpl (шаблон корзины заказов) из папки install;
8. Создайте чанк Shop_Cart_Empty, воспользовавшись файлом Shop_Cart_Empty.chunk.tpl (шаблон пустой корзины заказов) из папки install;
9. Создайте чанк Shop_Checkout, воспользовавшись файлом Shop_Checkout.chunk.tpl (шаблон корзины при оформлении заказов) из папки install;
10. Создайте чанк Shop_Infoblock, воспользовавшись файлом Shop_Infoblock.chunk.tpl (шаблон инфоблока) из папки install;
11. Создайте чанк Shop_FinishText, воспользовавшись файлом Shop_FinishText.chunk.tpl (выводит сообщение об успешной покупке) из папки install;
12. Создайте чанк Shop_UserForm, воспользовавшись файлом Shop_UserForm.chunk.tpl (выводит форму для данных пользователя) из папки install;
13. Создайте чанк Shop_mail_admin, воспользовавшись файлом Shop_mail_admin.chunk.tpl (задает вид письма админу для подтверждения заказа) из папки install;
14. Создайте чанк Shop_mail_klient, воспользовавшись файлом Shop_mail_klient.chunk.tpl (задает вид письма клиенту для подтверждения заказа) из папки install;
15. Создайте чанк Shop_UpdateOrder, воспользовавшись файлом Shop_UpdateOrder.chunk.tpl (задает вид письма обновления статуса заказа) из папки install;
16. Создайте плагин TSVсlearCache, воспользовавшись файлом TSVсlearCache.plugin.tpl из папки install; присвойте события OnCacheUpdate, OnManagerPageInit
17. Создайте плагин TSVshopNotifier, воспользовавшись файлом TSVshopNotifier.plugin.tpl из папки install; присвойте события OnManagerWelcomePrerender
18. Создайте плагин Hints, воспользовавшись файлом Hints.plugin.tpl из папки install; присвойте события OnChunkFormRender, OnTempFormRender, конфигурация &lang=hints language;string;ru
19. Создайте TV-параметр price, в котором будет задаваться цена товара. Присвойте этот параметр шаблону страницы, которая является карточкой товара;
20. Создайте TV-параметр tsvshop_param, в котором будет задаваться дополнительные свойства товара. Присвойте этот параметр шаблону страницы, которая является карточкой товара;
21. При необходимости создайте TV-параметр cart_icon с типом ввода Image, в котором будет задаваться иконка товара, отображаемая в корзине. Присвойте этот параметр шаблону страницы, которая является карточкой товара;
22. Создайте три документа, где будут Корзина, Оформление покупки и Завершение покупки (сделайте скрытой);
23. На файлы /assets/snippets/tsvshop/js/config.js и /assets/snippets/tsvshop/include/config.inc.php нужно выставить права на запись.
24. Для Корзины вызов сниппета такой:
    

    [!TSVshop? &act=`basket` &checkid=``!]

    – где checkid – ИД страницы оформления покупки;
25. Для Оформления покупки вызов такой:
    

    [!TSVshop? &act=`checkout` &backid=``!]

    – где backid – ИД страницы, куда переход после успешной покупки;
26. Для Завершения покупки такой:
    

    [!TSVshop? &act=`finish`!]

27. В любом месте шаблона страницы или документа, в котором будет выводиться список товаров, вставьте вызов:
    

    [!TSVshop? &act=`none`!]

    – это касается только той страницы, где ни разу не вызывался сниппет TSVshop. Этот вызов вставит в код страницы служебные скрипты, необходимые для работы корзины. На странице корзины, оформления и завершения покупки, а также там, где есть хотя-бы один вызов сниппета TSVshop, этот вызов не делать;
28. При желании в любую часть страницы можно вставить инфоблок корзины, в котором отображается общая сумма заказа и колличество товаров в корзине со ссылкой на саму корзину. Вызов инфоблока таков:
    

    [!TSVshop? &act=`info` &basketid=``!]

    – где baskeid – ИД страницы с корзиной;
29. Теперь в самом каталоге продукции в Ditto используйте чанк product. Например:
    

    [!Ditto? &language=`russian` &tpl=`product` &sortDir=`ASC` &extenders=`shop`!]

    – это выведет продукцию с кнопкой «В корзину». ОБРАТИТЕ ВНИМАНИЕ! В вызове Ditto при выводе списка товаров магазина указан параметр &extenders=`shop` - его присутствие обязательно. С его помощью идет обработка чанка product. Без этого параметра добавление в корзину работать не будет.
30. Либо если вы используете для вывода товаров сниппет DocLister, то используйте такой вывод (здесь только минимально необходимый набор параметров)

    [!DocLister? &parents=`30` &prepare=`TSVshopPrepare`  &tvList=`cart_icon,price,typeitem,tsvshop_param` &tpl=`DLproduct`!]

    Подробнее о работе с DocLister читайте здесь
31. Если вам нужно вставить кнопку добавления товара в корзину на отдельной странице, без использования Ditto, то воспользуйтесь таким кодом:

    [!TSVshop? &act=`itemcard`!]
    <form action="" method="post" name="Tovar[*id*]" id="Tovar[*id*]" >
    [+tsvoptions+]
      Цена: [+tsvprice+] руб.
      <p><input type="text" name="qty" value="1" [+tsvbattr+] /></p>
       <a href="javascript: void(0);" onclick="AddToCart('[*id*]');return false">В корзину</a>
    [+tsvservices+]
    </form>
    

    Обратите внимание, что обязательно наличие вызова сниппета [!TSVshop? &act=`itemcard`!] , поскольку с его помощью идет обработка плейсхолдеров [+tsvoptions+], [+tsvprice+], [+tsvbattr+] и [+tsvservices+] (это системные плейсхолдеры, вместо которых выводится служебная информация). Также при вызове [!TSVshop? &act=`itemcard`!] срабатывает событие TSVshopOnViewItemCard, которое можно повесить на плагин для обработки карточки товара или для подсчета просмотров товара.