=== WP Feedback to Telegram ===
Contributors: MyUkr.Biz
Tags: telegram, feedback, contact form, recaptcha, notifications
Requires at least: 5.0
Tested up to: 6.5
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Отправляет сообщения обратной связи с сайта WordPress в Telegram. Поддерживает Google reCAPTCHA, уведомления и логирование.

== Description ==

WP Feedback to Telegram - это мощный плагин для WordPress, который позволяет получать сообщения обратной связи с вашего сайта прямо в Telegram.

= Основные возможности =

* 📱 **Отправка в Telegram** - Мгновенная доставка сообщений в Telegram бот или группу
* 🛡️ **Google reCAPTCHA v3** - Защита от спама и ботов
* ⚙️ **Гибкая настройка** - Включение/отключение полей формы
* 📧 **Email уведомления** - Дублирование на email администратора
* 📊 **Логирование** - История всех сообщений
* 🎨 **Кастомизация** - Настройка формата сообщений
* ⚡ **AJAX отправка** - Без перезагрузки страницы
* 📱 **Адаптивный дизайн** - Работает на всех устройствах

= Как использовать =

1. Создайте бота через @BotFather в Telegram
2. Получите Bot Token и Chat ID
3. Настройте плагин в WordPress
4. Добавьте шорткод `[wpfbtg_form]` на любую страницу

= Настройка формы =

Вы можете настроить:
* Включение/отключение полей (имя, email, телефон)
* Обязательность полей
* Текст кнопки отправки
* Сообщение об успехе
* Формат сообщения в Telegram

= Безопасность =

* Проверка nonce для всех запросов
* Санитизация входных данных
* Google reCAPTCHA v3
* Защита от SQL инъекций и XSS

== Installation ==

= Автоматическая установка =

1. Войдите в админ-панель WordPress
2. Перейдите в "Плагины" → "Добавить новый"
3. Найдите "WP Feedback to Telegram"
4. Нажмите "Установить" и затем "Активировать"

= Ручная установка =

1. Загрузите папку плагина в `/wp-content/plugins/`
2. Активируйте плагин через меню "Плагины"
3. Перейдите в "Настройки" → "Feedback to Telegram"

= Настройка =

1. Создайте бота через @BotFather в Telegram
2. Получите Bot Token
3. Получите Chat ID через @userinfobot
4. Введите данные в настройках плагина
5. Нажмите "Проверить соединение"
6. Добавьте шорткод `[wpfbtg_form]` на страницу

== Frequently Asked Questions ==

= Как создать Telegram бота? =

1. Откройте Telegram и найдите @BotFather
2. Отправьте команду /newbot
3. Следуйте инструкциям
4. Скопируйте полученный токен

= Как получить Chat ID? =

Для личных сообщений используйте @userinfobot
Для групп используйте @getidsbot (ID начинается с минуса)

= Сообщения не приходят в Telegram =

1. Проверьте правильность Bot Token и Chat ID
2. Убедитесь, что бот не заблокирован
3. Для групп: сделайте бота администратором
4. Используйте кнопку "Проверить соединение"

= Как настроить reCAPTCHA? =

1. Зарегистрируйте сайт на google.com/recaptcha
2. Выберите reCAPTCHA v3
3. Скопируйте Site Key и Secret Key
4. Вставьте в настройки плагина

= Можно ли изменить дизайн формы? =

Да, вы можете добавить свой CSS или использовать параметр class в шорткоде:
`[wpfbtg_form class="my-custom-class"]`

== Screenshots ==

1. Форма обратной связи на сайте
2. Настройки Telegram
3. Настройки формы
4. Настройки reCAPTCHA
5. Логи сообщений
6. Сообщение в Telegram

== Changelog ==

= 1.0.0 - 2026-05-14 =
* Первый релиз
* Отправка сообщений в Telegram
* Поддержка Google reCAPTCHA v3
* Логирование сообщений
* Email уведомления администратору
* Гибкая настройка полей формы
* Кастомизация формата сообщений
* AJAX отправка без перезагрузки
* Адаптивный дизайн
* Статистика отправок

== Upgrade Notice ==

= 1.0.0 =
Первый релиз плагина.

== Additional Info ==

= Требования =
* WordPress 5.0+
* PHP 7.2+
* Telegram Bot Token
* SSL сертификат (рекомендуется)

= Поддержка =
Если у вас возникли вопросы, проверьте:
* Логи в настройках плагина
* Консоль браузера на ошибки JavaScript
* Правильность Bot Token и Chat ID

= Конфиденциальность =
Плагин не собирает и не передает данные третьим лицам, кроме:
* Telegram API (для отправки сообщений)
* Google reCAPTCHA (если включено)

Все данные хранятся локально в базе данных WordPress.
