GamiPress Points Payouts - WordPress Plugin

Руководство по настройке GamiPress Points Payouts для вывода баллов в деньги

GamiPress Points Payouts нужен не для обычного начисления баллов, а для более ответственного сценария: пользователь накопил баллы в системе GamiPress и хочет отправить заявку на денежную выплату по заранее заданному курсу. В этом руководстве разберём, как подготовить балльную экономику, включить выплаты для нужного типа баллов, настроить курс, ограничения, страницу истории, форму заявки и ручную обработку выплат в админ-панели WordPress.

Главная сложность здесь не в установке add-on, а в контроле логики: сколько баллов можно вывести, как пользователь указывает способ оплаты, где администратор видит заявки, когда баллы возвращаются при возврате и как не перепутать Points Payouts с покупкой баллов, обменом баллов или оплатой заказов. Поэтому материал построен как практическая инструкция, а не как повтор карточки продукта.

По ходу руководства будут отдельные проверки результата, пример внедрения на сайте сообщества, идеи применения для разных типов проектов, блок диагностики и сравнение с близкими решениями. Если вы только планируете использовать выплаты, начните с разделов про подготовку и ограничения. Если add-on уже установлен, переходите к настройке типов баллов, формы и истории заявок.

Какую задачу решает add-on в системе GamiPress

В базовой логике GamiPress баллы работают как внутренняя валюта мотивации: сайт начисляет их за действия, прогресс, покупки, участие в сообществе или другие события, а пользователь видит баланс. GamiPress Points Payouts добавляет к этой модели слой вывода: администратор разрешает вывод для выбранного типа баллов, задаёт курс конвертации в валюту и показывает пользователю форму заявки.

Ключевая идея продукта - не автоматическая отправка денег, а управляемая заявка на выплату. По официальной документации администратор видит историю заявок, может отклонить заявку, отметить её как оплаченную или вернуть оплаченную заявку с восстановлением баллов пользователю. Это важно понимать до запуска: финансовое действие, проверка реквизитов и фактический перевод денег остаются в зоне ответственности владельца сайта и выбранного им платёжного процесса.

Points Payouts хорошо ложится на сайты, где баллы уже имеют понятную ценность. Например, авторы получают баллы за публикации, участники сообщества - за активность, партнёры - за полезные действия, а владелец сайта хочет дать им возможность обменять часть накопленного баланса на выплату. Для магазина или обучающей платформы это может быть мотивационный слой, но он должен быть просчитан экономически: курс вывода, минимальная сумма, максимальная сумма и ручная проверка заявок здесь не второстепенные детали, а основа безопасности.

При этом add-on не заменяет WooCommerce-платёжный шлюз, систему партнёрских начислений, банковский сервис или бухгалтерский модуль. Он работает внутри GamiPress и управляет именно заявками на вывод баллов. Если вам нужно, чтобы баллы списывались при покупке товара, смотрите в сторону WooCommerce Points Gateway или Partial Payments. Если нужна покупка баллов пользователем, это другая ветка GamiPress. Если нужен обмен одного типа баллов на другой, это уже Points Exchanges.

Кому подходит такой сценарий

GamiPress Points Payouts уместен там, где сайт уже умеет честно начислять баллы и владелец готов вручную контролировать вывод. Хорошие кандидаты: закрытые сообщества, образовательные порталы, контентные проекты с вознаграждением авторов, сайты с заданиями, клубы, локальные программы лояльности и проекты, где баллы выдаются за проверяемое участие.

Особенно полезен add-on, если нужно разделить мотивацию и финансы. Пользователь видит понятную форму вывода, но администратор сохраняет контроль: заявка попадает в историю, сумма считается по курсу, статус меняется после проверки, а спорную выплату можно отклонить или вернуть.

Когда лучше не начинать с Points Payouts

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

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

Что проверить перед установкой и включением выплат

Подготовка к GamiPress Points Payouts начинается не с кнопки Upload Plugin, а с проверки уже работающей системы GamiPress. Add-on опирается на типы баллов, шорткоды, блоки, виджеты и админские экраны GamiPress, поэтому сначала убедитесь, что базовый плагин установлен, активен и корректно начисляет баллы выбранным пользователям.

