GamiPress Points Cards - WordPress Plugin

Руководство по настройке и применению GamiPress Points Cards

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

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

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

Как Points Cards меняет обычную систему баллов

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

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

Это важно понимать до настройки, потому что продукт не является универсальной системой купонов WooCommerce и не заменяет полноценную кассовую программу. Он связывает внутренние баллы GamiPress с внешней проверкой карты. Если на сайте нет понятной экономики баллов, пользователи не понимают, за что получают очки, а администратор не контролирует балансы, Points Cards только вынесет эту путаницу наружу.

Что происходит при генерации карты

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

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

Где в цепочке участвуют коммерсанты

Коммерсант в документации GamiPress - это связанная точка или участник, который может принимать карты. Зарегистрированный пользователь сайта может подать заявку через форму Commerce Area. Администратор рассматривает заявку и вручную принимает или отклоняет её. После одобрения коммерсант получает код, появляется в каталоге Commerces и может погашать карты через QR-сканирование или ручной ввод кода.

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

Кому подойдёт такой формат, а кому лучше выбрать другой инструмент

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

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

Не стоит начинать с Points Cards, если нужна обычная скидка в корзине WooCommerce, автоматическая программа лояльности интернет-магазина или денежная выплата баллов. Для скидок по заказам лучше смотреть на WooCommerce-ориентированные решения. Для выплат внутри GamiPress есть другой add-on - Points Payouts. Для обмена между типами баллов есть Points Exchanges. Points Cards сильнее именно там, где нужна проверяемая карта с кодом или QR-кодом и возможным участием физической точки погашения.

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

Перед установкой add-on нужно проверить не только факт наличия WordPress. Points Cards зависит от того, насколько аккуратно уже настроен GamiPress. Если типы баллов ещё не созданы, правила начисления не работают, а пользователи не получают баланс, форма генерации карты не решит проблему. Она будет выводить интерфейс, но бизнес-смысл карты останется пустым.

Базовая экономика баллов

Начните с типа баллов. В GamiPress можно создавать разные типы, например credits, coins или gems. В документации подчёркнуто, что slug типа баллов используется для внутренних ссылок и атрибутов шорткодов. Поэтому до внедрения карт важно зафиксировать slug и не менять его без необходимости. Если вы вставите в форму генерации несуществующий slug, пользователь не сможет корректно вывести нужный баланс. Для администратора slug - это технический идентификатор, а не просто подпись в интерфейсе.

Проверьте, что у тестового пользователя есть баллы выбранного типа. Лучше не начинать с администратора: создайте обычного пользователя, начислите ему баллы штатным способом или вручную через инструменты GamiPress, затем откройте страницу генерации именно под этой ролью. Так вы заранее увидите, не мешают ли права доступа, кеш, шаблон страницы или ограничения входа.

Страницы, которые должны существовать

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

Быстрая проверка опубликованных страниц

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

• Страница истории должна содержать [gamipress_points_cards_history] и показывать карты текущего пользователя.
• Страница погашения должна содержать [gamipress_redeem_points_card], потому что QR-код ведёт именно к ней.
• Commerce Area должна содержать [gamipress_points_cards_commerce_area], если вы используете заявки и личную область коммерсантов.
• Страница Commerces должна содержать [gamipress_points_cards_commerces], если пользователю нужно видеть список точек погашения.

Требования для QR-кодов

QR-коды зависят от двух вещей: должна быть настроена страница погашения, а на сервере должна быть активна библиотека PHP GD. Без этого карта может существовать, но QR-код не появится или не будет генерироваться. В документации также указано, что QR-коды хранятся в каталоге загрузок WordPress, обычно внутри /wp-content/uploads/gamipress-points-cards/.

Проверка перед запуском: если QR-код не отображается на деталях карты, не начинайте с переустановки плагина. Сначала проверьте страницу погашения в настройках Points Cards, наличие PHP GD и права записи в папку загрузок.

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

Установка проходит как у обычного WordPress-плагина: загрузка ZIP-архива через Plugins, установка, затем Activate. Так как это add-on к GamiPress, сначала должен быть установлен и активен основной GamiPress. Не стоит тестировать Points Cards на рабочей программе лояльности без резервной копии: карта меняет баланс пользователя и создаёт записи, которые потом придётся чистить вручную, если сценарий был пробным.

