=== ZELMU ID ===
Contributors: zelmu, theabhikmaitra
Donate link: https://zelmu.org
Tags: woocommerce, student discount, verification, discounts, coupons
Requires at least: 5.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Mint single-use student discounts directly in WooCommerce with cryptographic collegiate verification and zero PII exposure.

== Description ==

**ZELMU Verified Student Discounts** is the official WordPress & WooCommerce plugin connecting your online store to the ZELMU Student Identity Network.

It enables online merchants and brand partners to offer exclusive, fraud-proof discounts to actively enrolled university and college students across 250+ accredited institutions without leaking personal student data.

= Key Features =
* **Instant Collegiate Verification**: Validates students using official academic emails (`.ac.in`, `.edu.in`, `.edu`) via cryptographic one-time passwords (OTP).
* **Dynamic Single-Use WooCommerce Coupons**: Automatically generates authentic single-use coupons (`WC_Coupon`) upon verification and applies them directly to the customer's active cart session.
* **Zero Theme Collision**: Enforces responsive flex/grid resets, guaranteeing our button never breaks theme layouts on single product or cart pages.
* **Storefront Floating Trust Badges**: Responsive trust badges with automated clearance over mobile sticky checkout bars and customer support chat widgets.
* **WCAG AA Accessible**: Includes keyboard navigation, visible focus outlines, and screen reader labels.
* **Page Builder Friendly**: Includes shortcode `[zelmu_student_discount]` for Elementor, Divi, and Gutenberg.

= External Services & Privacy Disclosure =
This plugin relies on a 3rd party service to securely verify collegiate credentials without exposing sensitive student Personally Identifiable Information (PII) to merchants.

* **Service Name**: ZELMU Student Identity Network
* **Provider**: ZELMU (https://zelmu.org)
* **What Data is Transmitted**: When a shopper clicks "Verify Student Status" and requests a discount code, their submitted academic email address and your store identifier are transmitted over encrypted HTTPS to `https://zelmu.org/api/shopify/verify/send-otp` to dispatch a verification OTP. No passwords, payment details, or personal student documents are sent.
* **Terms of Service**: https://zelmu.org/terms
* **Privacy Policy**: https://zelmu.org/privacy

== Installation ==

1. Download the `zelmu-id-verified.zip` archive.
2. In your WordPress Admin, navigate to **Plugins -> Add New Plugin -> Upload Plugin**.
3. Select `zelmu-id-verified.zip` and click **Install Now**.
4. Click **Activate Plugin**.
5. Navigate to **WooCommerce -> ZELMU Student Discount** in your WordPress sidebar.
6. Enter your Store Domain or Partner ID (defaults to your store hostname).
7. Choose your desired button theme and floating badge position, then click **Save WooCommerce Settings**.

== Frequently Asked Questions ==

= Do I need WooCommerce to use this plugin? =
Yes, WooCommerce is required for automated coupon creation and checkout application. However, you can also place the custom shortcode `[zelmu_student_discount]` anywhere on standard WordPress pages.

= How are coupons created and secured? =
Upon successful collegiate email verification, the plugin dynamically mints a single-use coupon in WooCommerce (`WC_Coupon`) with a 24-hour expiration limit, restricted to a single redemption, and applies it to the active cart.

= Can students hoard multiple discount codes? =
No. ZELMU includes a configurable Frequency Limit Guard (default 30 days) that prevents an individual student from generating multiple discount codes within the window.

= Does this plugin slow down my store? =
No. Scripts and styles are packaged locally within the plugin, and DOM operations utilize debounced observers (150ms cooldown) to prevent frame drops or CPU spikes.

== Screenshots ==

1. Single Product Page integration: student discount button mounted below native Add to Cart.
2. Storefront Floating Trust Badge with mobile sticky bar clearance.
3. Modal verification dialog with cryptographic OTP prompt.
4. WordPress Admin configuration panel under WooCommerce -> ZELMU Student Discount.

== Changelog ==

= 1.0.0 =
* Initial public release.
* Automated WooCommerce hooks for Single Product and Cart pages.
* Dynamic single-use coupon minting and cart auto-application.
* Responsive floating trust badge with mobile collision protection.
* Shortcode support: `[zelmu_student_discount]`.
* 100% WordPress.org Plugin Directory guidelines compliance.

== Upgrade Notice ==

= 1.0.0 =
Initial release for WooCommerce student discount verification.