Первый объект проверки - тип баллов. В GamiPress можно создавать несколько кошельков, например Credits, Gems или Coins. Для выплат это не просто название: каждый тип баллов может получить отдельный курс, отдельные лимиты и отдельную логику допуска. Если на сайте есть баллы для статуса и баллы с денежной ценностью, вывод включайте только для второго типа. Не делайте вывод доступным для каждого типа баллов автоматически, пока не понимаете экономику каждого кошелька.

Второй объект - правила начисления. Если баллы выдаются за действия, которые легко накрутить, сначала настройте ограничения, модерацию или более строгие события начисления. Points Payouts не должен становиться способом монетизировать случайные баллы, полученные через тестовые действия, массовые комментарии или некорректно настроенные интеграции.

Чек-лист перед установкой

• Проверьте, что базовый GamiPress активен и типы баллов уже созданы.
• Убедитесь, что баланс тестового пользователя меняется ожидаемо после начисления и списания баллов.
• Решите, какие типы баллов можно выводить, а какие нужны только для рангов, бейджей или доступа к функциям.
• Подготовьте текст правил вывода: минимальная сумма, период проверки, допустимый способ получения денег, причины отклонения.
• Проверьте роли администраторов и редакторов: доступ к финансовым заявкам должен быть только у тех, кто реально обрабатывает выплаты.
• Настройте доставку писем WordPress через надёжный почтовый механизм, если будете полагаться на уведомления о новых заявках.

Как выбрать курс до первой заявки

Документация Points Payouts показывает простую модель: администратор задаёт, сколько баллов соответствует одной денежной единице, а сумма заявки считается по этому соотношению. В примере с курсом 100 баллов к 1 денежной единице заявка на 1000 баллов превращается в 10 денежных единиц. В реальном проекте курс лучше считать от экономики сайта, а не от красивой цифры.

Сначала оцените, сколько баллов средний пользователь может набрать за обычную активность. Затем посчитайте, сколько выплат сайт выдержит без ущерба. После этого задайте минимальный вывод так, чтобы администратор не тратил время на микрозаявки, и максимальный вывод так, чтобы крупная заявка не обходила ручную проверку. Для старта часто разумнее поставить более строгие лимиты, протестировать месяц работы и только потом смягчать правила.

Установка и первичная проверка в WordPress

GamiPress Points Payouts относится к add-on для GamiPress. Общая схема установки такая же, как у других WordPress-плагинов: перейти в админ-панель, открыть Plugins, выбрать Add New, загрузить ZIP-архив через Upload Plugin, установить и активировать. Не нужно реализовывать авторизацию внутри проекта или менять файлы ядра WordPress.

После активации проверьте не публичную форму, а наличие новых настроек в админке. В документации указано, что параметры Points Payout находятся в меню GamiPress -> Settings -> вкладка Add-ons, а настройки выплат для конкретного типа баллов появляются на экране редактирования этого points type. Это два разных уровня: общий add-on управляет историей, валютным форматом и текстом способа оплаты, а экран типа баллов управляет разрешением вывода, курсом и лимитами.

Мини-проверка после активации

1. Откройте GamiPress и убедитесь, что существующие типы баллов видны без ошибок.
2. Перейдите к редактированию тестового типа баллов и найдите метабокс с настройками Points Payouts.
3. Откройте GamiPress -> Settings -> Add-ons и найдите общие параметры Points Payout.
4. Проверьте, появилась ли страница истории заявок, которую add-on может создать автоматически при установке.
5. Создайте или выберите тестового пользователя с ненулевым балансом, чтобы позже проверить форму вывода.

Если на этом этапе нет настроек add-on, не переходите к созданию формы. Сначала проверьте, активен ли базовый GamiPress, корректно ли установлен ZIP-файл add-on, нет ли критической ошибки в журнале WordPress и не скрыт ли нужный экран правами текущей роли администратора.

