Opens in a new tab
Deliver toTennessee
0 0 0Cart
Get a Project Quote

Athenian Product Add-ons

v3.56.80 October 6, 2026
First-party replacement for WAPF add-ons.

Overview

Athenian Product Add-ons

Athenian Product Add-ons — Technical & Marketing Overview

Plugin: Athenian Product Add-ons Slug / package: athenian-product-addons Version inspected: 3.56.74 Author: Scott Mays | Athenian Brands Primary platform: WordPress + WooCommerce Primary purpose: First-party WooCommerce product configuration, add-on pricing, visual option selection, upload capture, linked-product add-ons, Store API enrichment, APF/3D handoff support, and AI-assisted generation workflows.

---

1. Executive Summary

Athenian Product Add-ons is a first-party WooCommerce add-on and configuration system built for the Athenian commerce platform. It replaces generic WAPF-style product option plugins with a structured, platform-aware add-on layer that can render configurable product fields, calculate add-on pricing, capture uploads and generated assets, inject selected companion products into the cart, and preserve the customer’s configuration through cart, checkout, Store API responses, and order item metadata.

The plugin is designed for storefronts where product options are not just simple form fields. It supports visual selection patterns, image and swatch choices, multi-select fields with per-option uploads, file and URL-backed configuration, product/variation add-ons that become real WooCommerce cart lines, AI image-generation prompts, credit-aware AI usage, and integration with adjacent Athenian systems such as Platform Core, Print Forge, Custom Cart Builder, vendor pricing, 3D previews, and service-commerce workflows.

In practical terms, Athenian Product Add-ons turns customer customization choices into durable commerce data that can be priced, displayed, edited, synchronized, sent through Store API responses, and stored on the final WooCommerce order.

---

2. Marketing Positioning

Short Positioning Statement

Athenian Product Add-ons turns WooCommerce product options into structured, price-aware, transaction-ready configuration data for complex storefronts.

One-Sentence Description

Athenian Product Add-ons is a WooCommerce configuration plugin that supports rich add-on groups, visual selectors, file uploads, AI-generated assets, linked-product add-ons, Store API compatibility, and reliable cart-to-order persistence.

Website Description

Athenian Product Add-ons gives WooCommerce merchants a stronger way to sell configurable products. Instead of treating product options as fragile page-level form fields, it captures add-on selections as structured commerce data that can be priced, displayed, edited, carried through checkout, exposed to modern cart surfaces, and preserved on order records. Merchants can build reusable add-on groups with text fields, dropdowns, radios, checkboxes, image choices, swatches, image-plus-swatch cards, uploads, URL-backed generated assets, and product/variation choices that add companion items to the cart.

Sales-Focused Description

Generic product add-on plugins often work until the store needs serious configuration: uploaded artwork, visual choices, add-on pricing, optional accessories, AI-generated assets, Store API carts, custom checkout surfaces, and production-ready order metadata. Athenian Product Add-ons fills that gap by giving the Athenian platform a first-party configuration layer designed for complex WooCommerce products, decorated goods, vendor-routed items, personalized products, service add-ons, and AI-assisted commerce workflows.

---

3. Core Value Proposition

Athenian Product Add-ons is valuable because it co

ects four areas that are often handled by separate plugins or custom patches:

  1. Merchandising configuration — reusable add-on groups targeted to products, categories, tags, product types, and service contexts.
  2. Customer-facing interaction — polished frontend fields for text, file, visual, swatch, product-choice, and AI-assisted inputs.
  3. Commerce integrity — fixed and percentage add-on pricing, cart signatures, quantity synchronization, linked-product cart lines, and Store API extensions.
  4. Operational persistence — structured cart item meta, order item meta, upload maps, artwork payloads, placement data, and formatted display rows for support, production, and fulfillment.

