Athenian Service Provider Platform
product details.
Athenian Service Provider Platform adds provider onboarding, service offers, geo discovery, quoting, request orders, and buyer-provider messaging on top of WooCommerce. It helps teams manage service supply, customer requests, provider communication, and commerce records in one connected marketplace flow while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Service Provider Platform is a WordPress and WooCommerce marketplace layer for service-based commerce. It turns WooCommerce products and variations into provider-owned service offers that can be onboarded, priced, discovered by location, quoted, added to cart, requested as orders, and supported through buyer-provider messaging.
Instead of treating services as static catalog pages, the plugin introduces an offer-centric workflow that connects provider identity, vendor profiles, WooCommerce product or variation targets, geographic service areas, vendor-specific pricing, service keys, and customer communication into one operational model. Each ath_sp_offer record can link an Athenian Social Users person record, vendor profile, vendor user, service category, product/variation target, geo metadata, active state, SwapShop availability, and offer catalog items.
For marketplace operators, the plugin provides the missing service-commerce layer between WooCommerce, provider onboarding, local discovery, quote workflows, and service request orders. Providers can onboard, select services, manage linked offers, edit catalog items, update pricing, and enable SwapShop availability. Customers can search by location and service type, view provider offers, configure a service, request a quote, add it to cart, create a pending service order, and message the provider.
Within the broader Athenian Platform, Athenian Service Provider Platform acts as a bridge between Athenian Social Users Core, WooCommerce, vendor/dropship pricing, SwapShop listings, Google Places, Leaflet-based marketplace search, messaging, and service request workflows.
How Athenian Service Provider Platform fits the Athenian Platform
Platform role: Athenian Service Provider Platform is a focused capability in the Service, Workforce & Learning Platforms and Vendor, Marketplace & Multi-Party Commerce layer. Its primary scope covers Scheduling, Booking & Field Service and Service Provider Marketplaces while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Service Provider Platform 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.
Provider Marketplace
Turn Providers, Vendors, and WooCommerce Services Into Marketplace Offers
Athenian Service Provider Platform introduces a dedicated Service Offer model
that connects provider identity, vendor linkage, WooCommerce products or
variations, service keys, geographic metadata, pricing context, and active state.
| Provider Layer | Operational Value |
|---|---|
| Provider Onboarding | Capture provider profile details, service radius, address/geolocation, contact details, credentials, service categories, and service selections. |
| Service Offers | Create ath_sp_offer records that connect person records, vendor profiles, vendor users, service keys, targets, and offer items. |
| Provider Dashboard | Allow linked providers to manage editable offers, catalog items, pricing, lead times, active state, and SwapShop availability. |
| Readiness Checks | Help staff verify person, vendor, user, product target, and geo completeness before exposing offers to marketplace flows. |
- Uses the primary Service Offer CPT
ath_sp_offer. - Supports provider onboarding through the shortcode name
'ath_sp_provider_onboard'. - Supports provider offer management through the shortcode name
'ath_sp_provider_dashboard'. - Stores offer linkage metadata such as
_ath_sp_provider_person_id,_ath_sp_vendor_id,_ath_sp_vendor_user_id, and_ath_sp_offer_items_json.
Location-Aware Commerce
Let Buyers Search, Quote, Customize, and Convert Service Offers
The plugin provides a public marketplace interface with location-aware
provider discovery, offer feeds, map pins, quote-ready pricing, service
customization, add-to-cart support, and pending service request orders.
Find providers by latitude, longitude, radius, service key, and result limit
Calculate service pricing from offer, target, quantity, vendor tiers, and distance context
Create pending WooCommerce orders with provider, vendor, target, and request metadata
| Commerce Layer | How It Helps |
|---|---|
| Geo Discovery | Use the public /ath-sp/v1/providers route to return nearby provider offers based on search location and service filters. |
| Offer Builder | Let buyers select service items, quantities, notes, quote refresh, and add-to-cart from a selected provider offer. |
| Vendor Pricing | Read and write canonical vendor pricing rows on WooCommerce products or variations for service-specific pricing. |
| Order Metadata | Preserve offer ID, service key, provider person ID, vendor ID, target ID, unit price, quantity, distance, and request JSON on service orders. |
- Supports the marketplace UI through the shortcode name
'ath_sp_marketplace'. - Supports service configuration through the shortcode name
'ath_sp_offer_builder'. - Uses Leaflet and OpenStreetMap tile layers for the frontend marketplace map.
- Provides Google Places autocomplete and place-detail proxy routes intended to keep Google API keys server-side.
Marketplace Operations
Connect Service Offers to Messaging, SwapShop, ASU, Vendors, and REST Workflows
Athenian Service Provider Platform coordinates service-commerce context across
buyer-provider messaging, Athenian Social Users Core, vendor pricing,
SwapShop service listings, REST APIs, and WooCommerce order workflows.
| Integration Layer | Operational Purpose |
|---|---|
| Messaging | Provide buyer-provider inboxes, message threads, replies, unread state, offer context, and optional ASU message mirroring. |
| ASU Integration | Extend ASU person records with provider fields and add a Service Offers tab to the person editor. |
| SwapShop Bridge | Expose service offers as SwapShop-eligible listing options and target snapshots for service listing workflows. |
| REST Surface | Expose onboarding, catalog, offer management, people/vendor lookup, marketplace search, quote, request-order, and messaging APIs. |
A service marketplace bridge for the Athenian Platform:
ASU supplies person identity, WooCommerce supplies commerce, vendor records
supply pricing context, SwapShop supplies listing opportunities, and this
plugin coordinates those pieces into a provider-service marketplace workflow.
- Supports buyer/provider conversations through the shortcode name
'ath_sp_messages'. - Registers message CPTs
ath_sp_message_threadandath_sp_message. - Uses hooks such as
ath_sp_service_request_order_createdandath_sp_offer_swapshop_contract_changed. - Builds toward provider approvals, availability calendars, service completion ratings, notifications, distance-based pricing, map clustering, and conversion reporting.