Настройка курса, минимальной и максимальной суммы вывода

Самая важная часть настройки находится не только в общих параметрах add-on, а на экране каждого типа баллов. Там появляется отдельный блок, где можно разрешить вывод, указать курс обмена и задать минимальную или максимальную сумму одной заявки. Такой подход удобен: один тип баллов можно использовать для денег, другой - оставить только для бейджей, уровней или доступа.

Разрешение вывода для конкретного типа баллов

Параметр Allow Points Payout включает возможность отправлять заявки на выплату именно для этого points type. Если он выключен, пользователь может продолжать копить баллы, но форма вывода не должна принимать этот тип баллов как доступный для денежного обмена. Это хороший способ отделить условные статусные очки от баллов с финансовым смыслом.

Включайте вывод только после проверки начислений. Если баллы выдаются автоматически за действия в WooCommerce, LMS, форуме или сообществе, сначала протестируйте, как они начисляются и списываются. Любая ошибка в начислении будет усиливаться выплатами: пользователь увидит не просто лишний баланс, а потенциальную сумму к выводу.

Курс обмена

Параметр Exchange Conversion задаёт отношение баллов к валюте. В документации описан пример, где 100 баллов соответствуют 1 денежной единице, а 1000 баллов дают сумму 10. Смысл настройки простой, но последствия серьёзные: курс определяет, как сайт переводит внутреннюю активность в реальный денежный эквивалент.

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

Минимальная и максимальная сумма

Минимальный лимит защищает администратора от микрозаявок. Если оставить его равным нулю, ограничение не применяется. Это удобно для теста, но на живом сайте чаще лучше задать нижний порог. Максимальный лимит ограничивает размер одной заявки; значение ноль означает отсутствие верхней границы. Для сайта с денежным выводом отсутствие максимума может быть рискованным, особенно если начисления зависят от автоматических действий.

Сначала поставьте понятные рамки: минимум должен быть достижимым для активного пользователя, а максимум - достаточно низким, чтобы крупные балансы проходили несколькими проверяемыми заявками или через отдельное согласование. Если правила выплат опубликованы на сайте, синхронизируйте их с этими настройками, чтобы пользователь не видел одно обещание в тексте и другое поведение в форме.

Таблица первичных настроек

Эта таблица помогает быстро понять, что проверять после включения выплат для points type.

После сохранения настроек не ограничивайтесь визуальной проверкой формы. Проверьте расчёт денег, статус заявки, баланс пользователя и запись в истории. Именно связка «настройка -> заявка -> история -> статус» показывает, что GamiPress Points Payouts работает корректно.

Форма вывода, история выплат и виджеты на публичной части сайта

Пользователь взаимодействует с add-on через форму заявки на вывод и историю своих заявок. Документация указывает два ключевых шорткода: [gamipress_points_payout] для формы вывода и [gamipress_points_payout_history] для истории. Также add-on поддерживает размещение через блоки и виджеты, поэтому форму можно встроить в страницу, запись или боковую область темы.

Где размещать форму

Лучшее место для формы - не случайная запись, а отдельная служебная страница личного кабинета, профиля участника или раздела наград. Пользователь должен понимать контекст: сколько у него баллов, какие правила вывода действуют, какой способ оплаты нужно указать и где потом смотреть статус. Если форма размещена без пояснений, часть заявок будет ошибочной: пользователи будут вводить неполные реквизиты, путать типы баллов или отправлять суммы, которые администратор всё равно отклонит.

Практичный вариант - сделать одну страницу «Вывод баллов» и расположить на ней три блока: краткие правила, форму [gamipress_points_payout] и ссылку на историю выплат. Если тема поддерживает редактор блоков, используйте блок шорткода или официальный блок add-on. Если сайт использует классический редактор, вставьте шорткод в содержимое страницы.

Как использовать страницу истории

В общих настройках Points Payout есть параметр Points Payout History Page. Он указывает страницу, где текущий пользователь видит историю заявок и детали. Документация также отмечает, что при установке add-on может автоматически создать страницу с заголовком Points Payout History и шорткодом [gamipress_points_payout_history] в содержимом.

