s2tg - формы отправки сообщений в telegram для DLE

Плагин для DLE позволяющий отправлять формы с сайта в telegram.

Назначение: замена форм обратной связи в которых отправляются email на уведомления в мессенджер телеграм.
Актуально для тех, кто "не смог" работать с электронной почтой, а вот с мессенджерами дружит и понимает что так и как.
Возможно отправка как личных сообщений определенному получателю, так и трансляция уведомления в группы.

Типовые примеры использования: заказ обратного звонка, форма предзаказа товара, форма обратной связи с возможностью прикреплять файлы.

Плагин s2tg(Send to Telegram by TCSE)

Плагин s2tg by TCSE это реализация формы отправки уведомлений с сайта в telegram. За основу взята статья с сайта smartlanding.biz и доработана для использования в виде плагина DataLife Engine.

Первое что нам нужно - это создать своего бота. Делается это достаточно просто. В поиске наберите @botfather, откройте родительского бота и нажмите "Start":



Далее: Пишем команду /newbot, для создания нового бота. Придумываем имя бота. Придумываем ник бота.



Если все прошло успешно, то увидите поздравления и токен вашего бота, в моем случае это:

5698580640:AAEfqUZXa2J-JPhWsvP1K6_v-qx640w8Nig

Теперь нужно найти своего бота в поиске, указав его ник и нажать "Start", чтобы активировать его. В моем случае ник @TCSEtestForm_bot.



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

Давайте займемся этим и, пока, пойдем по первому пути.

Зайдите в меню, нажмите "New Group" ("Создать группу") и задайте имя вашему чату.



Не забываем пригласить своего бота в чат. Откройте меню чата, перейдите в "Add Members" ("Добавить участников") и введите имя своего бота.



На данный момент у нас есть бот, мы знаем его токен, есть чат, в который будут приходить заявки, и нам осталось узнать только id чата. Для этого, напишем в чате: /join @ник_бота
А затем перейдите в браузер, если используете приложение и введите:

https://api.telegram.org/botXXXXXXXXXXXXXXXXXXXXXXX/getUpdates
где, XXXXXXXXXXXXXXXXXXXXXXX - токен вашего бота, полученный ранее.

Если все сделали правильно, то перед вами откроется подобная страница:


Нас интересует объект "chat":{"id":-884220018. — Это id моего тестового чата. На данном этапе у нас есть все, чтобы отправлять текстовые сообщение из контактной формы на сайте в Telegram.

Кстати, если не хотите создавать группу, то можете получать личные сообщения от бота. Просто напишите боту @getmyid_bot и он отобразит ваш ID персонального чата с ним.


Именно это значение можно будет указать в настройках формы отправки.

Настройки плагина s2tg by TCSE

Подключение стилей и скриптов в шаблоны сайта
1. В файл main.tpl перед секцией

</head>

вставить:

<link rel="stylesheet" href="{THEME}/assets/s2tg/css/style.css">

Перед закрывающим тегом

</body>

вставить JS для формирования номера телефона по маске

<!-- Маска ввода номера телефона.-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.mask/1.14.15/jquery.mask.min.js">
<script>
$(function () {
  $('input[type="tel"]').mask('+7(000)000-00-00');
});
</script>

Структура шаблонов форм
Каждая отдельная форма состоит из следующих файлов:

/templates/{THEME}/assets/s2tg/callback/form.tpl
/templates/{THEME}/assets/s2tg/callback/script.js
/engine/modules/mod_tcse/s2tg/callback.php

Где callback - это имя формы, а {THEME} - это имя вашего шаблона с установленным плагином.

В комплекте с плагином поставляются две базовых формы связи:
Форма заказа обратного звонка callback


Форма обратной связи feedback


Шаблоны каждой из форм можно отредактировать по своему вкусу: добавить или удалить поля форм. Необходимы знания HTML.

для формы заказать звонок - вывод в шаблон сайта через

{include file="assets/s2tg/callback/form.tpl"}

для формы обратной связи - вывод в шаблон сайта через

{include file="assets/s2tg/feedback/form.tpl"}

Настройки получателя
Для формы заказа звонка необходимо через ftp открыть файл engine/modules/mod_tcse/s2tg/callback.php и указать свои параметры const TOKEN ='свой-токен' и const CHATID ='свой-id' .



Для формы обратной связи необходимо через ftp открыть файл engine/modules/mod_tcse/s2tg/feedback.php и аналогично указать свои параметры const TOKEN ='свой-токен' и const CHATID ='свой-id'.

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

Уведомления об отправке из формы

для формы заказать звонок - внести правки в файле
/templates/{THEME}/assets/s2tg/callback/script.js

для формы обратной связи - внести правки в файле
/templates/{THEME}/assets/s2tg/feedback/script.js

Где {THEME} - это имя вашего шаблона с устаноленным плагином.