Создание шаблонов
Вы автоматизатор?
Разбираетесь в блок-схемах?
Умеете делать крутые штуки, которые нужны бизнесу?
Или возможно уже прошли наш курс?
Тогда вы можете самостоятельно создавать готовые решения!
Для себя. Чтобы в своих проектах и проектах своих клиентов не собирать каждый раз всё с нуля, а использовать свои готовые наработки с удобной настройкой.
Для своих клиентов. Чтобы не тратить время на сборку, а просто отправить ссылку на установку шаблона.
Для продажи. Чтобы зарабатывать на продаже готовых решений в соц. сетях.
Структура создания шаблона
Создание шаблона состоит из нескольких этапов:
Создание схемы и нужных компонентов
Если вы создаете шаблон в первый раз, то рекомендуем перейти к этому пункту только после создания полей. А сейчас создать пустую схему и пропустить данный пункт.
Прежде чем мы создадим с вами шаблон, необходимо создать схему, которая будет запускаться с помощью шаблона.
А также, при необходимости создать компоненты, такие, как:
Списки
Поля профилей пользователей
Глобальные переменные
Валюта
Достижения
Ресурсы
Вебхуки
Для того, чтобы шаблон взаимодействовал с блок-схемой используются переменные:
Переменная шаблона - {t:}
Переменная пользователя - {u:}
Создание переменных
Ниже представлены такие переменные, как: {t:text} {t:key} {t:check} и т.д.
Не обязательно брать именно их. Все эти переменные придуманы нами. Вы можете придумывать свои переменные. Главное, чтобы они были на латинице.
Более того, вы можете вообще их не придумывать, а использовать готовые системные имена полей, по типу {t:b807e5d8db}
Например, в блок "Сообщение" вместо текста подставляем переменную {t:text}
В блоке "Событие" выбираем контейнер "Входящее сообщение" и выбираем условие "Текст события" или "Текст сообщения".
Если мы хотим в шаблоне подставлять ключевые слова, то используем переменную шаблона. Например - {t:key}
Обратите внимание, что в данном примере, мы ставим галочку "Передавать JSON массив как список значений" - ставим её, потому что мы решили использовать поле "Теги", а они передаются массивом. Но об этом будет подробнее сказано ниже.
Для классических условий, таких, как "Находится в списке" и подобных - мы можем использовать обычные условия без переменных.
Но давайте сделаем для теста сделаем проверку строки в массиве.
Для этого создадим переменную {t:check} и в контейнере условия "Числовая переменная поставим, что она равна первой строке. Напомним, что строки в массиве начинаются с нуля.
И для переключателя создадим переменную {t:admin_message}
С помощью неё мы будем включать возможность отправлять сообщение админу.
Для этого используем условие "Текстовая переменная" и поставим равное true
true - включен переключатель
false - выключен переключатель
Либо можно сделать еще проще, использовав условие "Переменная статуса: True / False"
По умолчанию будет стоять True.
Отлично!
Осталось задействовать пользовательскую переменную.
Давайте сделаем ограничение по количеству использований шаблона пользователем.
С помощью действия "Задать переменную шаблона" мы будем добавлять пользователю значение переменной count на 1. Т.е. прибавляем количество запусков схемы. Другими словами попыток пользователя.
И сделаем условие, где будем проверять не вышел ли пользователь за лимит этих попыток.
Выеберем условие "Числовая переменная" и поставим меньше или равно какому-то значению. В нашем примере это три.
Кстати, вместо цифры лучше использовать переменную, которую пользователь сам укажет в шаблоне. Например, {t:point}
В итоге у нас получилась вот такая простая схема:
Она будет реагировать на ключевые слова, проверять какое-то условие, выбранное в шаблоне, выдавать текст и срабатывать не чаще определенного количества раз.
Создание заготовки шаблона
После того, как мы создали схемы, необходимо создать заготовку для нашего будущего шаблона.
Заходим в раздел "Установленные в проект"
И создаем новый шаблон
Мы думали сделать отдельный раздел "Мои шаблоны", но потом отказались от этой идеи. Так что установленные и созданные находятся в одном разделе.
Для удобства рекомендуем вам систематизировать шаблоны по папкам.
Изображение (по желанию) Оно используется в магазине шаблонов и в списке установленных шаблонов. Если в магазине шаблон размещаться не будет, рекомендуем добавлять квадратное изображение. По умолчанию подставляется стандартная иконка с мешочком.
Название шаблона Здесь всё понятно :)
Папка - настоятельно рекомендуем сразу приучать себя всё каталогизировать. В будущем скажете себе спасибо :)
"Включено и работает" - после сохранения шаблон включится и будет работать. Здесь по желанию, но рекомендуем включить сразу.
"Разрешено устанавливать в другие проекты" - Если не планируете передавать кому-либо ссылку, то не включайте галочку. Но рекомендуем включить. Хотя бы для тестирования своих шаблонов.
Описание шаблона - Здесь тоже всё понятно. Но обратите внимание, что здесь у вас большое количество возможностей по оформлению, включая стилизацию текста, гиперссылки и вставку изображений. Не стесняйтесь этим пользоваться.
"Включить выбор интеграций" - Если включите эту галочку, то у пользователя в установленном шаблоне появится пункт выбора интеграции. Лично я обычно её не ставлю, потому что добавляю этот пункт вручную в нужное мне место. По умолчанию оно идёт в самом низу настроек установленного шаблона.
"Можно выбирать только одну интеграцию" - А вот этот параметр уже не будет работать без предыдущей галочки. Она позволяет добавлять только одну интеграцию к шаблону.
"Указывать интеграцию обязательно" - эта функция также работает в обязательном порядке только вместе с галочкой "Включить выбор интеграций". Если включить эту опцию и не выбрать интеграцию при заполнении шаблона, то шаблон НЕ будет работать.
Тип шаблона - нужен только для магазина шаблонов и последующей фильтрации. Рекомендуем указать.
Подключение схем и компонентов к шаблону
Для соединения схемы и других компонентов с шаблоном, необходимо выбрать пункт "Настроить компоненты". Его можно открыть нажав на иконку напротив шаблона, либо нажав три точки и выбрав из списка.
Всё, что необходимо сделать в этом разделе - это выбрать из списков необходимые компоненты, которые будут автоматически подключаться при установке шаблона.
Блок-схемы
Выбираем из списка вашу схему, которую вы создали ранее.
Не переживайте, если вы там что-то не доделали. Вы всегда можете её поправить после.
Все шаблоны, которые подключат пользователи, будут работать через схему, которая установлена у вас.
Обратите внимание!
Все шаблоны запускаются через вашу схему.
Любое изменение схемы повлияет на все проекты, где шаблон установлен.
Если схема будет отключена или вы забудете оплатить раздел блок-схем, то все шаблоны у всех пользователей, которые его установили - перестанут работать до тех, пор, пока вы не возобновите работу схемы.
Компоненты
Если схема просто подключается, то все остальные компоненты устанавливаются. Т.е. создаются внутри проекта пользователя, который устанавливает проект.
Они будут скопированы с такими же системными именами, которые вы указали у себя при создании.
Среди компонентов есть:
Глобальные переменные
Вебхуки
Списки
Поля профилей пользователей
Валюты
Достижения
Ресурсы
Для всех компонентов, кроме вебхуков и глобальных переменных - поля не поддерживают быстрое создание, потому что для них нужно указывать тип данных. Но вы также можете использовать переменные шаблона вместо полей. Но об этом подробнее ниже.
Создание полей шаблона
Напротив вашего шаблона выбираем иконку колбы, либо нажимаем на три точки и выбираем "Редактировать поля шаблона" из списка.
Нас встречает большой выбор возможности создания разных типов полей
Типы полей шаблона:
Строка
Сообщение
Абзац
Меню
Теги
Картинки
Переключатель
Скрытые данные
Заголовок
Инструкции
Элементы полей
Каждое поле состоит из нескольких элементов:
Заголовок поля
Описание поля
Системное имя поля
Текст внутри поля (подсказка)
Галочка "Поле обязательно для заполнения"
Тип поля
Удаление поля
Дублирование поля
Перемещение поля
Также, для некоторых типов полей, таких, как "Меню" и "Теги" есть дополнительные настройки.
Теперь давайте разберем по порядку каждый тип поля:
Поле "Строка"
Самый простой тип поля. Поддерживает любые символы. Не поддерживает абзацы.
Подходит для хранения простых данных, таких, как "Ключевое слово", "ID поста", "Ссылка" и т.д.
Если используете для ключевого слова - учитывайте, что здесь нельзя указать несколько ключевых слов, потому что весь текст, который сюда будет добавлен пользователем, будет восприниматься как одно значение.
Поле "Сообщение"
Если брать наш пример, то вместо системного имени, мы пишем нашу переменную text
С виду непримечательно поле "Сообщение" открывает для пользователя большие возможности для его заполнения.
После установки шаблона поле будет выглядеть так:
Оно поддерживает все классические форматы редактирования, в том числе гиперссылки.
Обратите внимание, что стили текста поддерживаются только в Telegram.
В ВКонтакте придет обычный текст без стилей.
Гиперссылки поддерживаются всеми платформами.
Поле "Абзац"
Абзац - это тоже максимально-простое поле, которое отличается от типа поля "Строка" только тем, что здесь пользователь сможет ставить абзацы.
Пример поля с типом "Абзац" в установленном шаблоне:
Этот тип поля удобен, когда нам нужно добавлять несколько строк и обрабатывать их как массив, выдавая определенные или случайные строки.
Поле "Меню"
С простыми полями разобрались. Переходим к более сложным и интересным.
Как говорится, проще показать, чем объяснять.
Меню - это классическое выпадающее меню, где можно выбрать один из нескольких вариантов.
Например, меню со списком интеграций:
И здесь нам как раз поможет дополнительная функция поля "Источник данных"
Вы можете указать конкретный раздел, который будет открываться в этом меню:
Если же ничего не выбирать, то вы можете задать значения самостоятельно:
Если вы задаете свои значения, то вывод этих значений осуществляется через JSON массив.
Где результатом будет номер строки массива, начиная с нуля.
Например Котлетка - это ноль, Сыр - 1, Помидор - 2 и т.д.
А если если вы хотите, чтобы пользователь мог сам создавать значения прям из поля. Например, свои списки. Тогда в поле "Возможности поля" выбираем "Создание записей"
Также вы можете поменять текст подсказки, который будет отображаться в незаполненном меню. По умолчанию стоит текст "Выберите значение".
Поле "Теги"
Тип поля "Теги" отлично подходит для указывания нескольких ключевых слов, а также, выбора любых других значений: списков, чатов, полей и т.д.
В отличие от поля "Меню", где пользователь выбирает из списка, в Тегах, пользователь может указывать несколько пунктов, прописывать свои значения, либо выбирать из списка.
Как и в меню, вы можете либо задать свои значения, либо использовать "Источник данных", чтобы пользователи выбирали значения из своих разделов, или предустановленных вами значений.
Однако, чтобы появилась у пользователя возможно задавать свои значения, необходимо в поле "Возможности поля" выбрать пункт "Добавление значений".
Поле "Картинки"
Тип поля "Картинки" позволяет добавлять свои изображения, либо выбирать уже загруженные вами.
Максимальное количество картинок
Максимальное количество картинок, которое пользователь может загрузить в одно это поле. Минимум 1, максимум 1000
Соотношение сторон
0 - не обрезать.
1 - квадрат.
Коэффициент: ширина / высота.
Больше 1 - горизонтальная картинка [1,778]
Меньше 1 - вертикальная [0,5625]
P.S. это поле работает для всех платформ. Но вы также можете использовать код вложения в других типах полей.
Поле "Переключатель"
Простой, но максимально удобный форма поля.
Где включение - это True
Выключено - это False
В схемах используется условие "Текстовая переменная", либо "Переменная статуса: True / False".
Примеры использования:
Поле "Скрытые данные"
Скрытые данные - удобное для многих автоматизаторов поле, в которое можно сохранять значение, которые не нужно показывать пользователю. Например, массив данных, id и другие данные.
Поле "Заголовок"
Здесь всё должно быть понятно :)
Рекомендуем активно их использовать.
Если у вас большой шаблон, то с помощью заголовков можно отделить основные настройки, от дополнительных.
Поле "Инструкции"
Даже если у вас максимально-простой шаблон, инструкции не помешают.
Вы можете использовать их не только в начале, но и добавлять их к каким-то сложным и неоднозначным полям. Учитывайте, что пользователи, которые будут заполнять шаблон, могут не понимать даже элементарных вещей.
В начале шаблона рекомендуем сообщать какие интеграции необходимо установить перед настройкой шаблона, и какой примерный расход сообщений будет в этом шаблоне на одного пользователя.
Заполнение полей шаблона
Мы создали схему, создали шаблон, объединили данные.
Теперь мы хотим, чтобы пользователь открыл не просто пустой шаблон, а уже заполненный.
Для этого достаточно просто нажать на наш шаблон, заполнить его и сохранить.
Область открытия шаблона:
Пример заполненного шаблона:
Тестирование и доработка
Схема готова, шаблон готов.
Осталось что?
Правильно - протестировать наш шаблон.
Для этого настоятельно рекомендуем использовать другой тестовый проект.
Обратите внимание, что во время тестов вы можете редактировать схему в режиме реального времени. Но если вы добавляете новые значения переменных, то шаблон необходимо будет переустановить.
___________________________________________________________________________________________
На этом всё.
Last updated