Key Benefits

  • Replaces generic add-on builders with a first-party Athenian/WooCommerce configuration layer.
  • Lets admins create reusable add-on groups with product/category/tag/type targeting.
  • Supports rich field types such as image choice, swatch choice, image + swatch, file uploads, hidden URL fields, and product/variation choices.
  • Handles fixed and percentage-based add-on price deltas.
  • Captures uploads and generated file URLs into canonical cart metadata.
  • Supports per-option uploads for multi-select workflows.
  • Allows selected add-ons to inject additional WooCommerce products or variations as linked cart lines.
  • Keeps linked add-on quantities synchronized with parent product quantities when configured.
  • Enriches WooCommerce Store API cart responses with normalized extensions.apa payloads.
  • Persists add-on selections, APF artwork, 3D/generated asset metadata, upload maps, and placement data to order items.
  • Bridges into Athenian Custom Cart Builder and legacy WAPF-compatible hooks.
  • Adds AI prompt improvement, progress snippets, and image generation for supported add-on fields.
  • Integrates with APC AI policy/credit systems where available.

---

4. Best-Fit Use Cases

  • Personalized or decorated WooCommerce products.
  • Print, apparel, signage, sticker, decal, badge, label, powder-coating, or custom production workflows.
  • Products requiring customer-uploaded files or generated artwork.
  • Products with visual material, color, finish, style, or placement selection.
  • Product builders that need image and gradient swatches tied to 2D or 3D previews.
  • Configurable products that need optional accessories, add-on services, or companion products.
  • Stores that need cart editing while preserving structured add-on values.
  • Store API, block-cart, or custom frontend cart surfaces that require normalized add-on payloads.
  • Vendor-aware carts where add-ons must feed into pricing, tier displays, or fulfillment context.
  • AI-assisted product creation where the customer can generate a file or image before purchase.

---

5. Customer-Facing Workflow

> Source excerpt shortened for the baseline web reference; the linked repository remains authoritative for the complete document.

Installed source inventory: 38 files.
Detected 139 hook registrations, 3 REST route patterns, and 0 shortcode patterns.
Canonical source pinned to commit 0c1a2d38469278678d0c5c149f591a129ea80d47.

Use cases

  • Manual developer onboarding
  • Admin and frontend workflow review
  • Release and deployment reconciliation

Developer

Developer starting point

Use this baseline with the active plugin installation and linked repository. Confirm the deployed header version and dependency state before applying changes.

Athenian Product Add-ons — Technical & Marketing Overview

Plugin: Athenian Product Add-ons Slug / package: athenian-product-addons Version inspected: 3.56.74 Author: Scott Mays | Athenian Brands Primary platform: WordPress + WooCommerce Primary purpose: First-party WooCommerce product configuration, add-on pricing, visual option selection, upload capture, linked-product add-ons, Store API enrichment, APF/3D handoff support, and AI-assisted generation workflows.

---

1. Executive Summary

Athenian Product Add-ons is a first-party WooCommerce add-on and configuration system built for the Athenian commerce platform. It replaces generic WAPF-style product option plugins with a structured, platform-aware add-on layer that can render configurable product fields, calculate add-on pricing, capture uploads and generated assets, inject selected companion products into the cart, and preserve the customer’s configuration through cart, checkout, Store API responses, and order item metadata.

The plugin is designed for storefronts where product options are not just simple form fields. It supports visual selection patterns, image and swatch choices, multi-select fields with per-option uploads, file and URL-backed configuration, product/variation add-ons that become real WooCommerce cart lines, AI image-generation prompts, credit-aware AI usage, and integration with adjacent Athenian systems such as Platform Core, Print Forge, Custom Cart Builder, vendor pricing, 3D previews, and service-commerce workflows.

In practical terms, Athenian Product Add-ons turns customer customization choices into durable commerce data that can be priced, displayed, edited, synchronized, sent through Store API responses, and stored on the final WooCommerce order.

---

2. Marketing Positioning

Short Positioning Statement

Athenian Product Add-ons turns WooCommerce product options into structured, price-aware, transaction-ready configuration data for complex storefronts.

One-Sentence Description

Athenian Product Add-ons is a WooCommerce configuration plugin that supports rich add-on groups, visual selectors, file uploads, AI-generated assets, linked-product add-ons, Store API compatibility, and reliable cart-to-order persistence.

Website Description

Athenian Product Add-ons gives WooCommerce merchants a stronger way to sell configurable products. Instead of treating product options as fragile page-level form fields, it captures add-on selections as structured commerce data that can be priced, displayed, edited, carried through checkout, exposed to modern cart surfaces, and preserved on order records. Merchants can build reusable add-on groups with text fields, dropdowns, radios, checkboxes, image choices, swatches, image-plus-swatch cards, uploads, URL-backed generated assets, and product/variation choices that add companion items to the cart.

