Octobercms в Руската

Plugins са основа за добавянето на нови функции на CMS, той да се удължи. Тази статия описва процеса на регистрация на плъгини, който ви позволява да декларират своите функции, като например компоненти или външни страници и менюта. Примери за това, което може да направи плъг-ин:

Структурата на приставката

Всички приставки се намират в подпапка / плъгини. плъгин структура е както следва:

Но не всички плъгини са задължени да имат такава структура. Например, ако вашият приставка осигурява само един компонент. съдържанието му може да изглежда така:

Забележка: Ако сте разработчик плъгин за Marketplace. наличието на актуализации / version.yaml файл е необходимо.

пространство от имена

файл за регистрация

Plugin.php файл. по-долу файл за регистрация плъгин или регистрацията плъгин. е сценария инициализиране, който декларира, основните функции и съдържа информация за плъгина. Тя може да съдържа следното:

скрипт за влизане трябва да съдържа клас, наречен Plugin. която се простира на \ System \ Classes \ PluginBase клас. Необходимата само от класа на регистрация плъгин е pluginDetails (). например:

Поддържани методи

Следните методи могат да се съдържат в плъг-ин регистрация файл:

Routing и инициализация

регистрация файлове плъгин може да съдържа два метода: зареждане () и да се регистрирате (). С тези методи, можете да правите каквото искате: да се регистрирате маршрути или се свързват манипулатори на събития.

метод се регистрирате () се нарича директно в момента, когато тапата се записва. метод за зареждане () се нарича точно преди искането за маршрутизация. По този начин, ако си действие зависи от друг плъгин, трябва да използвате метода на изтегляне. Така например, в метода на зареждане () Можете да разширите модела:

Забележка: Методи зареждане () и да се регистрирате () не се нарича в процес на актуализиране на плъгина за да се избегнат критичните грешки.

Приставките могат да съдържат routes.php файл. който може да бъде произволна логика за маршрутизиране. Например:

Определянето на зависимост

Работа вашия плъгин може да зависи от други плъгини. За да направите това, изберете ги в имуществото на изискват $ в File добавка. например:

Персонализирани филтри клонка и функции могат да бъдат регистрирани в CMS използване registerMarkupTags () метод на регистрация на плъг-ин за файла. например:

Plugins могат да разширят менюто в административната част на сайта, първостепенни метод registerNavigation () в File приставката. например:

Можете да използвате низове локализация на етикета. Можете също така да се ограничи достъпа на потребителите до определени елементи от менюто.

Персонализирайте контекст. за да се покаже подменю в административната част на сайта.