Не оставляйте эту страницу без проверки. Откройте её от имени обычного пользователя, убедитесь, что история показывает именно его заявки, а не служебную админскую информацию, и добавьте понятную ссылку с формы вывода на страницу истории. Если на сайте есть личный кабинет, разместите ссылку в меню аккаунта или в навигации профиля.

Текст способа оплаты

Общий параметр Payment method text отвечает за подпись поля, где пользователь указывает способ получения денег. По умолчанию используется Payment Method, но документация приводит примеры вроде PayPal Email, Payment Email или Bank account. Для русскоязычного сайта лучше не оставлять абстрактную подпись, а объяснить, что именно требуется: адрес PayPal, платёжный email, банковские реквизиты или другой согласованный канал.

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

Валютный формат

В настройках add-on можно задать валюту, позицию символа, разделитель тысяч, десятичный разделитель и количество знаков после запятой. Эти параметры не меняют бизнес-логику начисления баллов, но влияют на доверие пользователя к расчёту. Если на сайте русскоязычная аудитория, проверьте, как сумма выглядит в форме, истории и админке: не перепутаны ли точки и запятые, не появляется ли лишняя дробная часть, не выглядит ли валюта как тестовый формат.

Проверка результата: создайте заявку на тестовую сумму, откройте её в истории пользователя и в админской истории. Денежная сумма должна выглядеть одинаково понятно в обоих местах.

Как администратор обрабатывает заявки на выплаты

После отправки формы заявка попадает в админский экран GamiPress -> Points Payout History. Там видны номер заявки, пользователь, количество баллов, денежная сумма по курсу, статус, дата и действия. Это рабочий центр администратора: именно здесь становится понятно, какие заявки ожидают проверки, какие уже отмечены как оплаченные, какие отклонены и какие нужно вернуть.

Статусы и действия

На уровне деталей заявки администратор видит пользователя, баллы, денежную сумму, статус и дату. Документация описывает действия в зависимости от текущего статуса: когда заявка ожидает обработки, её можно отклонить или отметить как оплаченную; когда заявка уже оплачена, её можно вернуть, и баллы пользователя будут восстановлены.

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

Порядок проверки заявки

Что сверить до фактической оплаты

1. Откройте заявку в Points Payout History и проверьте пользователя, сумму баллов и денежный эквивалент.
2. Сравните сумму с правилами сайта: минимальный порог, максимальный порог, допустимый способ выплаты.
3. Проверьте поле способа оплаты и убедитесь, что реквизиты полные и относятся к пользователю.
4. При необходимости проверьте недавнюю историю начислений GamiPress, чтобы исключить тестовые или ошибочные баллы.
5. Выполните фактическую выплату вне WordPress тем способом, который принят на вашем сайте.
6. После подтверждения отметьте заявку как оплаченную или отклоните её с внутренней пометкой в своей системе поддержки.

Как не потерять связь между заявкой и реальным переводом

Points Payouts не должен быть единственным местом финансового контроля, если сайт работает с реальными деньгами. Ведите отдельную внутреннюю запись выплат, особенно если у вас несколько администраторов. Это может быть таблица, CRM, бухгалтерский сервис или тикет в поддержке. Главное - чтобы статус в GamiPress совпадал с реальным действием.

Уведомления о новых заявках

В настройках писем Points Payouts есть блок Points Payouts: New payout request email. Там можно отключить письма о новых заявках, изменить тему и содержимое письма. Поле темы поддерживает те же теги, что и содержимое письма, поэтому уведомление можно сделать более информативным для администратора.

Если выплаты обрабатываются вручную, уведомление лучше оставить включённым, но не полагаться только на него. Почта WordPress может задерживаться или попадать в спам, особенно без SMTP-настройки. Сделайте регулярную проверку экрана Points Payout History частью административного процесса, а письмо используйте как дополнительный сигнал.

Практический пример: страница вывода баллов для сообщества авторов

