Параметры предназначены для работы с динамически изменяющимися значениями, которые можно использовать в источниках данных и шаблонах.
Обзор
Параметры представляют собой пары атрибут-значение, которые доступны при работе со страницами проектов 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, который позволяяет просматривать значения всех доступных на странице переменных.
