=== Prodamus Gateway for WooCommerce ===
Contributors: prodamusplugin
Tags: prodamus, woocommerce, payment gateway, ecommerce, online payments
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.9
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Платежный шлюз для оплаты через Prodamus в WooCommerce.

== Description ==

**Платежный шлюз Prodamus для WooCommerce** требует установки плагина [WooCommerce](https://wordpress.org/plugins/woocommerce/). Он позволяет продавцам принимать онлайн-платежи через оплачиваемые страницы Prodamus.

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

* Перенаправление со страницы оформления заказа WooCommerce на платежную страницу Prodamus.
* Возврат на отдельную страницу неудачи, если платеж не был завершен.
* Возврат на отдельную страницу успеха с обратным отсчетом на время ожидания подтверждения.
* Подтверждение платежа только после проверки подписанного вебхука (HMAC).
* Автоматический опрос статуса заказа во время ожидания подтверждения вебхука.
* Поддержка `available_payment_method_groups`.
* Поддержка `installments_disabled`.
* Поддержка как классической оформления заказа, так и блоков оформления WooCommerce.
* Объявление совместимости с HPOS (высокопроизводительное хранение заказов).

Плагин не использует устаревшую логику переключения способов оплаты для каждого товара, что помогает избежать проблем совместимости с разными версиями WordPress и WooCommerce.

Использование внешнего сервиса (Prodamus):

* Плагин отправляет данные о заказе в Prodamus (ID заказа, товарные позиции, итоги, email/телефон клиента, URL-адреса возврата и вебхука).
* Передача данных используется только для создания и подтверждения платежных транзакций.
* Документация по интеграции:
  * PF 1.0: https://help.prodamus.ru/payform/integracii/cms/woocommerce
  * PF 2.0: https://help.prodamuspay.ru/kanaly-prodazh/integracii/cms/wordpress
* Сайт Prodamus: https://prodamus.ru/

Поддержка:

Для ускорения поддержки, пожалуйста, указывайте:

* Версии WordPress и WooCommerce.
* Версию плагина Prodamus.
* URL-адрес страницы оформления заказа.
* Детали ошибки и соответствующие логи вебхука/подписи.

Контакты поддержки:

* Телефон: 8 (495) 150-08-71
* Сообщения ВК: https://vk.com/im?sel=-11636316
* Email: sales@prodamus.ru
* MAX бот: https://max.ru/id1215156909_2_bot

== Installation ==

1. Установите и активируйте [WooCommerce](https://wordpress.org/plugins/woocommerce/).
2. Установите плагин из админки WordPress (`Плагины -> Добавить новый -> Загрузить плагин`) или распакуйте его в `/wp-content/plugins/prodamus`.
3. Активируйте **Платежный шлюз Prodamus для WooCommerce** в `/wp-admin/plugins.php`.
4. Перейдите в `WooCommerce -> Настройки -> Платежи -> Prodamus`.
5. Заполните обязательные настройки:
   * `URL-адрес платежной страницы`
   * `Секретный ключ`
6. При необходимости настройте дополнительные параметры (демо-режим, статус заказа после оплаты, группы способов оплаты, флаг рассрочки).

== Frequently Asked Questions ==

= Когда заказ отмечается как оплаченный? =

Заказ считается окончательно оплаченным только после успешной проверки подписи и подтверждения вебхука от Prodamus.

= Почему на странице успеха есть таймер? =

Таймер информирует покупателя, пока плагин ожидает подтверждения вебхука. После подтверждения покупатель перенаправляется на стандартную страницу получения заказа WooCommerce.

= Поддерживается ли оформление заказа через блоки WooCommerce? =

Да. Плагин регистрирует специальную интеграцию для оформления заказа на основе блоков.

= Можно ли установить этот плагин вместе со старым плагином wc-prodamus? =

Да. Эта версия использует изолированные идентификаторы и имена классов, чтобы избежать фатальных конфликтов при параллельной установке.

== Changelog ==

= 1.0.9 =
* Исправлены смешанные окончания строк в файле prodamus.php (предупреждение проверки плагина).

= 1.0.8 =
* Исправлена фатальная ошибка при активации, когда классы WooCommerce еще не были загружены.
* Проверка плагина: санитизация GET-параметров на странице статуса через filter_input, протестировано до версии 7.0.

= 1.0.7 =
* Проверка плагина: протестировано до WordPress 7.0, санитизация аргументов URL возврата, удален устаревший load_plugin_textdomain().

= 1.0.6 =
* Соответствие требованиям WordPress.org: заголовок Requires Plugins, load_plugin_textdomain, callback разрешений REST, исправления в readme.
* Удалены значения подписей из отладочных логов.
* Добавлены файлы index.php в поддиректории плагина.

= 1.0.5 =
* Исправлена загрузка скриптов таймера на странице успеха путем постановки ресурсов в очередь на wp_enqueue_scripts после регистрации.
* Уменьшено количество ненужных скриптов WooCommerce на размещенных страницах статуса.

= 1.0.4 =
* Замена встроенных тегов скриптов на wp_enqueue_script, wp_localize_script и wp_add_inline_script.
* Переименованы префиксы плагина в prodamusplugin для избежания конфликтов имен.
* Переименован вспомогательный класс HMAC в Prodamusplugin_Hmac.

= 1.0.3 =
* Добавлена защита от конфликтов при параллельной установке с устаревшим `wc-prodamus`.
* Улучшена поддержка WooCommerce Blocks и стабильность регистрации платежного метода.
* Обновлено поведение страницы успеха: обратный отсчет, проверки статуса и перенаправление после подтверждения.
* Добавлены параметры `available_payment_method_groups` и `installments_disabled`.
* Улучшена обработка URL-адресов платежей и генерация подписанных полезных данных.

= 1.0.0 =
* Первый публичный выпуск платежного плагина Prodamus для WooCommerce.
