ьМЧЙУ-фЕМЕЛПН ISP
  
  
  
  
  
  


Документация по шаблонам для интернет-магазина OSG WebShop, версии 1.x.


Версия
для
печати
Общие сведения
Описание команд CGI программы и html-шаблонных файлов ИМ.
Форматы вызова CGI программы и обязательные теги.
Команды CGI программы и соответствующие им html-шаблоны
Описание специальных тегов и их применение. Служебные теги
Описание специальных тегов и их применение. Шаблонные теги форматирования
Описание шаблонных тегов форматирования и способы их применения

Общие сведения

HTML-шаблоны Интернет-магазина (далее ИМ) используются при разработке дизайна Веб-сайта соответствующего ИМ. Внешний вид Веб-сайта ИМ и его функциональные возможности определяются работой CGI программы, которая транслирует html-шаблонные файлы, используя определенные команды.

Все графические файлы, использующиеся для построения навигации и дизайна сайта ИМ должны располагаться в поддиректории i относительно базового url сайта ИМ.

Все коды и значения команд должны писаться прописными латинскими буквами.

Для каждого раздела Веб-сайта ИМ определен соответствующий html-шаблонный файл, который, в свою очередь, включает специальные теги, использующиеся CGI программой при форматированном выводе информации, содержащейся в базах данных ИМ, а также для построения навигации по Веб-сайту ИМ. Специальные теги, при транслировании html-шаблонного файла CGI программой, заменяются соответствующими данными. Специальные теги делятся на служебные теги и шаблонные теги форматирования. Служебные теги используются для построения навигации и вывода служебной информации относительно работы ИМ. Некоторые служебные теги являются обязательными для включения в html-шаблоны, тем самым, обеспечивая корректную работу CGI интерфейса ИМ. Шаблонные теги форматирования используются для описания шаблонов, определяющих визуальное представление информационных баз данных ИМ.

Все названия специальных тегов должны писаться ЗАГЛАВНЫМИ латинскими буквами.

Описание команд CGI программы и html-шаблонных файлов ИМ.

Форматы вызова CGI программы и обязательные теги.

Формат вызова CGI программы, использующийся в html тегах <a href="…" > должен иметь следующий вид:

"/cgi-bin/osg_script.cgi?i=<!--#SHOPNAME#-->[&c=значение управляющей команды[&код дополнительной команды=значение дополнительной команды[&…]]]"

Формат вызова CGI программы, использующийся в  html тегах <form action="…"> должен иметь следующий вид:

<form action="/cgi-bin/osg_script.cgi" method=post>
<input type=hidden name=i value="<!--#SHOPNAME#-->">
[<input type=hidden name=c value="значение управляющей команды">]
[<input type=hidden name="код дополнительной команды" value="значение дополнительной команды">]
[…]

Обязательными данными являются относительный виртуальный путь к CGI программе "/cgi-bin/osg_script.cgi", команда идентификации "i" с обязательным служебным тегом <!--#SHOPNAME#--> в качестве значения данной команды.

Дополнительные команды и управляющая команда "c" являются необязательными.

Каждый html-шаблонный файл должен содержать обязательный тег <base href="<!--#SERVER#-->/"> для обеспечения корректной обработки локальных и глобальных ссылок относительно текущего html-документа в рамках Веб-сайта соответствующего ИМ.

Стартующий html документ (документ по умолчанию) для Веб-сайта ИМ должен иметь имя index.htm и содержать следующие данные:

<html>
<head>
<meta content="0; url=http://www.доменное имя ИМ/cgi-bin/osg_script.cgi?i=учетное имя ИМ" http-equiv=refresh>
</head>
</html>

Команды CGI программы и соответствующие им html-шаблоны

Доступ к необходимым разделам Веб-сайта ИМ определяется значением управляющей команды "c", а также расширенной командой "v". CGI программа транслирует соответствующий html-шаблонный файл в зависимости от значения данной команды.

В таблице №1 приводится список значений управляющей команды и соответствующие им транслируемые html-шаблонные файлы.

Значение управляющей команды
Транслируемый файл
Описание раздела
Стандартные команды управления ИМ
Нет либо команда не используется home.htm

Основная (вводная) страница ИМ.

about about.htm

Страница, содержащая информацию о фирме — владельце данного ИМ.

info, info1, info2, info3, и т.д. Info.htm, info1.htm, info2.htm, и т.д.

Страницы, содержащие любую информацию об ИМ. Применяется для предоставления посетителю Веб-сайта необходимой информации для пользования данным ИМ.

