Переменные и методы
На страницах редактора дизайна, который доступен в бекенде некоторых приложений (Shop-Script, «Сайт», «Блог», «Фото»), справа внизу есть ссылка «Шпаргалка». Эта ссылка позволяет открыть область подсказок со списком переменных и методов, которые можно использовать в шаблонах соответствующего приложения.
Переменные и методы нужны для того, чтобы удобно и быстро добавлять на страницы сайта разнообразные данные, размещать которые вручную было неудобно или даже невозможно. Например, переменная {$wa_url} добавляет в шаблон относительный URL вашей установки фреймворка Вебасист. Если фреймворк установлен и доступен по адресу вида http://yourdomain.ru/, то относительный URL установки имеет вид /. Если фреймворк установлен по адресу вида http://yourdomain.ru/<strong>folder/</strong>, то ее относительный URL — /<strong>folder/</strong>. Относительные 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 можно ознакомиться в официальной документации этого шаблонизатора.
