43 заметки с тегом: symphony
43 заметки с тегом

symphony

Ctrl + ↑ Позднее

Расширения

Расширения добавляют в проекты Symphony дополнительный функционал.

Обзор

Расширения позволяют добавлять различные дополнительные функции к вашим проектам Symphony.
Некоторые дополнительные расширения добавляют дополнительные типы полей, парсеры текстов, расширяют возможности панели управления или добавляют совершенно новые возможности. В Symphony есть API для расширений (документация в процессе написания), который позволяет облегчить написание дополнительных расширений.

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

Все расширения следует копировать к каталог extensions/.

Управление расширениями осуществляется через панель управления в меню Система > Расширения. Индивидуальное или групповое управление осуществляется при помощи выпадающего меню в самом низу страницы управления расширениями. Вы можете включать, отключать или удалять расширения.

Детали

Ниже представлено описание семи основных расширений системы:

Расширение Описание
Debug Devkit Представляет собой инструментарий разработчика и позволяет производить отладку, профилирование и другие задачи при разработке сайта.
Экспорт сборки Расширение для создания сборок через панель управления администратора.
Select Box Link Дополнительный типа полей, позволяющий создавть связи между разделами.
JIT Image Manipulation Расширение позволяющее изменять изобращения на лету с помощью специально сформированного URL адреса.
Режим обслуживания Позволяет закрывать сайт на время проведения работ.
Markdown Text Formatter Расширение, которое добавлят парсер текста Markdown и применяет его к текстовым полямы.
Profile Devkit Дополняет инструментарий разработчика и позволяет производить отладку, профилирование и другие задачи при разработке сайта.

The Big Picture

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

Сборки (Ансамбли)

Сборки (Ensembles) Symphony представляют собой проекты, включающие в себя все рабочие файты, базы данных и установочные файлы.

Обзор

Сборки это готовые к установке копии проектов Symphony. Создать сборку можно через панель управления администратора, тем самым упаковав все файлы, копии баз данных и пр. файлы в один ZIP архив.
Сборки могут быть использованы в качестве бэкапов, для переноса проектов или созданиях отдельных дистрибутивов. Отдельные сборки проектов вы можете посмотреть тут.

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

Создание сборок осуществляется в панели управления в разделе Система > Настроки, нажатием на кнопку «Создать сборку». Примечание: необходимо, чтобы на серверы был установлен PHP модуль для работы с ZIP.

Установка сборки осуществляется так же, как и обычная установка движка (см. «Установка Symphony»)

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

Детали

Сборки по своей сути представляют копию проекта Symphony с его структурой и внешним видом.

The Big Picture

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

Фильтры событий

Фильтры событий устанавливают дополнительные условия для срабатывания событий.

Обзор

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

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

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

Детали

Описание трёх основных фильтров, доступных в Symphony по умолчанию:

Фильтр Функция
Только для администратора (Admin Only) Событие может быть вызвано только авторизованым администратором системы.
Отправка уведомления (Send Email) При выполнении события, система отправляет письмо администратору.
Множественные изменения (Allow Multiple) Разрешает изменение нескольких записей.

События

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

Обзор

События представляют собой скрипты, закреплённые за страницами, которые при срабатывании в определённых условиях, выполняют ряд заданных действий. Встроенный с Symphony редактор позволяет легко и быстро создавать любые события на страницах пользователей, позволяя им тем самым добавлять данные в разделы системы (например, система комментариев это хороший пример для описания). Однако, вы можете содавать свои собственные события посредством API системы (материал готовится к публикации)

К каждому условию может быть прикреплён фильтр, для создания дополнительных условий (например, только автор может вызывать событие) или для выполнения вторичного действия (например, отправка почты при срабатывании события).

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

Доступ к управлению событиями осуществляется через меню компонентов (Blueprints > Components).

После создания новго события, редактор событий покажет инструкции и примеры кода для использования событий на страницах вашего сайта.

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

Детали

Редактор событий.

Редактор событий.

События создаются и редактируются с использованием редактора событий Symphony, который представляет собой простую форму с тремя полями:

