GamiPress Time based Rewards - WordPress Plugin

Руководство по настройке и применению GamiPress Time based Rewards

GamiPress Time based Rewards нужен не для обычного одноразового бейджа, а для повторяемой награды, которую пользователь может забрать после заданного интервала ожидания. В этом руководстве разберём, как встроить такой сценарий в уже существующую систему GamiPress: что подготовить до установки, какие поля проверить после активации, как настроить правила выдачи, где вывести награду на сайте и как понять, что claim-процесс работает корректно.

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

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

Какую задачу решает повторяемая награда по времени

В базовом GamiPress награды часто привязаны к действию: регистрация, комментарий, покупка, прохождение урока, получение достижения или другой триггер. Time based Rewards добавляет другой тип мотивации - пользователь возвращается к конкретному reward-блоку и забирает награду после истечения интервала. Поэтому продукт особенно полезен там, где важно не просто выдать баллы за событие, а создать привычку регулярного возвращения.

Механика строится вокруг трёх элементов. Сначала администратор создаёт объект time-based reward как отдельную сущность в админ-панели. Затем задаёт recurrence - промежуток, который пользователь должен подождать перед следующей выдачей. После этого настраивает список возможных наград: points, achievement или rank из уже созданных типов GamiPress. На публичной части сайта пользователь видит счётчик, кнопку получения и сообщение о результате.

Важная тонкость: recurrence не означает конкретное время суток. Это именно интервал между доступными claim-действиями. Если в поле указано 2:30:00, логика продукта работает как ожидание в два часа тридцать минут между выдачами, а не как ежедневная выдача в фиксированное время. Первый отсчёт официальная документация связывает с датой публикации reward-объекта, поэтому для тестирования удобно публиковать награду осознанно, а не создавать её задолго до проверки.

Главная проверка смысла: если вам нужна цепочка дней, календарь входов, штраф за пропуск или визуальная сетка ежедневных наград, смотрите в сторону Daily Login Rewards. Если нужна одна или несколько повторяемых наград с собственным таймером claim, подходит Time based Rewards.

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

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

Подходящие случаи

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

• Сайт уже использует GamiPress и имеет настроенные типы points, achievement или rank.
• Пользователи авторизуются, потому что гостевой visitor не сможет корректно накапливать персональные reward-результаты.
• Награда не должна быть слишком ценной, иначе случайная выдача и частый claim быстро нарушат баланс.
• На сайте есть место, где таймер логично видеть регулярно: личный кабинет, страница сообщества, dashboard курса, sidebar или отдельная страница бонусов.

Когда Time based Rewards может не подойти

Если вам нужна строгая программа лояльности с покупками, купонами, кошельком, сложными транзакциями и финансовой логикой, одного time-based блока будет мало. Если задача - награждать за конкретные действия пользователя, лучше сначала настроить обычные события GamiPress или интеграцию с нужным плагином. Если нужен календарь с последовательными днями и наказанием за пропуск, Time based Rewards не заменяет Daily Login Rewards.

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

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

Перед установкой важно проверить не только техническую совместимость WordPress, но и логическую готовность системы наград. Time based Rewards расширяет GamiPress, поэтому в одиночку он не заменяет базовую структуру points, achievements и ranks. Если базовые типы не созданы, в настройке reward-блока придётся выбирать из пустого или неподготовленного набора.

Минимальная подготовка в GamiPress

Сначала откройте админ-панель и убедитесь, что базовый GamiPress активен. Затем проверьте, какие reward-типы уже существуют. Для простого старта достаточно одного points type, например внутренние credits или bonus points. Achievement и rank можно подключать позже, когда вы поймёте, как пользователи реагируют на повторяемую награду.

1. Проверьте, что в меню GamiPress есть разделы для points types, achievement types и rank types.
2. Создайте или выберите один points type, который можно безопасно выдавать часто.
3. Если хотите выдавать achievement, заранее создайте achievement type и сам achievement.
4. Если хотите выдавать rank, заранее настройте rank type и убедитесь, что логика повышения ранга не конфликтует с основной progression-системой.
5. Подготовьте тестового пользователя без прав администратора, чтобы увидеть публичную часть так, как её видит реальный участник.

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

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

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

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

Установка add-on выполняется стандартным способом для WordPress-плагина: через загрузку ZIP-файла в Plugins - Add New - Upload Plugin, затем активацию. После активации не начинайте сразу настраивать публичную страницу. Сначала убедитесь, что в меню GamiPress появился пункт Time-based Rewards, а в общих настройках GamiPress появилась секция add-on.

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

