=== AD-SD Referral CouponCore EcoSystem ===
Contributors: devadarsh
Tags: referral, rewards, coupons, woocommerce, anti-fraud
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.txt

Referral rewards and WooCommerce coupons with anti-fraud protection, email verification, and offline shop reward validation.

== Description ==

**AD-SD Referral CouponCore EcoSystem** is a scalable, modular, WooCommerce-compatible referral + reward + local shop verification plugin that works as a complete ecosystem:

* Referral engine
* Reward generator (fixed value, percentage, automatic or manual)
* Email verification system
* Local shop offline discount system
* WooCommerce smart dynamic coupon engine
* Anti-fraud system

**Key Feature:** WooCommerce coupons are NOT created immediately. They are dynamically generated ONLY when the user clicks "Claim & Apply Reward" during cart or checkout — preventing abuse and duplicate coupon generation.

= Core Features =

* Custom email-only registration with auto-generated password
* Full email verification flow before referral is activated
* Configurable reward recipients: sender, receiver, or both
* Four reward generation modes: automatic, manual, automatic %, manual %
* Dynamic WooCommerce coupon generation on user demand
* Local/offline shop reward verification via passkey-protected checker page
* Anti-fraud: daily limits, self-referral prevention, device fingerprinting, rate limiting
* Full email template builder (verification, reward generated, used, expired)
* Built-in SMTP support (Brevo, Gmail, SendGrid, Mailgun, Outlook)
* Admin logs, user stats, reward code management
* REST API endpoints for headless integrations

= Shortcodes =

* `[adsd_rcc_dashboard]` — User's referral dashboard
* `[adsd_rcc_code_list]` — User's reward list with statuses
* `[adsd_rcc_register]` — Custom registration form
* `[adsd_rcc_login]` — Login page
* `[adsd_rcc_checker]` — Shopkeeper reward checker (passkey protected)
* `[adsd_rcc_set_password]` — Password setup page for newly verified users

= Requirements =

* WordPress 6.0+
* PHP 8.0+
* WooCommerce 7.0+ (optional, for coupon integration)

== Installation ==

1. Upload the `adsd-referral-couponcore` folder to `/wp-content/plugins/`
2. Activate the plugin in **Plugins** > **Installed Plugins**
3. Navigate to **AD-SD Referral** > **Settings** to configure
4. Create pages and assign the shortcodes listed above
5. Configure email templates under **AD-SD Referral** > **Email Templates**
6. Generate a passkey under **AD-SD Referral** > **Passkey** for shopkeepers
7. Configure the From Email address (and optionally SMTP) in Settings > Email Settings

== Frequently Asked Questions ==

= When is the WooCommerce coupon created? =

Only when the user clicks "Claim & Apply Reward" on the cart or checkout page — not before.

= Can users cheat by referring themselves? =

No. Self-referrals are blocked automatically. The system also checks device fingerprints and IP rate limits.

= Does the plugin support offline shops? =

Yes. Shopkeepers use the `[adsd_rcc_checker]` page with a secure passkey to validate and mark rewards as used offline.

= Is there a daily limit on referral links? =

Yes, configurable in Settings. Default is 5 links per user per day (set 0 for unlimited).

= How do I set up email delivery? =

Configure a From Email address in Settings > Email Settings. For reliable delivery, enable SMTP and use a free transactional service such as Brevo (300 emails/day free), Gmail App Password, SendGrid, or Mailgun.

= Is the plugin multisite compatible? =

The plugin stores data per-site (not network-wide) and works correctly in multisite environments.

== Screenshots ==

1. Admin Settings — configure reward recipients, offer types, code formats, and email settings.
2. Referral Dashboard — users generate and share referral links, view referrals and active rewards.
3. Reward Code List — users see all earned rewards with status and expiry.
4. Shopkeeper Checker — passkey-protected page to validate and mark rewards as used offline.
5. Email Templates — fully customisable verification and reward notification templates.

== Changelog ==

= 1.0.0 =
* Initial release.
* Referral engine with token-based links.
* Email verification system.
* Reward engine: fixed value, percentage, automatic and manual modes.
* WooCommerce dynamic coupon generation.
* Anti-fraud: daily limits, self-referral prevention, device fingerprinting.
* Admin: settings, email templates, codes, users, logs, passkey pages.
* Built-in SMTP configuration with test email feature.
* REST API endpoints.
* Passkey-protected shopkeeper reward checker.

== Upgrade Notice ==

= 1.0.0 =
Initial release. Please create the required pages and assign shortcodes before activating for users. Configure your From Email address in Settings > Email Settings.