Представляем наш новый продукт в эпоху, когда Telegram в России заблокирован, а польза ботов стала очевидна.
# 📬 send2form — Универсальная система обработки форм и уведомлений
**Версия:** 2.2
**Статус:** Production-ready
**Лицензия:** Коммерческая (распространяется через веб-студию TCSE)
---
## 🎯 Что такое send2form?
**send2form** — это готовое PHP-решение для организации обратной связи на сайте с мультиканальной доставкой уведомлений. Система объединяет в себе:
- 📝 **Обработку форм** с сайта (заявки, обратная связь, консультации)
- 📱 **Мультиканальную доставку** (MAX, Telegram, Email, CSV-архив)
- 🤖 **Вебхук-бота** для MAX с поддержкой команд и пересылки сообщений
- 📰 **RSS-агрегатор** с доставкой анонсов в личные сообщения MAX
- 🎨 **Встраиваемые виджеты** для любых сайтов (кнопка + модальное окно или встроенная форма)
- 📊 **Панель просмотра заявок** с защитой паролем
---
## 🔧 Что умеет send2form
### 1. 📝 Обработка форм (`order.php`)
| Функция | Описание |
|---------|----------|
| Приём данных | Принимает JSON с полями: `product`, `name`, `phone`, `email`, `message`, `link` |
| Валидация | Проверяет заполнение имени и телефона |
| Мультиканальная отправка | Отправляет уведомления одновременно в **MAX**, **Telegram**, **Email** |
| CSV-архив | Сохраняет все заявки в CSV-файл с автоматическим созданием папки |
| Гибкая настройка | Можно отключать любые каналы уведомлений через константы в коде |
**Куда отправляются заявки:**
- 📱 **MAX** — личные сообщения администратору (ID: `69325555`)
- ✈️ **Telegram** — в группу/канал (с поддержкой прокси для РФ)
- 📧 **Email** — на один или несколько адресов (HTML-письма)
- 💾 **CSV** — локальное хранение всех заявок на сервере
---
### 2. 🤖 Вебхук-бот для MAX (`max.php` + модули)
Бот работает через вебхук и обрабатывает команды пользователей:
| Команда | Описание |
|---------|----------|
| `/start` | Приветствие и список основных команд |
| `/help` | Полный список команд |
| `/myid` | Показывает User ID и Chat ID пользователя (для настройки) |
| `/info` | Информация о боте и версии |
| `/ping` | Проверка связи с ботом |
| `/max2email` | Включение режима пересылки сообщений на email |
| `/send` | Отправка накопленных сообщений из буфера |
| `/cancel` | Выход из режима пересылки |
| `/subscribe` | Подписка на RSS-анонсы |
| `/unsubscribe` | Отписка от RSS-анонсов |
| `/rss` | Статус RSS-подписки |
| `/rssadmin` | Список подписчиков (только админ) |
| `/rssrun` | Ручной запуск RSS-парсера (только админ) |
**Модульная архитектура:**
- `core.php` — базовые команды
- `email.php` — пересылка MAX→Email с буферизацией (3 минуты)
- `rss.php` — управление RSS-подписками
---
### 3. 📰 RSS-агрегатор (`rss2max.php`)
| Функция | Описание |
|---------|----------|
| Парсинг RSS | Читает RSS-ленты и извлекает новые записи |
| Очистка HTML | Удаляет картинки (заменяет на переносы строк), оставляет только текст и ссылки |
| Ограничение | Можно настроить максимальное количество записей за один запуск |
| Дедупликация | Хранит GUID уже отправленных записей, исключая дубли |
| Защита | Запуск только по паролю (`?pass=9876543210`) |
| CRON-готовность | Можно запускать автоматически через планировщик |
**Отправка:**
Все подписчики (`/subscribe`) получают анонсы в личные сообщения MAX.
---
### 4. 🎨 Встраиваемые виджеты
| Тип виджета | Описание |
|-------------|----------|
| **Кнопка + модальное окно** | Компактная кнопка, по клику открывается форма |
| **Встроенная форма** | Готовая HTML-форма для вставки в тело страницы |
| **Генератор кода** | Веб-интерфейс для настройки виджета (цвет, текст, тип) |
| **CORS-прокси** | Решает проблему отправки данных с внешних сайтов |
**Как использовать:**
Вставьте один скрипт на сайт — и форма готова к работе.
---
### 5. 📊 Панель просмотра заявок (`orders_views.php`)
| Функция | Описание |
|---------|----------|
| Авторизация | Доступ только по паролю (`iLoveTCSE`) |
| Таблица заявок | Отображение всех полей из CSV |
| Сортировка | По дате (сначала новые) |
| Пагинация | По 25 записей на страницу |
| Поиск | По всем полям таблицы |
| Экспорт CSV | Скачивание всех заявок одним файлом |
| Визуальная индикация | Статус MAX отображается цветом (OK/Fail) |
---
## 📁 Структура файлов
```
send2form/
├── order.php # Обработчик форм
├── rss2max.php # RSS-парсер с доставкой в MAX
├── orders_views.php # Панель просмотра заявок
├── webhook/
│ ├── max.php # Вебхук-обработчик MAX (маршрутизатор)
│ ├── modules/
│ │ └── max/
│ │ ├── core.php # Базовые команды бота
│ │ ├── email.php # Пересылка MAX→Email
│ │ └── rss.php # RSS-подписки
│ ├── data/
│ │ ├── subscribers.json # Список подписчиков RSS
│ │ └── last_guid_rss.txt # GUID отправленных записей
│ └── logs/
│ └── max_*.log # Логи вебхука
├── data/
│ └── order.csv # База заявок
├── logs/
│ └── rss2max.log # Логи RSS-парсера
├── widgets/
│ ├── generator.php # Генератор кода виджетов
│ ├── proxy.php # CORS-прокси
│ ├── widget.js # Скрипт виджета
│ └── .htaccess # Защита папки
└── form.html # Пример страницы с формой
```
---
## ⚙️ Быстрая настройка
### 1. Вставьте свои данные в `order.php`:
```php
const MAX_TOKEN = 'ваш_токен_бота_в_MAX';
const MAX_USER_ID = 'ваш_user_id';
const TG_TOKEN = 'ваш_токен_бота_в_Telegram';
const TG_CHATID = 'ID_группы_или_канала';
const EMAIL_TO = 'ваш_email@mail.ru';
```
### 2. Установите вебхук для MAX:
```bash
curl -X POST "https://platform-api.max.ru/subscriptions" \
-H "Authorization: ваш_токен" \
-H "Content-Type: application/json" \
-d '{
"url": "https://ваш-сайт.ru/webhook/max.php",
"events": ["message_created", "bot_added", "bot_started"]
}'
```
### 3. Настройте CRON для RSS-парсера:
```bash
*/30 * * * * php /путь/к/сайту/rss2max.php
```
---
## 🛠️ Технические требования
| Компонент | Минимальная версия |
|-----------|-------------------|
| PHP | 7.1+ (рекомендуется 7.4+) |
| cURL | Включен |
| JSON | Включен |
| SimpleXML | Включен (для RSS) |
| MySQL | Не требуется (данные в CSV) |
**Поддерживаемые хостинги:**
Мастерхост, Beget, Timeweb, Reg.ru и любые другие с поддержкой PHP и cURL.
---
## 📞 Поддержка
- Разработчик: **Веб-студия TCSE**
- Сайт: [tcse-cms.com](https://tcse-cms.com)
- Telegram: [@TCSEcmscom](https://t.me/TCSEcmscom)
---
## 📄 Лицензия
**Коммерческая лицензия.**
Скрипт предоставляется клиентам веб-студии TCSE в составе комплексных решений или как отдельный продукт. Бесплатная версия не распространяется.
Включает:
- ✅ Полный исходный код
- ✅ Установка и настройка (включена в стоимость)
- ✅ Техническая поддержка (3 месяца)
- ✅ Обновления в течение года
---
> **send2form** — это не просто форма обратной связи. Это полноценная система управления коммуникациями, которая объединяет сайт, мессенджеры и email в единую экосистему.