root root.htm

Страница, содержащая список подрубрик (может не использоваться при условии вывода полного рубрикатора на странице home.htm). Если на основной странице ИМ home.htm выводятся только главные рубрики, то шаблон root.htm используется для вывода списка подрубрик соответствующего выбранной рубрике на странице home.htm посетителем сайта данного ИМ.

child child.htm

Страница, содержащая список товаров определенной подрубрики.

search search.htm

Страница, содержащая результаты выполнения запроса на поиск необходимого товара.

linkinfo linkinfo.htm

Страница, содержащая дополнительную информацию об отдельном товаре (описание товара). Дополнительная информация о товаре доступна, если в «Менеджере ИМ» определена ссылка на соответствующий товар (см. инструкцию пользователя «Менеджера ИМ»).

Если к товару прилагается текстовое либо графическое описание, то в списке товаров, соответствующего раздела сайта ИМ, он отображается в виде ссылки.

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

Showbasket basket.htm

Страница, содержащая информацию о состоянии корзины посетителя Веб-сайта ИМ. Также содержит приглашение (html-форму) для оформления заказа.

add child.htm

Добавление товара в корзину.

Updatebasket basket.htm

Пересчет общей суммы корзины посетителя согласно количеству выбранного товара.

authorise Home.htm

Режим авторизации посетителя в ИМ. При успешной авторизации устанавливается защищенная сессия для данного посетителя. Приглашение к авторизации располагается на главной странице home.htm.

enter service.htm или serviceok.htm

Аналогично authorise. При успешной авторизации транслируется serviceok.htm, иначе — service.htm. Приглашение к авторизации через режим enter располагается, как правило, на странице service.htm.

service service.htm или serviceok.htm

Страница service.htm содержит приглашение (html-форму) для авторизации посетителя в ИМ. Если посетитель прошел авторизацию режимом authorise, то транслируется serviceok.htm.

  serviceok.htm

Страница просмотра и управления заказами клиента данного ИМ. Доступна только после успешной авторизации.

reg reg.htm

Страница, содержащая приглашение (html-форму) регистрации посетителя в ИМ.

register reg.htm или regok.htm

Выполняет регистрацию посетителя в ИМ. При успешной регистрации транслируется regok.htm, иначе reg.htm.

orderlogin ordlogin.htm или basket.htm

Проверяет возможность посетителя оформить заказ. Если посетитель авторизовался в ИМ, то транслируется ordlogin.htm, иначе — basket.htm.

  ordlogin.htm

Страница, содержащая html-форму для выбора необходимого способа оплаты и способа доставки заказа.

orderfinal ordfinal.htm или bas-ket.htm

Формирует заказ посетителя ИМ. Если заказ сформирован успешно, то транслируется ordfinal.htm, иначе — basket.htm.

  ordfinal.htm

Страница, содержащая информацию о  том, что заказ был успешно сформирован.

print print.htm и print_o.htm

print.htm содержит краткую информацию о заказе и используется для отображения не обработанного заказа. print_o.htm содержит заполненный необходимой информацией бланк выставляемого счета владельцем данного ИМ, и используется для отображения обработанного заказа.

delorder serviceok.htm или home.htm

Удаляет заказ на странице просмотра и управления заказами клиента данного ИМ. В случае успешного удаления транслируется serviceok.htm, иначе — home.htm.

Расширенные команды управления ИМ
Setvalute Текущий html-шаблонный файл

Выбор необходимого вида цен на товары или услуги согласно установленному курсу обмена валюты.


Описание специальных тегов и их применение. Служебные теги

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

Служебные теги имеют следующий формат (использование пробелов не допускается):

<!--#код служебного тега#-->

В таблице №2 приводится описание служебных тегов и способы их применения:

Тег
Заменяемое значение
Использующий шаблон и назначение тега
Служебные теги общего назначения, применяемые для построения навигации Веб-сайта ИМ.
<!--#SERVER#-->

WWW-адрес сервера (базовый url)

Обязательный параметр для всех шаблонов, включаемый в тег
<base href="<!--#SERVER#-->">.

<!--#SHOPNAME#-->

Код магазина (учетное имя)

Обязательный параметр при обращении к CGI программе, строго использующийся в формате:
i=<!--#SHOPNAME#-->
для html-ссылок и 
<input type=hidden name=i value="<!--#SHOPNAME#-->">
для html-форм.

Любое обращение к CGI программе должно содержать этот параметр.

<!--#PARAM#-->

Полные параметры вызова CGI программы

