Joomla telegram chat extension
В этом статье я расскажу, как можно получать сообщения с форм обратной связи и заказа звонка в ваш Telegram.
Для отправки сообщений мы подключим телеграмовского бота. Отмечу, что его создание и использование абсолютно бесплатно. Процесс настройки состоит из 3 этапов и не должен занять более 10-15 минут. Рассмотрим подробнее каждый из этапов.
1. Создание бота
Для начала, откройте Telegram и найдите специального бота, который поможет вам создать своего собственного. Это можно сделать по ссылке: https://telegram.me/botfather либо набрав в поиске botfather.
В открывшемся чате напишите /start, бот ответит вам списком доступных команд, нас интересует /newbot. После ее ввода, Botfather предложит вам дать имя своему боту. Имя может быть любым, а вот после него вам необходимо будет ввести username бота, который должен быть набран латиницей и обязательно заканчивается на «_bot«. Для своего проекта я выбрал название joomly_test_bot. После создания, бот вернет вам токен доступа в Телеграм, который будет выглядеть как набор цифр и букв на скриншоте. Этот токен нужно сохранить и позднее вставить в настройки модуля, подробнее об этом в пункте 3.
2a. Создание канала
Отправлять сообщения ботом мы будем в специально созданный канал. Если у вас несколько сотрудников, то вам не придется плодить кучу чатов, все подпишутся на канал и будут получать сообщения из одного места.
Откройте основное меню телеграма (иконка «стопки» слева вверху), выберите «New Сhannel», введите название канала и адрес(URL) на новой вкладке. Адрес канала сохраните, его нужно будет вставить в настройки модуля в пункте 3. Важно! Канал в данном примере создается публичным. О создании приватного канала будет рассказано в пункте 2б.
После создания, канал должен появиться в списке контактов. Откройте канал и нажмите на его аватарку, перед вами появиться страница информации. Откройте список админов, нажмите «Add administrator», в окне поиска напишите название вашего бота и выберите его из выпадаюшего списка. На странице прав можно ничего не менять. Бот создан и добавлен в канал, осталось связать его с вашим модулем.
2б. Создание приватного канала
Этот пункт вам потребуется только, если вы собираетесь сделать канал приватным (а я настойчиво рекомендую это сделать!).
Сложность с использованием приватного канала заключается в том, что если для идентификации публичного канала мы можем использовать его адрес(URL), то для приватного нам понадобится узнать Сhat ID канала, а Телеграм не предоставляет для этого удобных инструментов. Ниже я описал два максимально удобных, на мой взгляд, способа, но для начала, я расскажу как сделать канал приватным, если он изначально был сделан публичным.
Найдите канал в списке контактов, откройте и нажмите на аватарку, чтобы попасть на страницу с информацией. Нажмите на иконку шестеренки, далее «Channel type» и поменяйте публичный тип на приватный.
Теперь нам нужно узнать Chat ID нашего канала.
Способ 1: Найдите и добавьте в администраторы канала бота @get_id_bot. Это делается также как в пункте 2a, где мы добавляли в администраторы собственного бота. Далее напишите в своем чате /my_id@get_id_bot и бот вернем Chat ID, который нам необходим в последнем пункте. После этого бота можно удалить.
Способ 2: Откройте ваш чат в браузере в веб-интерфейсе и обратите внимание на набор цифр после символов «=с» и до нижнего подчеркивания «_». Если убрать «с» и дописать перед ними -100, то мы получим наш Chat ID из предыдущего скриншота. Обратите внимание, что айди начинается со знака минус!
3. Настройка модуля
Осталось самое простое — связать ваш модуль (Contactus или Callback) с созданным ботом. Для этого откройте в настройках модуля вкладку «Боты» выберите отправку через Telegram и введите API Token, который вы получили при создании бота в пункте 1 и название чата (чата, не бота!) из пункта 2а, которое должно начинаться с собаки @. Если чат приватный, то вместо название бота вводится Chat ID из пункта 2б. На этом все, теперь все ваши сообщения будут дублироваться в телеграм.
Joomla Telegram Chat
Description
Telegram extension by Elfsight is the fastest way for your website clients to address you and get answers to their questions and requests. Stay available right now for people in their beloved messenger at all times. Place Telegram Chat on your store and make it appear on selected pages or for selected kinds of clientele, choose start-chat triggers, show your custom welcome message, choose icons and apply other personalization. Using Telegram messenger embedded on your site, you will stay in the loop of customers at any hour and from any place.
It is the handiest way for people to reach you and get their questions resolved!
Features
Here you can see all the functions of Telegram Chat. They are available directly in the editor and they will help you configure the widget exactly for your use-case.
- Add Telegram messenger on your site to chat with visitors
- 3 variants of chat position: floating bubble, embed bubble, and embed chat window;
- A library of bubble icons for you to select from;
- Editable bubble text;
- FlexibleChat header with page logo, name, and caption.
How do I integrate Telegram Chat Box with Joomla?
Simply follow the following steps given below to add the tool on Joomla.
- Manage our free editor and start shaping your customized Telegram Chat extension.
Specify the preferable form and characteristics of the widget and apply the corrections. - Get your personal code which is shown in the box on Elfsight Apps.
When the creation of your personal plugin is over, copy the personal code in the appeared box and keep it for further use. - Commence usage of the extension on your Joomla website.
Paste the code copied before into your page and save the improvements. - The installation is successfully performed.
Visit your website to take a look at how’s the tool running.
You are welcome to address the customer service if you need help or have issues. Our specialists will be happy to assist with every request.
Joomla Telegram Chat Extension
Joomla Telegram Chat Extension Features
Joomla Telegram Chat Support Extension helps your visitors to contact you immediately over telegram on your joomla website.
Joomla Telegram Chat Extension Version History
You can view below all version changes / updates for Telegram Chat.
Released on : 03 September 2019, Tuesday
Latest updated on : 01 February 2021, Monday
Current Version : 1.0.2
Changelog 1.0.1 New language Files added. Deutsch,Español, Française, Italiano, Português, Türkçe 1.0.0 Initial release
Do you have any questions before buy?
Use the form below and ask your question before buying Joomla Telegram Chat Extension.
Joomla Telegram Chat Extension developed by ExtensionCoder™
Click on to an option to select the best for you
Basic Support Package — 10 €
Instant Download after purchase
Support for 1 domain during 3 months
Pro Support Package — 18 €
Instant Download after purchase
Support for 3 domains during 6 months
Lifetime Support Package — 24 €
Instant Download after purchase
Support for Unlimited domains for LIFETIME
18 €
—>Buy Now
100% Secured Payments with Credit Card, Debit Card or Paypal
Instant download after purchase
You’ll receive an official invoice instantly.
Support is based on subscription
You can install extensions on unlimited domains
—> Coupon / promo codes are applicable at checkout page.
Just after completion of the payment, you will get access to the download board
Type: Module
Joomla 3 Compatibility: and newer
Joomla 4 Compatibility: YES
Responsive: 100% Responsive
Mobile Devices: Tested
Deutsch, English, Español, Française, Italiano, Português, Türkçe
Released on : 03 September 2019, Tuesday
Latest updated on : 01 February 2021, Monday
Current Version : 1.0.2
Joomla Extension Directory : View JED Listing
Support requests are replied directly by the developer latest in 24 hours and with no cost during your subscription.
Our extension and templates are tested before we release them. If any of the feature which is written is not exist you can ask for a refund.
Joomla Telegram Chat Support Extension ,
Joomla Telegram Chat Support Extension is reviewed
5.0 out of 5 by 1 ExtensionCoder™ Customer!
Name already in use
TCI / README.ru.md
- Go to file T
- Go to line L
- Copy path
- Copy permalink
Copy raw contents
Copy raw contents
TCI – Telegram Content Import
Системный плагин для CMS Joomla!, обеспечивающий импорт постов из Telegram в материалы Joomla.
CLI-решение. Базируется на работе сервиса https://tg.i-c-a.su/.
Плагин совместим с Joomla! 4.
Краткая инструкция по запуску плагина
Проверьте, чтобы плагин был опубликован.
Укажите в параметрах плагина системное имя публичного telegram-канала (без символа @).
Плагин вызывается исключительно из командной строки. Создайте cron-запись с периодом выполнения в минутах и значением, указанным в параметре плагина «Период», с адресом:
Ключ безопасности будет автоматически сформирован при первом сохранении параметров плагина.
Вы можете дополнительно указать параметры:
для импорта постов с канала, отличного от указанного в параметрах плагина. При отсутствии любого из этих параметров будут применяться их аналоги из параметров плагина.
Telegram-сервер *. URL-адрес сервиса, посредством которого производится получение постов из Telegram. Значение по умолчанию: https://tg.i-c-a.su/ .
Ключ безопасности. Необходим для защиты сайта от возможных DDOS-атак. Автоматически формируется при первом сохранении плагина.
Отладочный режим. Режим, при котором данные о постах запрашиваются только один раз и записываются в файл tci_<имя_канала>.json в папке кэша Joomla. При существовании файла повторно с указанного канала json не запрашивается, файл очищается методом стандартной очистки кэша Joomla. Параметр действует на все каналы, в т.ч. указываемые через реквест в cli-запросах. Не оставляйте файлы кэша после отключения отладочного режима!
В отладочном режиме посты всегда создаются неопубликованными.
В отладочном режиме в лог пишется сообщение о включении отладочного режима и информация о причинах пропуска импорта каждого поста по условиям параметров плагина.
Даннй режим может быть полезен при разработке плагина предварительной обработки контента.
Системное имя канала *. Системное имя telegtram-канала (без символа @), с которого предполагается импортировать посты.
Лимит получаемых постов за одну обработку *. Указывается общее количество получаемых от сервиса постов. Значение по умолчанию: 10 . ВАЖНО: что является постом в Telegram?
Период, за который берутся посты с канала на момент обращения, минуты *. Время указывается в минутах. Момент обращения – подразумевается момент запуска плагина. Значение по умолчанию: 60 .
Параметры материала Joomla
Категория материалов *. Категория материалов Joomla, в которую будет производиться импорт материалов. Значение по умолчанию: Uncategorized (без категории, >
Язык материалов. Значение по умолчанию: для всех языков.
Автор материалов. Пользователь Joomla, выступающий как автор материалов, импортируемых из Telegram. Значение по умолчанию: пользователь, от имени которого создавался сайт.
Состояние материалов при импорте. Принимаемые значения: Не опубликовано|Опубликовано . Значение по умолчанию: Не опубликовано .
Добавлять ID поста в конец алиаса. Позволит импортировать посты с одинаковыми заголовками. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Помещать материал в избранные. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Преобразовывать хештеги из поста в метки Joomla. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Преобразовывать хештеги в теле материала в ссылки на теги. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет . Этот параметр отображается только в случае включения параметра «Преобразовывать хештеги из поста в метки Joomla».
Формировать meta description. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Особенности формирования meta description: из тела материала берутся первые 150 символов текста, из которого предварительно вырезаны иконографические символы (символы-иконки), производится обрезка до ближайшего пробела с конца строки и в случае, когда строка не является цельным предложением, добавляется многоточие.
Папка импортируемых из постов изображений. Папка, в которую будут импортированы изображения из поста в Telegram. Значение по умолчанию: корень папки images в корне сайта. ВАЖНО: Особенности формирования материала Joomla.
Действия при ошибке скачивания изображения. Принимаемые значения: Пропускать изображение|Сохранять оригинальную ссылку . Значение по умолчанию: Пропускать изображение . ВАЖНО: Особенности формирования материала Joomla.
Действия с изображениями постов-галерей. Принимаемые значения:
- Оставлять в контенте материала ,
- Первое изображение – во вводное и в основное изображение материала ,
- Первое изображение – во вводное, второе – в основное изображение материала .
Значение по умолчанию: Оставлять в контенте материала . ВАЖНО: Особенности формирования материала Joomla.
Добавлять подпись для изображений. Влияет только на вводное и основное изображения материала. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Префикс папки с изображениями. Принимаемые значения:
- Не указывать (не рекомендуется) ,
- ID канала ,
- Имя канала .
Значение по умолчанию: ID канала .
Подключать комментарии из поста. Позволяет подключить живые комментарии, прикреплённые к посту. При наличии авторизации из телеграма позволяет полноценно использовать на сайте систему комментариев телеграма. Подключение производится посредством загрузки соответствующего скрипта API Telegram. Подключение производится только в тех случаях, когда на момент импорта у поста были активны комментарии, а в поле примечаний к материалу сохранена структура с информацией о посте. В разметке материала блок комментариев оборачивается в контейнер с классом telegram-comments . Поддерживается подключение тёмной темы оформления. Плагин не содержит собственных стилей по оформлению блока комментариев. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Тёмная тема оформления. Подключение тёмной темы оформления блока комментариев. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет . Этот параметр отображается только в случае включения параметра «Подключать комментарии из поста».
Параметры условий пропуска импортируемых постов
ВАЖНО: обработка условий пропуска производится последовательно, в порядке перечисления ниже указанных параметров. Если на каком-либо из них срабатывает условие пропуска, остальные, нижеследующие, не проверяются.
Обрабатывать посты, пересылаемые с других каналов. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Пропускать медиа-посты без текстового контента. Конкретно: посты-изображения, посты-файлы. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Пропускать посты сгруппированного контента (посты-галереи). Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Пропускать посты без изображений (в т.ч. галерей). В случае поста-галереи условие отработает только если в материале формируется вводное и/или основное изображение. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Пропускать посты без текстового контента. Позволит пропускать посты-изображения и галереи, если в них отсутствует текстовое описание. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Пропускать посты, если текстовый контент не более, символов. Включая пробелы и знаки препинания. Укажите 0 для снятия ограничений. Значение по умолчанию: 0 .
Пропускать посты, если текстовый контент не более, абзацев. Подсчёт количества абзацев производится до формирования заголовка материала. Укажите 0 для снятия ограничений. Значение по умолчанию: 0 .
Пропускать посты-голосования. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Пропускать посты с наличием кнопок. Кнопками могут являтся как кнопки голосования так и кнопки-ссылки. Принимаемые значения: Да|Нет . Значение по умолчанию: Нет .
Пропускать посты-видео, в т.ч. видео из постов-галлерей. Принимаемые значения: Да|Нет . Значение по умолчанию: Да . Скачивание файла видео возможно только если размер файла не превышает 50мб. При превышении этого порога файл видео загружен не будет, ссылки на него не будет.
Пропускать посты-файлы. Принимаемые значения: Да|Нет . Значение по умолчанию: Да . Скачивание файла возможно только если размер файла не превышает 50мб. При превышении этого порога будет сохранятся ссылка на пост в Telegram.
Действие с файлом. Принимаемые значения:
- Сохранять ссылку на пост в Telegram ,
- Скачивать файл с Telegram .
Значение по умолчанию: Сохранять ссылку на пост в Telegram . Этот параметр отображается только в случае отключения параметра «Пропускать посты-файлы».
Дополнительные cli-параметры обусловлены возможным импортом постов из более чем из одного telegram-канала.
Корректное указание любого из нижеприведённых параметров переопределяет значение соответствующего параметра плагина.
channel – Системное имя канала.
limit – Лимит получаемых постов за одну обработку.
period – Период, за который берутся посты с канала на момент обращения, минуты, указываются числом
catid – ID категории материалов, указывается числом. ID можно посмотреть в административной панели Joomla, на странице списка категорий материалов.
lang – Язык материалов, указывается системная константа (например: en-GB , ru-RU ) либо символ * для указания значения для всех языков.
publiched – Опубликовывать материалы автоматически. Указывается числом, значение 0 – Нет, 1 – Да, иные значения игнорируются и берётся значение из параметра плагина. Параметр игнорируется в режиме отладки.
featured – Помещать материал в избранные. Указывается числом, значение 0 – Нет, 1 – Да, иные значения игнорируются и берётся значение из параметра плагина.
userid – Установить ID пользователя Joomla как автора материала.
Сервис имеет следующие лимиты:
- Работа только с публичными чатами.
- Не белее 15 запросов в минуту.
- Не более 100 постов за 1 запрос.
- Временный бан за любую ошибку, например: неверное название канала или закрытый канал.
Сервис имеет свободный исходный код (ссылка доступна на официальной странице сервиса) и позволяет поднять на собственном сервере свой экземпляр сервиса, что настоятельно рекомендуется, если у вас предполагается импорт большого количества постов за малый временной период.
!Бан имеет накопительное время: попытка обращения к сервису во время действия бана автоматически увеличивает продолжительность бана в два раза!
Что является постом в Telegram
Пост в Telegram – это более сложная структура, нежели классическое визуальное представление того, что обычно считается постом. Технически, визуальный пост – это сразу несколько постов. Например, пост-галерея из 10 изображений — это сразу 10 постов, т.е. каждое изображение — это отдельный пост, просто они сгруппированы по определённому признаку. При импорте эти изображения будут также сгруппированы в один материал Joomla.
Почему это важно? Потому что сервис, используемый по умолчанию, имеет ограничение на лимит запросов. Изображения получаются отдельными запросами и всё это происходит за один прогон плагина. Учитывайте это при расчёте периода: вполне может оказаться, что импортируя 10 постов галерей, вы на выходе получите 10 галерей по 10 изображений, что в итоге выльется в 101 запрос (1 запрос – на получение списка постов), что явно больше указанного ограничения сервиса в 15 запросов.
Какие типы постов игнорируются
Игнорируются системные посты самого Telegram, скрытые посты (скрываются администратором канала), посты-стикеры. Аудиозаписи рассматриваются как обычные файлы неизвестного типа.
Особенности формирования материала Joomla
Плагин импортирует только текст и изображения.
Текст разбивается на абзацы.
Из первого абзаца формируется заголовок. Из заголовка вырезаются все иконографические символы, обрезается до 100 символов (ограничение Joomla на заголовок материала), затем обрезается до первого пробела с конца строки. Из получившейся строки формируется alias материала, по которому уникализируется последний: если материал с таким alias уже существует, то он пропускается.
Если первый абзац подвергался обрезки при формировании заголовка, он полностью в необработанном виде формирует вводную часть материала, в противном случае вводная часть материала формируется из второго абзаца.
Все последующие абзацы формируют основную часть материала.
Если абзацев менее трёх, основная часть материала не формируется.
Если абзацев всего один, он полностью формирует вводную часть материала.
Изображения из постов-галерей, которые не формируют вводное и основное изображения материала, добавляются только в основную часть материала, каждое изображение оборачивается в отдельный абзац. Каких-либо редактирующих действий над изображениями не производится.
В случае включения опции плагина Преобразовывать хештеги из поста в метки Joomla все найденные хештеги преобразуются в метки Joomla и присваиваются материалу. Ранее существующие метки повторно не создаются.
В случае включения опции плагина Преобразовывать хештеги в теле материала в ссылки на теги все найденные хештеги будут преобразованы в ссылки на соответствующие метки. В этом случае рекомендуется отключить показ меток материала в опциях материала (или в общих опциях компонента материалов).
В поле «Примечание» сохраняется JSON-структура о Telegram-посте, которую могут использовать сторонние расширения при работе с материалом. Структура представляет из себя объект с именем tci с набором полей. Поля структуры содержат:
- channelid – id канала,
- channelname – системное имя канала,
- channeltitle – публичный заголовок канала,
- postid – id поста в канале,
- replies – наличие прикреплённых к посту комментариев.
Эта структура необходима для корректной работы функционала подключения блока комментариев. Также её могут, не изменяя, использовать иные кастомые сторонние решения.
Предварительная обработка контента материала перед его сохранением
Вы можете обработать контент материала перед его сохранением сторонним плагином на событие onContentBeforeData .
ВАЖНО: плагин должен быть системным! Контентный плагин отрабатывает один раз за сессию и в итоге будет обработан только 1 материал, остальные будут пропущены: повторно контентный плагин просто не запустится, так устроена Joomla.
Плагин принимает на входе 2 параметра:
- (string) $context – передаётся значение com_plugins.plugin.system.tci , вы должны проверить контекст исключительно на это значение, чтобы точно знать, что вы обрабатываете контент материала, импортируемого данным плагином;
- (array) $data = [] – стандартный массив объекта материала, передаётся не по ссылке.
Ожидается возвращаемое значение в виде массива объекта материала, чтобы эти изменения были применены либо false в ином случае.
Пример реализации функции события:
Плагин формирует ежемесячный лог посредством стандартного логгера Joomla. Имя файла лога формируется по маске tci_<Год-месяц>.php.log . Для просмотра лога из административной панели Joomla можно воспользоваться компонентом View logs.
Ссылки на видеоролики с YouTube в уже импортированных материалах можно преобразовать контент-плагином YtVideo.
Стоимость решения — $75 USD
Вы можете опатить в любой валюте мира, кроме биткойнов, по курсу на момент оплаты.
Заказ осуществляется посредством обращения через форму обратной связи на личной страничке автора.
При заполнении формы обязательно укажите свой username в Telegram, а в тексте обращения «Заказ TCI».
Поддержка осуществляется в личной переписке с автором в Telegram.