Представим сайт, где авторы получают баллы за опубликованные материалы и проверенную активность. Владелец хочет разрешить вывод только баллов Credits, показать форму в личном кабинете и обрабатывать заявки вручную после проверки качества публикаций. Это типовой сценарий для GamiPress Points Payouts: есть накопленный баланс, понятный курс, публичная форма и админская проверка.

Цель

Нужно получить рабочую страницу, где автор видит правила, отправляет заявку на вывод Credits, указывает платёжный email и затем отслеживает статус в истории. Администратор должен увидеть заявку в Points Payout History, проверить реквизиты и отметить её как оплаченную только после фактического перевода.

Подготовка

• В GamiPress уже создан тип баллов Credits.
• У тестового автора есть баланс выше минимального порога.
• Правила начисления Credits проверены и не выдают баллы за случайные действия.
• Администратор заранее решил курс обмена и лимиты одной заявки.
• На сайте есть страница личного кабинета или отдельная страница для вывода баллов.

Шаги настройки

1. Откройте тип баллов Credits и включите Allow Points Payout.
2. Задайте курс в Exchange Conversion. Сразу проверьте расчёт на простой тестовой сумме, чтобы администраторы одинаково понимали формулу.
3. Заполните Minimum Amount и Maximum Amount. Минимум защищает от мелких заявок, максимум - от слишком крупных выплат без отдельной проверки.
4. В GamiPress -> Settings -> Add-ons выберите страницу истории выплат и настройте валютный формат.
5. Измените Payment method text так, чтобы автор понял, какой email или реквизит указывать.
6. Создайте страницу «Вывод баллов» и вставьте форму через [gamipress_points_payout].
7. На странице истории разместите [gamipress_points_payout_history] или проверьте автоматически созданную страницу.
8. От имени тестового автора отправьте заявку, затем откройте админский экран Points Payout History.

Проверка результата

После отправки заявки пользователь должен увидеть её в истории, а администратор - в админском списке. Денежная сумма должна соответствовать курсу, статус должен показывать, что заявка ожидает обработки, а поле способа оплаты должно содержать понятные данные. После отметки заявки как оплаченной проверьте, что статус изменился. Если используете действие возврата для оплаченной заявки, проверьте восстановление баллов у пользователя.

Нюанс, который часто ломает первый тест

Если форма видна, но заявка не отправляется или сумма не проходит проверку, сначала смотрите не на тему WordPress, а на настройки типа баллов. Вывод должен быть разрешён именно для того points type, который выбирает пользователь, а сумма должна попадать между минимальным и максимальным порогом. Второй частый источник путаницы - пользователь тестирует форму без достаточного баланса.

Практичные идеи применения Points Payouts на разных типах сайтов

Выплаты баллов имеют смысл только тогда, когда пользователь понимает, за что он получает ценность, а администратор может проверить основание выплаты. Ниже не универсальный список «где пригодится», а несколько сценариев, которые опираются на подтверждённые функции add-on: вывод выбранного типа баллов, курс, лимиты, форма, история и ручная обработка статусов.

Сообщество авторов

Авторы получают Credits за опубликованные материалы, редакторскую помощь или принятые правки. Points Payouts показывает форму вывода, а администратор проверяет, нет ли спорных начислений перед оплатой. В таком сценарии особенно важен минимальный порог: он уменьшает количество мелких заявок и даёт редактору время проверить качество работы.

Ожидаемый результат - автор видит понятный путь от активности к заявке, а редакция не ведёт выплаты вручную в переписке. Проверка проста: тестовый автор должен отправить заявку, увидеть её в истории, а администратор должен найти её в общем списке.

Обучающий портал

На образовательном сайте баллы могут начисляться за прохождение уроков, участие в обсуждениях или помощь другим участникам. Вывод лучше включать не для всех баллов, а для отдельного типа, который отражает проверенный вклад. Так статусные очки, бейджи и прогресс остаются мотивацией, а денежная ценность появляется только у контролируемого кошелька.

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

Клуб или закрытое сообщество

