Шаблоны инфо-постов
Команда -шаблон - разобрать пост в шаблон оформления, собрать шаблон в конструкторе на сайте, посмотреть список шаблонов чата и удалить ненужные.
Шаблон это образец оформления для постов инфо-канала: где стоят заголовки, как разложены категории, из чего состоит строка с участником, каким символом отмечена занятая роль. Пока шаблона нет, бот повторяет вёрстку того поста, который вы ему показали. С шаблоном все посты одного вида в чате выглядят одинаково, и новые списки бот собирает по образцу.
-шаблонРазбирает пост в шаблон оформления и хранит шаблоны чата
/template<параметр> — обязательный<параметр> — обязательный<параметр> — обязательный<параметр> — обязательныйКоманда работает только в группах. Полезнее всего она в ролевых чатах, флудах и небольших сообществах, где роли, ресты и дни рождения разложены по спискам.
Как создать шаблон
Проще всего показать боту готовый пост. Перешлите его из канала в чат и ответьте на пересланное сообщение командой с именем будущего шаблона:
Второй путь: собрать оформление в конструкторе на сайте. Там шаблон складывается из блоков мышкой, рядом видно, как он будет выглядеть в телеграме, а кнопка копирования отдаёт сразу готовую команду с именем и коротким кодом. Останется вставить её в чат.
Код это то же оформление, записанное одной строкой, поэтому им удобно делиться: тот же шаблон можно поднять в другом чате, если вставить код после имени.
[скриншот: разбор шаблона перед сохранением]
Что бы вы ни прислали, бот сначала показывает разбор: имя, вид, тип структуры, сколько нашлось категорий и пар «ключ - значение», есть ли легенда и как он увидел сообщение целиком. Строки, которые он не распознал, перечисляются отдельно и попадут в шаблон как есть, без подстановок.
Кнопки под разбором: «Вид» перебирает виды по кругу, «Тест с данными» заполняет макет выдуманными участниками и датами, чтобы посмотреть на результат заранее, «Конструктор» ведёт на сайт, «Сохранить» и «Отмена» заканчивают дело. Нажимать их может только тот, кто отправил команду.
Неподтверждённый разбор живёт до следующего: разберёте другой пост, и прежний черновик заменится. Отмена удаляет черновик, а сохранённые шаблоны не трогает.
Виды шаблонов
Вид решает, что бот будет подставлять в пост, оформленный этим шаблоном:
| Вид | Что подставляется |
|---|---|
| Роли | Отметки занятости рядом с ролями |
| Ресты | Список тех, кто в ресте, вместе с датами |
| Дни рождения | Даты участников, разложенные по месяцам |
| Статистика | Счётчик участников |
| Набор | То же, что статистика, для постов о наборе |
| Общий | Ничего, только оформление |
Вид бот определяет сам и подписывает такой разбор словом «авто». Ошибся - поправьте кнопкой «Вид»: она перебирает пять видов по кругу. «Общий» кнопкой не выбрать, его бот ставит сам, когда в тексте нет ничего похожего на список.
Имя шаблона
Имя нужно, чтобы потом найти шаблон в списке, и на него же ссылаются команды просмотра и удаления. Длина до 64 символов, начинать с подчёркивания нельзя, и нельзя занимать служебные слова список, удалить, инфо, просмотр и их английские варианты: бот примет их за подкоманду.
Имя, которое в чате уже занято, перезаписывает прежний шаблон без лишних вопросов. Шаблоны, которые бот собрал сам по кнопке «Создать из поста» в панели инфо-канала, называются вроде auto_roles и лежат в том же списке, так что накопившиеся можно спокойно удалять.
Что происходит после сохранения
Бот отвечает, что шаблон сохранён, и сразу переоформляет по нему привязанные посты этого вида, а в ответе пишет, сколько их получилось. Если какой-то пост обновить не удалось, например у бота нет прав в канале, он перечислит ошибки тут же.
Активным остаётся один шаблон на вид. Сохранили новый шаблон ролей, и прежний перестаёт применяться, но из списка не исчезает: вернуть его можно кнопкой «Шаблон» в панели поста, там у активного стоит галочка.
Список и карточка
Список показывает, сколько шаблонов сохранено, и раскладывает их по страницам, по шесть на каждой. Каждый шаблон становится кнопкой с видом и именем, нажатие открывает карточку.
[скриншот: список шаблонов чата]
В карточке видно вид, тип структуры, счётчики категорий и пар, дату последнего изменения и оригинальный макет целиком: он спрятан в раскрывающуюся цитату, чтобы не растягивать сообщение. Кнопки под ней: «Тест с данными» показывает шаблон заполненным, «Код MR1» отдаёт его короткой строкой, «Открыть на сайте» ведёт в конструктор, дальше удаление и возврат к списку.
Если шаблон с таким именем уже есть, а текста вы не приложили, карточка открывается и без списка: -шаблон роли покажет шаблон «роли». Явная форма -шаблон просмотр роли делает то же самое.
Кнопка «Код MR1» присылает код шаблона отдельным сообщением. Его можно сохранить себе, передать другому админу или вставить в другом чате командой с именем.
Удалить шаблон
<параметр> — обязательныйТо же делает кнопка удаления в карточке. Бот покажет, что именно удаляет, и предупредит: если по этому шаблону оформлялись посты инфо-канала, их автоматическое обновление прекратится. После подтверждения он возвращает вас к списку.
Когда бот просит помочь
В разборе иногда появляется подсказка. Все они про одно: бот чего-то не разглядел в тексте и просит помочь.
Пост статистики или набора без счётчика: бот допишет строку с числами сам, но лучше показать ему место, оставив в тексте Статистика: 0 / 100, {current} или <stats/>.
Список рестов без примера: если в посте пока никто не отдыхает, бот не понимает, как должна выглядеть строка. Оставьте один пример вроде • Ник [01.09-10.09] или оберните область списка в <rests> и </rests>.
Стилизованный текст: буквы из фигурных шрифтов бот распознаёт, но с обычным текстом всё работает точнее.
Отметки занятости бот берёт из условных обозначений поста: есть строка «Занято» с вашим символом, значит он будет ставить именно его. Когда обозначений нет, их можно задать пометками <role_busy>🎐</role_busy>, а рядом такие же role_admin, role_reserved, role_wanted и role_free. Пометка <role_status/> в строке роли показывает, куда встанет сама отметка. Обёртка <template type="roles" name="роли"> вокруг текста задаёт вид и имя сразу, тогда в команде их можно не писать. Те же пометки понимает вкладка «Текст» в конструкторе.
Кастомные эмодзи бот подхватывает из набора, подключённого к чату, и подставляет подходящие к названиям ролей. В канал они всё равно уйдут обычными: почему так, написано в инфо-канале.
Кому доступна команда
Нужно право на управление шаблонами инфо-сообщений, по умолчанию оно есть у администраторов и выше. Выдать его отдельному участнику можно через права. Это же право открывает кнопки с шаблонами в панели инфо-канала, а вот сама привязка постов лежит выше, у владельца чата.