Использование переменных из «Шпаргалки» редактора дизайна

На страницах редактора дизайна, который доступен в бекенде некоторых приложений (Shop-Script, «Сайт», «Блог», «Фото», «Хаб»), а также при редактировании информационных страниц справа внизу есть ссылка «Шпаргалка». Эта ссылка позволяет открыть область подсказок со списком переменных и методов, которые можно использовать в HTML-шаблонах соответствующего приложения.

Переменные и методы

Переменные и методы нужны для того, чтобы удобно и быстро добавлять на страницы сайта разнообразные данные, размещать которые вручную было неудобно или даже невозможно.

Например, переменная {$wa_url} добавляет в шаблон относительный URL вашей установки фреймворка Вебасист. Если фреймворк установлен и доступен по адресу вида http://yourdomain.ru/, то относительный URL установки имеет вид /. Если фреймворк установлен по адресу вида http://yourdomain.ru/folder/, то ее относительный URL — /folder/. Относительные URL используются, например, для добавления изображений на страницы сайта. Конечно, можно указывать относительный URL «по старинке», вручную: / либо /folder/, однако использование переменной в этом случае позволяет избежать необходимости учитывать директорию установки фреймворка и легче управлять дизайном сайта. HTML-код с переменной {$wa_url} может выглядеть примерно так:

<img src="{$wa_url}wa-data/public/site/images/logo.png">

Другой пример — метод {$wa->locale()}. Этот метод возвращает название языковой локали пользователя. Например, для русского языка это значение равно «ru_RU», а для английского — «en_US». Название локали можно использовать для формирования различного содержимого сайта с помощью условий следующего вида:

{if $wa->locale() == 'ru_RU'}
    ...содержимое страницы для пользователей, говорящих на русском языке...
{else}
    ...содержимое для всех остальных пользователей...
{/if}

Вкладки «Шпаргалки»

В каждом приложении, где есть редактор дизайна, в «Шпаргалке» отображаются несколько вкладок: вкладка с названием приложения (например, «Магазин» или «Фото»), а также вкладки «$wa» и «Smarty».

В приложении «Сайт» вкладки с названием этого приложения нет, т. к. в нем используются только системные переменные и методы, описанные на остальных вкладках — собственных переменных и методов для использования в шаблонах у этого приложения нет.

Вкладка с названием приложения содержит имена и описания переменных, доступных только для данного приложения. Например, в редакторе дизайна интернет-магазина доступны методы для получения информации о товарах или категориях с заданным идентификатором, в приложении «Фото» предложены переменные для получения информации об альбомах и методы для получения списков фотографий по различным признакам.

Вкладка «$wa» содержит информацию о системных переменных и методах фреймворка Webasyst. Например, здесь перечислены переменные для получения URL установки фреймворка и URL текущего поселения, методы для получения полного URL текущей страницы, содержимого строки User-Agent и другие переменные и методы, полезные для разработки и доработки темы дизайна.

На вкладке «Smarty» кратко описаны основные возможности шаблонизатора Smarty, доступные разработчику темы дизайна, например, правила получения значений переменных или задания новых значений, работа с массивами и объектами, использование условий и т. д. Более подробно с возможностями Smarty можно ознакомиться в официальной документации этого шаблонизатора.

0 комментариев

    Добавить комментарий

    Чтобы добавить комментарий, зарегистрируйтесь или войдите