Athenian WooCommerce Dropship

docs/athenian-platform-marketing.md u2014 WC Dropship - 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 WC Dropship - Technical Platform Brief; Plugin Identity; Technical Purpose; Source Inputs Reviewed; Source-Derived Signals; Implementation Surfaces; WordPress and WooCommerce Touchpoints; Data and Configuration

docs/developer/athenian-wc-dropship-developer-documentation.md u2014 Athenian WooCommerce Dropship Developer Documentation; Overview; High-Level Architecture; Bootstrap Sequence; Core constants and autoloading; WooCommerce feature declarations; Activation and rewrite behavior; Hard dependency on Athenian Platform Core

docs/marketing/athenian-wc-dropship-marketing-document.md u2014 Athenian WooCommerce Dropship Marketing Draft; Working positioning; Executive summary; Core marketing message; The problem Athenian WooCommerce Dropship solves; What Athenian WooCommerce Dropship does; 1. Builds a usable vendor network inside WooCommerce; 2. Makes vendor offers actionable at the product level

docs/marketing/athenian-wc-dropship-platform-overview.md u2014 Athenian WooCommerce Dropship Marketing Overview; Positioning Statement; Executive Summary; What Athenian WooCommerce Dropship Brings To The Platform; Ecosystem Narrative; Athenian Platform Core; Athenian Print Forge; Athenian Product Add-ons

docs/technical-marketing.md u2014 Athenian WooCommerce Dropship 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

Athenian WooCommerce Dropship Developer Documentatio

Overview

Athenian WooCommerce Dropship is a WooCommerce vendor-orchestration plug-in that adds vendor onboarding, vendor portals, competitive vendor offer handling, cart and Store API vendor selection, shipping package splitting, purchase-order generation, vendor email dispatch, shipment-label workflows, and payout-ready settlement snapshots.

In this repository snapshot, the plug-in acts as the supply-side execution layer of the broader Athenian Platform and is designed to work with:

• WooCommerce for cart, checkout, orders, shipping, and order-item storage
• Athenian Platform Core (required) for the canonical Vendor CPT and shared bridge patterns
• optional ACF field groups for vendor and PO data entry
• optional Athenian Print Forge and Product Add-ons order metadata for artwork, proofing, and production-file handoff

High-Level Architecture

The main bootstrap file is athenian-wc-dropship.php. It defines constants, registers the namespace autoloader, declares WooCommerce feature compatibility, checks for WooCommerce and Athenian Platform Core, and then defers all runtime bootstrapping to AthenianWCDropshipPlugin.

At a high level, the plug-in is composed of seven layers:

1. Bootstrap and compatibility declarations
2. Vendor and storefront runtime wiring
3. Cart and Store API vendor persistence
4. Shipping package splitting and rate a

otatio

1. Purchase-order generation and vendor communications
2. Shipment and payout workflows
3. Admin, vendor onboarding, and portal surfaces

Bootstrap Sequence

Core constants and autoloading

The root plug-in file defines:

• AB_WCDS_PATH
• AB_WCDS_URL
• AB_WCDS_VERSION
• AB_WCDS_DEBUG

It also registers a PSR-4-ish autoloader for classes under AthenianWCDropship*, with a dashed-file fallback for class files such as class-vendor-portal-shortcode.php.

WooCommerce feature declarations

On before_woocommerce_init, the plug-in declares compatibility with:

• custom_order_tables
• cart_checkout_blocks
• new_product_editor

Activation and rewrite behavior

includes/Setup.php handles basic lifecycle work:

• activation sets _ab_wcds_needs_flush=1
• init loads the text domai

• init flushes rewrites once after activation when needed

The main plug-in also registers the Woo My Account vendor endpoint during runtime.

Hard dependency on Athenian Platform Core

Plugin::__construct() exits early with an admin notice if APC_PATH is not defined. In practice, this plug-in expects Athenian Platform Core to provide the canonical Vendor CPT and shared platform wiring.

Primary boot path

Once WooCommerce is available, Plugin::instance() wires the major runtime modules:

• assets
• setup and admin classes
• vendor role and vendor-user linking helpers
• shortcodes and vendor profile routes
• APF vendor buybox integratio

• PO subsystem
• shipping, email, PDF, and shipment label services
• REST controllers

Main Runtime Modules

1. Root orchestrator

The main runtime orchestrator lives in includes/Plugin.php.

Responsibilities:

• verifies Platform Core is present
• initializes feature modules
• exposes canonical meta keys such as _apc_vendor_eligible and _apc_vendor_offers
• manages vendor role creatio

• manages vendor post to user and user to vendor linking
• renders APF vendor buybox fallback HTML through the ath/apc/vendor_buybox_html filter

Important constants in this class include:

• META_VENDOR_ELIGIBLE = _apc_vendor_eligible
• META_VENDOR_OFFERS = _apc_vendor_offers
• META_VENDOR_USER_ID = _ab_vendor_user_id
• META_USER_VENDOR_ID = _ab_vendor_id
• ROLE_VENDOR = vendor

2. Asset system

The front-end asset registry lives in includes/class-assets.php.

Responsibilities:

• registers cart, archive, vendor selector, buybox, profile, and APF bridge scripts
• registers vendor selector, buybox, and cart styles
• conditionally enqueues assets on product, cart, and archive-like views
• injects a shared window.APC_CART_VENDOR_CFG payload for front-end consumers

Notable registered handles include:

• apc-cart-vendor-blocks
• apc-cart-vendor-single
• apc-cart-vendor-archives
• apc-vendor-selector
• ab-vendor-profile
• ab-wcds-vendor-buybox
• ab-wcds-apf-vendor-bridge

3. Vendor resolution and offer storage

