Навигационные группы позволяют группировать разделы в интерфейсе администратора Symphony.

Обзор

Навигационная группа является одним из атрибутов при создании или редактировании разделов и позволяет разбивать разделы в меню администратора на группы меню.

Например, в проекте имеется четыре раздела «Customers», «Vendors», «Invoices» и «Expense Reports». Эти разделы разбиты парами на две группы «Contacts» и «Finances». Результирующее меню можно увидеть на представленной картинке.

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

Во время создания или редактирования раздела вы можете указать название раздела навигационной группы, в которую попадёт раздел.

Разделы с одинаковыми разделами попадут в одно подменю, т. е. создадут группу. Если название группы ещё не вводилось, то будет создана новая группа с указанным названием.

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

The Big Picture

Навигационные группы используются для группировки разделов только в меню администратора и никак не влияют на конечный вид записей выводимых обычным посетителям сайта.

Парсеры текста (text formatters) могут применяться к полям для преобразования или форматирования текста перед сохранением.

Обзор

Парсеры текста это своего рода скрипты, которые могут применяться к полям определённого типа для преобразования или форматирования текста перед сохранением. Система форматирования Markdown по умолчанию входит в состав ядра Symphony, а расширеные редакторы текста (такие, как Textile или WYSIWYG редакторы) доступны в виде расширений.

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

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

Детали

В Symphony включено три парсера текста по умолчанию: Markdown, Markdown Extra и Markdown Extra plus SmartyPants.

Типы полей определяют структуру полей и управляют представлением данных.

Обзор

Типы полей определяют структуру и поведение полей в Symphony. Они определяют как поля отображаются в интерфейсе администратора, какие типы данных могут быть введены в поле и как следует форматировать данные при выводе. В базовой версии Symphony имеется восемь типов полей; дополнительные типы полей можно добавить используя расширения.

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

Типы полей определяют структуру данных при создании разделов в редакторе разделов.

Детали

В Symphony имеется восемь основных типов полей и девятый тип Select Box Link (в виде расширения), предоставляются по умолчанию.

Автор (Author)

Тип поля «Авторы» генерируется системой и представляется список select. Для данного типа имеются следующие настройки:

Чекбокс (Checkbox)

Типа данного поля представляет собой обычный чексбокс (checkbox). Для данного типа имеются следующие настройки:

Дата (Date)

Поле типа «дата» представлена в виде простого поля для ввода текста. Ожидаемый формат указания даты определяется во время установки движка и описывается в файле /manifest.config.php. Для данного типа имеются следующие настройки:

Загрузка файла (File Upload)

Поле типа «File Upload» служит для загрузки различных файлов. Для данного типа имеются следующие настройки:

Список значений (Select Box)

Тип поля Select Box представлен в виде списка статических, динамических или обоих типов значений. Для данного типа имеются следующие настройки:

Ссылочный список значений (Select Box Link)

Тип поля Select Box Link представлен в виде списка связанных с разделами записей. Для данного типа имеются следующие настройки:

Список тегов (Tag List)

Поле типа «список тегов» представляет собой текстовое поле для ввода тегов, разделяемых запятыми.Так же имеется динамически генерируемый список, уже использовавшихся, тегов. Для данного типа имеются следующие настройки:

Текстовый блок (Textarea)

Поле типа «текстовый блок» представляет собой большое текстовое поле textarea для форматированно содержимого. Для данного типа имеются следующие настройки:

Текстовое поле (Text Input)

Поле типа «текстовое поле» представляет собой однострочное текстовое поле text. Для данного типа имеются следующие настройки:

Утилиты

Утилиты позволяют выделять и повторно использовать функции шаблонов и разметки.

Обзор

Утилиты являются автономными XSLT модулями, которые можно использовать многократно. Вы сожете включать их с шаблоны любых страниц или в тела других утилит. Они часто используются для решения общих задач форматирования (например, работа с датами и временем) или для выделения часто используемых элементов интерфейса (например, заголовок и подвал страницы).

Утилиты не являются уникальными для Symphony, но они позволяют пользователям создавать надёжные XSLT модули для работы с шаблонами страниц.

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

Работа с утилитами осуществляется через меню компонентов (Blueprints > Components) или с помощью непосредственного редактирования XSLT файла (workspace/utilities/utility-name.xsl).

Для работы с утилитами их необходимо предварительно подключить в шаблоне страницы.

Начало пути ../utilities необходимо указывтаь при включении утилиты в шаблон потому, что шаблоны страниц расположены в каталоге pages/, который находиться рядом с каталогом utilities/ в каталоге workspace.

Так же утлиты можно включать с тело других утилит следующей инструкцией:

Детали

Редактор утилит довольно простой и не нуждается в особом описании. Он содержит одно большое текстовое поле, содержащее полный XSLT код утилиты. На боковой панели спарва расположен список утилит доступных в проекте. Все утилиты используемые в редактируемом шаблоне подсвечены.

The Big Picture

Утилиты имеют большое значение в работе с разметкой и форматированием данных. Любая часть шаблона страниц, которая используется более одного раза может быть вынесена для удобсва в отдельную утилиту. Сейчас количество утилит для Symphony быстро растёт, любую из них вы можете скачать на сайте разработчиков.

Шаблон кода простой утилиты

Страницы

Страницы представляют пользовательский интерфейс и определяют структуру URL.

Обзор

Страницы представляют собой интерфейс пользователя, каждого проекта Symphony. Они служат шаблоном вывода данных от источников данных, определяют структуру URL и определяют параметры передаваемые пользователем обратно системе с использованием событий. Другими словами, страницы служат для взаимодействия пользователей с системой и её компонентами.

Страницы проектов Symphony отличаются от «страниц» дургих систем: они являются не просто контейнерами для статических данных определённого источника, а могут взаимодействовать с различными источниками данных всей системы.

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

Управление страницами осуществляется через меню Blueprints > Pages. Сами по себе, создаваемые страницы, не являются конечным интерфейсом проектов Symphony.

Страницы используются в сочетании с шаблонами страниц, поэтому создание или удаление страницы ведёт к созданию или удалению и её шаблона.

Детали

Список страниц можно найти открыв меню Blueprints > Pages. Страница состоит из пяти столбцов:

Доступные групповые операции: удаление

Доступ к редактору страниц осуществляется через меню Blueprints > Pages > Create New или Blueprints > Pages > {Page Title}. Редактор состоит из двух разделов: Настройки страницы (Page Settings) и Ресурсы страницы (Page Resources).

Настройки страницы определяют URL схему и атрибуты.

Ресурсы страницы служат для указания доступных на странице источников данных и событий.

1. События (Events).
2. Источники данных (Data Sources).

The Big Picture

Без страниц источники данных, devkits, события, шаблоны страниц, параметры и утилиты являются абсолютно бесполезными. Страницы представляют собой среду в которой все элементы могут работать и взаимодействовать. Так же без страниц, ни один проект на Symphony не будет иметь пользовательского интерфейса и будет совершенно недоступен пользователям.