Системный плагин ТелеПост

1. Введение

Что умеет плагин?

Плагин ТелеПост — это мост между вашими каналами в Telegram и сайтом на Joomla. Он автоматически создает и публикует материалы на сайте при появлении новых постов в Telegram-каналах.

Основные возможности:

• Автоматическая публикация: Создание и публикация статей Joomla напрямую из сообщений Telegram.
• Гибкие правила: Настройка связей «канал → категория → автор» для разных источников.
• Фильтрация по тегу-триггеру: Материалы создаются только из постов, содержащих указанный тег (например, #news).
• Импорт хештегов: Остальные хештеги из поста могут автоматически сопоставляться с уже существующими тегами Joomla (новые теги не создаются).
• Поддержка медиа: Автоматическое скачивание изображений и превью видео с привязкой к статье.
• Автоформатирование текста: Переносы строк преобразуются в абзацы и переносы, а ссылки автоматически становятся кликабельными.
• Современная архитектура: Плагин разработан специально для Joomla 5 с использованием пространств имён, сервисного контейнера и событий PSR-14.
• Расширяемость: Функционал можно расширять с помощью дочерних плагинов-парсеров для обработки сложных структур контента.

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

Для работы плагина необходимо создать Telegram-бота через официальный сервис @BotFather. После создания вы получите токен — ключ для доступа к API Telegram.

1. Вы добавляете бота в нужные Telegram-каналы в качестве администратора.
2. В настройках плагина создаёте правила обработки: канал, категория, автор и тег-триггер.
3. При публикации поста с нужным тегом Telegram отправляет уведомление на ваш сайт.
4. Плагин принимает уведомление и создаёт материал Joomla в соответствии с правилом.

Таким образом, можно автоматически собирать контент из нескольких каналов и распределять его по разделам сайта.

Важно:
Тег-триггер (например, #news) используется только для фильтрации и не связан с системой тегов Joomla.
При включённой опции «Импортировать хештеги» остальные хештеги из поста автоматически сопоставляются с существующими тегами Joomla. Новые теги не создаются.

Расширяемость и интеграция

ТелеПост построен как расширяемый инструмент. Он генерирует событие перед сохранением материала, позволяя другим плагинам изменять данные статьи.

Это позволяет использовать Telegram для наполнения не только простых статей, но и каталогов, портфолио, новостных лент и других структурированных разделов. Плагин совместим с популярными конструкторами контента, включая YOOtheme Pro.

2. Установка

1. Установите плагин стандартным способом через Система → Установка → Расширения.
2. Перейдите в Система → Плагины.
3. Найдите плагин «Система – ТелеПост» и настройте его (плагин включён автоматически).

3. Настройка

Вкладка «Плагин»

• Токен бота: токен, полученный от @BotFather.
• Секретный ключ веб-хука: защищает URL веб-хука от посторонних запросов.
  • Можно сгенерировать автоматически.
  • После изменения ключа необходимо сохранить настройки и переустановить веб-хук.
• Управление веб-хуком: установка и удаление веб-хука Telegram.
• Папки для изображений и видео: директории внутри /images/.
• Автоформатирование текста: преобразование переносов строк и ссылок.
• Режим отладки: включает подробное логирование в /administrator/logs/plg_system_telepost.log.php.

Вкладка «Настройки каналов»

• Канал Telegram: список каналов, в которые добавлен бот.
  • Список сохраняется локально для обхода ограничений Telegram API.
  • Для обновления списка требуется временно удалить веб-хук и отправить сообщение в канал.
• Категория: категория Joomla для создаваемых материалов.
• Автор: пользователь Joomla, от имени которого будет создан материал.
• Обязательный тег: тег-триггер без символа #.
• Срок публикации: через сколько дней материал будет снят с публикации.

4. Пример использования

1. Настройте плагин и установите веб-хук.
2. Создайте правило для канала.
3. Опубликуйте в Telegram сообщение:

   
   Заголовок статьи
   
   Основной текст статьи.
   Он может содержать несколько абзацев и ссылки https://example.com
   
   #news #joomla
   

4. Через несколько секунд статья появится на сайте.

5. Решение проблем (FAQ)

6. Вместо заключения

ТелеПост — это расширяемый инструмент для автоматизации публикаций. Он предоставляет стабильную основу, которую можно адаптировать под любые задачи, связанные с импортом контента из Telegram.

Если проекту требуется нестандартная логика обработки постов или индивидуальная настройка, доступна услуга разработки и настройки под ключ.