В клубе баллы можно выдавать за полезные действия: участие в мероприятиях, ответы новичкам, модерацию или экспертные материалы. Points Payouts помогает превратить эти баллы в контролируемый запрос на вознаграждение, но правила должны быть опубликованы заранее. Если участники не понимают, почему одни баллы можно вывести, а другие нет, поддержка быстро перегружается вопросами.

Для такого сайта полезно сделать страницу «Правила и вывод баллов»: сверху объяснить условия, ниже поставить форму, ещё ниже - ссылку на историю. Это снижает количество неверных заявок и делает процесс прозрачнее.

Партнёрские задания без сложной партнёрской системы

Если сайт выдаёт баллы за простые проверяемые задания, Points Payouts может закрыть базовый процесс запроса выплаты. Но если нужны комиссии, холд, многоуровневые партнёрские связи, автоматические выплаты и налоговые документы, одного add-on будет мало. В таком случае лучше рассматривать специализированную партнёрскую систему, а GamiPress оставить для мотивации внутри сайта.

Проверка результата, безопасность процесса и аккуратная доработка внешнего вида

После настройки важно проверить весь путь, а не только видимость формы. Рабочий результат выглядит так: пользователь с достаточным балансом может отправить заявку, сумма считается по курсу, заявка появляется в истории пользователя, администратор видит её в Points Payout History, статус меняется после действия администратора, а при возврате баллы восстанавливаются. Если любой элемент цепочки не работает, запуск на живую аудиторию лучше отложить.

Контрольный тест перед публикацией страницы

Тест от имени обычного пользователя

1. Создайте тестового пользователя с обычной ролью, не администратором.
2. Начислите ему достаточно баллов выбранного типа.
3. Откройте страницу формы в режиме этого пользователя и отправьте заявку на сумму внутри лимитов.
4. Проверьте пользовательскую историю через [gamipress_points_payout_history].
5. Откройте админскую историю и сравните пользователя, баллы, сумму, способ оплаты и статус.
6. Отметьте тестовую заявку как оплаченную, затем при необходимости проверьте сценарий возврата на отдельной тестовой заявке.
7. Проверьте письмо о новой заявке, если уведомления включены.

Что считать успешным тестом

Не проводите первый тест на реальном пользователе с реальной выплатой. Тестовая заявка должна быть понятной для всех администраторов, чтобы её не обработали как настоящую. Если на сайте несколько ответственных, заранее договоритесь, как помечать тесты.

Совместимость с темой, кешем и редактором

Форма и история выводятся на публичной части сайта, поэтому на них влияет тема, редактор, CSS контейнеров, виджеты и кеш. Если страница построена конструктором, сначала вставьте шорткод в обычный текстовый или shortcode-блок и проверьте без дополнительных анимаций. Если сайт использует агрессивную оптимизацию скриптов, исключите страницу вывода из спорных оптимизаций только при реальном конфликте, а не заранее.

Кеш страницы для личного кабинета и финансовых форм требует осторожности. Страница с персональной историей должна показывать данные текущего пользователя. Если на сайте есть полный кеш для авторизованных пользователей, проверьте, что история не смешивается между аккаунтами. При малейшем сомнении страницу формы и истории лучше исключить из кеша на уровне кеш-плагина.

Безопасная CSS-доработка формы без правки плагина

Если нужно визуально отделить форму вывода от остального контента, не правьте файлы GamiPress или add-on. Оберните шорткод в собственный контейнер на странице и добавьте CSS через Appearance -> Customize -> Additional CSS или через дочернюю тему. Это безопасная внешняя правка: она не зависит от внутренних PHP-хуков и легко откатывается.

<div class="points-payout-box">
  [gamipress_points_payout]
</div>

.points-payout-box {
  border: 1px solid #d7dee8;
  border-radius: 8px;
  padding: 24px;
  background: #ffffff;
}

.points-payout-box input,
.points-payout-box select,
.points-payout-box textarea {
  max-width: 100%;
}

