1. Введение

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

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

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

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

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

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

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

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

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

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

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

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

2. Установка

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

3. Настройка

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

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

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

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

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

Настройте плагин и установите веб-хук.
Создайте правило для канала.
Опубликуйте в Telegram сообщение: Заголовок статьи Основной текст статьи. Он может содержать несколько абзацев и ссылки https://example.com #news #joomla
Через несколько секунд статья появится на сайте.

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

Материалы не создаются

Проверьте, что плагин включён.
Убедитесь, что веб-хук установлен.
Проверьте наличие тега-триггера в сообщении.
Проверьте соответствие канала правилу.

Список каналов пуст

Это связано с ограничениями Telegram API. Следуйте инструкции по обновлению списка каналов.

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

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

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

Актуальный файл продукта