Vendor offer and resolution logic is split across:

• includes/Vendors/VendorResolver.php
• includes/Vendors/VendorPricingOffers.php

VendorResolver handles fulfillment-oriented vendor eligibility and vendor selection rules.

Responsibilities:

• reads canonical fulfillment offers from _apc_vendor_offers
• falls back from variations to parent products
• supports legacy single-vendor meta synthesis
• treats unpi

ed cart items as Store by default

• resolves vendor origin data from vendor post meta

VendorPricingOffers handles pricing-offer persistence.

Responsibilities:

• stores vendor prici

n[Excerpt truncated for the initial reference draft.]

---nplugin_slug: athenian-wc-dropshipnplugin_name: athenian-wc-dropshipndoc_type: technicalnsource_batch: temp-athenian-plugin-markdown-sources-20260701-094754nsource_priority: updated-overlay-plus-reponprimary_category_id: cat-marketplace-cha

elsncategory_ids: 'cat-orders-fulfillment;cat-marketplace-cha

els'ntag_ids: 'tag-wordpress-plugin;tag-orders;tag-operations;tag-shipping;tag-logistics;tag-fulfillment;tag-dropship;tag-marketplace;tag-co

ectors'nsite_nav_section_ids: 'nav-ecommerce-marketplaces'nsource_plugin_path: 'C:UsersscottDocumentsGitHubathenian-wc-dropship'ngenerated_at: 2026-07-01T15:51:27Z ---

WC Dropship - Technical Platform Brief

Plugin Identity

• Plugin slug: athenian-wc-dropship
• Plugin folder: C:UsersscottDocumentsGitHubathenian-wc-dropship
• Plugin header file(s): athenian-wc-dropship.php
• Header name: Athenian WooCommerce Dropship
• Version: 0.4.1
• Primary category: Orders, Fulfillment & Logistics
• Category IDs: `cat-orders-fulfillment;cat-marketplace-cha

els`

• Tag IDs: `tag-wordpress-plugin;tag-orders;tag-operations;tag-shipping;tag-logistics;tag-fulfillment;tag-dropship;tag-marketplace;tag-co

ectors`

• Source priority: updated-overlay-plus-repo

Technical Purpose

Vendors, dropship flows, vendor portal UI/REST. Works with MU Core Vendors & PriceDelegate.

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

• cat-orders-fulfillment: Order operations, fulfillment workflows, shipping carriers, dropship, returns, cancellations, and customer service resolution.
• cat-marketplace-cha

els: Marketplace operations, external cha

el integrations, supplier/manufacturer workflows, Google Sheets/GraphQL bridges, and multi-vendor commerce.

• nav-ecommerce-marketplaces: Commerce, marketplace, catalog, orders, shipping, cha

els, and WooCommerce products.

Source Inputs Reviewed

• athenianbrands-updated-markdowns: athenian-wc-dropship-technical-marketing.md
• plugin-repo-markdown: docsdeveloperathenian-wc-dropship-developer-documentation.md
• plugin-repo-markdown: docsmarketingathenian-wc-dropship-marketing-document.md
• plugin-repo-markdown: docsmarketingathenian-wc-dropship-platform-overview.md

• Source character count: 84349
• PHP files sca

ed: 66

Source-Derived Signals

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

• Athenian WooCommerce Dropship 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, Vendor, and Admin Workflow
• Customer-Facing Flow

Representative source context:

• Plugin: Athenian WooCommerce Dropship Slug / package: athenian-wc-dropship Version inspected: 0.4.1 Author: Scott Mays | Athenian Brands Text domain: ab-wc-dropship Primary platform: WordPress + WooCommerce Requires: PHP 8.0+, WordPress 6.2+, WooCommerce 7.1+ **WooCommerce compatibili...
• Athenian WooCommerce Dropship is the vendor orchestration and fulfillment-routing layer of the Athenian Platform for WooCommerce. It extends WooCommerce beyond standard store-owned fulfillment by adding vendor onboarding, vendor account linking, product and variation-level vendor offers, storefront vendor selection, c...
• In a conventional WooCommerce store, an order is captured as one transaction, but vendor fulfillment often becomes a fragmented back-office process involving spreadsheets, emails, manually generated purchase orders, external shipping tools, and disco

ected payout calculations. This plugin closes that operational gap...

• The result is a commerce workflow where a customer can select or be routed to a vendor, that vendor choice is preserved through cart and checkout, the order can be split into vendor-specific fulfillment packages, purchase orders can be generated automatically, production files and custom order metadata can be carried...
• Athenian WooCommerce Dropship turns WooCommerce into a vendor-aware fulfillment platform with onboarding, vendor offers, cart routing, purchase orders, shipping labels, shipment confirmation, and payout-ready settlement snapshots.

Implementation Surfaces

Main PHP files:

• athenian-wc-dropship.php

Namespaces and classes:

• AthenianWCDropship
• AthenianWCDropshipAPI
• AthenianWCDropshipAdmi

• AthenianWCDropshipCompat
• AthenianWCDropshipFrontend
• AthenianWCDropshipFrontendCart
• AthenianWCDropshipFrontendShortcodes
• AthenianWCDropshipOrders
• AthenianWCDropshipPO
• AthenianWCDropshipPayout
• AthenianWCDropshipShipping
• AthenianWCDropshipUtil
• AthenianWCDropshipVendors
• missing
• not
• Assets
• Plugi

• Setup
• Vendor_Onboard_REST_Controller
• ACF_Fields
• Dashboard_Vendor_Stats
• Screen_Tidy
• Settings
• Vendor_API_Integratio

• Vendo

[Excerpt truncated for the initial reference draft.]

Sca

ed file count: 102

Sca

er mode: installed plugin analyzer