Используется в html-ссылках вида:
<a href=" <!--#PARAM#--> #anchor">,
обеспечивая корректный вызов локальных ссылок относительно текущего html документа.

<!--#RND#-->

Случайное число (одно на страницу)

Как правило, используется в качестве параметра для корректной (без кэширования) загрузки баннеров. Например:
http://rle.ru/cgi/rle.cgi?20056? <!--#RND#-->

<!--#ERRMSG#-->

Сообщения об ошибках, вызванные некорректными действиями посетителя при просмотре разделов ИМ.

Рекомендован к включению в шаблоны

  • home.htm (означает ошибку при авторизации посетителя в ИМ),
  • basket.htm (ошибки связанные при работе с корзиной),
  • service.htm (ошибки связанные с оформлением заказа),
  • reg.htm (ошибки связанные с регистрацией посетителя).

Информационные и командные служебные теги.
<!--#BASKET#-->

Выводит содержимое корзины посетителя в текстовом виде.

Рекомендован к использованию во всех шаблонах, кроме print.htm. Может использоваться в качестве информационной текстовой строки, либо в качестве параметра тега <img src="…" alt=<!--#BASKET#-->>, отражающей содержимое корзины посетителя.

<!--#LINKINFOTEXT#-->

Выводит текст описания товара (текстовая часть ссылки на товар определенная в «Менеджере Интернет-Магазина» для соответствующего товара).

Рекомендован к использованию в шаблоне linkinfo.htm.

<!--#LINKINFOGRAPH#-->

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

Рекомендован к использованию в шаблоне linkinfo.htm. Обязательный формат использования:

<img src="linkpics/ <!--#LINKINFOGRAPH#--> " …>

<!--#PAGESIZE=NN#-->

Заменяемого значения нет

Устанавливает количество выводимых за раз строк (позиций) товара при просмотре. Вместо NN необходимо поставить соответствующее число. Рекомендован к использованию в шаблоне child.htm

<!--#INCLUDE=имя фай-ла#-->

Заменяется содержимым соответствующего файла с обработкой всех тегов шалонов ИМ в вставляемом файле.

Аналог команды SSI
<!--#include file="имя файла"-->

<!--#CATOPTIONS#-->

Вставляет тег SELECT, содержащий полный рубрикатор (рубрики и подрубрики), на страницу

Рекомендован к использованию в шаблонах

  • home.htm,
  • linkinfo.htm,
  • child.htm,
  • basket.htm,
  • service.htm,
  • info.htm.

Также может использоваться и в других шаблонах.

<!--#CATALOG#-->

Выводит рубрикатор ИМ согласно шаблонному тегу форматирования:

  • <!--#MAINCAT#

(см. раздел "Теги форматирова ния")

Рекомендован к использованию в шаблоне home.htm.

<!--#CATCHILD#-->

Выводит подрубрики, соответствующие выбранной рубрике, согласно шаблонному тегу форматирования:

  • <!-- #CHILDCAT#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне root.htm.

<!--#CHILDSNUM=ИД#-->

Вывод списка подрубрик отдельной рубрики в любом месте страницы, согласно шаблонным тегам

  • <!--#MAINCAT#,
  • <!--#CHILDCAT#

ИД — идентификатор основной рубрики.

<!--#ITEMS#-->

Выводит список товаров, соответствующий выбранной подрубрике, согласно шаблонным тегам форматирования:

  • <!--#ITEMSEPARATOR#
  • <!--#ITEMTEMPLATE#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне child.htm.

<!--#ITEMSNUM=ИД #-->

Вывод списка товаров отдельной подрубрики в любом месте страницы, согласно шаблонным тегам

  • <!--#ITEMTEMPLATE#,
  • <!--#ITEMSEPARATOR#,
  • <!--#STATUSTAMPLATE#

ИД — идентификатор подрубрики.

<!--#SEARCHITEMS#-->

Выводит список товаров, соответствующий поисковому запросу (режим поиска товаров по наименованию), согласно шаблонным тегам форматирования:

  • <!--#MAINCAT#,
  • <!--#CHILDCAT#,
  • <!--#ITEMTEMPLATE#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне search.htm

<!--#BASKETITEMS#-->

Выводит список товаров, выбранных посетителем ИМ в корзину, согласно шаблонному тегу форматирования:

  • <!--#BASKETTEMPLATE#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне basket.htm

<!--#ORDERITEMS#-->

Выводит список товаров сформированного посетителем заказа в выставляемом ему счете согласно шаблонному тегу форматирования:

  • <!--#ORDERTEMPLATE#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне print.htm.

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