Порядок проверки после активации

1. Откройте GamiPress в левом меню WordPress и найдите подпункт Time-based Rewards.
2. Перейдите в GamiPress - Settings - Add-ons и проверьте, что есть настройки Time-based Rewards.
3. Создайте тестовую награду с коротким заголовком и понятным описанием.
4. Не добавляйте сразу много reward-вариантов. Для первого запуска достаточно одного points reward с фиксированным количеством.
5. Опубликуйте reward и откройте страницу вывода от имени тестового пользователя.

Если на этом этапе всё видно в админ-панели, но на публичной странице пусто, вероятнее всего, проблема не в установке, а в способе вывода. Тогда переходите к разделу про shortcode, block и widget, а затем к диагностике.

Настройки add-on: тексты, slug и публичность reward-страниц

Глобальные настройки Time based Rewards находятся в GamiPress - Settings - Add-ons. Эти параметры задают поведение по умолчанию, но часть текстов можно переопределить в отдельной reward-записи. Практический подход простой: сначала настройте базовые тексты для всего сайта, затем меняйте их только у отдельных reward, где нужен другой смысл.

Тексты, которые видит пользователь

В настройках есть несколько текстовых полей, влияющих на восприятие механики. Claim Button Text задаёт текст кнопки. Next Reward Text объясняет ожидание до следующего claim. Guest Message показывает гостю, что нужно войти в аккаунт. Pop-up Content отвечает за сообщение после успешного получения награды, а No Rewards Content пригодится, если при claim не оказалось доступной награды.

Не стоит оставлять технические или слишком общие формулировки, если аудитория русскоязычная. Кнопка может быть короткой: Получить бонус, Забрать награду или Открыть награду. Текст ожидания лучше сделать объясняющим: Следующая награда будет доступна через:. Сообщение для гостя должно не просто говорить о входе, а объяснять причину: награда привязана к профилю пользователя.

Post type: когда делать reward публичной страницей

В настройках post type есть Slug, Public и Supports. Параметр Public особенно важен. Если он включён, отдельный reward может иметь свою публичную страницу. Если выключен, reward удобно показывать только через shortcode, block или widget. Для большинства сайтов безопаснее начинать с непубличного режима и выводить награду в заранее подготовленном месте.

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

Разделитель тысяч и читаемость наград

Поле Thousands separator влияет на отображение больших количеств reward-значений. Это мелкая настройка, но она важна для сайтов с крупными points-балансами. Если у вас русскоязычная аудитория, заранее решите, какой формат чисел будет понятнее в интерфейсе. Главное - не менять формат после запуска без причины, потому что пользователь привыкает к одному виду баланса.

Создание time-based reward: recurrence, тексты и набор наград

Отдельная time-based reward настраивается похоже на WordPress-запись: у неё есть заголовок, контент, изображение при необходимости и метабоксы конфигурации. Но смысловые поля отличаются от обычного поста. Здесь важнее не красивое описание, а точная настройка ожидания, набор reward-элементов и то, как пользователь увидит результат после нажатия кнопки.

Recurrence как главный регулятор баланса

Recurrence задаёт промежуток, через который пользователь сможет получить reward снова. На тестовом стенде можно поставить короткий интервал, чтобы быстро проверить поведение кнопки и счётчика. На рабочем сайте не стоит оставлять слишком короткий интервал, если награда влияет на экономику points, доступ к достижениям или progression по rank.

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

Тексты внутри конкретной reward-записи

Документация указывает, что тексты в конфигурации конкретной time-based reward могут переопределять глобальные add-on settings. Это удобно для разных сценариев. Например, в личном кабинете можно написать Забрать ежедневный бонус, а на странице клуба - Проверить клубную награду. Если отдельное поле оставить пустым, будет использован текст из общих настроек.

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

Rewards box: что именно получит пользователь

В блоке Rewards добавляются возможные награды, которые пользователь может получить при claim. Тип reward выбирается из сущностей GamiPress: points type, achievement type или rank type. Если выбран achievement или rank, появляется дополнительный выбор конкретного достижения или ранга. Это значит, что Time based Rewards не создаёт новую отдельную экономику, а использует уже подготовленную структуру GamiPress.

У каждого reward-элемента есть логика вероятности. По документации обычная reward-запись может попасть в выдачу случайно с шансом 50%. Если включить Always included, конкретная награда будет добавляться в каждый успешный claim. Эта настройка особенно важна для базового points-бонуса: пользователь получает предсказуемый минимум, а дополнительные reward-элементы могут оставаться случайными.

Min, max и label без сюрпризов для пользователя