После активации не переходите сразу к дизайну страниц. Сначала проверьте, появились ли пункты и настройки add-on. Документация указывает путь к настройкам через GamiPress -> Settings -> Add-ons, а экран управления картами находится в меню GamiPress -> Points Cards. Если этих пунктов нет, проверьте активность основного GamiPress, права текущего администратора и отсутствие фатальных ошибок в журнале сайта.

Минимальный тест установки

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

Мини-итог этого этапа: после установки вы должны видеть настройки, страницы должны быть опубликованы, пользователь должен иметь возможность создать карту, а администратор - увидеть её в списке. Если это не работает, переход к срокам действия, коммерсантам и QR-кодам только усложнит диагностику.

Настройка страниц, сроков и режима коммерсантов

Раздел настроек Points Cards отвечает за то, как карта живёт после генерации. Здесь важно не включать всё подряд. Настройка должна повторять реальный процесс на вашем сайте: где пользователь смотрит историю, где коммерсант вводит код, кто может погашать карту, нужен ли каталог точек и должен ли у карты быть срок действия.

Назначение страниц в настройках add-on

На странице настроек проверьте четыре связки. Первая - Points Cards History Page. Она нужна пользователю, чтобы видеть свои карты и открывать детали. Вторая - Points Cards Redemption Page. Она критична для QR-кодов и ручного погашения. Третья - Commerce Area Page, личная область коммерсанта и форма заявки. Четвёртая - Commerces Page, каталог одобренных коммерсантов.

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

Срок действия карт

В настройках есть параметр Enable Points Cards Expiration. После включения появляются поля для количества и периода: часы, дни, недели, месяцы или годы. Документация отдельно уточняет, что карты, созданные до включения этой функции, не получают срок действия задним числом. Это важное ограничение: если вы решили включить сроки после тестов, старые карты не станут автоматически просроченными.

Когда включать expiration

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

Отключение коммерсантов

Опция Disable Commerces отключает функцию коммерсантов. В этом режиме коммерсанты исчезают из интерфейса, а карта может быть погашена без кода коммерсанта. Это хороший стартовый вариант для небольшого сайта, где карту проверяет один администратор или сотрудник. Меньше сущностей - меньше ошибок: не нужно одобрять заявки, вести каталог, объяснять партнёрам их личную область.

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

Письма и текст для пользователя

Points Cards отправляет пользователю письмо с кодом карты, а документация указывает, что письмо настраивается в email settings add-on. Проверьте тему, текст, наличие кода, понятность инструкции и доставляемость. Хорошее письмо отвечает на три вопроса: что это за карта, где её показать или ввести, когда она перестанет работать, если срок включён.

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

Форма генерации карты: fixed, custom и options

Форма [gamipress_points_card_generator] - центральная точка пользовательского сценария. Она может быть выведена шорткодом, блоком или виджетом. Документация описывает общие атрибуты: points_type, select_points_type, amount_type и button_text. От значения amount_type зависит, насколько свободно пользователь выбирает сумму.

Фиксированная сумма

Режим fixed показывает форму с заданной суммой без возможности изменить её. Это лучший вариант для простых кампаний: например, один бонусный сертификат на определённое количество баллов. Пользователь не думает о правилах, а администратор получает одинаковые карты, которые проще проверять.

[gamipress_points_card_generator points_type="credits" amount_type="fixed" amount="100" button_text="Generate Card"]

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

Произвольная сумма

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

[gamipress_points_card_generator points_type="credits" amount_type="custom" initial_amount="100" button_text="Generate Card"]

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

Готовые варианты суммы

Режим options позволяет предложить несколько сумм, а при allow_user_input="yes" добавить пользовательский ввод. Это хорошая середина между контролем и гибкостью: администратор задаёт понятные пороги, а пользователь не теряется в произвольных значениях.

[gamipress_points_card_generator points_type="credits" amount_type="options" options="50,100,250" allow_user_input="yes" initial_amount="100" button_text="Generate Card"]

Для публичной страницы чаще всего удобнее options-режим. Он помогает объяснить ценность карты: маленькая сумма для теста, средняя сумма для обычной награды, крупная сумма для редкого бонуса. Если у вас несколько типов баллов, используйте select_points_type только после того, как у пользователя действительно есть смысл выбирать между ними. Иначе форма станет сложнее, а число ошибок возрастёт.

Commerce Area и список точек погашения