Sales-Focused Description

Generic product add-on plugins often work until the store needs serious configuration: uploaded artwork, visual choices, add-on pricing, optional accessories, AI-generated assets, Store API carts, custom checkout surfaces, and production-ready order metadata. Athenian Product Add-ons fills that gap by giving the Athenian platform a first-party configuration layer designed for complex WooCommerce products, decorated goods, vendor-routed items, personalized products, service add-ons, and AI-assisted commerce workflows.

---

3. Core Value Proposition

Athenian Product Add-ons is valuable because it co

ects four areas that are often handled by separate plugins or custom patches:

  1. Merchandising configuration — reusable add-on groups targeted to products, categories, tags, product types, and service contexts.
  2. Customer-facing interaction — polished frontend fields for text, file, visual, swatch, product-choice, and AI-assisted inputs.
  3. Commerce integrity — fixed and percentage add-on pricing, cart signatures, quantity synchronization, linked-product cart lines, and Store API extensions.
  4. Operational persistence — structured cart item meta, order item meta, upload maps, artwork payloads, placement data, and formatted display rows for support, production, and fulfillment.

Key Benefits

  • Replaces generic add-on builders with a first-party Athenian/WooCommerce configuration layer.
  • Lets admins create reusable add-on groups with product/category/tag/type targeting.
  • Supports rich field types such as image choice, swatch choice, image + swatch, file uploads, hidden URL fields, and product/variation choices.
  • Handles fixed and percentage-based add-on price deltas.
  • Captures uploads and generated file URLs into canonical cart metadata.
  • Supports per-option uploads for multi-select workflows.
  • Allows selected add-ons to inject additional WooCommerce products or variations as linked cart lines.
  • Keeps linked add-on quantities synchronized with parent product quantities when configured.
  • Enriches WooCommerce Store API cart responses with normalized extensions.apa payloads.
  • Persists add-on selections, APF artwork, 3D/generated asset metadata, upload maps, and placement data to order items.
  • Bridges into Athenian Custom Cart Builder and legacy WAPF-compatible hooks.
  • Adds AI prompt improvement, progress snippets, and image generation for supported add-on fields.
  • Integrates with APC AI policy/credit systems where available.

---

4. Best-Fit Use Cases

  • Personalized or decorated WooCommerce products.
  • Print, apparel, signage, sticker, decal, badge, label, powder-coating, or custom production workflows.
  • Products requiring customer-uploaded files or generated artwork.
  • Products with visual material, color, finish, style, or placement selection.
  • Product builders that need image and gradient swatches tied to 2D or 3D previews.
  • Configurable products that need optional accessories, add-on services, or companion products.
  • Stores that need cart editing while preserving structured add-on values.
  • Store API, block-cart, or custom frontend cart surfaces that require normalized add-on payloads.
  • Vendor-aware carts where add-ons must feed into pricing, tier displays, or fulfillment context.
  • AI-assisted product creation where the customer can generate a file or image before purchase.

---

5. Customer-Facing Workflow

On eligible WooCommerce products, the plugin renders add-on groups before the standard add-to-cart button. The customer can complete the fields assigned to that product and submit the product normally.

A typical customer flow looks like this:

  1. Customer opens a product with one or more matching add-on groups.
  2. The frontend renderer displays the group title and configured add-on fields.
  3. Customer selects options, uploads files, chooses swatches, enters notes, or triggers AI image generation where enabled.
  4. Frontend JavaScript updates projected pricing based on base price, quantity, fixed add-ons, percent add-ons, creator asset fees, and licensed asset fees.
  5. On add-to-cart, the plugin captures submitted add-on data into _apadd_addons and related canonical cart item keys.
  6. If any selected field is a product/variation add-on, the plugin injects the selected product or variation as a separate linked WooCommerce cart line.
  7. Cart, checkout, Store API, and order metadata preserve the selected configuration for downstream workflows.

---

6. Admin Workflow

The plugin registers an internal add-on group management experience under the custom post type:

athenian_addon_group

Admin users can create an add-on group, configure its fields, assign targeting rules, set priority, optionally attach a group image, and publish the group for eligible products.