Min и Max задают диапазон количества для reward-элемента. Если нужно гарантировать точную сумму points, поставьте одинаковое значение в оба поля. Если нужен небольшой случайный разброс, задайте разумный диапазон. Если минимальное значение равно нулю, появляется шанс, что конкретная reward-строка не даст пользователю ничего, если её результат оказался нулевым. Для первого сценария такой вариант лучше не использовать, потому что он часто воспринимается как ошибка.

Label влияет на то, как reward будет описан в pop-up после claim. Документация показывает шаблонные теги {amount} и {label}. Для русскоязычного сайта проверьте, как фраза выглядит с разными числами. Если идеального склонения не добиться через label, лучше выбрать нейтральную формулировку: {amount} bonus points в UI или короткую русскую подпись вокруг блока, чем обещать грамматически идеальную строку без проверки.

Где вывести reward: block, shortcode, widget и страница бонусов

После настройки reward нужно показать пользователю интерфейс получения. В документации для Time based Rewards указан shortcode [gamipress_time_based_reward] с параметрами отображения. В общих описаниях add-on также упоминается вывод через blocks, shortcodes и widgets. Практически это означает, что вы можете начать с shortcode на тестовой странице, а затем перенести блок в более естественное место сайта.

Shortcode для точного контроля

Shortcode удобен, когда нужно быстро проверить конкретный reward по ID или встроить блок в редактор, который корректно обрабатывает короткие коды. Минимально полезный пример выглядит так:

[gamipress_time_based_reward id="123" title="yes" link="yes" thumbnail="yes" excerpt="yes" rewards="yes"]

Замените 123 на ID вашей time-based reward. Параметры title, link, thumbnail, excerpt и rewards принимают значения yes или no. Для первого теста оставьте всё включённым: так легче увидеть, какой элемент не выводится. Когда интерфейс станет понятен, можно скрыть лишнее, например thumbnail или excerpt.

Block и widget для редакторского сценария

Если сайт активно использует блочный редактор, block-подход удобнее для контент-менеджера: не нужно помнить синтаксис shortcode. Widget полезен, когда reward должен жить в sidebar или другой области темы. Но при любом способе вывода сначала проверьте один и тот же reward на простой странице. Если он работает через shortcode, но не работает в виджете, проблема обычно связана с областью вывода, темой или кешем, а не с самой reward-логикой.

Где размещать reward, чтобы пользователь видел смысл

Не ставьте time-based reward в случайный футер. Лучшие места связаны с действием, которое вы хотите подкрепить: кабинет ученика, профиль участника, страница бонусов, страница ежедневной активности, sidebar сообщества или блок над списком заданий. Пользователь должен понять: он не просто нажимает кнопку ради числа, а возвращается к полезному разделу сайта.

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

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

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

Цель - создать один reward-блок на странице Бонусы участника. Пользователь заходит в кабинет, видит таймер или активную кнопку, забирает гарантированное количество points и иногда получает дополнительное достижение. Для подготовки нужны активный GamiPress, один points type и одно достижение, которое не критично для основной progression-системы.

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

1. Откройте GamiPress - Time-based Rewards и создайте новую reward-запись.
2. Дайте ей понятный заголовок, например Клубный бонус, и короткое описание для пользователя.
3. В Configuration задайте recurrence, который соответствует вашей частоте возвращения.
4. Переопределите тексты кнопки и ожидания, если глобальные фразы слишком общие.
5. В Rewards добавьте points reward, включите Always included и задайте одинаковые Min и Max, если нужен фиксированный бонус.
6. Добавьте второй reward-элемент с achievement, если хотите редкий дополнительный приз, но не включайте для него Always included.
7. Опубликуйте reward и вставьте shortcode на тестовую страницу.
8. Откройте страницу от имени тестового участника и выполните claim.

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

После успешного claim пользователь должен увидеть pop-up с результатом, а кнопка должна перейти в состояние ожидания. Счётчик начинает новый отсчёт. В GamiPress проверьте баланс points, user earnings или logs, чтобы убедиться, что выдача записалась. Если выдавался achievement, проверьте профиль пользователя или список earned achievements.

Контрольный пользователь

Для проверки используйте не администратора, а отдельный аккаунт участника. У администратора могут быть видны notices, дополнительные панели и другое состояние кеша, поэтому он не всегда показывает реальный путь пользователя. Контрольный аккаунт должен пройти весь сценарий: открыть страницу, увидеть кнопку, выполнить claim, закрыть pop-up, обновить страницу и убедиться, что снова отображается ожидание.

