Настройки и витрины
Обновлено
Где находятся настройки
Откройте «Магазин» → «Плагины» → «Посты из Telegram». Страница называется «Настройки постов Telegram».
Сначала выберите набор параметров в поле «Витрина». «Основные ●» — общие настройки, которые используются витринами без собственного набора.
Все настройки
Значения по умолчанию ниже — начальные значения общих настроек при установке.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Username канала | Задаёт username публичного канала для ленты и ссылок на посты. | @mychannel или mychannel; @ при обычном получении постов добавляется автоматически. По умолчанию пусто. Не указывайте здесь полный URL. |
| Ссылка на канал | Делает заголовок блока и имя канала ссылками. Не заменяет username для получения постов. | Необязательный адрес, например https://t.me/mychannel. По умолчанию пусто. |
| Отображаемое имя | Имя в карточках; используется также для первой буквы канала в данных хелпера. | По умолчанию Telegram. Пустое значение при выводе заменяется на Telegram. |
| Заголовок блока | Текст над сеткой карточек. | По умолчанию Посты из Telegram. При пустом значении используется отображаемое имя. |
| Токен Telegram-бота | Подключает Telegram Bot API. Бот должен быть администратором канала. | Токен от @BotFather; по умолчанию пусто. Подсказка поля: «Один бот на один канал». |
| Количество постов | Ограничивает число последних сохранённых постов в блоке. | По умолчанию 5. При выводе значение приводится к целому; значение меньше или равное нулю заменяется на 5, больше 100 ограничивается до 100. |
| Кэш, секунд | Задаёт срок кэширования результата получения постов. | По умолчанию 600. 0 отключает кэш. При выводе отрицательное значение приводится к 0. |
Нажмите «Сохранить», чтобы записать изменения для выбранного набора. Сохранение настроек само по себе не проверяет токен запросом к Telegram.
Отдельные настройки витрины
- Выберите нужный адрес в поле «Витрина».
- Если у витрины ещё нет настроек, интерфейс очистит поля. Заполните все необходимые значения, включая username и токен.
- Нажмите «Сохранить».
Сохранённый набор отмечается зелёным цветом и символом ●. До создания собственного набора витрина использует «Основные». После сохранения применяется её собственный набор целиком: пустые поля не дополняются значениями общих настроек.
Для витрины с сохранённым набором доступна кнопка «Удалить настройки витрины». Подтвердите удаление — витрина снова будет использовать общие настройки. Набор «Основные» удалить этой кнопкой нельзя. Это действие удаляет настройки, а не сохранённые посты.
Как работает кэш
При действующем кэше плагин возвращает сохранённый результат без запроса новых публикаций. По истечении срока следующий вызов хелпера запрашивает обновления и читает посты из базы. Значение 0 отключает кэш результата, но не хранение постов в базе.
Ключ кэша зависит от username и количества постов. Для одинаковых username и количества витрины используют один ключ. Заголовок, имя и ссылка подставляются при каждом вызове из настроек или параметров хелпера.
Отдельной кнопки очистки кэша нет. Для проверки свежих данных сохраните 0 в поле «Кэш, секунд» и откройте страницу с блоком. Этот вызов удаляет соответствующий кэш результата и принудительно запрашивает URL фотографий. Затем верните нужное время кэширования.