Начало работы v210.1.0
Обзор ParserKit 210.1.0: доноры, alias/типы, Twig-карта, параметры {search}, окно схемы строки.
ParserKit — сателлит DevCraft Admin для DataLife Engine. Модуль подключает доноры (RSS, Atom, XML, JSON), сам находит поля в ответе и даёт шаблоны заполнения: сопоставление полей новости с данными записи донора через Twig-выражения (условия, циклы, |date), без глобального холста конструктора.
Версия 210.1.0 добавляет пути схемы без числовых сегментов списка, alias и типы полей, параметры запроса с {search}, редактор строки карты во всплывающем окне Metro (дерево + Twig + превью) и подсветку сломанных ссылок.
Исходники пакета: репозиторий DLE-ParserKit (devcraft/src/modules/ParserKit/).
Документация этой версии: parserkit/210.1.0 — та же ссылка, что в админке модуля (docsLink).
Как это работает
- Донор — URL источника. После опроса сохраняется снимок схемы: пути полей, узел списка записей (
list_node), при необходимости пометки «последний узел». - Шаблон заполнения — правила для одного донора: первичный ключ записи, условия применения, карта «поле новости → выражение» (
field_graphсmappings:target+expr). - Заполнение на форме новости — редактор с правом add/edit news выбирает донор, шаблон и запись; поля формы подставляются по карте.
Схема потока:
Что видит администратор
| Раздел | Зачем |
|---|---|
| Главная | Обзор модуля |
| Доноры | URL, узел списка, опрос, схема полей |
| Шаблоны | Условия, первичный ключ, карта Twig, окно схемы строки |
| Настройки | User-Agent HTTP и прочие параметры |
| Журнал изменений | История версий пакета |
Что видит редактор новости
На форме добавления и редактирования новости (после установки плагина) — блок ParserKit: выбор донора, шаблона, списка записей и кнопка «Заполнить поля». Подробнее: Заполнение на форме новости.
Возможности 210.1.0
- опрос доноров RSS/Atom/XML/JSON с вложенными путями (
area.name, атрибуты@idи т.п.); - режим «Корень»: если в ответе нет массива записей — одна запись = корень ответа (
list_node=""в базе); - пометка «последний узел» на группах схемы — обрезка ветки при построении тегов;
- шаблоны:
target/exprна Twig, условия с связью and / or (по умолчанию «и»); - alias и тип полей схемы; параметры запроса донора с плейсхолдером
{search}; - окно «Схема» на строке карты (дерево + Twig + превью) и подсветка сломанных ссылок;
- заполнение с подтверждением перезаписи непустых полей и предупреждением о битых выражениях.
Требования
| Компонент | Версия |
|---|---|
| DataLife Engine | ≥ 21.0 |
| PHP | ≥ 8.3 |
| DevCraft Admin | ≥ 200.4.0 |
Идентификация модуля
| Поле | Значение |
|---|---|
| Каталог модуля | ParserKit |
| Код в админке | parserkit |
| Версия | 210.1.0 |
| Точка входа | engine/inc/parserkit.php |
| Пространство имён | DevCraft\Modules\ParserKit |
| Документация | https://readme.devcraft.club/latest/dev/parserkit/210.1.0/ |
Таблицы в базе
| Назначение | Таблица |
|---|---|
| Доноры | {prefix}_parserkit_donors |
| Шаблоны заполнения | {prefix}_parserkit_templates |