<!--#ORDERS_LIST#-->

Выводит список заказов и их текущие состояния (обработан, оплачен, отгружен) согласно шаблонному тегу форматирования:

  • <!--#ORDERTEMPLATE#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне serviceok.htm.

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

  • <!--#ORDERTEMPLATE#

в файле print.htm может не совпадать с таким же тегом в файле serviceok.htm.

<!--#SPECIALSITEMS#-->

Выводит список специальных предложений согласно шаблонному тегу форматирования:

  • <!--#SPECIALSCAT#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне home.htm либо root.htm, либо в других шаблонных файлах.

<!--#SINGLITEM#-->

Выводит отдельную позицию товара, выбранную по ссылке (дополнительной информации), согласно шаблонному тегу форматирования:

  • <!--#ITEMTEMPLATE#

(см. раздел "Теги форматирования")

Рекомендован к использованию в шаблоне linkinfo.htm.

Дает возможность заказать соответствующий товар из окна подробного описания.

<!--#INTEXT#-->

Выводит предыдущие значения условий для поиска.

Рекомендован к использованию в шаблоне search.htm.

Необходим для реализации механизма «поиска в найденном».

Обязательные форматы использования:

  • <input type=hidden name=intext value="<!--#INTEXT#-->">

для html форм

  • <a href="ws.exe?…&intext=' <!--#INTEXT#-->"

для html ссылок

<!--#VIEWVALUTE#-->

Выводит наименование текущей валюты (руб., долл.) согласно шаблонному тегу форматирования:

  • <!--#VALUTECAT#

(см. раздел "Теги форматирования")

Рекомендован к использованию во всех шаблонах, кроме print.htm.

<!--#SETVALUTE#-->

Выводит инверсное значение текущей валюте (например, если текущее — руб., то вывод. Долл.) согласно шаблонному тегу форматирования:

  • <!--#VALUTECAT#

(см. раздел "Теги форматирования")

Рекомендован к использованию во всех шаблонах, кроме print.htm. Обязательный формат использования:

  • <a href="/scripts/wsshop.exe? v=setvalute& <!--#PARAM#--> "> <!--#SETVALUTE#--> </a>

Доступ к изменению текущей валюты определяется «Менеджером Интернет-Магазина».

<!--#CURSEVALUTE#-->

Выводит значение текущего курса валюты установленного «Менеджером Интернет-Магазина».

Рекомендован к использованию во всех шаблонах, кроме print.htm.

<!--#IMAGEBASKET#-->

Выводит имя файла картинки корзины покупателя согласно шаблонному тегу форматирования:

  • <!--#IMAGEBASKETCAT#

(см. раздел "Теги форматирования")

Рекомендован к использованию во всех шаблонах, кроме print.htm. Теги, выводящие данные о заказе

Теги, выводящие данные о заказе
<!--#ORDER#-->

Номер заказа

Рекомендован к использованию в шаблонах ordfinal.htm и print.htm.

<!--#TOTALSUM#-->

Общая сумма не оформленного заказа (считается по наличию товара в корзине).

Рекомендован к использованию в шаблонах basket.htm и ordlogin.htm.

<!--#ORDERSUM#-->*

Общая сумма оформленного заказа, показанная в валюте, установленной посетителем сайта.

Рекомендован к использованию в шаблоне print.htm.

<!--#USDORDERSUM#-->*

Общая сумма оформленного заказа, показанная в USD, не зависимо от валюты уста-новленной посетителем сайта.

Рекомендован к использованию в шаблоне print.htm.

<!--#RUBLEORDERSUM#-->*

Общая сумма оформленного заказа, показанная в рублях, не зависимо от валюты установленной посетителем сайта.

Рекомендован к использованию в шаблоне print.htm.

<!--#ORDERNDS#-->**

НДС (в установленной валюте)

Рекомендован к использованию в шаблоне print.htm.

<!--#USDORDERNDS#-->**

НДС в USD

Рекомендован к использованию в шаблоне print.htm.

<!--#RUBLEORDERNDS#-->**

НДС в рублях

Рекомендован к использованию в шаблоне print.htm.

<!--#ORDERTOT#-->***

Общая сумма минус НДС (в установленной валюте)

Рекомендован к использованию в шаблоне print.htm.

<!--#USDORDERTOT#-->***

Общая сумма минус НДС в USD

Рекомендован к использованию в шаблоне print.htm.

<!--#ORDERSUMDOST#-->

