Обзор

Что делает плагин

Плагин получает новые публикации публичного Telegram-канала через бота, сохраняет их в базе магазина и отдаёт для вывода в теме Shop-Script. В бэкенде он называется «Посты из Telegram», страница настроек — «Настройки постов Telegram».

Владелец магазина управляет каналом и параметрами блока. Разработчик размещает блок в теме и настраивает оформление.

Возможности

• Готовая сетка карточек с именем канала, датой, сокращённым текстом и фотографией.
• Настройка количества публикаций и времени кэширования.
• Общие параметры и отдельные наборы настроек для витрин.
• Хелпер render() для готового блока и getPosts() для получения массива данных.
• Собственный шаблон блока в активной теме.

Посты выбираются из базы по дате, начиная с новых. Встроенный шаблон показывает до 180 символов текста с добавлением многоточия при сокращении; фотография ведёт к публикации в Telegram. Если фотография отсутствует, отдельной ссылки на публикацию в стандартной карточке нет.

Ограничения

Импорта старой истории канала нет. Для проверки после подключения бота опубликуйте новый пост.

Плагин запрашивает обновления при вызове хелпера, если нет действующего кэша. Само открытие настроек не запускает получение публикаций. Фонового расписания, готовой команды cron и обработчика webhook в продукте нет.

Вложения для вывода ограничены фотографиями: из размеров фотографии выбирается вариант с наибольшей шириной. В пределах одного ответа Telegram элементы альбома объединяются в одну запись; выбирается сообщение с текстом, если оно есть. Полная галерея альбома не формируется. Видео, документы и аудио в карточке не выводятся. Изменения и удаления уже опубликованных сообщений не синхронизируются.

Редакции

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

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

Плагин предназначен для приложения Shop-Script. Обязательные требования:

Отдельный минимальный номер версии Shop-Script и верхний предел PHP в этом файле не заданы. Для получения постов серверу нужен HTTPS-доступ к api.telegram.org, а бот должен быть администратором канала.