Add-on Group Builder

Each add-on group supports a draggable field builder with field cards. Field configuration includes:

  • Field label.
  • Internal field name/slug.
  • Field type.
  • Placeholder/default text.
  • Required field flag.
  • Help text.
  • Field-level pricing mode and value.
  • Option rows for choice-based fields.
  • Option images for image-based fields.
  • Option swatch/style definitions, including solid colors and structured gradients.
  • File accept rules and max upload sizing where relevant.
  • Per-option upload behavior for multi-select fields.
  • AI image generation enablement for file and multi-select upload flows.
  • Product-choice source, UI mode, quantity mode, and exposed product metadata.

> Source excerpt shortened for the baseline web reference; the linked repository remains authoritative for the complete document.

Install

Installed and canonical identity
  • Plugin file: athenian-product-addons/athenian-product-addons.php
  • Live installed version: 3.56.80
  • Canonical repository version: 3.56.74
  • Version drift requires review before publication: live 3.56.80, canonical 3.56.74.
  • Product ID: 90235

Configuration

Reference documents available for manual verification
  • CHANGELOG.md u2014 Changelog; 3.56.74
  • README.md u2014 Athenian Product Add-ons; Included source; Verification
  • docs/athenian-platform-marketing.md u2014 Product Addons - Marketing Platform Brief; Product Positioning; Platform Value; Primary Audiences; Key Capabilities to Promote; Ecosystem Fit; Suggested Product Page Short Description; Suggested Product Page Long Description

  • docs/athenian-platform-technical.md u2014 Product Addons - Technical Platform Brief; Plugin Identity; Technical Purpose; Source Inputs Reviewed; Source-Derived Signals; Implementation Surfaces; WordPress and WooCommerce Touchpoints; Data and Configuration

  • docs/technical-marketing.md u2014 Athenian Product Add-ons u2014 Technical & Marketing Overview; 1. Executive Summary; 2. Marketing Positioning; Short Positioning Statement; One-Sentence Description; Website Description; Sales-Focused Description; 3. Core Value Proposition

Usage

