Теги шаблонов - это короткие теги, которые могут быть использованы в HTML шаблонах, а некоторые из них в CSS файлах.
Теги имеют вид:
{tag="значение"}Некоторые теги могут содержать опции:
{tag="значение" option="значении_опции" other_option="другое_значение"}Кроме того, будет интересен следующий материал - http://invisionbyte.ru/docs/dev/logika-shablonov-r38/
Языковые сроки
{lang="ключ"}Возвращает фразу или слово языка, используемого пользователем в данный момент.
Доступные опции:
- sprintf - может быть использовано для передачи значений, которые будут заменены с помощью sprint. Значение будет экранировано для предотвращения XSS атак; если в экранировании нет необходимости, можно использовать htmlsprintf.
- pluralize - может быть использовано для передачи плюрализационного значения. http://invisionbyte.ru/docs/dev/yazykovye-sroki-vo-mnozhestvennom-chisle-plyuralizaciya-r28/
- wordbreak - добавляет теги <wbr> ко всем возвращаемым значениям и может быть использовано для форматирования контента, предоставляемого пользователем, способного нарушить целостность шаблона сайта.
Дата и время
{datetime="699753360"}Возвращает значение для отображения даты. По умолчанию отображает дату в формате HTML5 (например: 5 минут назад), в теге <time> и автоматически адаптируется под экраны мобильных устройств.
Доступные опции:
- norelative - отображает дату и время в обычном формате, вне тега <time> и без других дополнительных функций. Для этого нужно указать norelative="true".
- dateonly - работает как norelative, но не отображает время, только дату.
Данные пользователя
{member="name"}Возвращает значение указанного параметра для текущего авторизованного пользователя. Данный пример отобразит \IPS\Member::loggedIn()->name.
Доступные опции
- group - вернёт значение информации о группе пользователя, то есть \IPS\Member::loggedIn()->group[ $key ]. Необходимо лишь указать group="true".
- id - вернёт ID авторизованного пользователя.
- raw - предотвратит возвращение форматированного значения для предотвращения XSS атаки на сайт. Для использования необходимо указать raw="true".
Настройки
{setting="board_name"}Возвращает значение параметра с указанным ключом.
Настройки темы
{theme="selected"}Возвращает значение параметра темы с указанным ключом.
URL адреса (могут быть использованы в CSS)
{url="app=core&module=system&controller=login"}Возвращает URL.
Доступные опции:
- seoTemplate - FURL шаблон.
- seoTitle - title FURL, если применимо. Если необходимо использование более одного, можно разделить значения запятыми.
- csrf - если указано, добавит CSRF ключ в URL. Для использования нужно указать csrf="true".
- fragment - если указано, добавит #fragment в конечную часть URL с указанным значением.
- noprotocol - если указано, вернёт URL без протокола. Для использования нужно указать noprotocol="true".
- plain - вернёт URL в текстовом режиме, без HTML форматирования. Обычно используется для текстовых email шаблонов. Для использования нужно указать plain="true".
Числа
{number="1000"}Возвращает число, отформатированное локалью пользователя. Например "1,000".
Размер файла
{filesize="1000000"}Возвращает читаемый размер файла в байтах, например 1Мб.
Доступные опции:
- decimal - сделает его десятичным (1000 байт= 1кБ), вместо бинарного (1024 байта = 1кБ)
CSS префиксы (можно использовать в css файлах)
{prefix="transition" value="0.1s all linear"}Возвращает блок CSS кода со всеми префиксами браузеров ("-webkit-", "-moz-", "-ms-" и "-o-"). Опция обязательна.
Шаблон
{template="userPhoto" group="global" app="core" params="$entry->author(), 'small'"}Включает в себя ещё один шаблон. Все опции обязательны.
Изображения (можно использовать в CSS)
{resource="image.png" app="core" location="front"}Возвращает URL адрес изображения. Все опции обязательны.
Вы ражение (можно использовать в CSS)
{expression="1+1"}Выполняет указанное значение как php код и возвращает результат.
Доступные опции:
- raw - предотвращает форматирование возвращаемого результата для защиты сайта от XSS атак. Для использования необходимо указать raw="true"
Перенос строки (можно использовать в CSS)
{wordbreak="Здесь очень длиный текст..."}Возвращает значение с тегами <wbr>, чтобы избежать нарушения макета сайта контентом, предоставленным пользователями.
Обрезать контент (можно использовать в CSS)
{truncate="Длинный текст..." length="10"}Возвращает значение, укороченное до указанной в опции длины. Опция обязательна.
Дополнительные опции:
- start - может быть указано в качестве смещения
- append - может быть указано в конце обрезанного текста
Рекламные объявления
{advertisement="location"}Отображение рекламного блока, настроенного для отображения в этой области.