Контрольный откат

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

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

Нюанс, который часто путают

Если в reward-наборе есть только случайные элементы без Always included, пользователь может получить pop-up без ожидаемого полезного результата. Это не обязательно ошибка, если вы осознанно используете шанс. Но для первого сценария лучше сделать хотя бы один гарантированный небольшой reward. Так пользователь понимает, что система сработала, даже если редкий bonus не выпал.

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

Time based Rewards можно использовать глубже, чем просто “кнопка раз в день”. Хороший сценарий связывает interval, reward type и место вывода с поведением пользователя. Ниже несколько идей, которые опираются на подтверждённые возможности add-on: recurrence, points/achievement/rank rewards, pop-up результата и вывод через block, shortcode или widget.

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

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

Сообщество или форум

В сообществе reward можно поместить рядом с активностями участника: профиль, клубная лента, раздел заданий. Это превращает бонус в ритуал входа, но не заменяет награды за реальные действия. Если сообщество уже использует badges за вклад в обсуждения, time-based reward должен быть меньше по ценности, чем achievement за полезный комментарий или помощь другому участнику.

Контентный сайт с личным кабинетом

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

Внутренняя проверка для администратора

Администратор может использовать отдельный тестовый reward с коротким recurrence на staging-сайте или закрытой странице, чтобы проверять после обновлений, что кнопка, pop-up, user earnings и shortcode не сломались. В рабочей версии такой тестовый reward лучше скрыть или удалить, чтобы он не мешал статистике и не путал пользователей.

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

Запуск time-based reward нельзя считать завершённым сразу после публикации shortcode. Нужно проверить три уровня: пользовательский интерфейс, запись результата в GamiPress и экономический баланс. Если один из уровней не проверен, проблема может всплыть позже, когда пользователи уже начнут получать награды.

Публичная часть

Откройте страницу от имени обычного пользователя. До первого claim должна быть понятная кнопка или состояние ожидания, зависящее от publication time и recurrence. После claim должен появиться pop-up с результатом, а затем кнопка должна стать недоступной до следующего интервала. Если страница кешируется для авторизованных пользователей, проверьте её в приватном окне и с отключённым кешем.

Админ-панель и журнал действий

В GamiPress проверьте, что points, achievement или rank действительно записались пользователю. Для points смотрите баланс и earnings, для achievement - earned achievements, для rank - текущий ранг и условия progression. Если pop-up показался, но запись в GamiPress не изменилась, это отдельный диагностический симптом: публичный интерфейс отработал частично, но reward-результат не был применён или был равен нулю.

Баланс и частота claim

Через несколько тестовых циклов оцените, не слишком ли щедрой получилась механика. Умножьте среднюю выдачу на ожидаемое количество активных пользователей и частоту claim. Если цифры выглядят слишком большими, уменьшите диапазон Min/Max, увеличьте recurrence или оставьте guaranteed reward маленьким, а редкие prize-элементы не делайте обязательными.

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

Официальная документация GamiPress описывает template hierarchy и возможность переопределять шаблоны через тему, но для Time based Rewards не стоит начинать с template override, если задача сводится к небольшому визуальному акценту. Более безопасный путь - поместить shortcode в отдельный Group-блок или контейнер с собственным CSS-классом, а затем стилизовать именно этот внешний контейнер.

Такой способ не зависит от внутренних CSS-классов add-on и не требует править файлы плагина. Если оформление не понравится, вы удаляете класс или CSS, а reward-логика остаётся нетронутой. Это особенно полезно на сайтах, где theme updates и plugin updates выполняются регулярно.

Пример CSS для контейнера вокруг shortcode

В редакторе добавьте Group-блоку класс daily-bonus-panel, внутрь вставьте shortcode Time based Rewards, затем добавьте CSS через безопасный механизм вашей темы, например Appearance - Customize - Additional CSS или через child theme.

.daily-bonus-panel {
  max-width: 720px;
  margin: 24px auto;
  padding: 24px;
  border: 1px solid rgba(30, 41, 59, 0.14);
  border-radius: 12px;
  background: #ffffff;
  box-shadow: 0 12px 30px rgba(15, 23, 42, 0.08);
}

.daily-bonus-panel :where(h2, h3, p) {
  margin-top: 0;
}

.daily-bonus-panel a,
.daily-bonus-panel button {
  transition: transform 0.18s ease, box-shadow 0.18s ease;
}

.daily-bonus-panel a:hover,
.daily-bonus-panel button:hover {
  transform: translateY(-1px);
}

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

Частые проблемы и диагностика Time based Rewards

