Onboarding Tour
A guided walkthrough for new admins — written in the order you'd actually click.

Open the dashboard
WP Admin → WooCommerce → Webkul Addons → Auctions Dashboard
You'll land on the analytics shell. On a fresh install everything reads zero — that's expected.
The header shows three range buttons: 7 D / 30 D / 90 D. They re-query the dashboard data for that window. Default is 30 days.
Tour the dashboard
The dashboard has four rows.
Row 1 — KPI cards
| Card | What it counts |
|---|---|
| Total Auctions | Every auction in the database, regardless of status |
| Bids Today | Bids placed since 00:00 in your site timezone |
| Live Bid Pool | Sum of current_price across active + scheduled lots |
| Settled Revenue | Platform revenue from completed auction-flagged orders |
Row 2 — Charts
| Chart | What it shows |
|---|---|
| Revenue & Bid Activity | Dual-axis line: revenue (gold) and bid count (emerald) per day |
| Auction Status | Donut: active / scheduled / ended / paid / failed / paused / cancelled |
Row 3 — More charts
| Chart | What it shows |
|---|---|
| Top 5 Auctions by Bids | Horizontal bar — most-contested lots in the range |
| Bids by Hour of Day | Heat-bar of bid traffic by hour, last 7 days |
Row 4 — Lists
| List | What it shows |
|---|---|
| Top Bidders | 5 most active users in the range |
| Recent Activity | Last 10 entries from the auction log table |
Open Settings
Auctions → Settings
Settings has 8+ tabs. The order to explore them on day one:
- General — poll interval, anti-snipe defaults, currency display
- Bidding — increment defaults, retraction, cooldown
- Auction Types — enable / disable formats you'll offer
- Notifications — email triggers
- Wallet — top-up product, min/max
- Compliance — age, KYC, terms
- Fraud — rate limits, IP rules
- Integrations — Stripe, Twilio, Firebase, Klaviyo, etc.
Create your first auction
Auctions → Add Auction
The form is one screen, top-to-bottom:
- Product — link to existing or create new
- Auction Type — Standard for first try
- Start Price / Reserve / Buy Now
- Bid Increment — fixed or variable
- Schedule — start / end date, anti-snipe window, max-extension cap
- Item Condition — new / used / refurbished / for-parts
- Images — pulled from the linked product
- Publish
Watch a bid land
After your auction is live, place a bid as a customer in another browser. Then:
- Auctions → All Auctions —
bid_countandcurrent_priceupdated - Auctions → Bids — your test bid appears with IP / user agent
- Auctions → Audit Log — hash-chain entry recorded
- Customer's email inbox — bid-placed confirmation
- Bidder's My Auctions tab — auction shown under Active Bids
If any of these don't happen, see Troubleshooting.
Brand it
Auctions → Design Studio
Live iframe preview on the right; controls on the left. Tweak:
- Bid form colors / spacing / button shape
- Countdown timer color stops
- Badge style on shop pages
Click Save. Changes propagate site-wide.
Where to go next
| You want to... | Read |
|---|---|
| Configure every option | Settings |
| Pay vendors / run a marketplace | Multi-Vendor |
| Take fees | Monetization |
| Build a custom integration | REST API, Hooks & Filters |
| Run an event with multiple lots | Events |
| Detect fraud automatically | Fraud Detection |
