DevCraft Документации

Начало работы 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).

Как это работает

  1. Донор — URL источника. После опроса сохраняется снимок схемы: пути полей, узел списка записей (list_node), при необходимости пометки «последний узел».
  2. Шаблон заполнения — правила для одного донора: первичный ключ записи, условия применения, карта «поле новости → выражение» (field_graph с mappings: target + expr).
  3. Заполнение на форме новости — редактор с правом 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

Структура файлов (обзор)

manifest.php

Дальше

На этой странице