К содержимому
Начало работы

Установка и первые шаги

Обновлено

Установите плагин

Откройте страницу плагина в маркете Webasyst и воспользуйтесь действием «Открыть в Инсталлере» для установки в нужный аккаунт Webasyst.

После установки откройте приложение «Магазин» → «Плагины» → «Посты из Telegram». На странице «Настройки постов Telegram» находятся параметры подключения и оформления.

Подготовьте Telegram

  1. Создайте бота через @BotFather командой /newbot и получите токен.
  2. Добавьте бота администратором публичного канала. В инструкции продукта рекомендовано право публикации сообщений.
  3. Используйте отдельного бота для канала. Подключение одного бота к нескольким каналам этим плагином не предусмотрено как безопасный способ разделения лент.

Подробности обмена данными описаны в статье «Подключение Telegram».

Заполните основные настройки

  1. В поле «Витрина» оставьте «Основные ●».
  2. Заполните «Username канала», например @mychannel или mychannel, и «Токен Telegram-бота».
  3. Укажите «Отображаемое имя» и «Заголовок блока». При необходимости заполните «Ссылка на канал» полным адресом вида https://t.me/mychannel.
  4. Для первичной проверки задайте «Кэш, секунд» = 0.
  5. Нажмите «Сохранить».

Обязательны для запроса постов именно username и токен. Ссылка на канал задаёт переходы из заголовка и имени, но не выбирает источник публикаций.

Добавьте блок в тему

Разработчик должен вставить вызов в нужное место шаблона витрины Shop-Script:

{if !empty($wa->shop->ewshoptgpostsPlugin->version())}
    {$wa->shop->ewshoptgpostsPlugin->render()}
{/if}

Хелпер показывает блок там, где расположен вызов. Автоматической вставки через хуки витрины в коде нет. Подробнее — «Вывод в теме».

Проверьте результат

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

Если блок пуст, проверьте username, токен, выбранную витрину и наличие нового поста. При пустом списке render() возвращает пустую строку, включая отсутствие заголовка. Ошибки запросов пишутся в shop/plugins.log средствами Webasyst.

После проверки можно вернуть «Кэш, секунд» к исходному значению 600 или выбрать другое время. Для витрин с собственными настройками изменять нужно их набор параметров.