Стоимость доставки

Используется в шаблонах print.htm и print_o.htm

<!--#RUBLEORDERTOT#-->***

Общая сумма минус НДС в рублях

Рекомендован к использованию в шаблоне print.htm. Из соответствующих тегов (*,**,***) должен использоваться только один, указывающий в каких единицах (в какой валюте) должен быть выписан счет или чек. Теги, выводящие данные о клиенте (посетителе)

<!--#USER_FIO#-->

ФИО клиента

Рекомендован к использованию в шаблонах ordlogin.htm, ordfinal.htm ,servicrok.htm, reg,htm, regok.htm.

<!--#USER_LOGIN#-->

"Login" зарегистрировавшегося клиента.

Рекомендован к использованию во всех шаблонах, кроме print.htm.

<!--#USER_PASS#-->

Пароль клиента

Рекомендован к использованию в шаблонах ordlogin.htm, ordfinal.htm

<!--#USER_CITY#-->

Город

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_INDEX#-->

Почтовый индекс

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_COUNTRY#-->

Страна

Рекомендован к использованию в шаблоне reg,htm.

<!--#USER_AREA#-->

Область, Край

Рекомендован к использованию в шаблоне reg,htm.

<!--#USER_EMAIL#-->

E-Mail

Рекомендован к использованию в шаблоне reg,htm.

<!--#USER_PHONE#-->

Телефон

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_FAX#-->

Факс

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_ADDRESS#-->

Адрес

Рекомендован к использованию в шаблонах ordfinal.htm, reg,htm, print.htm.

<!--#USER_ORG#-->

Название организации

Рекомендован к использованию в шаблонах ordfinal.htm, reg,htm, print.htm.

<!--#USER_INN#-->

ИНН организации

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_KS#-->

Кр. Счет.

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_RS#-->

Рс. Счет

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_BANK#-->

Банк

Рекомендован к использованию в шаблонах print.htm, reg,htm.

<!--#USER_BIK#-->

БИК

Рекомендован к использованию в шаблонах print.htm, reg,htm.


Описание специальных тегов и их применение. Шаблонные теги форматирования

Шаблонные теги форматирования используются для оформления блоков данных в html-шаблонном файле. При транслировании html-шаблонных файлов CGI программой, шаблонные теги форматирования используются в  дальнейшем служебными тегами для вывода соответствующих данных, согласно содержимому внутри них шаблонному коду.

Шаблонные теги форматирования обязательно должны располагаться до соответствующих (совместно использующихся) служебных тегов (см. таблицу №2 «Информационные и  командные служебные теги») в html-шаблонном файле.

Шаблонные теги форматирования имеют следующий формат:

<!--#код тега форматирования# (начало тега — отдельная строка)
…<теги html>…#внутренние теги форматирования#…<теги html>
--> (конец тега - отдельная строка)

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

Описание шаблонных тегов форматирования и способы их применения

 

Тег VALUTECAT

Формат тега:

<!--#VALUTECAT#
#RUBLE=КодРубли# #USD=КодUSD#
-->

Где:
  • КодРубли — html код представляющий вид символа "Рубли" в ИМ.
  • КодUSD — html код представляющий вид символа "USD" в ИМ.
Использующий шаблон
и назначение тега:

Используется служебными тегами <!--#VIEWVALUTE#--> и <!--#SETVALUTE#--> для вывода символов представления денежных единиц ИМ

Рекомендован к использованию во всех шаблонах, кроме print.htm.

 

Тег IMAGEBASKETCAT

Формат тега:

<!--#IMAGEBASKETCAT#
#EMPTY=i/картинка пустой корзины# #PRESENT=i/картинка корзины содержащей товар#
-->

Где:
  • картинка пустой корзины — имя графического файла, изображающего пустую корзину.
  • картинка корзины содержащей товар — имя графического файла, изображающего не пустую корзи-ну.
Использующий шаблон
и назначение тега:

Используется служебным тегом <!--#IMAGEBASKET#--> для отображения соответствующего вида корзины посетителя ИМ

Рекомендован к использованию во всех шаблонах, кроме print.htm.

 

Тег SPECIALSCAT

Формат тега:

<!--#SPECIALSCAT#
#LINKCURWIN#
… #NAME# … #ITEM=N# … #SPECPRICE# … #CHILDNAME# … #TCODE# … #LINKINFOTEXT# … #SHOPNAME# … #ID# … #CODE#
-->

