# ✅ jChat + Telegram - ГОТОВО К РАБОТЕ!
## 🎉 Плагин успешно установлен и работает!
Теперь вы получаете уведомления в Telegram о новых сообщениях в чате.
---
## 📋 Что было сделано:
### 1. Создан плагин jchat_tgnotify
- ✅ Полностью соответствует стандартам NGCMS
- ✅ Интеграция с jChat через хук
- ✅ Гибкие фильтры уведомлений
- ✅ Антифлуд защита
- ✅ Локализация на русском
### 2. Структура плагина:
```
engine/plugins/jchat_tgnotify/
├── jchat_tgnotify.php    # Основная логика
├── config.php            # Настройки в админке
├── install.php           # Установка
├── uninstall.php         # Удаление
├── version               # Метаданные
├── readme                # Описание
├── history               # История версий
├── SETUP_GUIDE.md        # Руководство
└── lang/russian/
    └── main.ini          # Локализация
```
### 3. Интеграция в jChat:
- Модифицирован `/engine/plugins/jchat/jchat.php`
- Добавлен вызов уведомлений после сохранения сообщения
---
## ⚙️ Текущие настройки (рекомендуемые):
| Параметр          | Значение    | Назначение                   |
| ----------------- | ----------- | ---------------------------- |
| **Включено**      | ✅ Да       | Уведомления активны          |
| **Bot Token**     | ✅ Настроен | Токен от @BotFather          |
| **Chat ID**       | ✅ Настроен | ID для уведомлений           |
| **Только гости**  | ⚙️ На выбор | Фильтр незарегистрированных  |
| **Только первое** | ✅ Да       | Одно уведомление за сессию   |
| **Антифлуд**      | 20 сек      | Интервал между уведомлениями |
**Изменить:** Админка → Плагины → jchat_tgnotify → Конфигурация
---
## 📱 Формат уведомления:
```
🟦 jChat: новое сообщение
👤 Автор: Гость123
🕒 Время: 2025-12-15 14:30:45
🌐 IP: 192.168.1.100
🔗 Страница: https://yoursite.ru/
💬 Здравствуйте, можно задать вопрос?
```
---
## 🔧 Управление фильтрами:
### "Только гости" - кому отправлять
- **ВКЛ** → Только от незарегистрированных пользователей
- **ВЫКЛ** → От всех (гости + зарегистрированные)
### "Только первое сообщение" - как часто
- **ВКЛ** → Одно уведомление за сессию от посетителя
- **ВЫКЛ** → Каждое сообщение (может быть много!)
### "Антифлуд" - интервал
- **0** → Без ограничений (не рекомендуется)
- **20-30** → Оптимально
- **60+** → Редкие уведомления
---
## 💡 Рекомендации:
### Для минимума уведомлений:
```
✅ Только гости: Да
✅ Только первое сообщение: Да
✅ Антифлуд: 30 секунд
```
### Для всех сообщений:
```
❌ Только гости: Нет
❌ Только первое сообщение: Нет
✅ Антифлуд: 10 секунд (защита от флуда)
```
### Для мониторинга новых посетителей:
```
✅ Только гости: Да
✅ Только первое сообщение: Да
✅ Антифлуд: 0 (выкл)
```
---
## 🛠️ Техническая информация:
### Как работает:
1. Посетитель пишет в jChat
2. jChat сохраняет в БД
3. Вызывается `jchat_tgnotify_send()`
4. Проверяются фильтры
5. Отправка через Telegram Bot API
6. Вы получаете уведомление
### API используемые:
- `extra_get_param()` - чтение настроек NGCMS
- `extra_set_param()` - сохранение настроек
- Telegram Bot API `sendMessage`
- PHP cURL или file_get_contents
### Требования:
- PHP 7.0+
- jChat установлен
- Интернет-соединение к api.telegram.org
---
## 🔄 Обновление плагина:
Если понадобится обновить:
1. Сделайте резервную копию настроек (Token, Chat ID)
2. Удалите плагин через админку
3. Установите новую версию
4. Введите настройки заново
---
## ❓ Часто задаваемые вопросы:
**Q: Можно ли отправлять в несколько чатов?**
A: Нет, только в один Chat ID. Но можно создать группу и добавить туда бота.
**Q: Как отключить уведомления временно?**
A: Настройки → Включить уведомления → Нет
**Q: Можно изменить текст уведомления?**
A: Да, отредактируйте функцию `jchat_tgnotify_send()` в файле `jchat_tgnotify.php`
**Q: Работает ли с несколькими сайтами?**
A: Да, создайте отдельного бота для каждого сайта.
---
## 📞 Поддержка:
При проблемах проверьте:
1. Плагин установлен и включен
2. Token и Chat ID правильные
3. Боту отправлен `/start` в Telegram
4. Сервер имеет доступ к api.telegram.org
5. Проверьте фильтры (могут блокировать)
---
**Автор:** GitHub Copilot
**Версия:** 1.0.0
**Дата:** 15.12.2025
**Лицензия:** MIT
---
🎯 **Плагин готов к использованию!** Приятной работы! 🚀
