@NewsApi · Новости NewsAPI.org в чат

Плагин WordPress для темы чата: команда news (также новости, tag, тема) запрашивает NewsAPI.org и кладёт каждую статью отдельным сообщением в текущий диалог.

Каталог: wp-content/plugins/@NewsApi. В списке плагинов WP — @NewsApi, в меню «Настройки» — NewsApi.

Возможности

• Команды в чате: news {запрос}, новости {запрос}, tag {запрос}, тема {запрос}.
• До трёх статей на запрос (язык ru), каждая — отдельный пузырь: источник, дата, заголовок, картинка, описание.
• Ключ API только на странице настроек плагина (опция newsapi_plugin_settings), не в файлах репозитория.
• Фронт: перехват my_chat_before_process_command, AJAX newsapi_get_news.
• Бэкенд (планировщик / REST команд): фильтр chat_theme_handle_backend_command; запись в диалог через che_add_message_to_dialog_context (плагин Chat Enhancer).

Без темы чата плагин не подключает JS/CSS. Без Chat Enhancer бэкенд-команды не сохраняются в историю.

Требования

• WordPress 6.0+.
• Тема чата HuskyNET (chat-theme5_5_5_5_1 или совместимая) — запись темы.
• Плагин Chat Enhancer — для сохранения ответов с бэкенда.
• Ключ NewsAPI.org (бесплатный тариф с ограничениями по домену и квоте).
• PHP с wp_remote_get (cURL / allow_url_fopen).

Установка и запуск

1. Каталог плагина: wp-content/plugins/@NewsApi (главный файл wp-news-plugin.php).
2. В админке Плагины включить @NewsApi. Если раньше стоял + wp-tag-plugin, после переименования папки WP снимет галочку — включить заново. Настройки ключа сохраняются (имя опции не менялось).
3. Настройки → NewsApi — вставить ключ с newsapi.org, сохранить.
4. Открыть фронт темы чата, в поле команды: news искусственный интеллект.

Использование

Новости в диалоге

1. Открыть чат на сайте.
2. Ввести news {тема} или русскую команду новости {тема}.
3. Дождаться пузырей со статьями; ссылки открываются в новой вкладке.

Пустой запрос или нет ключа — системное сообщение с ошибкой. Ничего не найдено — одно сообщение «к сожалению…».

Ключ API

Ключ выдаёт NewsAPI.org. Не коммитить его в git и не класть в README. Бесплатный план часто режет запросы не с localhost — на проде укажите домен сайта в кабинете NewsAPI.

Структура проекта

@NewsApi/
├── wp-news-plugin.php     # шапка, настройки, AJAX, фильтр темы
├── js/news-plugin.js      # перехват команды на фронте
├── css/news-plugin-styles.css
├── README.md
└── doc/
    ├── ARCHITECTURE.md
    ├── CHANGELOG.md
    └── AI_RULES.md

Технологии

• PHP, WordPress Settings API, wp_ajax_*.
• NewsAPI.org v2/everything.
• jQuery + события темы чата (my_chat_before_process_command, addMessage / addMessageSafe).

История изменений

Формат Keep a Changelog.

[Unreleased]

Changed

• Каталог @NewsApi (было + wp-tag-plugin). В списке плагинов — @NewsApi, в меню настроек — NewsApi.

[1.0.0]

Added

• Команды news / новости / tag / тема, ключ NewsAPI.org, вывод статей в чат.