Shortcodes

For each Gutenberg block / Elementor widget, an equivalent shortcode is available — useful for classic editor, Beaver Builder, Divi, and similar.

Auction Grid page — what renders on the storefront when you drop it on any page or template

Quick reference

Shortcode	Equivalent
`[wkafw_auctions]`	Auction list grid
`[wkafw_auction]`	Single auction (by ID)
`[wkafw_countdown]`	Standalone countdown
`[wkafw_bid_form]`	Bid form (use inside custom layouts)
`[wkafw_search]`	Search bar
`[wkafw_top_bidders]`	Leaderboard
`[wkafw_recent_winners]`	Recently-paid lots
`[wkafw_my_auctions]`	Customer's My Auctions tabs
`[wkafw_my_wallet]`	Wallet balance display
`[wkafw_watchlist]`	User's watchlist
`[wkafw_auction_of_day]`	Featured rotation
`[wkafw_flash_auctions]`	Flash auction grid
`[wkafw_event_landing]`	Event page (by event ID)
`[wkafw_donor_wall]`	Charity donor wall
`[wkafw_leaderboard]`	Achievements leaderboard
`[wkafw_compare]`	Comparison page
`[wkafw_share_buttons]`	Social share row
`[wkafw_seller_register]`	(legacy) seller registration form

Auction list grid

[wkafw_auctions
    status="active"
    type="all"
    category="watches"
    sort="end_date"
    order="ASC"
    limit="12"
    columns="3"
    layout="grid"
    show_countdown="yes"
    show_bid_count="yes"
    pagination="yes"
]

Param	Default	Values
`status`	active	active, scheduled, ended, paid, all
`type`	all	standard, reverse, sealed, proxy, silent, charity, penny, dutch, seated, unique-bid, all
`category`	(none)	WC product category slug
`vendor_id`	(none)	Filter to one vendor
`sort`	end_date	start_date, end_date, current_price, bid_count, created_at
`order`	ASC	ASC, DESC
`limit`	12	Max items
`columns`	3	1–6
`layout`	grid	grid, list, carousel
`show_countdown`	yes	yes, no
`show_bid_count`	yes	yes, no
`show_watchers`	no	yes, no
`pagination`	yes	yes, no
`class`	(empty)	Extra CSS class

Single auction

[wkafw_auction id="123"]

Param	Default	Effect
`id`	(required)	Auction ID
`components`	all	Comma-list: `bid_form,countdown,history,share,buy_now,reserve`
`layout`	two-column	two-column, stacked

Countdown timer

[wkafw_countdown auction="123" style="large"]

Param	Default	Values
`auction`	(required)	Auction ID
`style`	compact	compact, large, minimal
`show_label`	yes	yes, no
`when_ended`	hide	hide, show, redirect

Bid form (in-context)

For custom auction layouts where you want to compose components yourself:

[wkafw_bid_form auction="123"]

Param	Default	Effect
`auction`	(required)	Auction ID
`quick_bids`	yes	Show quick-bid buttons
`show_max`	auto	Show "Max bid" field for proxy auctions

Search bar

[wkafw_search]

Renders an autocomplete search input that queries auctions live (uses /wp-json/wkafw/v1/search).

Param	Default	Effect
`placeholder`	"Search auctions..."	Input placeholder
`limit`	10	Max suggestions
`categories`	(none)	Restrict to categories

Top bidders / leaderboard

[wkafw_top_bidders limit="10" range="all"]

Param	Default	Values
`limit`	10	Number of rows
`range`	all	day, week, month, all
`show_avatar`	yes	yes, no
`show_count`	yes	yes, no

Recent winners

[wkafw_recent_winners limit="6"]

Shows recently-paid auctions with winner names, amounts, and "won X minutes ago" timestamps.

Customer endpoints

These render the same content as their respective My-Account pages — use to embed in custom dashboards:

[wkafw_my_auctions tab="active"]   # active / won / lost / watchlist
[wkafw_my_wallet]
[wkafw_watchlist]

Auction of the Day

[wkafw_auction_of_day style="hero"]

Renders the Auction of the Day prominently. Style: hero (full-width banner) or card (compact).

Flash auctions

[wkafw_flash_auctions]

Grid of currently-running flash auctions with heightened urgency UI.

Event landing

[wkafw_event_landing event_id="42"]

Renders an event page inline. Use to embed event listings in custom layouts.

Donor wall

[wkafw_donor_wall limit="50" charity_only="yes"]

Public donor list. Defaults to last 50 donations across all charity auctions. Set charity_only="no" for any auction donor.

Compare

[wkafw_compare]

Renders the comparison page (up to 3 lots side-by-side).

[wkafw_share_buttons platforms="facebook,twitter,whatsapp,linkedin"]

Standalone share row. Useful when you want shares on a non-auction page (e.g., "share this campaign").

Custom shortcodes

add_shortcode( 'my_auction_widget', function( $atts ) {
    $atts = shortcode_atts( [ 'category' => '', 'limit' => 5 ], $atts );

    $auctions = wkafw_get_auctions( [
        'category' => $atts['category'],
        'limit'    => (int) $atts['limit'],
        'status'   => 'active',
    ] );

    ob_start();
    foreach ( $auctions as $auction ) {
        // ... your output
    }
    return ob_get_clean();
} );

Performance

Shortcodes cache their query results:

60-second TTL for active-auction queries
Cached per-shortcode-attribute hash
Bust on bid placement (cache invalidation tied to wkafw_bid_placed hook)

For very-high-traffic pages with many shortcodes, ensure object cache (Redis / Memcached) is enabled.

Common questions

"Can I use these in widgets?"

Yes — shortcodes work in WP Text widgets, Custom HTML widgets, Elementor's "Shortcode" widget, and similar.

"How do I get a list of currently-active auctions in PHP?"

Use wkafw_get_auctions() directly:

$auctions = wkafw_get_auctions( [
    'status' => 'active',
    'limit'  => 10,
    'sort'   => 'end_date',
    'order'  => 'ASC',
] );
foreach ( $auctions as $auction ) {
    echo $auction->title . ' — $' . $auction->current_price;
}

"Why does [wkafw_bid_form] show 'Auction not found'?"

The shortcode requires auction attribute with a valid auction ID. Ensure you're passing it correctly: [wkafw_bid_form auction="123"].