Developer reference excerpt
  • ---nplugin_slug: athenian-product-addonsnplugin_name: athenian-product-addonsndoc_type: technicalnsource_batch: temp-athenian-plugin-markdown-sources-20260701-094754nsource_priority: updated-overlay-plus-reponprimary_category_id: cat-commerce-catalogncategory_ids: 'cat-commerce-catalog'ntag_ids: 'tag-wordpress-plugin;tag-woocommerce;tag-product-data'nsite_nav_section_ids: 'nav-ecommerce-marketplaces'nsource_plugin_path: 'C:UsersscottDocumentsGitHubathenian-product-addons'ngenerated_at: 2026-07-01T15:51:27Z ---

    Product Addons - Technical Platform Brief

    Plugin Identity

    • Plugin slug: athenian-product-addons
    • Plugin folder: C:UsersscottDocumentsGitHubathenian-product-addons
    • Plugin header file(s): athenian-product-addons.php
    • Header name: Athenian Product Add-ons
    • Version: 3.56.74
    • Primary category: Commerce Catalog & Merchandising
    • Category IDs: cat-commerce-catalog
    • Tag IDs: tag-wordpress-plugin;tag-woocommerce;tag-product-data
    • Source priority: updated-overlay-plus-repo

    Technical Purpose

    First-party replacement for WAPF add-ons.

    Within the Athenian Platform ecosystem, this plugin is documented as part of the following operating context:

    • cat-commerce-catalog: Product catalog, merchandising, inventory, pricing, add-ons, bundles, catalog output, and checkout-adjacent product experiences.
    • nav-ecommerce-marketplaces: Commerce, marketplace, catalog, orders, shipping, cha

    els, and WooCommerce products.

    Source Inputs Reviewed

    • athenianbrands-updated-markdowns: athenian-product-addons-technical-marketing.md
    • plugin-repo-markdown: athenian-product-addons-marketing-document.md
    • Source character count: 48953
    • PHP files sca

    ed: 22

    Source-Derived Signals

    Key source headings and repeated concepts identified from the current Markdown corpus:

    • Athenian Product Add-ons u2014 Technical & Marketing Overview
    • 1. Executive Summary
    • 2. Marketing Positioning
    • Short Positioning Statement
    • One-Sentence Descriptio
    • Website Descriptio
    • Sales-Focused Descriptio
    • 3. Core Value Propositio
    • Key Benefits
    • 4. Best-Fit Use Cases
    • 5. Customer-Facing Workflow
    • 6. Admin Workflow

    Representative source context:

    • Plugin: Athenian Product Add-ons Slug / package: athenian-product-addons Version inspected: 3.56.74 Author: Scott Mays | Athenian Brands Primary platform: WordPress + WooCommerce Primary purpose: First-party WooCommerce product configuration, add-on pricing, visual option selection, upload...
    • Athenian Product Add-ons is a first-party WooCommerce add-on and configuration system built for the Athenian commerce platform. It replaces generic WAPF-style product option plugins with a structured, platform-aware add-on layer that can render configurable product fields, calculate add-on pricing, capture uploads and...
    • The plugin is designed for storefronts where product options are not just simple form fields. It supports visual selection patterns, image and swatch choices, multi-select fields with per-option uploads, file and URL-backed configuration, product/variation add-ons that become real WooCommerce cart lines, AI image-gene...
    • In practical terms, Athenian Product Add-ons turns customer customization choices into durable commerce data that can be priced, displayed, edited, synchronized, sent through Store API responses, and stored on the final WooCommerce order.
    • Athenian Product Add-ons turns WooCommerce product options into structured, price-aware, transaction-ready configuration data for complex storefronts.

    Implementation Surfaces

    Main PHP files:

    • athenian-product-addons.php

    Namespaces and classes:

    • AthenianPlatformCoreIntegrationsWooCommerce
    • AthenianPlatformCoreIntegrationsVendors
    • AthenianProductAddons
    • AthenianProductAddonsAjax
    • AthenianProductAddonsServices
    • APA_Addons
    • Cart_To_Order_Meta
    • PriceDelegate
    • Store_Cart_Extensions
    • Addon_Groups
    • Admin_UI
    • Admi
    • AI_Credits
    • AI
    • Generate
    • Prompts
    • ATH_Addons_Cart_Bridge
    • Cart_Editor
    • Price_Engine
    • Cart_Integratio
    • CPT
    • External_Staging
    • Frontend_Render
    • Frontend
    • OpenAI_Service

    WordPress hooks:

    • rest_api_init
    • wp_ajax_apadd_upload_file
    • wp_ajax_nopriv_apadd_upload_file
    • plugins_loaded
    • woocommerce_init
    • init
    • woocommerce_checkout_create_order_line_item
    • woocommerce_store_api_checkout_update_order_from_request
    • woocommerce_checkout_update_order_meta
    • woocommerce_checkout_order_processed
    • woocommerce_cart_loaded_from_sessio
    • woocommerce_before_calculate_totals
    • woocommerce_after_calculate_totals
    • add_meta_boxes
    • save_post_
    • admin_enqueue_scripts
    • wp_ajax_apadd_search_products
    • wp_ajax_apadd_search_services
    • wp_ajax_apadd_search_terms
    • admin_init
    • admin_menu
    • wp_ajax_apadd_generate_image
    • wp_ajax_nopriv_apadd_generate_image
    • wp_ajax_apadd_pimp_prompt
    • wp_ajax_nopriv_apadd_pimp_prompt
    • wp_ajax_apadd_progress_snippets
    • wp_ajax_nopriv_apadd_progress_snippets
    • accb/apply_addons_meta_to_cart_item
    • a

    [Excerpt truncated for the initial reference draft.]

Shortcodes

Detected shortcodes

REST Endpoints

Detected REST routes
  • ath-apa/v1/upload u2014 includes/class-frontend.php
  • apadd/v1/stage u2014 includes/class-external-staging.php
  • apc/v1/price-probe u2014 cart/PriceDelegate.php

Hooks

