Symphony. Параметры
Здесь я пишу свои идеи, мысли, описываю события своей жизни и просто делаю личные и рабочие заметки. «А Вы что, собираетесь жить вечно?»

Symphony. Параметры

14 июля 2012, 10:54

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

Обзор

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

Поделиться
Ваш комментарий
адрес не будет опубликован

ХТМЛ не работает

Ctrl + Enter
Популярное