Где:
  • #LINKCURWIN# — выводит описание специального предложения в текущем окне (размещается сразу после тега #SPECIALSCAT# на отдельной строке).
  • #NAME# — название товара.
  • #ITEM=N# — графический файл ссылки на товар, N — количество выводимых спец. предложений.
  • #SPECPRICE# — цена товара.
  • #CHILDNAME# — название подрубрики к которой относится товар.
  • #TCODE# — поле код товра.
  • #LINKINFOTEXT# — расширенное описание товара.
  • #SHOPNAME# — код магазина.
  • #ID# — идентификатор подрубрики.
  • #CODE# — идентификатор товара.
Использующий шаблон
и назначение тега:

Используется служебным тегом <!--#SPECIALSITEMS#--> для вывода списка специальных предложений. Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблоне home.htm и root.htm.

Теги #SHOPNAME# #ID# #CODE# используются в конструкциях вида:

<a href="/cgi-bin/osg_script.cgi?i=#SHOPNAME#&id=#ID#& code=#CODE#&c=команда"> … </a>

например для вывода корзины.

 

Тег MAINCAT

Формат тега:

<!--#MAINCAT#
…. #SHOPNAME# … #ID# … #NAME# … #CHILDS# …
-->

Где:
  • #SHOPNAME# — код магазина.
  • #ID# — код рубрики.
  • #NAME# — название рубрики.
  • #CHILDS# — вывод подрубрик в виде списка ссылок через запятую.
  • #CHILD2# — вывод подрубрик в 2 колонки.
Использующий шаблон
и назначение тега:

Используется служебным тегом <!--#CATALOG#--> для вывода списка рубрик и подрубрик, и те-гом <!--#SEARCHITEMS#--> для вывода списка найденных товаров (для разделения этого списка по разделам). Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблонах home.htm, search.htm.

Если необходимо вывести только главные рубрики, то внутренний тег #CHILDS# не используется, при этом используется следующая конструкция, находящаяся внутри тега MAINCAT:

<a href="/cgi-bin/osg_script.cgi?i=#SHOPNAME#&c=root&id=#ID#">#NAME#</a>,

Параметры i=#SHOPNAME# и id=#ID# в конструкции являются обязательными.

При использовании внутреннего тега #CHILDS#, использование #SHOPNAME# и #ID# в шаблонном теге форматирования MAINCAT является не обязательным. Также использование шаблонного тега форматирования в файле search.htm является не обязательным.

 

Тег CATCHILD

Формат тега:

<!--#CATCHILD#
…. #SHOPNAME# … #ID# … #NAME#….
-->

Где:
  • #SHOPNAME# — код магазина.
  • #ID# — код подрубрики.
  • #NAME# — название подрубрики.
Использующий шаблон
и назначение тега:

Используется служебным тегом <!--#CATCHILD#--> для вывода списка подрубрик, соответствующие выбранной рубрике, и тегом <!--#SEARCHITEMS#--> для вывода списка найденных товаров (для разделения этого списка по разделам). Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблонах home.htm, search.htm, при этом используется следующая конструкция, находящаяся внутри тега CATCHILD:

<a href="/cgi-bin/osg_script.cgi?i=#SHOPNAME#&c=child&id=#ID#">#NAME#</a>

Параметры i=#SHOPNAME# и id=#ID# в конструкции являются обязательными.

Использование данного шаблонного тега форматирования в файле search.htm является не обязательным.

 

Тег SCROLTAMPLATE

Формат тега:

<!--# SCROLTAMPLATE#
…. #ALLITEMS# … #SCROLL# …
-->

Где:
  • #ALLITEMS# — количество всех товаров в разделе (число).
  • #SCROLL# — выводит линейку прокрутки в виде ссылок на группы записей "1-10, 11-20, …" и т.д.
Использующий шаблон
и назначение тега:

Используется совместно со служебным тегом <!--#PAGESIZE=NN#--> для вывода линейки прокрутки после вывода списка товаров тегом <!--#ITEMS#-->. Внутренние теги форматирования заменя-ются соответствующими значениями.

Рекомендован к использованию в шаблоне child.htm

 

Тег STATUSTAMPLATE

Формат тега:

<!--#SCROLTAMPLATE#
…. #STATUSSKLAD=любой html код#… #STATUSZAKAZ=любой html код# …
-->

Где:
  • #STATUSSKLAD — соотвтетствует статуса товара на складе.
  • #STATUSZAKAZ — соотвтетствует статуса товара под заказ.
Использующий шаблон
и назначение тега:

