Skip to content

Repository files navigation

WT LLMs для Joomla

WT LLMs - пакет расширений Joomla для подготовки AI-friendly данных сайта и публикации корневых файлов /llms.txt и /llms.json.

Пакет включает:

  • компонент com_wtllms с административным интерфейсом;
  • webservices-плагин plg_webservices_wtllms для REST API Joomla;
  • системный плагин plg_system_wtmdsitealternateversion для Markdown-альтернативы страниц.

Что делает компонент

Компонент помогает владельцу сайта описать сайт в формате, удобном для AI-агентов и внешних интеграций:

  • профиль сайта или организации: название, описание, тип, аудитория, внешние профили;
  • география и зона обслуживания;
  • контакты, офисы и правила использования информации AI;
  • важные пользовательские намерения;
  • канонические страницы сайта и связь страниц с намерениями;
  • генерация структурированного /llms.json и текстового /llms.txt.

Возможности

  • Административная панель WT LLMs с главным экраном генерации.
  • Редактирование Profile, Intents, Canonical Pages и Import через стандартные Joomla MVC-формы.
  • Публичная схема для AI-агентов: GET /api/index.php/v1/wtllms/llmsjson/schema.
  • Защищенный REST API для чтения и изменения данных:
    • GET/PATCH /api/index.php/v1/wtllms/profile;
    • GET/PATCH /api/index.php/v1/wtllms/llmstxt;
    • GET/PATCH /api/index.php/v1/wtllms/import;
    • CRUD /api/index.php/v1/wtllms/intents;
    • CRUD /api/index.php/v1/wtllms/pages;
    • POST /api/index.php/v1/wtllms/generate.
  • Импорт полного пользовательского JSON через Import view с режимом raw override.
  • Генерация файлов с главного экрана компонента или через защищенный REST endpoint POST /api/index.php/v1/wtllms/generate; публичные URL строятся через Joomla routing, включая поддержку menu item и ручных относительных URL.
  • Markdown-альтернатива страниц через системный плагин с параметром ?markdown=1.
  • Joomla ACL для защищенных REST-операций и генерации файлов.

Системные требования

  • Joomla 5.x или Joomla 6.x.
  • PHP 8.1 или выше.
  • MySQL/MariaDB, поддерживаемая установленной версией Joomla.
  • Включенное приложение Joomla API/Web Services для REST API.
  • Для защищенных REST-запросов нужен пользователь Joomla с правом API-входа и правами компонента com_wtllms.
  • Для установки используется стандартный менеджер расширений Joomla.

Пакет проверялся на локальном стенде Joomla 6.1.0 с PHP 8.3.30.

Установка

  1. Соберите или получите ZIP-пакет pkg_wtllms.
  2. В панели администратора Joomla откройте Система -> Установка -> Расширения.
  3. Загрузите ZIP-пакет через стандартный установщик Joomla.
  4. Откройте компонент WT LLMs в меню администратора.
  5. Заполните Profile, Intents и Canonical Pages, затем выполните генерацию на главном экране компонента.

После генерации проверьте файлы:

  • /llms.txt;
  • /llms.json.

REST API

Публичный endpoint схемы доступен без авторизации:

GET /api/index.php/v1/wtllms/llmsjson/schema

Остальные endpoints защищены механизмами Joomla API и ACL. Неавторизованные запросы к защищенным WT LLMs endpoints должны получать стандартный отказ Joomla API, а не серверную ошибку.

Releases

Contributors

Languages