Сниппет TSVshop

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

• инфоблок корзины (&act=`info`);
• корзина заказов (&act=`basket`);
• форма для оформления заказа (&act=`checkout`);
• завершение оформления (&act=`finish`);
• карточка товара (&act=`itemcard`);
• печать накладной/товарного чека (&act=`printorder`) (новое, будет доступно с версии TSVshop 5.4)

Рассмотрим подробнее работу со сниппетом.

Инфоблок заказов (&act=`info`)

Чтобы в нужном месте страницы вывести информацию о количестве товаров в корзине и их сумме (так называемый инфоблок), достаточно вставить в страницу/шаблон такой вызов:

[!TSVshop? &act=`info` &basketid=`` &hideon=`` &tplinfoblock=`имя_чанка_или_путь_к_файлу` &tvs =``!]

где 

• &basketid=`` - это ID страницы с корзиной, 
• &hideon=`` - список ID документов (через запятую), на которых инфоблок не будет отображаться (будет скрыт); 
• &tplinfoblock=``- имя чанка или путь к файлу (напр., @FILE:путь_от_корня_сайта/имя_файла) с шаблоном инфоблока. По умолчанию чанк Shop_Infoblock.
• &tvs =`` - названия TV-параметров (через запятую), которые будут выводиться в инфоблоке вместо [ +tv.mytv+ ] (доступно с версии TSVshop 5.4)

Корзина заказов (&act=`basket`)

Чтобы вывести корзину заказов, достаточно вставить в нужную страницу/шаблон такой вызов:

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

где

• &checkid=`` - это ID страницы с формой для оформления заказа;
• &namesource=``- поле документа, откуда брать название товара, напр., longtitle, pagetitle, menutitle. По умолчанию - pagetitle.
• &tvs = `` - названия TV-параметров (через запятую), которые будут выводиться в корзине вместо [ +tv.mytv+ ] (доступно с версии TSVshop 5.4)

Внешний вид корзины вы можете настроить с помощью чанка Shop_Cart (корзина с товарами) и Shop_Cart_Empty (корзина пуста). Вы также можете указать другой чанк или даже файл. Для этого используйте параметр tplcart и tplcartempty соответственно. Например, для другого чанка такой вызов:

[!TSVshop? &act=`basket` &checkid=`` &tplcart=`имя_чанка_или_путь_к_файлу` &tplcartempty=`имя_чанка_или_путь_к_файлу`!]

Для того, чтобы вместо чанка указать файл, используйте такой вызов:

[!TSVshop? &act=`basket` &checkid=`` &tplcart=`@FILE:путь_от_корня_сайта/имя_файла` &tplcartempty=`@FILE:путь_от_корня_сайта/имя_файла`!]

Оформление заказа (&act=`checkout`)

Чтобы вывести форму оформления заказа, достаточно вставить в нужную страницу/шаблон такой вызов:

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

где

• &backid=`` - это ID страницы, куда будет происходить переход после успешного заполения формы заказа.
• &tvs = `` - названия TV-параметров (через запятую), которые будут выводиться в корзине вместо [ +tv.mytv+ ] (доступно с версии TSVshop 5.4)

Внешний вид корзины при оформлении товара вы можете настроить с помощью чанка Shop_Checkout, а форму для оформления заказа - в чанке Shop_UserForm. Последний используется сниппетом eForm, поэтому в нем вы можете использовать синтаксис eForm.

Указать другой чанк или шаблон вы можете с помощью таких параметров сниппета:

Для корзины - tplcheckout, напр.,

[!TSVshop? &act=`checkout` &backid=`` &tplcheckout=`имя_чанка_или_путь_к_файлу`!]

Для того, чтобы вместо чанка указать файл, используйте такой вызов:

[!TSVshop? &act=`checkout` &backid=`` &tplcheckout=`@FILE:путь_от_корня_сайта/имя_файла`!]

Для формы пользователя (поддерживается ТОЛЬКО чанки) - tpluserform, напр.,

[!TSVshop? &act=`checkout` &backid=`` &tpluserform=`имя_чанка`!]

Завершение оформления заказа (&act=`finish`)

После заполнения формы заказа и ее подтверждения пользователь попадает на страницу завершения оформления заказа. Для этой страницы вызов такой:

[!TSVshop? &act=`finish` &tplsuccess=`имя_чанка_или_путь_к_файлу` &tplmailadmin=`имя_чанка_или_путь_к_файлу` &tplmailklient=`имя_чанка_или_путь_к_файлу` &tplmailupdateorder=`имя_чанка_или_путь_к_файлу` &tvs=`имена_TV`!]

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

[!TSVshop? &act=`finish` &tplsuccess=`имя_чанка_или_путь_к_файлу`!]

Для того, чтобы вместо чанка указать файл, используйте такой вызов:

[!TSVshop? &act=`finish` &tplsuccess=`@FILE:путь_от_корня_сайта/имя_файла`!]

Также в этом режиме вы можете изменить: &tplmailadmin - шаблон письма админу (по-умолчанию чанк Shop_mail_admin); &tplmailklient - шаблон письма клиенту (чанк Shop_mail_klient); &tplmailupdateorder - шаблон с письмом клиенту при изменении статуса заказ (чанк Shop_UpdateOrder). Можно указывать имена чанков и путь к файлу: @FILE:путь_от_корня_сайта/имя_файла.

Печать накладной/товарного чека (&act=`printorder`)

(новое, будет доступно с версии TSVshop 5.4)

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

[!TSVshop? &act=`printorder` &tplprintorder=``!]

где &tplprintorder - это чанк с шаблоном накладной/товарного чека.

• Может быть файлом: @FILE:путь_к_файлу/имя_файла,
• Кодом @CODE:html-код 
• Именем чанка. По-умолчанию используется файл /assets/snippets/tsvshop/addons/sales/tpl/Shop_PrintOrder.tpl.

Чтобы распечатать накладную/товарный чек, нужно перейти по ссылке: http://site.name/страница_с_вызовом_сниппета?i=номерзаказа:коддоступа

Код доступа - это поле с уникальным кодом генерируется для каждого заказа в момент его оформления. В таблице shop_order это поле называется code. Если ссылку на печать накладной нужно выслать покупателю вместе с письмом о заказе, то в чанке Shop_mail_klient (шаблон письма клиенту), то код доступа выводится плейсхолдером [ +shop.mail.code+ ]