Detected hooks
  • init u2014 includes/class-cpt.php
  • woocommerce_store_api_cart_add_item_data u2014 includes/class-cart-integration.php
  • woocommerce_store_api_add_to_cart_data u2014 includes/class-cart-integration.php
  • woocommerce_store_api_cart_item u2014 includes/class-cart-integration.php
  • woocommerce_store_api_cart_item_schema u2014 includes/class-cart-integration.php
  • woocommerce_add_cart_item_data u2014 includes/class-cart-integration.php
  • woocommerce_add_to_cart u2014 includes/class-cart-integration.php
  • woocommerce_remove_cart_item u2014 includes/class-cart-integration.php
  • woocommerce_after_cart_item_quantity_update u2014 includes/class-cart-integration.php
  • woocommerce_get_cart_item_from_session u2014 includes/class-cart-integration.php
  • woocommerce_get_item_data u2014 includes/class-cart-integration.php
  • woocommerce_checkout_create_order_line_item u2014 includes/class-cart-integration.php
  • woocommerce_before_calculate_totals u2014 includes/class-cart-integration.php
  • ath_addons/render_fields_html u2014 includes/class-cart-integration.php
  • ath_addons/apply_posted_meta u2014 includes/class-cart-integration.php
  • ath_addons/should_render_in_accb u2014 includes/class-cart-integration.php
  • ath_addons/should_render_in_cart u2014 includes/class-cart-integration.php
  • wp_enqueue_scripts u2014 includes/class-frontend-render.php
  • woocommerce_before_add_to_cart_button u2014 includes/class-frontend-render.php
  • wp_ajax_apadd_generated_file_upload u2014 includes/class-frontend-render.php
  • wp_ajax_nopriv_apadd_generated_file_upload u2014 includes/class-frontend-render.php
  • ath_product_addons_html u2014 includes/class-frontend-render.php
  • apc_ai/policy u2014 includes/class-ai-credits.php
  • admin_init u2014 includes/class-ai-credits.php

Data Model

