Что такое плагины?

[Гончаров Игорь]

Плагином мы называем набор файлов, организованных по определенным правилам и добавляющих или меняющих логику работы платформы.

Для простоты понимания рассмотрим пример плагина ItemTargetBlank.
Стояла задача: все ссылки на товары, открывать в новой вкладке, по аналогии с сайтом https://www.taobao.com/

Структура файлов:
packages/
НзаваниеПлагина (основная папка с файлами плагина, например ItemTargetBlank)
- НзаваниеПлагинаPlugin.class.php (основной класс плагина, например ItemTargetBlankPlugin.class.php)
- config (папка содержащая конфигурационный файл плагина)
-- config.xml (файл конфигурации плагина)

Для активации плагина, необходимо поместить основную папку плагина в папку packages, например /packages/ItemTargetBlank/ .

Файл config.xml имеет вид:

<?xml version="1.0" encoding="UTF-8"?>
<plugin>
    <title>Открыть товар в новой вкладке</title>
    <description>Все ссылки на товары будут открываться в новой вкладке (по аналогии с сайтом taobao)</description>
    <version>1.0.0</version>
    <events>
        <event name="onAfterRenderFooter" />
    </events>
</plugin>

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

Основная логика плагина содержится в файле ItemTargetBlankPlugin.class.php. Мы постарались минимизировать навязываемые стандарты к написанию данного файла. Вот ряд правил, которые необходимо соблюдать:
- класс должен называться по названию НзаваниеПлагинаPlugin (например ItemTargetBlankPlugin)
- класс должен быть унаследован от GeneralPlugin

Класс плагина содержит методы, название которых соответствует названию событий заявленных в файле конфигурации. Например:
public function onAfterRenderFooter($vars = array()) { ... }
Класс плагина может содержать метод public function renderPluginPage($request) - метод должен вернуть html. Этот html будет отображен администратору сайта в админке сайта. На самом деле в этом методе можно организовать свой роутинг и сделать админку внутри админки. Все ограничено лишь Вашей фантазией.



Рецепты:
- Если администратор сайта изменяет статус строки заказа на "Готово к отправке", необходимо отправить sms уведомление покупателю.