Multi-Vendor Compatibility

The plugin natively integrates with four multi-vendor plugins. Vendor onboarding, dashboards, and payouts stay in the multi-vendor plugin — auction-specific UI is layered in.

Supported plugins

• WCFM Marketplace
• Dokan
• WC Vendors
• YITH Multi-Vendor

The plugin auto-detects which multi-vendor plugin is active and adapts its UI on top of it. If more than one is active, priority is WCFM > Dokan > WC Vendors > YITH (for legacy compatibility reasons). If none are active, the plugin runs in single-vendor mode — the admin owns all auctions.

What the integration does

Vendor side

The vendor never sees the auction admin pages — those are admin-only.

Admin side

Commission flow

When an auction sells:

Customer pays $100 → Order completes
   ↓
wkafw_vendor_commissions table:
   ├── Insert row: vendor_id=12, auction_id=N, total=$100,
   │   commission_rate=10%, commission_amount=$10,
   │   vendor_earning=$90, adapter_slug='wcfm', status='pending'
   ↓
Multi-vendor plugin's payout system reads commissions
   ↓
On payout date (per multi-vendor plugin's schedule):
   ├── Vendor gets $90
   └── Platform keeps $10

For Stripe Connect, the split is done at the payment level (Stripe sends $90 directly to the vendor's connected account, $10 to platform).

Per-plugin notes

WCFM Marketplace

• Auction creation appears under Products → Add New Product with auction-type fields
• Vendor-side bid view at WCFM → Auctions (custom page)
• Commissions flow through WCFM's commission table, with auction-specific rate from wkafw_commission_override_wcfm
• Withdrawals use WCFM's withdrawal system

Dokan

• Auction creation in Dokan dashboard → Products → Add Product
• Vendor sees bids in Dokan dashboard → Auctions (custom)
• Commissions integrate with Dokan's commission engine
• Withdrawal via Dokan's standard flow

WC Vendors

• Pro version recommended (free version has limited product creation)
• Auction creation in vendor dashboard → Add Product
• Commissions via WC Vendors' default split logic
• Withdrawal via WC Vendors' Pro feature

YITH Multi-Vendor

• Auction creation in vendor dashboard → Products
• Commissions stored separately in wkafw_vendor_commissions
• Payouts manual via YITH's vendor list

Lot moderation

When wkafw_lot_review_enabled = yes:

• Vendor-created auctions enter pending state
• Admin reviews in Pending Review
• Approve / reject / edit before lot goes live

Recommended for new vendor onboarding; optional for trusted vendors.

Vendor ratings

Buyers can rate sellers after winning an auction:

• 1–5 stars + optional review
• Stored in wkafw_vendor_ratings
• Public on vendor's store page (configurable)

Vendor onboarding (KYC for marketplace)

If your platform requires vendor KYC (regulatory or legal):

The auction plugin doesn't ship its own vendor onboarding — that stays in the multi-vendor plugin.

Settings

Auctions → Settings → Multi-Vendor:

Reporting

Reports → By Vendor:

• Top vendors by revenue
• Average winning bid per vendor
• Listing → sale conversion per vendor
• Average dispute rate per vendor (warning indicator)
• Outstanding commission per vendor

Common questions

"What if no multi-vendor plugin is active?"

The plugin runs in single-vendor mode. Admin owns all auctions. Vendor-related settings, the Pending Review menu, and commissions are still available but unused.

"Can vendors set their own auction-specific commission?"

Not directly. Admin sets the commission per-adapter via wkafw_commission_override_*. To override per-vendor:

"How do I migrate existing vendor commissions to the auction plugin's table?"

Use Tools → Maintenance → Recalculate vendor balances — reads the multi-vendor plugin's commission table and writes equivalent rows to wkafw_vendor_commissions.