Athenian Coupon Builder
product details.
Athenian Coupon Builder extends native WooCommerce coupons with richer eligibility rules, auto-apply behavior, customer-aware controls, and structured promotion management. It helps teams run more precise discounts while preserving the familiar WooCommerce coupon foundation and platform reporting context while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Coupon Builder for WooCommerce is a native promotion orchestration layer that extends standard WooCommerce coupons with richer eligibility rules, cleaner admin authoring, automatic coupon application, and developer-friendly integration hooks.
Rather than replacing WooCommerce coupons with a separate discount engine, the plugin builds directly on the existing shop_coupon model. Merchants can continue using familiar WooCommerce coupon records while gaining more targeted campaign controls such as subtotal windows, role-based eligibility, custom campaign dates, new-customer restrictions, first-order offers, per-customer usage limits, and auto-apply behavior.
The plugin adds an Athenian Coupon Conditions meta box to the WooCommerce coupon editor, then enforces the configured rules during WooCommerce coupon validation. It also includes developer filters, campaign context helpers, external linkage metadata, and a lightweight REST probe for debugging coupon configuration.
Within the Athenian Platform, Coupon Builder fits as the promotion and campaign-eligibility layer for WooCommerce stores, connecting naturally with pricing tiers, subscriptions, bundles, rewards, affiliate workflows, quote flows, guided carts, and broader commerce automation.
How Athenian Coupon Builder fits the Athenian Platform
Platform role: Athenian Coupon Builder is a focused capability in the Cart, Checkout & Customer Service and Storefront, Merchandising & Product Data layer. Its primary scope covers Checkout & Assisted Ordering and Promotions & Pricing Programs while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Coupon Builder is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
Promotion Operations
Build Smarter WooCommerce Coupon Campaigns Without Replacing Native Coupons
Athenian Coupon Builder keeps WooCommerce coupons as the source of truth
while adding a focused rule-authoring layer for subtotal thresholds,
customer roles, campaign windows, first-order targeting, usage limits,
and auto-applied promotions.
| Coupon Rule | Operational Value |
|---|---|
| Subtotal Windows | Require carts to meet minimum or maximum subtotal thresholds before a promotion can be used. |
| Role Eligibility | Restrict coupon access to selected WordPress user roles while excluding guests when role rules are configured. |
| Campaign Dates | Set custom start and end dates so promotions only validate during the intended campaign window. |
| Customer Lifecycle Rules | Support new-customer and first-order campaigns by checking completed WooCommerce order history by billing email. |
- Extends native WooCommerce
shop_couponposts instead of creating a separate promotion post type. - Adds an Athenian Coupon Conditions meta box to WooCommerce coupon edit screens.
- Stores rule metadata such as
acb_min_subtotal,acb_max_subtotal,acb_allowed_roles,acb_start_date, andacb_end_date. - Supports customer rules such as
acb_new_customers_only,acb_first_order_only, andacb_max_uses_per_user.
Promotion Enforcement
Validate Coupons Against Cart, Customer, Role, and Campaign Context
ACB hooks into WooCommerce coupon validation and auto-apply behavior so
promotions can be accepted, rejected, or applied automatically based on
configured business rules and extension filters.
Validate entered codes against WooCommerce and ACB rules together
Apply eligible promotions automatically when the cart qualifies
Use billing email and completed orders for lifecycle targeting
| Runtime Layer | How It Helps |
|---|---|
| Coupon Validation | Uses WooCommerce’s native validation lifecycle and returns false when ACB rules fail. |
| Auto-Apply Query | Scans published coupons marked with auto-apply behavior and applies qualifying discounts on the cart page. |
| Usage Limits | Enforces Athenian-specific max uses per customer by checking completed orders for the billing email and coupon code. |
| Store-Timezone Windows | Evaluates start and end dates using the store timezone so campaign timing aligns with merchant expectations. |
- Uses the WooCommerce filter
woocommerce_coupon_is_validfor runtime validation. - Uses
woocommerce_before_cartto attempt auto-application of eligible coupons. - Stores auto-apply behavior in
acb_auto_apply. - Fires actions such as
acb_coupon_validatedandacb_coupon_auto_applied. - Uses
WC_Order_Queryfor customer order-history checks instead of direct legacy order-table SQL.
Campaign Integration Layer
Connect Coupon Rules to Campaigns, Assignments, Bundles, Subscriptions, and Debug Tools
Athenian Coupon Builder includes helper APIs, context metadata, validation
filters, auto-apply filters, and a lightweight REST probe so developers can
connect WooCommerce coupons to larger Athenian campaign and commerce workflows.
| Integration Surface | Operational Purpose |
|---|---|
| Campaign Context | Attaches external campaign, assignment, user, coupon, subscription, and bundle references to native coupon records. |
| REST Probe | Provides a lightweight endpoint for inspecting coupon validity, selected ACB metadata, and attached context. |
| Validation Filters | Allows external plugins to enrich validation context or modify the final coupon validity result. |
| Auto-Apply Filters | Allows connected modules to adjust which coupons are considered for auto-apply and whether a specific coupon should apply. |
Native coupon control with platform reach:
Coupon Builder preserves WooCommerce compatibility while creating a
dedicated promotion layer for Athenian Platform campaign, quote, bundle,
subscription, affiliate, and account-based cart workflows.
- Supports context metadata such as
affp_campaign_id,affp_assignment_id,affp_user_id,affp_coupon_id,affp_subscription_id, andaffp_bundle_id. - Registers the probe route
/wp-json/ath-coupons/v1/probe?code=COUPONCODE. - Provides extension filters such as
acb_coupon_is_valid_for_context,acb_coupon_validation_context,acb_auto_apply_query_args, andacb_should_auto_apply_coupon. - The public REST probe is useful for development and QA, but production deployments should review whether full coupon metadata should remain publicly inspectable.
- Builds toward stricter cart restriction enforcement, customer segments, shipping/payment/fulfillment rules, recurring campaign presets, campaign preview tools, eligibility reason logging, performance dashboards, and deeper Athenian Platform Core integration.