Technical source excerpt
  • ---nplugin_slug: athenian-product-addonsnplugin_name: athenian-product-addonsndoc_type: technicalnsource_batch: temp-athenian-plugin-markdown-sources-20260701-094754nsource_priority: updated-overlay-plus-reponprimary_category_id: cat-commerce-catalogncategory_ids: 'cat-commerce-catalog'ntag_ids: 'tag-wordpress-plugin;tag-woocommerce;tag-product-data'nsite_nav_section_ids: 'nav-ecommerce-marketplaces'nsource_plugin_path: 'C:UsersscottDocumentsGitHubathenian-product-addons'ngenerated_at: 2026-07-01T15:51:27Z ---

    Product Addons - Technical Platform Brief

    Plugin Identity

    • Plugin slug: athenian-product-addons
    • Plugin folder: C:UsersscottDocumentsGitHubathenian-product-addons
    • Plugin header file(s): athenian-product-addons.php
    • Header name: Athenian Product Add-ons
    • Version: 3.56.74
    • Primary category: Commerce Catalog & Merchandising
    • Category IDs: cat-commerce-catalog
    • Tag IDs: tag-wordpress-plugin;tag-woocommerce;tag-product-data
    • Source priority: updated-overlay-plus-repo

    Technical Purpose

    First-party replacement for WAPF add-ons.

    Within the Athenian Platform ecosystem, this plugin is documented as part of the following operating context:

    • cat-commerce-catalog: Product catalog, merchandising, inventory, pricing, add-ons, bundles, catalog output, and checkout-adjacent product experiences.
    • nav-ecommerce-marketplaces: Commerce, marketplace, catalog, orders, shipping, cha

    els, and WooCommerce products.

    Source Inputs Reviewed

    • athenianbrands-updated-markdowns: athenian-product-addons-technical-marketing.md
    • plugin-repo-markdown: athenian-product-addons-marketing-document.md
    • Source character count: 48953
    • PHP files sca

    ed: 22

    Source-Derived Signals

    Key source headings and repeated concepts identified from the current Markdown corpus:

    • Athenian Product Add-ons u2014 Technical & Marketing Overview
    • 1. Executive Summary
    • 2. Marketing Positioning
    • Short Positioning Statement
    • One-Sentence Descriptio
    • Website Descriptio
    • Sales-Focused Descriptio
    • 3. Core Value Propositio
    • Key Benefits
    • 4. Best-Fit Use Cases
    • 5. Customer-Facing Workflow
    • 6. Admin Workflow

    Representative source context:

    • Plugin: Athenian Product Add-ons Slug / package: athenian-product-addons Version inspected: 3.56.74 Author: Scott Mays | Athenian Brands Primary platform: WordPress + WooCommerce Primary purpose: First-party WooCommerce product configuration, add-on pricing, visual option selection, upload...
    • Athenian Product Add-ons is a first-party WooCommerce add-on and configuration system built for the Athenian commerce platform. It replaces generic WAPF-style product option plugins with a structured, platform-aware add-on layer that can render configurable product fields, calculate add-on pricing, capture uploads and...
    • The plugin is designed for storefronts where product options are not just simple form fields. It supports visual selection patterns, image and swatch choices, multi-select fields with per-option uploads, file and URL-backed configuration, product/variation add-ons that become real WooCommerce cart lines, AI image-gene...
    • In practical terms, Athenian Product Add-ons turns customer customization choices into durable commerce data that can be priced, displayed, edited, synchronized, sent through Store API responses, and stored on the final WooCommerce order.
    • Athenian Product Add-ons turns WooCommerce product options into structured, price-aware, transaction-ready configuration data for complex storefronts.

    Implementation Surfaces

    Main PHP files:

    • athenian-product-addons.php

    Namespaces and classes:

    • AthenianPlatformCoreIntegrationsWooCommerce
    • AthenianPlatformCoreIntegrationsVendors
    • AthenianProductAddons
    • AthenianProductAddonsAjax
    • AthenianProductAddonsServices
    • APA_Addons
    • Cart_To_Order_Meta
    • PriceDelegate
    • Store_Cart_Extensions
    • Addon_Groups
    • Admin_UI
    • Admi
    • AI_Credits
    • AI
    • Generate
    • Prompts
    • ATH_Addons_Cart_Bridge
    • Cart_Editor
    • Price_Engine
    • Cart_Integratio
    • CPT
    • External_Staging
    • Frontend_Render
    • Frontend
    • OpenAI_Service

    WordPress hooks:

    • rest_api_init
    • wp_ajax_apadd_upload_file
    • wp_ajax_nopriv_apadd_upload_file
    • plugins_loaded
    • woocommerce_init
    • init
    • woocommerce_checkout_create_order_line_item
    • woocommerce_store_api_checkout_update_order_from_request
    • woocommerce_checkout_update_order_meta
    • woocommerce_checkout_order_processed
    • woocommerce_cart_loaded_from_sessio
    • woocommerce_before_calculate_totals
    • woocommerce_after_calculate_totals
    • add_meta_boxes
    • save_post_
    • admin_enqueue_scripts
    • wp_ajax_apadd_search_products
    • wp_ajax_apadd_search_services
    • wp_ajax_apadd_search_terms
    • admin_init
    • admin_menu
    • wp_ajax_apadd_generate_image
    • wp_ajax_nopriv_apadd_generate_image
    • wp_ajax_apadd_pimp_prompt
    • wp_ajax_nopriv_apadd_pimp_prompt
    • wp_ajax_apadd_progress_snippets
    • wp_ajax_nopriv_apadd_progress_snippets
    • accb/apply_addons_meta_to_cart_item
    • a

    [Excerpt truncated for the initial reference draft.]

API Reference

Scan and repository evidence
  • Manifest hash: 64d01e2cf80ccd799c417788d7fa399fd82d22bf
  • Sca

    ed file count: 38

  • Canonical repository commit: 0c1a2d38469278678d0c5c149f591a129ea80d47
  • Sca

    er mode: installed plugin analyzer

Troubleshooting

Review gates
  • This document remains unpublished until the reference material and live behavior are manually verified.
  • Version drift requires review before publication: live 3.56.80, canonical 3.56.74.
  • The installed-plugin analyzer was exercised for this regular plugin.

FAQ

Is this reference published?

No. It is a draft for manual verification and enrichment.

Which source should reviewers treat as authoritative?

The pi

ed repository commit is the canonical source reference; the live installation is the deployed-behavior reference. Any difference is recorded as a review item.

Changelog

3.56.80 2026-10-06
  • Changelog

    3.56.74

    • Promoted the Product Add-ons, cart, pricing, Store API, and AI runtime into an clean private repository.
    • Excluded temporary live overlays, browser captures, generated output, icons,n and upload archives.
    • Added reproducible release metadata, repository contract checks, and CI.