Используется совместно со служебным тегом <!--#ITEMS#--> и шаблонами #ITEMTEMPLATE# или #ITEMSEPARATOR# для вывода информации о товаре в режиме просмотра списка товаров или от-дельного товара. Если в шаблонах #ITEMTEMPLATE# или #ITEMSEPARATOR# включон внутренний тег #STATUS#, то данный тег будет заменятся соответствующими статусу товаров значениями описанными в теге #SCROLTAMPLATE#. Например, для того чтобы выделить товары в списке (ря-дом с наименованием товра поставить, напимер, слово "заказ" красным цветом) которые реали-зуются под заказ, то необходимо использовать следующую конструкцию:

<!--#STATUSTAMPLATE# #STATUSSKLAD=# #STATUSZAKAZ=<font color=red>заказ</font># -->

Рекомендован к использованию в шаблоне child.htm, search.htm, linkinfo.htm, basket.htm, print.htm,

 

Тег ITEMSEPARATOR

Формат тега:

См. описание тега #ITEMTEMPLATE#

Использующий шаблон
и назначение тега:

Используется служебным тегом <!--#ITEMS#--> для оформления строки-разделителя в списке товаров. Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблоне child.htm.

 

Тег ITEMTEMPLATE

Формат тега:

<!--#ITEMTEMPLATE#
#LINKCURWIN#
… #NAME# … #TCODE# … #ID# … #PRICE# … #SHOPNAME# … #CODE# … #NUMITEM# … #CURPAGE# … #QUAN# … #GARANT# … #CHILDNAME# … #LINKINFOTEXT# … #LINKINFOGRAPH# … #NOLINKNAME# … #STATUS# …
-->

Где:
  • #LINKCURWIN# — выводит описание специального предложения в текущем окне (размещается сра-зу после тега #ITEMTEMPLATE# на отдельной строке).
  • #NAME# — название товара с автоматической подстановкой ссилки (если есть) на расширенное описание.
  • #TCODE# — символьный код товара.
  • #ID# — идентификатор подрубрики.
  • #PRICE# — цена товара.
  • #SHOPNAME# — код магазина.
  • #CODE# — идентификатор товара.
  • #NUMITEM# — порядковый номер строки (1,2,3, и т.д.)
  • #CURPAGE# — номер текущей страницы (необходим при использовании скроллинга см. тег #SCROLTAMPLATE#)
  • #QUAN# — количество товара
  • #GARANT# — гарантия
  • #STATUS# — статус товара (выводится значение согласно шаблону #STATUSTAMPLATE#)
  • #CHILDNAME# - название подрубрики к которой относится товар.
  • #LINKINFOTEXT# — расширенное описание товара.
  • #LINKINFOGRAPH# — графическое изображение
  • #NOLINKNAME# — название товара без ссылки на расширенное описание.
Использующий шаблон
и назначение тега:

Используется служебными тегами <!--#ITEMS#--> и <!--#SEARCHITEMS#--> для вывода списка товаров, а также служебным тегом <!--#SINGLITEM#--> для вывода строки определенного товара (на-пример, после описания на товар). Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблонах child.htm, search.htm, linkinfo.htm (вывод строки то-вара с возможностью добавления его в корзину на странице описания).

При реализации механизма добавления товаров в корзину посетителя используется следующая конструкция, находящаяся внутри тега ITEMTEMPLATE :

<a href="/cgi-bin/osg_script.cgi?i=#SHOPNAME#& c=add&id=#ID#& code=#CODE#& curPage=#CURPAGE#"> положить в корзину </a>

Параметры i=#SHOPNAME# , id=#ID# и code=#CODE# в конструкции являются обязательными.

 

Тег BASKETTEMPLATE

Формат тега:

<!--#BASKETTEMPLATE#
… #NAME# … #PRICE# … #CODE# … #QUAN# … #SUM# … #TCODE# …
-->

Где:
  • #NAME# — название товара.
  • #PRICE# — цена товара.
  • #CODE# — идентификатор товара.
  • #QUAN# — количество выбранного товара.
  • #SUM# — сумма отдельной строки товара (цена * количество).
  • #TCODE# — поле код товра.
Использующий шаблон
и назначение тега:

Используется служебным тегом <!--#BASKETITEMS#--> для вывода списка товаров содержащихся в корзине посетителя. Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблонах basket.htm и ordlogin.htm.

При реализации механизма пересчета выбранного товара в корзине посетителя используется следующая конструкция, находящаяся внутри тега BASKETTEMPLATE:

<input type=Text name="#CODE#" value="#QUAN#"> (см. соответствующие шаблонные файлы)

