About This File
Модуль позволяет отправлять любые формы (обратная связь, обратный звонок, контактная форма, быстрый заказ и т.д.) в телеграм в личный чат, либо в группу(удобно, если у вас несколько менеджеров).
Возможности:
- Создавать неограниченное количество экземпляров модуля и привязывать их к разным формам с различными настройками.
- Использовать разные чаты для разных форм.
- Привязываться к форме или кнопке (кнопка ОБЯЗАТЕЛЬНО должна быть внутри формы) по CSS-селектору.
- Задавать индивидуальный формат сообщений для каждой формы.
- Отправлять в чат картинки и другие файлы.
- Отображать пользователю уведомления об успешной отправке или ошибке.
- Собственный код валидации/проверки полей. По умолчанию модуль не проверяет ошибки, а сразу отправляет сообщение.
Принцип работы:
Модуль находит кнопку или форму, которая указана в поле "Селектор формы или кнопки" и вешает обработчик события click (на кнопку) или submit(на форму). Внутри обработчика вызывается метод validate (вы можете самостоятельно написать код для проверки полей в настройках модуля), который по умолчанию возвращает true. Если валидация прошла успешно, то форма сериализуется (именно поэтому кнопка должна быть внутри тега <form>, если в качестве селекторы вы указываете кнопку) и отправляется запрос AJAX на контроллер модуля, который с учетом заполненного в админке формата уведомлений формирует сообщение и отправляет его в чат.
Если в качестве селектора указана форма, то удостоверьтесь, что она реально отправляется на сервер(происходит submit). Если же этого не происходит, то лучше привязывать отправку к кнопке.
Установка:
1. Зайдите в административную панель своего интернет-магазина.
2. На вкладке Модули/Расширения выберите пункт Установка расширений.
3. Нажмите на кнопку Загрузить и выберите архив formInTelegram.ocmod.zip.
4. После процесса установки перейдите на вкладку Модули/Расширения - Модификаторы и обновите модификаторы.
5. Перейдите на вкладку Модули/Расширения - Модули/Расширения.
6. В выпадающем списке выберите тип расширения - Модули.
7. В списке модулей найдите [AppDevStudio] Отправка форм в Telegram и активируйте модуль.
8. Нажмите на кнопку редактирования [AppDevStudio] Отправка форм в Telegram, введите данные формы, токен бота и идентификатор чата и нажмите Сохранить.
9. В меню Дизайн/Макеты выведите созданный модуль на той же странице, где имеется данная форма или поставьте галочку "Форма находится на всех страницах", если форма реально присутствует на всех/многих страницах сайта.
Как зарегистрировать бота и получить токен:
1. Найти в телеграме юзера @botfather
2. Возле окна ввода текста нажать кнопку Меню и выбрать "/newbot" или ввести эту же команду в поле ввода и отправить сообщение.
3. Вам будет предложено ввести название бота, а затем его имя пользователя, заканчивающееся на "bot".
4. Ввести требуемые данные.
5. В ответном сообщении после строки "Use this token to access the HTTP API:" будет написан токен в формате "цифры:символы"
6. Скопировать и сохранить куда-нибудь токен.
7. Открыть настройки модуля и ввести туда токен в соответствующее поле.
Как узнать ид личного чата:
1. Найти своего бота в телеграме по имени пользователя.
2. Написать ему произвольное сообщение.
3. Перейти в браузере по URL https://api.telegram.org/bot<token>/getUpdates где вместо <token> нужно вписать полученный ранее токен. Браузер Firefox отображает данные структурированно, а не просто текстом. Это удобнее для поиска информации.
4. Если не видно сообщений, то обновить страницу, возможно написать повторно сообщение.
5. В разделе "chat" будет подраздел "id". Это и есть ваш chat_id (Идентификатор чата). Копируем его и вставляем в настройки модуля.
Как отправлять сообщения в группу:
1а. Создать группу в телеграм через стандартное меню, найти на шаге добавления пользователей своего бота и добавить его к группе.
1б. Если группа уже существует, то найти своего бота в телеграме по имени пользователя. В меню справа нажать кнопку "Добавить в группу" и выбрать соответствующую группу.
2. Написать в группе сообщение латиницей, начинающееся со знака "/".
3. Перейти в браузере по URL https://api.telegram.org/bot<token>/getUpdates где вместо <token> нужно вписать полученный ранее токен. Браузер Firefox отображает данные структурированно, а не просто текстом. Это удобнее для поиска информации.
4. Если не видно сообщений, то обновить страницу, возможно написать повторно сообщение.
5. В разделе "chat" будет подраздел "id". Это и есть ваш chat_id (у группы он начинается со знака "-" и далее содержит цифры). Копируем его полностью вместе со знаком "-" и вставляем в настройки модуля.
Модуль не заменяет стандартные файлы.
Не требуется IonCube.
Условия использования:
1 покупка = 1 доменное имя.
Если возникают проблемы с установкой/настройкой пишите - помогу.
Демо:
Фронт - https://oc302.appdevstudio.ru/
Админка - https://oc302.appdevstudio.ru/admin/
demo / demo
Модуль тестировался на OpenCart / OcStore / Opencart Сlub edition/ Русской сборке 3.0 на стандартном шаблоне. С другими шаблонами тоже должен работать.