Параметр Описание Пример
Имя (Name) Любое имя события. Save Comment
Источник (Source) Раздел, в который событие будет добавлять данные. Comments
Фильтры (Filter Rules) Фильтры события, которые влияют на работу события. Send Email

The Big Picture

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

JIT Image Manipulation

JIT Image Manipulation (Just in time image manipulation т. е. работа с изображениями «на лету») представляет собой API для данамического преобразования изображений на основании URL параметров.

Обзор

JIT (Just-in-time) Image Manipulation это расширение, которое помогает динамически преобразовывать изображения на основании параметров переданных через URL. Данное расширение позволяет обрезать и/или изменять размер оригинального изображения (независимо от расположения изображения на вутреннем проекте Symphony или внешнем хостинге), а так же кэшировать изображения и возвращать уже модифицированный вариант.

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

JIT Image Manipulation вызывается при помощи специально сформированного URL. Основанием для такого URL служит http://your-site.com/image/. Дополнительные параметры указываются после базового URL и определяют режим преобразования, опции и расположение файла (описание см. ниже). Вы можете использовать данное расширение в своих шаблонах, указывая специальный URL в атрибуте src элемента img, например:

<img src="http://yoursite.com/image/1/200/0/images/ninja-parade.jpg"/>

Внешние источники изображений

В случае если необходимо преобразовывать изображение с других сайтов, необходимо добавить домен-источник в список «Деверенные сайты (Trusted Sites)» в меню Система > Настройки. Добавлять домены следует по одному на строку в следующем формате:

images.external-site.com*

Детали

Режимы

JIT Image Manipulation имеет четыре разных режима работы, каждый из которых требует разного указания URL параметров. См. таблицу ниже для получения дополнительной информации:

Режим Описание и структура URL
/ image / e / path
По умолчанию: Если режим преобразования не указан, изображение выводится как есть без изменений.
1 / image / 1 / w / h / e / path
Режим 1: Изменение размера размер исходного изображения будет изменён в соответствии с указаными значениями. Если высота или длинна изображения указаны как 0, то данный параметр будет вычислен в соответствии с пропорциями изображения.
2 / image / 2 / w / h / p / e / path
Режим 2: Заполнение холста размер исходного изображения будет изменён в соответствии с указаными значениями. Если высота или длинна изображения указаны как 0, то параметры будут вычислены в соответствии с пропорциями изображения.
3 / image / 3 / w / h / p / b / e / path
Режим 3: Изменение размера холста производится несмотря на исходный размер изображения, основываясь на параметрах высоты, ширины и позиции. Если размер холста меньше исходного изображения в любом измерении, то изображение будет обрезано. В случае если размер холста больше, свободное пространство будет заполнено фоновым цветом.

Параметры

Опции преобразования изображений задаются с помощью параметров:

Параметр Описание
Ширина (Width) Число в пикселях. Если указано значение 0, то обязательно необходимо указать высоту изображения, а ширина будет подобрана автоматически на основании соотношения сторон.
Высота (Height) Число в пикселях. Если указано значение 0, то обязательно необходимо указать ширину изображения, а высота будет подобрана автоматически на основании соотношения сторон.
Позиция (Position) Число от 1 до 9, определяющее регион который будет вырезан или изменён. Смотрите сетку ниже...
Фон (Background Color) Hex значение цвета. Поддерживается CSS-стиль коротких hex строк (ff2233 == f23).
Источник (External) Опционально. 0 или пустое значение для внутренних изображений сайта. 1 для изображений с других сайтов.
Путь (Path) Путь к оригиналу изображения. Если изображение расположено локально, то можно указывать относительный путь к файлу от каталога /workspace. Если изображение находится на стороннем сайте, то следует указывать полный URL путь (без http://) .

Сетка позиционирования

При использовании режимов «Заполнение холста» и «Изменение размера холста» преобразования будут производиться с использованим параметра «Позиция». Изображение показанное ниже, показыват возможные значения, которые может принимать параметр «Позиция».

JIT Positioning Grid
Ctrl + ↓ Ранее