Функция коммерсантов превращает Points Cards из простой формы погашения в мини-систему партнёрских точек. Через [gamipress_points_cards_commerce_area] пользователь, который ещё не является коммерсантом, видит форму заявки. После одобрения он получает доступ к области коммерсанта и может погашать карты. Через [gamipress_points_cards_commerces] можно вывести каталог одобренных точек.

Эта часть важна именно для GamiPress Points Cards, потому что без неё карта остаётся внутренним кодом сайта. С коммерсантами появляется операционная модель: кто принимает карту, как пользователь выбирает точку, какие контактные данные видны и как администратор контролирует заявки.

Как настроить область коммерсанта

Создайте или проверьте страницу Commerce Area и убедитесь, что она содержит нужный шорткод. После этого подайте тестовую заявку от обычного пользователя. Не используйте администратора как единственный тест: администратор может видеть больше, чем будущий партнёр. В админ-панели найдите заявку, примите её и снова откройте страницу под этим пользователем.

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

Каталог Commerces

Шорткод [gamipress_points_cards_commerces] выводит список коммерсантов. Документация описывает атрибуты columns, additional_fields, search, load_more, limit, orderby и order. Для небольшого списка достаточно одной колонки и поиска. Для большого списка лучше оставить загрузку дополнительных записей и не выводить слишком много карточек сразу.

[gamipress_points_cards_commerces columns="2" additional_fields="yes" search="yes" load_more="yes" limit="10" orderby="name" order="ASC"]

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

Практический пример: карта на бонус в офлайн-точке

Разберём сценарий для обучающего клуба. Участники получают credits за прохождение уроков и активность в сообществе. Администратор хочет, чтобы участник мог вывести часть credits в карту и показать её на стойке клуба, а сотрудник клуба погасил карту через страницу WordPress. Это не абстрактная демонстрация: здесь задействованы основные функции продукта - генератор, письмо, QR или ручной код, страница погашения, история и статус карты.

Цель

Нужно получить страницу «Получить бонусную карту», где участник создаёт карту на заданное количество credits, получает письмо с кодом, а сотрудник проверяет карту на странице погашения. После погашения участник видит карту в истории, а администратор видит статус в списке Points Cards.

Подготовка

• В GamiPress создан тип баллов со slug credits.
• У тестового пользователя есть баланс credits, достаточный для генерации карты.
• Страница погашения назначена в настройках Points Cards и содержит [gamipress_redeem_points_card].
• Письма GamiPress отправляются с сайта и не попадают сразу в спам.
• Если нужен QR-код, на сервере активна PHP GD.

Шаги

1. Создайте страницу для пользователя, например «Получить бонусную карту».
2. Добавьте короткое объяснение правила: сколько credits будет вынесено в карту и где её можно погасить.
3. Вставьте генератор с фиксированной суммой или вариантами суммы. Для первого запуска проще fixed или options.
4. Сохраните страницу и откройте её в приватном окне под тестовым пользователем.
5. Сгенерируйте карту, дождитесь письма и запишите код.
6. Откройте страницу погашения как сотрудник или коммерсант и введите код карты, если QR не используется.
7. Проверьте статус карты в GamiPress -> Points Cards и историю пользователя.

Ожидаемый результат и нюанс

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

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

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

Мини-проверка результата: не считайте тест успешным только потому, что письмо пришло. Обязательно проверьте полный цикл: генерация, запись в админ-панели, код или QR, погашение, статус, история пользователя и поведение при повторном вводе того же кода.

Практичные идеи применения Points Cards

Points Cards раскрывается лучше всего там, где у баллов есть действие после сайта. Ниже не общие «идеи для вовлечения», а рабочие сценарии, которые опираются на подтверждённые возможности: карты с кодом, QR-коды, коммерсанты, каталог точек, история и срок действия.

Клубная программа с физической стойкой

Участники получают баллы за посещения, комментарии, прохождение материалов или участие в событиях. Раз в определённый период они выводят часть баллов в карту и показывают её на стойке клуба. Для такого сценария лучше использовать fixed или options-режим, чтобы сотруднику было проще понимать номиналы.

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

Партнёрская сеть для локальных точек

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

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

Учебные задания с очным подтверждением

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

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

Проверка результата на сайте и в админ-панели

После настройки важно проверить не только пользовательскую страницу, но и административные записи. Управление картами находится в меню GamiPress -> Points Cards. В списке должны быть номер карты, код, количество баллов, пользователь, статус, дата, коммерсант при включённой функции и дата погашения. Эти поля помогают быстро понять, где остановился процесс.