Диагностику лучше вести по цепочке: установлен ли add-on, создан ли reward, есть ли что выдавать, корректно ли выведен блок, видит ли его авторизованный пользователь и записывается ли результат в GamiPress. Такой порядок быстрее, чем случайно менять recurrence, тексты и shortcode одновременно.

Пункт Time-based Rewards не появился в меню GamiPress

Симптом: add-on активирован, но в меню GamiPress нет отдельного пункта для time-based rewards. Возможная причина - базовый GamiPress не активен, add-on не загрузился или WordPress не завершил активацию корректно. Проверьте страницу Plugins, наличие базового GamiPress и сообщения об ошибках в админ-панели.

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

Shortcode выводит пустой блок или ошибку

Если shortcode не показывает reward, проверьте ID и атрибуты. В документации GamiPress указано, что администраторы могут видеть notices shortcode-ошибок при неверном атрибуте или отсутствующем значении, а обычные пользователи эти notices не увидят. Поэтому проверку удобно делать сначала под администратором, а затем повторять под тестовым участником.

Исправление: скопируйте ID reward из админ-панели, временно включите все display-атрибуты со значением yes и вставьте shortcode на простую страницу. Если там всё работает, проблема в месте вывода. Если не работает, проверьте публикацию reward и выбранные rewards в метабоксе.

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

Это может быть нормальным состоянием, если первый отсчёт строится от publication time, а recurrence ещё не истёк. Проверьте значение recurrence и время публикации reward-записи. Для теста используйте короткий интервал на закрытой странице, но не оставляйте его в рабочем сценарии, если reward влияет на баланс points.

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

Pop-up появился, но пользователь не получил ожидаемую награду

Сначала проверьте, была ли награда гарантированной. Если reward-элемент не отмечен как Always included, он может не попасть в выдачу. Если Min равен нулю, случайный результат может оказаться нулевым. Это особенно заметно, когда пользователь ожидает fixed bonus, а администратор настроил случайную выдачу.

Исправление: для базового сценария включите Always included у points reward и задайте одинаковые Min и Max. Дополнительные случайные achievements или ranks добавляйте только после проверки основного reward-потока.

Гость видит reward, но не может его забрать

Time-based reward привязан к пользователю, поэтому гостю нужен понятный путь к авторизации. Проверьте Guest Message в глобальных настройках или в конкретной reward-записи. Текст должен объяснять, что награда сохраняется в профиле после входа, а не просто требовать логин.

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

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

Чаще всего причина в кешировании или в том, что текст переопределён на уровне конкретной reward-записи. Проверьте сначала индивидуальные поля reward, затем глобальные settings, затем кеш страницы. Если используется page builder, убедитесь, что изменён именно тот shortcode или block, который реально опубликован.

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

Ограничения и решения по балансу наград

Главное ограничение Time based Rewards следует из его силы: повторяемая награда может быстро изменить экономику сайта. Если points используются для доступа, скидок, рангов или открываемых достижений, ошибка в recurrence и min/max накопится быстрее, чем ошибка в одноразовом achievement. Поэтому любые значимые награды сначала тестируйте на малой группе или на staging-сайте.

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

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

Ranks требуют особой осторожности

Rank в GamiPress обычно связан с progression. Если вы выдаёте rank через time-based reward, проверьте, не разрушает ли это основную лестницу достижений. В документации по reward-настройке указано, что для rank не показываются min/max, потому что rank может быть awarded только один раз. Но “один раз” не означает “безопасно”: слишком лёгкий rank всё равно меняет восприятие статуса.

SEO и индексация reward-страниц

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

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

GamiPress Time based Rewards стоит использовать, если на сайте уже есть рабочая система GamiPress и вам нужен понятный повторяемый стимул: пользователь возвращается, видит таймер, получает небольшой reward и продолжает взаимодействовать с сайтом. Самые сильные сценарии появляются в личных кабинетах, клубах, обучающих порталах и сообществах, где регулярный визит связан с реальной активностью.

Перед рабочим запуском проверьте базовые types в GamiPress, задайте безопасный recurrence, сделайте один гарантированный небольшой reward, протестируйте pop-up и запись результата, а затем оцените баланс на нескольких циклах. Если всё работает на тестовом пользователе и не ломает экономику points, можно скачать последнюю версию GamiPress Time based Rewards и переходить к аккуратной проверке на своём WordPress-сайте.

Лучший результат даёт не самый щедрый reward, а хорошо объяснённая механика: пользователь понимает, когда награда доступна, что он получил, где это отражается в профиле и зачем ему вернуться снова.