README.md

BA-TG-Sender

Отправка сообщений в Телеграм с форм обратной связи на сайте

Что это такое?

С помощью этой библиотеки, можно легко организовать отправку сообщений в Телегам:

Различные уведомления
Сообщения от форм обратной связи
Как простой текст, так и файлы.

В библиотеке реализован функционал, который веб-мастеру приходится прописывать каждый раз при создании форм обратной связи на самописном сайте. Теперь всё необходимое можно сделать с помощью готовых компонентов.

Подготовить сообщение и файлы к отправке можно не только для Телеграм, но и (например) для e-mail или какого-нибудь отчёта.

Возможности

Считать данные, полученные с веб-формы
Автоматически отфильтровать: пробелы в начале и конце строки, специальные символы, HTML-теги.
Проверить данные формы на допустимые значения
На основе данных формы составить легко читаемое сообщение в несколько строк или отчёт
Загрузить и отправить файлы, при этом:
- разместить файлы в указанной папке на сервере (в том числе временной)
- переименовать файлы в транслит или рандомное имя
- проверить файлы на допустимый тип и размер
- удалить файлы и временный каталог после отправки
отправить в Телеграм сообщение с текстом и/или файлами

Как установить?

Скачайте архив с проектом BA-TG-Sender и распакуйте его в любом удобном месте.
Из папки classes возьмите все файлы и скопируйте в каталог вашего сайта, где хранятся другие классы и плагины.

Как подключить?

Подключение стандартным для PHP методом - через include и use.

Инструкция по установке и подключению

Как использовать?

Непосредственно отправку сообщения осуществляет класс BA_TelegramSender.

Простейший код для отправки:

$tgSender = new BA_TelegramSender();
$tgSender
	->setBotToken(сюда_передать_токен_телеграм_бота)
	->sendMessage(сюда_передать_ИД_чата, текст_сообщения );

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

Подробнее об использовании библиотеки BA-TG-Sender