Начало работы v200.4.0
Что такое DevCraft Admin: описание, возможности, требования и куда идти дальше.
DevCraft Admin — админ-оболочка для ваших плагинов на DLE 20.0. Один раздел в панели DLE, общие настройки, меню, AJAX и Twig — без копипасты каркаса в каждом ZIP.
Зачем это вам: пишете бизнес-логику модуля, а вход в админку, формы настроек и маршруты уже готовы.
Что умеет
- отдельный пункт DevCraft в админке DLE (
?mod=devcraftи сателлиты); - модули в
devcraft/src/modules/{Name}/сmanifest.php, страницами и AJAX; - настройки через
settings.schema.php→ JSON вdevcraft/config/; - Fluent Types:
manifest/ changelog / schema как объект или массив (гайд); - DataLoader / QueryBuilder: SELECT из таблиц DLE без
super_query(гайд); - общий AJAX через
devcraft/ajax.php(admin и public); - Composer UI, логи, генератор модулей, локали XLIFF;
- shared DTO из
devcraftclub/dev-tools.
Для кого
Авторы плагинов DLE, которым нужна одна оболочка под несколько модулей и линейка версий 200.* под DLE 20.
Требования
| Что | Минимум |
|---|---|
| CMS | DataLife Engine 20.0 |
| PHP | 8.3+ |
| Версия плагина | 200.4.0+ (почему major = 200) |
| Composer | зависимости в devcraft/ |
| PHP-расширения | simplexml, libxml, intl, fileinfo, pdo_mysql, curl, mbstring, openssl |
Память PHP — лучше от 128M. Полный чеклист установки: Установка.
Структура файлов
Корень сайта DLE после установки DevCraft (обзор; каркас своего модуля — создать модуль). В скобках — назначение; у modules/Admin — полный список.
devcraft/— ядро, модули, Composer, конфиги.engine/inc/{mod}.php— glue DLE →Application::runAdmin().templates/{skin}/devcraft/— публичные.tplсайта (админский Twig — вdevcraft/src/).
Разделы документации
Установка
ZIP, Composer, первый запуск
Создать модуль
Каркас, manifest, страницы, AJAX, install.xml
Генератор
Модуль из админки за минуту
Fluent Types
Билдеры и dual accept
Версионирование
Почему 173 / 200 / 261
Справочник API
Классы, манифест, точки входа
Архитектура в двух словах
AJAX: devcraft/ajax.php → handlers модуля. Сателлиты (Notifications, RePost, …) — отдельные mod, тот же каркас. Подробнее: точки входа.
Дальше
- Установить плагин на сайт.
- Создать модуль или открыть генератор.
- При миграции с MH Admin — миграция.
- Правила кода — конституция PHP.