Документация для разработчиков CMS ARGELIT

Для тех, кто делает для CMS ARGELIT темы и плагины. Если вы владелец сайта и хотите его установить или настроить — вам в руководство для владельцев сайтов.

CMS ARGELIT устроена в духе WordPress: события и фильтры (хуки), типы записей, темы с иерархией шаблонов, плагины в отдельных папках. Если вы писали для WordPress, большая часть покажется знакомой. Внутри — Laravel 13, поэтому в плагинах можно пользоваться всем, что умеет Laravel.

С чего начать#

1. Как устроена CMS — папки, порядок загрузки, хуки, настройки, права, команды, отладка.
2. Плагины — свой плагин за 10 минут и всё, что плагин умеет.
3. Темы — дочерняя тема, шаблоны, функции для шаблонов, меню.
4. Контент — свои типы записей, таксономии, метаполя, поля в редакторе, выборки, формы.
5. Блоки редактора — свои блоки для блочного редактора.

Справочники#

• События и фильтры — все хуки ядра: когда срабатывают и что получают.
• Функции — все функции для тем и плагинов.

Примеры#

• Плагин «Отзывы» — свой тип записей, поля в редакторе, свой блок, стили, уборка при удалении.
• Дочерняя тема «Пекарня» — свои цвета, свой блок в боковой колонке, своя страница 404.
• Плагин «Объявление на сайте» — папка plugins/announcement, идёт вместе с CMS: страница настроек в админке, вывод на сайте.

Заготовки для своих: php artisan cms:make-plugin папка и php artisan cms:make-theme папка.

Совместимость#

Пока номер версии CMS начинается с 0 (0.13, 0.14…), программный интерфейс ещё может меняться — изменения описываются в «Что нового» каждой версии. Стабильными считаются:

• функции из справочника функций;
• события и фильтры из справочника хуков;
• поля plugin.json и theme.json;
• модели Cms\Models\* (записи, рубрики, медиатека, меню, формы).

Всё остальное внутри core/ может меняться без предупреждения. В plugin.json и theme.json указывайте requires_cms — минимальную версию CMS, на которой ваш плагин или тема проверены: на более старой CMS их нельзя будет установить.