Yostoro HTML šablonu valoda


Макрос Описание
Внутренние ссылки
func:href:url_base

Путь к файлам шаблона*

func:href:home Линк, ведущий на первую страницу сайта
*В шаблоне страниц (*.html) должен присутствовать <base href="func:href:url_base"> для того, чтобы картинки и другие элементы стиля показывались правильно

Файлы шаблонов
inc:template:<name> Включить в шаблон другой файл (расширение файла должно быть .inc)

Автоматическая вставка контента из базы данных, введенные через административную часть через меню Сайты > Страницы
widget:custom:appserv_header_long Заголовок страницы
widget:custom:appserv_content Текст страницы

Управляющие элементы
widget:custom:languages_form Форма переключения языков страницы. Параметры:
- type [text, images], class
widget:custom:search_form Форма поиска по продуктам. Параметры:
- submit, class, class_submit
widget:custom:currencies_switch Форма переключения валют. Параметры:
- notitle

Параметры сайта
func:app_context:img_logo_width Ширина картинки логотипа (в пикселях)
func:app_context:img_logo_height Высота картинки логотипа (в пикселях)
func:app_context:img_header_bg_width Ширина картинки темы (в пикселях)
func:app_context:img_header_bg_height Высота картинки темы (в пикселях)
func:app_context:img_bg_width Ширина картинки фона страницы (в пикселях)
func:app_context:img_bg_height Высота картинки фона страницы (в пикселях)
func:app_context:img_boxes_header_bg_width Ширина картинки заголовков модулей (в пикселях)
func:app_context:img_boxes_header_bg_height Высота картинки заголовков модулей (в пикселях)

Элементы дизайна
widget:custom:img_logo Картинка логотипа
widget:custom:img_header_bg Картинка темы
widget:custom:img_bg Картинка фона страницы
%widget:custom:img_boxes_header_bg Картинка заголовком модулей

Функциональные модули

widget:custom:products_categories

Навигация по категориям продуктов. Параметры:
  • template - файл шаблона, который, хранит оформление строки с названием категории; указывается без расширения; файл на диске должен быть с расширением .inc
  • class - класс для подстановки в элемент item:class файла шаблона "template"
  • class_odd, class_even - классы для подстановки в элемент item:class:odd_even файла шаблона "template" в зависимости от того, четная или нечетная по порядку категория показывается
  • indent_px - количество пикселей для отступа для категорий каждого нижнего уровня (по умолчанию: 15)
  • indent_nbsp - количество пробелов для отступа для категорий каждого нижнего уровня (по умолчанию: 2)
  • prepend - шаблон для прибавления к началу каждой строки (например, <li class="myclass">)
  • append - шаблон для прибавления к концу каждой строки (например: </li>)
  • separator - шаблон для прибавления между строк
Если не используется параметер "template", по умолчанию используется "простой" шаблон:
item:indent<a href="item:href">item:title</a><br />

В файле шаблона <template> распознаются макросы:
  • item:title - название категории
  • item:href - ссылка на первую страницу продуктов в категории
  • item:indent:px - пиксели отступа для под-категорий
  • item:indent - пробелы отступа для под-категорий
  • item:class - заменяется на CSS класс из параметров макроса
  • item:class:odd_even - заменяется на CSS класс из параметров макроса, указанный в "class_odd" для нечетных, "class_even" для четных строк

widget:custom:items_show

Показывать список "особенных" продуктов (например, на первой странице магазина).

Параметры:
  • type:
    • time -- автоматически заполняется первыми/последними продуктами (в зависимости от параметра "sort") из добавленных в базу магазина
    • products_highlighted, products_recommended, products_latest, products_special, products_whats_new -- заполняется из списка кодов продуктов, заданными через административную часть "Е-Коммерция > Избранные продукты"
  • template - файл шаблона, который, хранит оформление строки с названием категории; указывается без расширения; файл на диске должен быть с расширением .inc
  • submit - файл картинки кнопки "в корзину" (иначе показывается стандартная HTML кнопка)
  • class_submit - CSS класс кнопки "В корзину"
  • rows/cols - количество строк/столбцов в списке продуктов (максимум 3); если установленоrows=1,cols=1, показывается только один продукт (может быть использовано в сочетаниис sort=random для списков продуктов, составленных администратором)
  • mode - products/services - только для сайтов, предлагающих как продукты, так и подписку на услуги
  • images_required - если не задано значение "images_required=0", показываются только продукты с картинками
  • sort
    • для "type=time" если установлено sort=desc, продукты будут показываться начиная с добавленных в недавнее время, если установлено sort=asc, самые первые по дате добавления
    • длай других type (для списков продуктов, составленных администратором), если установлено sort=random, продукты будут показываться в случайном порядке
В файле шаблона <template> распознаются макросы:
  • item:title - название категории
  • item:href - ссылка на первую страницу продуктов в категории
  • item:image - картинка продукта (полный <img src="">)
  • item:price - цена продукта (в т.ч. зачеркнутая "прежняя" цена, если продукт со скидкой)
  • item:nls_label_price - метка с автопереводом "Цена"
  • item:nls_label_details - метка с автопереводом для ссылки перехода на страницу продукта
  • item:twitter - приглашение послать найденный продукт в Twitter-ленту посетителя магазина

Общеупотребительные метки с автоматическим переводом при переключении языка страницы
const:nls:NLS_LABEL_LANGUAGE "Язык"
const:nls:NLS_LABEL_SEARCH "Поиск"