Структура файлов расширения
Строгая структуризация файлов расширений позволяет Symphony автоматически определять и загружать расширения.
Обзор
Структура файлов расширения создаёт определённый макет расположения и именования файлов, позволяя тем самым системе автоматически определять и загружать расширения.
Использование
При создании расширения просто следуйте конвенции описанной ниже.
Детали
Обзор
Расширения должны быть структурированы следующим образом. Обратите внимание, что обязательным файлом является лишь extension.driver.php. Остальный файлы могут быть добавлены по мере необходимости.
yourextension/ assets/ sample.js sample.css content/ content.index.php content.sample.php data-sources/ datasource.sample.php events/ event.sample.php fields/ field.sample.php lang/ lang.de.php lang.es.php lib/ yourphplibs.php text-formatters/ formatter.sample.php extension.driver.php license README
assets/
Хотя фактически каталог не используется для автоматического подключения файлов, но в него помещаются CSS файлы, JavaScript и изображения.
content/
Файлы в данном каталоге автоматически подключаются и используются для генерации страниц в панели управления. Файл content.sample.php будет доступен по адресу /symphony/extension/yourextension/sample, а файл content.index.php по адресу /symphony/extension/yourextension
data-sources/
Любые источники данных, которые будут предоставлены расширением, должны быть размещены здесь для автоматического подключения.
events/
Любые события, которые будут предоставлены расширением, должны быть размещены здесь для автоматического подключения.
fields/
Любые типы полей, которые будут предоставлены расширением, должны быть размещены здесь для автоматического подключения.
lang/
Любые файлы локализации, которые будут предоставлены расширением, должны быть размещены здесь для автоматического подключения.
lib/
Так же как и каталог assets, каталог lib не используется для автоматического подключения файлов, но используется для хранения дополнительных файлов библиотек, используемых в работе расширения.
text-formatters/
Любые парсеры текста, которые будут предоставлены расширением, должны быть размещены здесь для автоматического подключения.
extension.driver.php
Файл extension.driver.php используется для инициализации, включения, удаления и обновления расширения, а так же для подписывания на делегаты. Данный файл является обязательным.
license or licence
Текстовый файл описывающий лицензию использования расширения.
README or README.markdown
README файл для расширения. Обычно данный файл содержит основную информацию (имя расширения, версию и дату релиза), информацию разработчика (имя, email и адрес веб-сайта) и информацию о установке и использовании расширения.
The Big Picture
Структура файла расширения это важная часть API расширений Symphony (документация находиться в разработке).