=== 4A Scratch ===
Contributors: 4aworks
Tags: woocommerce, scratch card, rewards, coupons, customer retention
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A polished WooCommerce scratch-card reward for the moment after checkout.

== Description ==

4A Scratch gives eligible WooCommerce orders one digital scratch card. Customers scratch with mouse or touch to reveal a reward. Winning discount coupons are generated server-side, limited to one use and restricted to the order email address.

Free includes:
* One active scratch campaign
* Two coupon prizes plus a no-prize outcome
* Relative prize weights
* Percentage and fixed-cart discounts
* Unique one-use coupons
* Configurable coupon expiry
* Scratch card on the order-received page
* Scratch card in My Account order details
* Basic result counters
* Safe admin test mode
* Editable no-prize message
* Touch and mouse support

4A Scratch Pro is designed to add public/homepage scratch campaigns, multiple campaigns, free-product rewards, scheduling, advanced conditions, design controls and deeper analytics. Learn more at https://4a.nl/index.php/4a-scratch/.

== Installation ==
1. Upload and activate 4A Scratch.
2. Make sure WooCommerce is active.
3. Open 4A Scratch in the WordPress admin menu.
4. Configure your campaign and reward weights.
5. Place a test order before using the campaign on a live store.

== Frequently Asked Questions ==

= Can a customer scratch the same order twice? =
No. The first revealed result is stored on the WooCommerce order and subsequent views show that same result.

= Are winning coupons reusable? =
No. Free creates a unique coupon with a usage limit of one and restricts it to the billing email address of the order.

= How do the chances work? =
The weights are relative. For example, weights 20, 10 and 70 result in 20%, 10% and 70% chances.

== Changelog ==

= 1.0.4 =
* WordPress.org submission hardening: request validation, sanitization and valid internal prefixes.

* Faster automatic reveal after roughly 10% of the scratch surface is cleared.
* Default no-prize heading is now fully English: "NO LUCK THIS TIME".
* Default no-prize message is now: "No prize this time. Better luck next time!".

= 1.0.3 =
* Faster scratch reveal: larger scratch area and automatic reveal after roughly 18% is cleared.
* Improved no-prize result with a separate editable heading and customer message.
* Default no-prize copy now uses a clearer "Helaas…" message.

= 1.0.2 =
* Added safe admin Test Mode.
* Force Random, Prize 01, Prize 02 or No Prize.
* Test scratches create no real coupons, orders or statistics.
* Added instant reset/retest flow.

= 1.0.1 =
* Refined scratch interaction with a branded 4A scratch coin.
* Added smoother reward reveal animation.
* Added live reward chance percentages in the admin.
* Added live scratch-card preview text updates.
* Added clearer paused campaign state and Pro labels.


= 1.0.0 =
* Initial release.
* Scratch interaction for touch and mouse.
* Server-side reward selection.
* Unique WooCommerce coupon rewards.
* Thank-you and My Account integration.
* Styled 4A Works admin experience.
* Pro feature preview built into Free.

== Screenshots ==

1. Create your scratch campaign and configure the experience from a clean WooCommerce dashboard.
2. Customers scratch their card after checkout to reveal a reward and encourage a repeat purchase.
3. Customize the look of your scratch campaign with your own images and branding. Available in 4A Scratch Pro.
4. Fully responsive scratch cards designed to work seamlessly on desktop, tablet and mobile.
5. Live campaign preview while configuring your scratch card settings.