В этом случае параметры name="#CODE#" и value="#QUAN#" в конструкции являются обязательными.

Для окончательного оформления заказа используется «форма подтверждения закза»

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

Смотрите стандартную команду управления «с=orderfinal»:

<input type=hidden name=d0 value="10">
<input type=hidden name=d1 value="20">

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

Пример в файле ordlogin.htm:


<input type=hidden name=d0 value="50">
<input type=hidden name=d1 value="150">
<select name=dostavka>
<option value=0>В пределах Москвы — 50 р.
<option value=1>Другие регионы — 150 р.
</select>
<input type=submit value="Оформить заказ">

В этом случае, если при формировании заказа клиент выбрал доставку «В пределах Москвы», то к итоговой стоимости сформированного заказа добавляется число 50.

Внимание!!! При этом не происходит пересчет по текущему курсу.

 

Тег ORDERTEMPLATE

Формат тега:

Вариант использования для вывода списка заказов (см. serviceok.htm)

<!--#ORDERTEMPLATE#
… #ORDER# … #DATE# … #PRICE# … #OBRABOT# … #OPLATA# … #OTGRUZHEN# … #SHOPNAME# … #ORDER# … #USER_LOGIN# … #USER_PASS# …
-->

Где:
  • #ORDER# — номер заказа.
  • #DATE# — дата заказа.
  • #PRICE# — общая стоимость заказа.
  • #OBRABOT# — состояние обработанности заказа.
  • #OPLATA# — состояние оплаты заказа.
  • #OTGRUZHEN# — состояние отгрузки заказа.
  • #SHOPNAME# — код магазина.
  • #USER_LOGIN# — имя пользователя.
  • #USER_PASS# — пароль пользователя.
Использующий шаблон
и назначение тега:

Этот вариант используется служебным тегом <!--#ORDERS_LIST#--> для вывода списка заказов, оформленных клиентом ИМ. Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблоне serviceok.htm.

При реализации механизма печати и удаления соответствующего заказа используется следую-щие конструкции, находящиеся внутри тега ORDERTEMPLATE:

Для печати:

<form method=post action="/cgi-bin/osg_script.cgi" target="_blank">
<input type="hidden" name="i" value="#SHOPNAME#">
<input type="hidden" name="c" value="print">
<input type="hidden" name="order" value="#ORDER#">
<input type="hidden" name="login" value="#USER_LOGIN#">
<input type="hidden" name="pass" value="#USER_PASS#">
<input type="image" src="i/print.gif" border=0 alt="Распечатать счет">

Для удаления:

<form method=post action="/cgi-bin/osg_script.cgi">
<input type="hidden" name="i" value="#SHOPNAME#">
<input type="hidden" name="c" value="delorder">
<input type="hidden" name="order" value="#ORDER#">
<input type="hidden" name="login" value="#USER_LOGIN#">
<input type="hidden" name="pass" value="#USER_PASS#">
<input type="image" src="i/del.gif" border=0 alt="Удалить заказ">
</form>

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

Также настоятельно рекомендуется использовать html формы для реализации функций печати и удаления.

Формат тега:

Вариант использования для вывода списка товаров в оформленном заказе (см. print.htm)

<!--#ORDERTEMPLATE#
… #NAME# … #QUAN# … [ #PRICE# | #USDPRICE# | #RUBLEPRICE# ] … [ #SUM# | #USDSUM# | #RUBLESUM# ] …
-->

Где:
  • #NAME# — наименование товара.
  • #QUAN# — количество данного товара в заказе.
  • #PRICE# — стоимость товара согласно текущей валюте.
  • #USDPRICE# — стоимость товара строго в USD.
  • #RUBLEPRICE# — стоимость товара строго в рублях.
  • #SUM# — общая стоимость товара (price*quan) согласно текущей валюте.
  • #USDSUM# — общая стоимость товара (usdprice*quan) строго в USD.
  • #RUBLESUM# — общая стоимость товара (rubleprice*quan) строго в рублях.
Использующий шаблон
и назначение тега:

Этот вариант используется служебным тегом <!--#ORDERITEMS#--> для вывода списка товаров в оформленном заказе. Внутренние теги форматирования заменяются соответствующими значениями.

Рекомендован к использованию в шаблоне print.htm.

Из внутренних тегов [ #PRICE# | #USDPRICE# | #RUBLEPRICE# ] желательно использовать один из них. То же правила относится и к тегам … [ #SUM# | #USDSUM# | #RUBLESUM# ].