Reports

Auctions → Reports — ?page=wkafw-reports

Revenue, bidder, auction, and category breakdowns — with CSV export for every view. Fully HPOS-aware (works with WooCommerce's modern order storage).

Reports → Overview — at-a-glance metrics across the selected date range with the tab strip (OVERVIEW · REVENUE · BID ANALYTICS · TOP USERS · TOP SELLERS) and 7 D / 30 D / 90 D / ALL range chips

Report views

View	What it shows	Export
Revenue	Daily / weekly / monthly platform revenue, broken into settled vs fees	CSV
By Type	Revenue split by auction type	CSV
By Vendor	Multi-vendor revenue / commission split (if applicable)	CSV
By Category	Revenue rolled up by WooCommerce product category	CSV
Top Bidders	All-time and ranged top users by bid count + spend	CSV
Top Auctions	Most-contested lots in the date range	CSV
Conversion Funnel	Auctions → Bidders → Winners → Paid	CSV
Payment Status	Paid / overdue / unpaid winners	CSV

Revenue tab

Settled revenue against platform fees over the selected date range, with a daily series and a one-click CSV export. Use this view to answer "how much money came in this period?".

Reports → Revenue — settled revenue, fees split, daily series and CSV export

Bid volume, average bids per auction, hourly distribution and the share of bids placed by the proxy bidder. Use this to find the best end-times for your auctions and to spot bidding-pattern anomalies.

Reports → Bid Analytics — bid volume, average bids per auction, hourly distribution and proxy share

Top Users tab

Leaderboard of bidders ranked by activity and spend across the range, including their win rate and last-bid timestamp. Pair with the Audit Log for VIP-customer verification.

Reports → Top Users — leaderboard of bidders ranked by activity and spend across the date range

Top Sellers tab

Multi-vendor revenue split — gross sales per seller, commission earned, payout owed. Available only when a vendor plugin (WCFM / Dokan / WC Vendors / YITH) is active.

Reports → Top Sellers — multi-vendor revenue split with commission and gross sales per seller

Date range

Top-right of every view: 7 D / 30 D / 90 D / This Year / Custom.

Custom range opens a date picker; persisted via ?from=YYYY-MM-DD&to=YYYY-MM-DD.

Revenue model

The plugin distinguishes:

Term	Source
Settled revenue	Sum of completed orders that originated from a winning auction bid
Platform fees	Listing fees, buyer's premium, late penalty, featured boost — written to `wkafw_vendor_commissions`
Total revenue	Settled + Fees

Monetization → explains how each fee is configured.

Conversion funnel

Five stages, computed for the date range:

Auctions Listed — count of auctions started in range
Bidders — distinct user_id count in wkafw_bids for those auctions
Winners — auctions with status = ended and a winner assigned
Paid Winners — auctions with status = paid
Linked Orders — count of WooCommerce orders that originated from a winning auction

Drop-off between any two stages is shown as a percentage. Useful for spotting:

High Auctions → Bidders drop = listings aren't compelling
High Winners → Paid drop = collection problem (use Auto-charge)

Payment status

Three buckets:

Status	Meaning
Paid	Order completed within `wkafw_payment_deadline` (default 48 hours)
Overdue	Past deadline, no order completion
Unpaid	Past deadline + auto-relist triggered

Click a bucket to filter All Auctions to those rows.

CSV export

Each view has an Export → CSV button at the top right.

Size	Behavior
< 500 rows	Streams immediately
≥ 500 rows	Queued via Action Scheduler; you'll get a download link via email + an in-app notice when ready

CSV columns mirror the on-screen table.

Scheduling reports

Each view supports Schedule → Daily / Weekly / Monthly. The report runs at the chosen interval and emails the CSV to a list of recipients.

Setting	Where
Recipients	Per-report; comma-separated email list
Time	Site timezone, default 06:00
Format	CSV (XLSX optional)

Scheduled reports use the wkafw_process_scheduled_export Action Scheduler hook.

You want to...	View
Tax-time revenue summary	Revenue → year-to-date → CSV
Spot-check best-selling category	By Category → 90 D
Identify VIP buyers for outreach	Top Bidders → all-time → CSV
Detect a drop in listings	Conversion Funnel → 30 D → check stage 1
Pay vendors monthly	By Vendor → 30 D → CSV → import to your accounting