TelegramNotice — OctoberCMS Plugin

Send frontend form submissions to Telegram, MAX messenger, or both simultaneously. Falls back automatically to the dmdev.ru / Pechkin proxy when neither is configured.

Plugin code: DMdev.Telegramnotice
Requires: OctoberCMS 4.x, PHP 8.0+
Author: Denis Mishin
License: MIT

Features

Component TelegramNotice renders a ready-to-use contact form on any page or layout.
Telegram: sends directly via Telegram Bot API when bot_token + chat_id are configured.
MAX: sends via MAX platform API (platform-api.max.ru) when max_bot_token + max_chat_id are configured.
Simultaneous delivery: if both Telegram and MAX are configured the message goes to both channels at once.
Pechkin fallback: if neither Telegram nor MAX is configured, the plugin uses the dmdev.ru/Pechkin proxy — works out of the box with zero configuration.
MAX does not support HTML — text is automatically converted to plain-text (<code>val</code> → «val», other tags stripped).
pechkin_secret is generated and persisted automatically if not provided.
Fallback uses canonical POST /api/v1/pechkin/sendMessage with Authorization: Bearer + X-Site-Name headers; base URL overrideable via DMDEV_API_BASE_URL env variable.
All settings managed in Backend → Settings → Telegram Notice (grouped by channel).
Two ready layouts included: a standalone form and a Bootstrap 5 modal form.
Errors are logged via the standard Laravel/October Log facade.

Installation

Via October plugin installer (recommended)

php artisan plugin:install Dmdev.Telegramnotice --from=https://github.com/mifasu/telegramnotice.git

Manual installation

cd plugins/dmdev
git clone https://github.com/mifasu/telegramnotice.git telegramnotice
php artisan october:up

Configuration

Open Backend → Settings → Telegram Notice and fill in the channels you want to use.

Telegram Bot API

Field	Description
`bot_token`	Telegram bot token, e.g. `123456:ABC-DEF…`
`chat_id`	Target Telegram chat/channel id, e.g. `-1001234567890` or `@channelname`

MAX Messenger Bot API

Field	Description
`max_bot_token`	MAX bot access token (find it in business.max.ru → Chat bots → Integration)
`max_chat_id`	Target MAX chat or channel ID (integer, e.g. `12345678`)

Note: MAX does not support HTML in message text. The plugin automatically converts HTML to plain-text before sending: <code>value</code> → «value», other tags are stripped, HTML entities are decoded.

Fallback (dmdev.ru / Pechkin)

Field	Description
`pechkin_secret`	Secret for the dmdev.ru fallback (auto-generated if left empty)

Routing logic:

Configured	Result
Telegram only	Sent to Telegram
MAX only	Sent to MAX
Telegram + MAX	Sent to both (success if at least one succeeds)
Neither	Sent via Pechkin fallback

The plugin always works even without any configuration — Pechkin fallback is used automatically.

