Mikhailkyrychenko Discount Battle Game for WooCommerce

FAQ

Does this plugin require WooCommerce?

Yes. WooCommerce is required for product selection, coupon creation, and applying a reward in the cart. The dependency is declared in the plugin header.

How do I choose where the game appears?

Open Discount Battle → Settings. Choose Across the whole website or Only on pages with [wpcdg_discount_game]. In shortcode mode, add [wpcdg_discount_game] to each desired page.

How do maps, attempts, and free play work?

Each reward map can be enabled separately and has its own reward-attempt limit and coupon campaign. Woodland Practice is always unlimited and never offers a coupon. The After reward attempts run out setting controls whether a separate free-play launcher stays available after reward attempts are used. It lets visitors practice or replay maps they have already won without earning another coupon.

What happens when a player wins?

The plugin asks WooCommerce to create a coupon using that map’s campaign settings. The game displays the code and product links. The visitor can return to the map menu; free replay is available when enabled in Settings. Issued coupon codes remain WooCommerce coupons and are not removed by the global progress reset.

How do I play on a phone?

Rotate the phone to landscape. Drag with one finger to move around the map, pinch with two fingers to zoom, and swipe the bottom skill bar to reach additional controls. In the game, drag the catapult arm and release to fire. Select a skill, then tap a landed Savling to assign it. Space pauses, F toggles 2× speed, and Q/W switches between Savlings and barrels.

What data does the plugin store?

Game records store the WordPress user ID for logged-in visitors or a keyed hash of a random first-party wpcdg_visitor cookie for logged-out visitors (the cookie expires after one year). Records include the map, result, timestamps, and submitted gameplay replay. A keyed IP hash used for rate limiting expires after one minute. Popup frequency uses session or local storage. Records remain in the WordPress database until removed. The plugin sends no game analytics to an external service.

WordPress privacy tools export and erase records linked to registered accounts. If an issued coupon must remain redeemable, its attempt row is anonymized and the technical coupon link retained. Logged-out records are not linked to email and cannot be found by email-based privacy tools; the site owner must remove them. Resetting progress preserves history and issued coupons.

Is the game result independently verified by the server?

The server verifies that an attempt was recorded, checks the minimum elapsed time, rate limits requests, and applies reward rules. The game outcome itself is reported by the browser and the server does not independently replay the full simulation. Use a conservative reward for this style of campaign.

Where can I review statistics or reset attempts?

Open Discount Battle → Statistics to see overall totals, filter by map, or inspect recent activity. The reset control on the Settings page resets attempt counters and win state for all visitors and all maps. It does not delete historical attempts or coupons already issued.