Symphony. Параметры

Sat, 14 Jul 2012 09:54:57 +0500

Параметры предназначены для работы с динамически изменяющимися значениями, которые можно использовать в источниках данных и шаблонах.

Обзор

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

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

Савокупность всех параметров доступных на странице, называют «пулом параметров».

Использование

С источниками данных

Параметры могут быть определены в редакторе источников данных — в правилах фильтрации, в настройках ограничения результатов и в настройках постраничной навигации. Для использования в качестве XSLT атрибута применяется синтаксис: {$parameter-name}.

Источники данных имеют графу «Требуемый URL параметр», но его синтаксис немного отличается. Поскольку этот параметр относится сам к себе и не является значением, то фигурные скобки не используются: $parameter-name.

В проектировании шаблонов

Получить доступ к значениям параметров можно из шаблонов страниц и утилит, используя синтаксис {$parameter-name} или посредством XPath из пула XML данных.

Детали

Пул параметров

Пул параметров содержит значения всех параметров доступных на страницах. Значения пула доступны через окружение (как было описано выше) или посредством доступа к XML источнику страницы.

Системные параметры

Ниже приведён список глобальных параметров.

Параметр	Описание	Пример
today	Текущая дата	2009-11-30
current-time	Текущее время	19:09
this-year	Текущий год	2009
this-month	Текущий месяц	11
this-day	Текущий день месяца	30
timezone	Смещение текущей временной зоны	+10:00
website-name	Название веб-сайта записанное в файле /manifest/config.php.	Blue Ninja Bakery
page-title	Заголовок текущей страницы	The Ninja Way
root	Корневая ссылка сайта	http://blue-ninja-bakery.com
workspace	URL адрес каталога worspace	http://blue-ninja-bakery/workspace
root-page	URL обработчик родительской страницы для текущей страницы	about
current-page	URL обработчик для текущей страницы	the-ninja-way
current-page-id	ID текущей страницы	12
current-path	URL адрес текущей страницы относительно корня сайта	/about/philosophy/the-ninja-way
parent-path	Относительный URL родительской страницы	/about/philosophy
current-url	Полный URL адрес текущей страницы	http://blue-ninja-bakery/about/philosophy/the-ninja-way
upload-limit	Максимальный размер загружаемых файлов, указывается в файле /manifest.config.php	5242880
symphony-version	Версия Symphony	2.0.7
site-mode	Значения «live» или «maintenance» определяют находиться сайт на обслуживании или нет	live
cookie-username	Имя текущего залогиненого пользователя	admin
cookie-pass	Хэш пароля залогиненого пользователя	—

Просто пример вывода XML данных


        2009-11-30
        19:09
        2009
        11
        30
        +10:00
        Blue Ninja Bakery
        2.0.7
        5242880
        http://blue-ninja-bakery.com
        http://blue-ninja-bakery.com/workspace
        The Ninja Way
        about
        the-ninja-way
        12
        /about/philosophy/the-ninja-way
        /about/philosophy
        http://blue-ninja-bakery/about/philosophy/the-ninja-way
        admin
        7415346ecbf1c95e6894b23456a320e
        live

The Big Picture

При помощи расширения debug devkit становится доступным интерфейс ?debug, который позволяяет просматривать значения всех доступных на странице переменных.

В наушниках по жизни: заметки с тегом Parameters