Плагины

Плагины - это дополнительные программные модули, предназначенные для расширения функциональности Системы или выполнения дополнительных требований, характерных только для одного проекта.
Плагины будут выполняться только у пользователей, у которых в Значение по умолчанию "Прочие - Дополнительные модули - Плагины включены" установлено в Да.
Каждый плагин может быть включен/исключен из исполнения. Такое включение действует на плагин в рамках всей Системы.


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

Для создания плагинов необходимо:

• Знать язык PHP;
• Знать порядок вызова и параметры функций и переменных программного кода Системы;
• Быть знакомым со структурой данных Системы;

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

Примеры Системных событий:

- Закупки
· До добавления в спецификацию закупки
· До добавления закупки
· До изменения спецификации закупки
· До обновления закупки
· До удаления закупки
- Интерфейс
· До формирования списка
· После формирования списка аякс
· После формирования формы карточки объекта
- Организации
· До добавления организации
· После удаления организации
- Продажи
· После добавления в спецификацию заказа
· После добавления заказа
· После изменения заказа
· После изменения спецификации заказа
· После удаления заказа
· После удаления из спецификации заказа
- Товары
· До добавления товара
· После удаления товара
- Хоз. операции
· После добавления хоз. операции
· После изменения хоз. операции
· После удаления хоз. операции

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

Сами Плагины создаются в форме Служебные - Настройки - Плагины.
В левой части этой формы вводятся и редактируются карточки плагинов. Список карточек плагинов может быть организован в виде дерева. При выборе карточки в правой части формы выводится поле для ввода программного кода. После ввода/редактирования информации в этом поле следует нажать кнопку Изменить. Для получения помощи по созданию плагина необходимо нажать кнопку Помощь.

Для управления списком карточек плагинов нужно вызвать меню, нажатием на выбранной ветке правой клавишей мыши. Меню выполняет следующие функции (нажатие левой клавишей миши):

• Добавить на этом уровне - откроется форма для добавления новой карточки на одном уровне иерархии с выбранным;
• Добавить подчиненную ветку - откроется форма для добавления новой карточки на уровне иерархии, подчиненном выбранному;
• Изменить - откроется форма для редактирования карточки;
• Удалить - удаление из списка;

Поля карточки Плагина имеют следующее назначение:

• Название - название плагина, видимое в списке;
• Включен? Да/ Нет - отметка включения/отключения этого плагина в исполнение;
• Событие - системное событие, запускающее плагин;
• Код - незначащее поле;
• Верхний уровень - при необходимости указание верхнего уровня иерархии в дереве;

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