Проверка со стороны пользователя

Пользователь должен видеть страницу генерации, понятный текст правила, корректный баланс и подтверждение после создания карты. После этого карта должна отображаться в истории через [gamipress_points_cards_history]. Документация указывает, что при клике по View Details детали карты показываются без перехода на новую страницу. На своём сайте проверьте, что тема не ломает это поведение и что всплывающие или раскрывающиеся детали видны на типовых экранах.

Проверка со стороны коммерсанта

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

Проверка со стороны администратора

Администратор должен уметь быстро ответить на вопрос «что случилось с картой». Для этого откройте детали карты и проверьте статус. Если карта не погашена, доступны действия по генерации нового кода и повторной отправке письма. В документации отдельно отмечено, что генерация нового кода меняет QR-код. Поэтому не используйте это действие как обычную «обновить страницу»: оно меняет идентификатор карты и может запутать пользователя, если старое письмо уже отправлено.

Безопасная адаптация внешнего вида без правки плагина

У Points Cards есть документированные шорткоды и блоки, но в открытых источниках не подтверждены специальные хуки или шаблонные файлы именно для безопасной глубокой переделки вывода карт. Поэтому в руководстве лучше не выдумывать PHP API. Для небольшой визуальной адаптации используйте безопасную внешнюю обёртку страницы и CSS в дочерней теме или через Appearance -> Customize -> Additional CSS, если ваша тема поддерживает этот раздел.

Задача примера - сделать блок генерации карты заметнее и добавить пространство вокруг поясняющего текста. Мы не трогаем файлы GamiPress и не меняем логику списания баллов. Основание для такого подхода - обычная CSS-практика WordPress и документированный факт, что форму можно выводить шорткодом на странице.

<div class="points-card-campaign">
  <p>Выведите часть credits в карту и покажите код на стойке клуба.</p>
  [gamipress_points_card_generator points_type="credits" amount_type="options" options="50,100,250" allow_user_input="no" button_text="Generate Card"]
</div>

.points-card-campaign {
  max-width: 720px;
  padding: 24px;
  border: 1px solid #d9e2ef;
  border-radius: 8px;
  background: #f8fbff;
}

.points-card-campaign p {
  margin-top: 0;
  font-weight: 600;
}

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

Диагностика: почему карта, QR-код или погашение не работают

Проблемы Points Cards чаще связаны не с установкой ZIP-файла, а с разрывом в цепочке: пользовательская форма, письмо, страница погашения, QR, статус карты, коммерсант и кеш страницы. Начинайте диагностику с места, где цепочка остановилась, а не с полной переустановки.

Форма генерации не появляется на странице

Симптом: вместо формы виден текст шорткода или пустой блок. Возможная причина - шорткод вставлен в место, где WordPress не обрабатывает шорткоды, add-on не активен, основной GamiPress выключен или блок кэшируется как старый HTML.

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

Пользователь не может создать карту

Симптом: форма видна, но карта не создаётся или пользователь получает ошибку. Проверьте slug в points_type, баланс пользователя, режим суммы и права доступа. Частая ошибка - скопировать пример credits, хотя на сайте тип баллов называется иначе. Slug типа баллов берётся из настроек GamiPress Points Types, а не из красивого названия в интерфейсе.

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

Письмо с кодом не приходит

Симптом: карта создаётся и видна в админ-панели, но пользователь не получает письмо. Это уже не обязательно проблема Points Cards. Проверьте общую отправку писем WordPress, адрес отправителя, папку спама и настройки email-шаблона add-on. Отправьте тест на внешний почтовый ящик, а не только на адрес администратора домена.

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

QR-код не отображается

Симптом: карта создана, но QR отсутствует в деталях или письме. Документация указывает два обязательных условия: настроенная Points Cards Redemption Page и активная PHP GD library на сервере. Также QR-коды хранятся в папке /wp-content/uploads/gamipress-points-cards/, поэтому права записи в загрузки тоже важны.

Что проверить до регенерации QR

Проверьте назначение страницы погашения, наличие шорткода [gamipress_redeem_points_card] и поддержку GD на хостинге. Если домен или страница погашения менялись, документация рекомендует удалить папку QR-кодов в uploads, чтобы Points Cards сгенерировал их заново. Делайте это только после резервной копии и не удаляйте другие папки загрузок.

Карта уже погашена или просрочена

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

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

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

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

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

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