Important: To use the Pechkin fallback you must contact the author at dmdev.ru to register your site token and link it to a destination chat or channel. Without registration the fallback will not deliver messages. DMDEV_API_BASE_URL env variable overrides the fallback base URL (default https://dmdev.ru).

Usage

1. Attach the component to a page or layout

title = "Contact"
url = "/contact"
layout = "default"

[telegramNotice]

2. Render the form

{% component 'telegramNotice' %}

Use the modal variant instead:

{% component 'telegramNotice' template="TelegramNotice::order-modal-form" %}

3. Component properties (optional)

Property	Default	Description
`btnName`	`Оставить заявку`	Submit button label
`sitename`	(auto-detected)	Legacy — site hostname for Pechkin URL
`token`	(from Settings)	Legacy — Pechkin token override

4. Accepted form fields

Field name	Description
`ph`, `phone`, `phone_number`, `contact`	Phone number (required, must be > 4 chars)
`name`, `nm`, `fullname`	Visitor name
`tag`	Optional label/tag appended to the message
`from`	Section or page label shown instead of `page.title`
`arr[]`	Array of extra values, one per line in the message

Logging

All send errors are written via Log::error(...) and Log::warning(...) using the application default log channel (typically storage/logs/system.log).

Migration from config file

If you previously used plugins/dmdev/telegramnotice/config/telegram.php, the plugin automatically migrates the values into Backend Settings on first boot (only if the Settings fields are still empty).

Troubleshooting

If php artisan plugin:install with an SSH URL prompts for a fingerprint, run ssh -T git@github.com and answer yes or use the HTTPS URL instead.
For private repos configure an SSH key on GitHub or use HTTPS with a Personal Access Token.
Ensure Plugin.php exists in the plugin root and updates/version.yaml is present.

Changelog

Version	Notes
1.2.1	Relax `composer/installers` constraint for compatibility with current OctoberCMS / Composer dependency trees.
1.2.0	Add MAX messenger support. New settings: `max_bot_token`, `max_chat_id`. Routing: Telegram if set, MAX if set, both simultaneously if both set, Pechkin fallback when neither is configured. MAX text is auto-converted from HTML to plain-text.
1.1.3	OctoberCMS 4.x compatibility. Fallback uses new canonical API v1 endpoint with Bearer auth. Clean imports, fix Settings model, remove sensitive debug log, standardise Log facade, fix HTML typo. Add LICENSE, marketplace-ready composer.json.
1.1.2	Fix direct Telegram API call (no URL-encoded token), persist `pechkin_secret`, return real send status, improve error handling.
1.1.1	Move all config to Backend Settings, remove physical config file, add settings migration.
1.1.0	Add direct Telegram Bot API support and `pechkin_secret` fallback.
1.0.3	Bug fixes and refactored send method.
1.0.2	Support `arr[]` multi-value fields.
1.0.1	Initial release.

License

MIT © Denis Mishin

Русский

Описание

Плагин TelegramNotice добавляет на сайт форму обратной связи и отправляет данные в Telegram, MAX мессенджер или в оба канала одновременно. Если ни один канал не настроен — отправка автоматически идёт через прокси-сервис dmdev.ru / Pechkin.

Установка

Через консоль OctoberCMS:

php artisan plugin:install Dmdev.Telegramnotice --from=https://github.com/mifasu/telegramnotice.git

Вручную:

cd plugins/dmdev
git clone https://github.com/mifasu/telegramnotice.git telegramnotice
php artisan october:up

Настройка

Откройте Панель управления → Настройки → Telegram Notice и заполните нужные поля.

Telegram Bot API

Поле	Описание
`bot_token`	Токен вашего Telegram-бота, например `123456:ABC-DEF…`
`chat_id`	ID целевого чата или канала, например `-1001234567890` или `@channelname`

Как получить токен: обратитесь к @BotFather в Telegram, создайте бота командой /newbot и скопируйте токен.

MAX Messenger Bot API

Поле	Описание
`max_bot_token`	Токен доступа вашего MAX-бота (находится в business.max.ru → Чат-боты → Интеграция)
`max_chat_id`	ID целевого чата или канала в MAX (целое число, например `12345678`)

Важно: MAX не поддерживает HTML-форматирование в тексте. Плагин автоматически конвертирует сообщение перед отправкой: <code>значение</code> превращается в «значение», остальные HTML-теги удаляются, HTML-сущности декодируются.

Резервный канал (dmdev.ru / Pechkin)

Поле	Описание
`pechkin_secret`	Секретный ключ для резервной отправки через dmdev.ru (генерируется автоматически, если не задан)

Для работы резервного канала необходимо связаться с автором плагина через сайт dmdev.ru. Автор должен зарегистрировать ваш сайт и привязать токен к нужному чату или каналу в Telegram или MAX. Без этой привязки резервная отправка работать не будет.

Логика маршрутизации

Что настроено	Результат
Только Telegram	Отправка в Telegram
Только MAX	Отправка в MAX
Telegram + MAX	Отправка одновременно в оба канала
Ничего не настроено	Отправка через резервный Pechkin (требует регистрации у автора)

Использование на странице

Подключите компонент на страницу или лейаут:

title = "Контакты"
url = "/contacts"
layout = "default"

[telegramNotice]

Отобразите форму в шаблоне:

{% component 'telegramNotice' %}

Модальный вариант:

{% component 'telegramNotice' template="TelegramNotice::order-modal-form" %}

Поля формы

Компонент принимает следующие поля:

Поле	Описание
`ph`, `phone`, `phone_number`, `contact`	Номер телефона (обязательное, должно содержать более 4 символов)
`name`, `nm`, `fullname`	Имя посетителя
`tag`	Произвольная метка, добавляется в конец сообщения
`from`	Название раздела или страницы (вместо `page.title`)
`arr[]`	Массив дополнительных значений, каждое с новой строки

Логирование

Все ошибки отправки записываются через стандартный Log::error() и Log::warning() в системный лог OctoberCMS (обычно storage/logs/system.log).

Миграция с файла конфигурации

Если ранее использовался файл plugins/dmdev/telegramnotice/config/telegram.php — при первом запуске плагин автоматически перенесёт значения из него в Backend Settings (только если поля ещё пусты).

Name		Name	Last commit message	Last commit date
Latest commit History 27 Commits
components		components
models		models
updates		updates
.gitignore		.gitignore
LICENSE.md		LICENSE.md
Plugin.php		Plugin.php
README.md		README.md
composer.json		composer.json

Folders and files

Latest commit

History

Repository files navigation

TelegramNotice — OctoberCMS Plugin

Features

Installation

Via October plugin installer (recommended)

Manual installation

Configuration

Telegram Bot API

MAX Messenger Bot API

Fallback (dmdev.ru / Pechkin)

Usage

1. Attach the component to a page or layout

2. Render the form

3. Component properties (optional)

4. Accepted form fields

Logging

Migration from config file

Troubleshooting

Changelog

License

Русский

Описание

Установка

Настройка

Telegram Bot API

MAX Messenger Bot API

Резервный канал (dmdev.ru / Pechkin)

Логика маршрутизации

Использование на странице

Поля формы

Логирование

Миграция с файла конфигурации

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages