Athenian Product Add-Ons
product details.
Athenian Product Add-Ons provides a WooCommerce configuration engine for rich product options, add-on pricing, linked product behavior, and reliable cart-to-order data persistence. It helps teams sell configurable products while keeping option choices, prices, production details, and fulfillment context attached to each order while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Product Add-ons is a first-party WooCommerce product configuration engine for complex, personalized, decorated, production-driven, and service-enhanced products. It replaces fragile generic add-on forms with a structured Athenian add-on layer that can render configurable product fields, calculate price adjustments, capture uploads, stage generated assets, inject companion products into the cart, enrich Store API responses, and preserve customer selections through checkout and order fulfillment.
The plugin lets administrators create reusable add-on groups using a dedicated athenian_addon_group post type. Each group can include targeted fields such as text inputs, textareas, file uploads, URL-backed generated assets, dropdowns, multi-select fields, radio buttons, checkboxes, product or variation choices, image selectors, color swatches, and image-plus-swatch cards. Groups can be targeted by product, category, tag, product type, service records, service categories, and priority rules.
On the storefront, Athenian Product Add-ons turns customer choices into durable commerce data. Selected options can add fixed or percentage-based price deltas, upload artwork, store placement data, trigger AI image workflows, attach generated files, and add linked WooCommerce products or variations as real cart lines. The plugin keeps configured cart lines distinct through signatures and carries normalized metadata into cart, checkout, Store API, and order item records.
For the broader Athenian Platform, APADD connects product customization to Print Forge, Custom Cart Builder, Platform Core pricing, Store API carts, vendor-aware pricing, AI credits, 3D previews, generated assets, uploaded artwork, and production-ready order metadata. It is built for stores where product options are not just display fields, but essential transaction data used by pricing, fulfillment, support, production, and automation workflows.
How Athenian Product Add-Ons fits the Athenian Platform
Platform role: Athenian Product Add-Ons is a focused capability in the Storefront, Merchandising & Product Data layer. Its primary scope covers Product Configuration & Add-ons while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Product Add-Ons 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.
Product Configuration
Build Reusable Add-on Groups for Complex WooCommerce Products
Athenian Product Add-ons gives merchants a structured add-on group builder
for creating targeted product options, visual selectors, uploads, swatches,
linked products, and customer-facing configuration fields.
| Add-on Layer | Customer Experience Value |
|---|---|
| Input Fields | Support text, textarea, URL, file upload, select, radio, checkbox, and multi-select field types. |
| Visual Choices | Render image choices, color swatches, gradients, and image-plus-swatch option cards. |
| Targeting Rules | Assign groups by product, category, tag, product type, service record, service category, and priority. |
| Admin Builder | Create reusable add-on groups with labels, field names, help text, required flags, pricing, options, and uploads. |
- Use the dedicated
athenian_addon_grouppost type for reusable configuration groups. - Support fixed and percentage pricing at both field and option levels.
- Define choice options with labels, values, price deltas, pricing type, and supporting URLs.
- Render polished frontend configuration fields before WooCommerce add-to-cart actions.
Cart & Pricing
Turn Add-on Selections Into Durable WooCommerce Cart Data
APADD normalizes product configuration into cart item metadata, pricing
deltas, Store API extensions, linked-product cart lines, and order item
records so customer selections survive the full transaction lifecycle.
Calculate fixed and percentage add-on deltas per unit and line
Add selected companion products or variations as real WooCommerce cart lines
Expose normalized add-on data through modern cart response extensions
| Commerce Layer | How It Helps |
|---|---|
| Cart Signatures | Keep differently configured versions of the same product as distinct cart lines. |
| Split Pricing | Store fixed and percentage deltas separately for better compatibility with platform pricing logic. |
| Linked Lines | Track parent-child relationships when add-on selections inject additional products into the cart. |
| Order Persistence | Save add-ons, uploads, placements, artwork, APF, 3D, and item-data payloads to order items. |
- Capture classic WooCommerce and Store API add-to-cart payloads into one canonical format.
- Mirror normalized add-on data into
apc[apadd]for Athenian Platform Core consumers. - Synchronize linked add-on product quantities with parent quantities when configured.
- Avoid double-pricing when the Athenian Platform Core PriceDelegate is available.
Creative & Production Handoff
Capture Uploads, Generated Assets, AI Images, and Production Metadata
Athenian Product Add-ons supports file uploads, generated asset URLs,
AI image workflows, APF handoffs, 3D preview data, placement payloads,
and external staging so product customization can feed production-ready
commerce workflows.
| Workflow | Operational Purpose |
|---|---|
| Uploads | Accept standard files, generated files, uploaded artwork, STL/PDF/image assets, and URL-backed payloads. |
| AI Tools | Support prompt improvement, progress snippets, image generation, reference images, quality, size, and credit policy hooks. |
| External Staging | Let custom builders or APF screens stage generated values before the product is added to cart. |
| Platform Bridges | Connect with Print Forge, Custom Cart Builder, Platform Core, Store API carts, service-commerce, and 3D preview flows. |
Built for production-driven customization:
APADD does more than display option fields. It preserves uploaded files,
generated artwork, add-on selections, linked products, placement data,
and pricing context so support, fulfillment, production, and automation
tools can use the same structured order data.
- Use
/wp-json/ath-apa/v1/uploadand generated-file AJAX uploads for asset capture. - Stage external builder values through
apadd_stage_addon_valueor/wp-json/apadd/v1/stage. - Bridge add-on rendering into Athenian Custom Cart Builder with
ath_addons/render_fields_html. - Build toward product builders, AI-assisted personalization, 3D previews, vendor-aware pricing, and production automation.