GamiPress Referrals - WordPress Plugin

Руководство по настройке GamiPress Referrals для реферальных наград в WordPress

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

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

В статье не будет инструкций по покупке, активации лицензии или обходу ограничений. Фокус здесь другой: как безопасно встроить реферальный сценарий в реальную страницу WordPress, показать пользователю его ссылку, настроить награды и диагностировать типичные сбои.

Какую задачу решает реферальная надстройка

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

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

Важно разделить два сценария. Первый - реферальная геймификация, где награда выражается в баллах, достижениях или рангах. Второй - полноценная партнёрская программа с выплатами, модерацией заявок, налоговой логикой, рекламными материалами и отдельным кабинетом партнёра. GamiPress Referrals подходит прежде всего для первого сценария. Он может учитывать продажи через WooCommerce или Easy Digital Downloads, но его ценность остаётся в связи с наградами GamiPress, а не в замене специализированной партнёрской системы.

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

Документация add-on перечисляет несколько групп событий. Базовые события относятся к визитам и регистрациям: получение реферального визита, визит на конкретную запись, регистрация нового пользователя по реферальной ссылке и регистрация пользователя через приглашение. Для магазинов добавляются события продаж и возвратов, если сайт использует WooCommerce или Easy Digital Downloads.

На практике это означает, что администратор может не ограничиваться одним начислением за регистрацию. Можно построить разные уровни мотивации:

• Баллы за первый реферальный визит, если нужно поощрять распространение ссылок.
• Более ценная награда за регистрацию, потому что это уже конверсия, а не просто переход.
• Отдельное достижение за серию регистраций, если в GamiPress настроены шаги достижения.
• Комиссия в баллах за покупку, если магазинная интеграция действительно используется и проверена на тестовом заказе.

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

Кому GamiPress Referrals подходит, а где лучше выбрать другой инструмент

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

Хорошие кандидаты для add-on:

• Образовательные сайты, где участники приглашают однокурсников и получают прогресс в системе баллов.
• Комьюнити и клубы, где важно растить активную базу зарегистрированных пользователей.
• Магазины на WooCommerce или Easy Digital Downloads, если покупка по приглашению должна превращаться в очки или достижение.
• Контентные проекты с закрытыми разделами, где реферальные действия можно связать с рангами или бейджами.
• Сайты, где нужен простой способ показать пользователю его реферальную ссылку через шорткод, блок или виджет.

Не стоит начинать с GamiPress Referrals, если вам нужна бухгалтерская партнёрская программа с выплатами, заявками партнёров, рекламными материалами, купонным отслеживанием, отчётами по доходу и правилами комиссий для разных партнёров. Для этого логичнее смотреть в сторону специализированных решений вроде AffiliateWP или SliceWP. Они решают другую задачу: управление партнёрами и комиссиями. GamiPress Referrals решает задачу наград внутри геймифицированной системы WordPress.

Практическое правило: если результатом приглашения должны быть баллы, достижение или ранг внутри GamiPress, add-on уместен. Если результатом должна быть денежная выплата партнёру и отчётность по продажам, лучше сравнить отдельные affiliate-плагины.

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

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

Базовая готовность GamiPress

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

Минимальный набор перед подключением:

• Есть хотя бы один тип баллов, который будет использоваться для реферальных наград.
• Понятно, где администратор создаёт awards, deducts, steps или rank requirements.
• Журнал GamiPress показывает тестовые начисления по обычным событиям.
• На сайте есть страница, где пользователь сможет увидеть баланс или историю заработка.

Регистрация и роли пользователей

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

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

Кеш, cookie и тестовые браузеры

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

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

Установка и первичная проверка без лишнего риска

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

Порядок безопасного первого запуска

1. Сделайте резервную копию сайта или хотя бы базы данных перед установкой на рабочем проекте.
2. Убедитесь, что базовый GamiPress активен и его разделы доступны администратору.
3. Активируйте GamiPress Referrals через Plugins.
4. Перейдите в настройки GamiPress и откройте вкладку add-ons, где обычно находятся параметры надстроек.
5. Проверьте, что в правилах GamiPress появились события, связанные с referral visit, referral sign up и, если установлены магазинные плагины, referral sale.
6. Создайте временную тестовую награду за простое событие, например за реферальный визит или регистрацию.

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