После добавления CSS откройте страницу на настольном экране и на мобильной ширине. Поля не должны выходить за контейнер, кнопка должна оставаться видимой, а сообщения формы не должны сливаться с фоном. Чтобы откатить правку, удалите контейнер или CSS-блок. Это изменение влияет только на внешний вид страницы, а не на расчёт баллов, статусы заявок или финансовую логику.

Если форма вывода или история выплат работают неправильно

Диагностика GamiPress Points Payouts должна идти по цепочке: тип баллов, форма, баланс пользователя, лимиты, история, админский статус, почта. Если начать с темы или кеша, можно потратить время на внешний симптом и пропустить ошибку в главной настройке.

Форма видна, но пользователь не может отправить заявку

Симптом: страница открывается, но заявка не проходит, тип баллов недоступен или сумма отклоняется. Возможная причина - вывод не включён для выбранного points type, баланс пользователя ниже суммы заявки, сумма не попадает в минимальный или максимальный лимит, либо пользователь тестирует не тот тип баллов.

Проверьте экран редактирования типа баллов: включён ли Allow Points Payout, правильно ли задан курс и лимиты. Затем проверьте баланс конкретного пользователя. Если проблема возникла после изменения правил, временно верните предыдущие лимиты и повторите тест на отдельной заявке.

Денежная сумма выглядит неправильно

Симптом: пользователь ожидает одну сумму, а форма или история показывает другую. Чаще всего причина в неверно понятом Exchange Conversion или в форматировании валюты. Проверьте курс на простой сумме, например на 100, 1000 или другой удобной величине, и вручную пересчитайте результат.

Если расчёт правильный, но выглядит странно, откройте общие настройки add-on и проверьте валюту, позицию символа, разделители и количество десятичных знаков. Не меняйте курс, если проблема только в отображении валюты.

История заявок не показывает данные пользователя

Симптом: пользователь отправил заявку, но не видит её на странице истории. Проверьте, что на странице истории есть [gamipress_points_payout_history], а в настройках Points Payout выбрана правильная Points Payout History Page. Если страница была создана автоматически, убедитесь, что она опубликована и доступна текущей роли пользователя.

Если сайт использует кеш для авторизованных пользователей, временно отключите кеш для страницы истории и повторите тест. История выплат - персональная зона, поэтому кеширование здесь должно быть настроено осторожно.

Администратор не получает письмо о новой заявке

Симптом: заявка есть в админской истории, но письмо не пришло. Сначала проверьте блок Points Payouts: New payout request email: не включено ли отключение писем, заполнены ли тема и содержимое. Затем проверьте общую доставку писем WordPress через тестовое письмо или SMTP-плагин.

Если письма нестабильны, не откладывайте обработку заявок до исправления почты. Сделайте ручную проверку Points Payout History регулярной задачей администратора, а почтовую доставку настройте отдельно.

После оплаты нужно отменить выплату

Симптом: заявка уже отмечена как оплаченная, но выплату нужно вернуть или исправить. Документация описывает действие возврата для оплаченной заявки, при котором баллы пользователя восстанавливаются. Используйте штатное действие, а не ручное начисление баллов в другом разделе, чтобы история статусов оставалась понятной.

Если возврат связан с ошибкой фактического платежа вне WordPress, сначала зафиксируйте это во внутренней системе выплат, затем обновите статус заявки. Так администраторы не потеряют связь между реальным переводом и записью GamiPress.

Когда GamiPress Points Payouts будет удачным выбором

GamiPress Points Payouts стоит использовать, когда на сайте уже есть продуманная балльная система, понятные правила начисления и готовность вручную проверять заявки на выплаты. Add-on хорошо закрывает связку «баллы -> заявка -> история -> админский статус», но не снимает с владельца сайта ответственность за финансовые правила, реквизиты, фактическую оплату и поддержку пользователей.

Перед запуском на реальную аудиторию пройдите полный тест: настройте отдельный points type, включите вывод, задайте курс и лимиты, разместите форму, проверьте историю, обработайте тестовую заявку и убедитесь, что администратор понимает каждый статус. Если этот путь работает без путаницы, можно получить версию для WordPress и внедрять add-on на рабочем сайте поэтапно.

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