Как понять, что add-on действительно подключился

Есть три быстрых признака. Первый - доступны шорткоды Referrals, например [gamipress_affiliate_id], [gamipress_referral_url], [gamipress_referrals_count] и [gamipress_referral_url_generator]. Второй - в настройках GamiPress появился блок конфигурации URL-схемы для реферальных ссылок. Третий - в списке событий для awards, steps или rank requirements доступны реферальные события.

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

Настройка реферальной ссылки, блока участника и URL-генератора

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

Где выводить реферальные элементы

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

Документация add-on указывает, что элементы можно выводить через шорткоды и виджеты. Для современного редактора можно использовать страницу с обычным блоком Shortcode и вставить нужные шорткоды в читаемом порядке:

<h3>Ваша реферальная ссылка</h3>
<p>Ваш ID: [gamipress_affiliate_id]</p>
<p>Готовая ссылка: [gamipress_referral_url]</p>
<p>Приглашений: [gamipress_referrals_count]</p>
[gamipress_referral_url_generator]

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

Как использовать [gamipress_referral_url]

Шорткод [gamipress_referral_url] может вывести реферальную ссылку для текущей страницы или добавить реферальный код к заданному URL через атрибут url. В документации также указаны параметры current_user и user_id, которые помогают управлять тем, чей код добавляется к ссылке. Для обычной страницы личного кабинета чаще всего достаточно текущего пользователя.

Если нужно направлять приглашённых не на текущую страницу, а на конкретную посадочную страницу, используйте вариант с URL:

[gamipress_referral_url url="https://example.com/start/"]

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

Зачем нужен генератор referral URL

Генератор [gamipress_referral_url_generator] полезен, когда пользователь должен делиться не одной общей ссылкой, а разными страницами сайта: товаром, записью блога, страницей курса, каталогом или акцией. Вместо ручного копирования и добавления параметра пользователь вставляет URL в генератор и получает готовую реферальную ссылку со своим affiliate ID.

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

Мини-проверка после размещения

• Обычный авторизованный пользователь видит свой affiliate ID и готовую ссылку.
• Неавторизованный посетитель не видит чужой идентификатор в личном блоке.
• Генератор принимает корректный URL страницы сайта и возвращает ссылку с реферальным параметром.
• При неправильном URL пользователь получает понятное сообщение, а не пустой блок.

Как связать реферальные события с баллами, достижениями и рангами

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

Ступенчатая логика наград

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

Типовой набор правил может выглядеть так:

Внутри GamiPress эти события можно использовать в points awards, steps и rank requirements. Поэтому одна и та же реферальная механика может работать как простое начисление баллов, как шаг к бейджу или как условие для повышения ранга.

Настройка комиссии в баллах для WooCommerce

Если на сайте установлен WooCommerce, документация GamiPress Referrals описывает автоматическое подключение магазинной интеграции. Она добавляет события продаж и возвратов, а также блок Referrals - Sale Commissions на экране редактирования типа баллов. В этом блоке администратор задаёт процент комиссии, который будет начисляться affiliate-пользователю в баллах.

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

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

Easy Digital Downloads: логика похожа, проверка своя

Демо-страница GamiPress показывает сценарий для Easy Digital Downloads: пользователь берёт referral URL, другой пользователь регистрируется по ссылке, совершает покупку, а у приглашавшего увеличивается счётчик продаж и появляется запись о начислении в user earnings. Для реального сайта важны те же контрольные точки, что и в WooCommerce, но путь покупки, статусы и страницы аккаунта отличаются.

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

Практический сценарий: страница участника с приглашением друзей

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

Цель и подготовка

Цель сценария - не просто вывести красивую ссылку, а доказать, что она проходит весь путь до события GamiPress. Для подготовки нужны активный GamiPress, GamiPress Referrals, тестовый тип баллов и обычная регистрация WordPress или регистрация через ваш рабочий плагин.

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

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

1. Создайте страницу, например invite-friends, и ограничьте её видимость только для авторизованных пользователей, если на сайте есть такая возможность.
2. Добавьте заголовок и короткое объяснение правил: за что начисляется награда и когда она появляется.
3. Вставьте шорткоды [gamipress_affiliate_id], [gamipress_referral_url], [gamipress_referrals_count] и [gamipress_referral_url_generator].
4. В GamiPress создайте тестовую награду за событие, связанное с referral sign up.
5. Сохраните страницу и откройте её под тестовым пользователем referrer.
6. Скопируйте реферальную ссылку, откройте её в другом браузере и зарегистрируйте нового пользователя.
7. Вернитесь в админ-панель и проверьте журнал GamiPress или user earnings у referrer.

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

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

Проверка результата: не считайте сценарий рабочим, пока не увидите не только красивую ссылку, но и запись в user earnings или журнале GamiPress. Визуальный блок на странице и фактическое начисление - разные уровни проверки.

Нюанс, который часто мешает тесту

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

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

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

Обучающий сайт или курс

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

Комьюнити и форум

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

Магазин с внутренними очками

Для магазина на WooCommerce или Easy Digital Downloads интереснее не просто регистрация, а покупка по приглашению. Здесь GamiPress Referrals связывает продажу с баллами, которые затем можно использовать в вашей общей системе мотивации. Перед запуском продумайте экономику: сколько баллов выдаётся, можно ли их тратить на скидки, что происходит при возврате заказа и не создаёт ли схема слишком дорогую цепочку скидок.

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

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

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

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

Контрольный маршрут тестирования

1. Откройте страницу участника под обычным пользователем и скопируйте реферальную ссылку.
2. Перейдите по ссылке в другом браузере, где нет авторизации на сайте.
3. Зарегистрируйте нового пользователя или выполните тестовую покупку, если проверяется магазинный сценарий.
4. Вернитесь в админ-панель и проверьте запись в журнале GamiPress или user earnings.
5. Откройте страницу участника снова и убедитесь, что счётчик изменился, если вы его выводите.
6. Если проверяете продажу, выполните тестовый возврат и посмотрите, отозвались ли баллы согласно документации интеграции.

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

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

Для администратора полезно завести короткий тестовый чек-лист и повторять его после обновления GamiPress, Referrals, WooCommerce, EDD, формы регистрации или кеширующего плагина. Реферальная механика затрагивает сразу несколько частей сайта, поэтому поломка часто появляется после обновления не самого add-on, а соседнего элемента.

GDPR, cookie и безопасное изменение срока отслеживания

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

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

Когда менять срок жизни cookie

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

Ниже пример на основе документированного фильтра. Его можно добавить через безопасный плагин для snippets или в файл functions.php дочерней темы. Не правьте файлы GamiPress или add-on напрямую.

function my_prefix_custom_referrals_cookie_lifetime( $lifetime, $affiliate_id, $referral_id, $affiliate ) {
    // Устанавливает срок отслеживания примерно на месяц.
    return strtotime( '+1 month' );
}
add_filter( 'gamipress_referrals_cookie_lifetime', 'my_prefix_custom_referrals_cookie_lifetime', 10, 4 );

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

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

Производительность, приватность и поддерживаемость

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

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

Совместимость с темой и конструкторами

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

Для длинных ссылок можно использовать безопасную CSS-правку темы. Она не зависит от внутреннего API add-on и только помогает ссылке переноситься в пределах контейнера:

.entry-content .gamipress-referral-url,
 .entry-content .gamipress-referral-url-generator {
    overflow-wrap: anywhere;
    word-break: break-word;
}

Код добавляйте в настройках дополнительного CSS темы или в дочерней теме. После вставки откройте страницу участника на мобильной ширине и проверьте, что ссылка не ломает макет. Для отката удалите CSS и очистите кеш стилей.

Что не стоит автоматизировать без проверки

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

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

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

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

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

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