Go Back to Parent Doc

Storefront, My Account & Shortcodes

Everything your customers see and use: the auction page, the shop loop, their account area, and the shortcodes you can place anywhere.

The auction page

An auction’s product page replaces the usual add-to-cart area with:

  • Current bid and bid count — or the start price before the first bid.
  • Live countdown timer — counts down to the end (or to the start of a scheduled auction).
  • Start and end dates, shown in your site’s date format and timezone.
  • Reserve notice — “Reserve not met” / “Reserve met”, when the auction has a reserve.
  • Bid form — with the minimum next bid pre-filled and clearly labelled. Guests are asked to log in.
  • Buy It Now button, when available.
  • Watchlist button, when the watchlist is enabled.
  • Bid history tab — every bid with the highest highlighted, paginated, and optionally with masked bidder names (e.g. B*******e).

Bidding states

A logged-in bidder always knows where they stand. A status badge shows “You are winning”, “You have been outbid”, “You won” or “Not won” on the auction page, in product lists and in My Account. It updates with the live refresh and is announced to screen readers, so a bidder learns they were outbid without reloading. Finished auctions show their outcome to everyone else.

Quick bids and bid confirmation

Under the bid field, quick-bid buttons offer three ready amounts: the next acceptable bid, one increment further, and four increments further. They follow the live refresh and the shopper’s currency. A click fills in the amount; it does not place the bid.

With Bid confirmation on (the default), pressing Place bid first asks “Confirm your bid of $120?” inside the form, with Confirm bid and Cancel buttons. Changing the amount, pressing Cancel or the Escape key returns to the form. Both options can be switched off under Settings → Bidding.

A bidder cannot place two bids within two seconds, which stops accidental double submissions.

Auction terms

Select an Auction terms page in the settings and bidders must tick “I have read and agree to the auction terms” before their first bid. The checkbox appears once per bidder; the date they agreed is stored with their account and included in personal data exports.

Dates, local time and calendar reminders

The auction page shows when bidding opens and ends in the store’s timezone. When the visitor’s timezone is different, their own time is shown underneath (“Your time: …”), and an Add to calendar link downloads an .ics reminder for the moment bidding opens (upcoming auctions) or ends (running auctions). Switch this off with Local time in the settings.

In the last minutes of an auction (60 by default) the countdown turns red. When the countdown reaches zero the page asks the server what happened and replaces the bid form with an “ended” notice.

Watcher count

With Show how many people are watching on, the auction page shows “12 people are watching this auction” under the watchlist link.

Live bid updates

With Live bid updates on (the default), the current bid, bid count, minimum bid, and remaining time refresh in the background at your chosen Update interval (minimum 5 seconds). Updates pause while the browser tab is in the background, keeping server load down. Busy stores can lengthen the interval or turn updates off under Settings → Display.

The shop and category pages

Auctions appear in your catalog like any product, with badges and their current bid as the price. The badges are Live, Starts soon, Ending soon, Ended, Sold, No reserve and Reserve met; choose which ones to show under Settings → Display → Badges in product lists. A logged-in bidder also sees their own status badge on each auction they bid on. Enable Countdown in product lists to show the timer in the loop too. Settings control whether finished and scheduled auctions appear, and whether auctions are kept off the main shop page — see Settings → Catalog.

The watchlist

When enabled, customers can add or remove any auction from their watchlist — from the auction page or straight from the shop loop — without a page reload. They find it again under My Account → Auctions → Watchlist or wherever you place the [bafw_watchlist] shortcode. With Pro, watchers also receive the closing soon email.

My Account → Auctions

The plugin adds an Auctions item to the WooCommerce My Account menu with four tabs:

ViewShows
Active bidsRunning auctions the customer has bid on, each marked You are winning or You have been outbid, with a Bid again button when outbid.
WonAuctions they have won, marked Paid or Awaiting payment, with a Pay now button for anything unpaid.
WatchlistAuctions they’re watching (when the watchlist is enabled).
LostFinished auctions they bid on but did not win.

Links to the older My bids and Winning views (?view=bids, ?view=winning) open the Active bids tab.

If the Auctions page in My Account returns a 404 right after activation, visit Settings → Permalinks and click Save Changes to refresh your rewrite rules.

Filtering by auction status

Shop and category pages accept an auction_status query argument: ?auction_status=live, ?auction_status=upcoming or ?auction_status=ended. The Auction status filter block and the [bafw_auction_status_filter] shortcode print All / Live / Upcoming / Ended links for it. On a product archive the links filter that archive; anywhere else they lead to the shop. Use [bafw_auction_status_filter url="https://example.com/auctions/"] to point them somewhere else.

Blocks and patterns

Search for “auction” in the block inserter. Every block is rendered on the server with the same code as the shortcodes, and shows a live preview in the editor.

BlockWhat it showsSettings
Auction gridLive, ending soon, upcoming or finished auctionsShow, number of items, columns, category slugs, order
Auction countdownThe countdown of one auctionAuction product ID (0 = the auction being viewed)
Auction bid formDates, countdown, reserve notice, bid form and Buy It Now of one auctionAuction product ID (0 = the auction being viewed)
Recent bidsThe latest bids across the storeNumber of items
My auctionsAuctions the logged-in customer bid onNumber of items, columns
Auction watchlistThe logged-in customer’s watchlistNumber of items, columns
Auction status filterAll / Live / Upcoming / Ended links–

Three patterns in the Auctions category combine them: Auction landing page, Ending soon strip and Upcoming auctions.

Block themes

On a block theme (for example Twenty Twenty-Five) the single auction page is printed by WooCommerce’s Add to Cart with Options block inside the Single Product template: dates, countdown, reserve notice, bid form and the Buy It Now or pay button, exactly once. Nothing has to be added to the template. To place the auction box somewhere else in a template, use the Auction bid form block with the product ID left at 0.

Shortcodes

Drop these into any page, post, or Shortcode block. Every listing shortcode renders a standard WooCommerce product grid, so it matches your theme.

[bafw_auctions] — auction grid

AttributeDefaultValues
limit12Number of auctions.
columns4Grid columns.
orderbydatedate, title, price, start_date, end_date, rand
orderDESCASC or DESC
statusrunningrunning, scheduled, finished, or empty for all
category—Product category slug(s), comma-separated
[bafw_auctions limit="8" columns="4" orderby="end_date" order="ASC" category="watches"]

Ready-made listings

These accept limit (default 4), columns (default 4), and category:

  • [bafw_ending_soon_auctions] — running auctions closing soonest.
  • [bafw_future_auctions] — scheduled auctions, opening soonest first.
  • [bafw_finished_auctions] — closed auctions, most recent first.

Customer shortcodes

These show content for the logged-in customer and accept limit (default 12) and columns (default 4):

  • [bafw_my_auctions] — auctions the customer has bid on.
  • [bafw_watchlist] — the customer’s watchlist.

[bafw_recent_bids]

A table of the most recent bids across the store — great social proof on a homepage. Accepts limit (default 10). Bidder names respect the masking setting.

[bafw_auction_status_filter]

Live / Upcoming / Ended links for a product archive. See Filtering by auction status.

Customising the look

Every piece of auction markup is a template you can override from your theme — see Developer Reference → Templates. The plugin ships a full RTL stylesheet for right-to-left languages.

Colours

Badge and status colours are CSS custom properties, so one rule in your theme restyles them:

:root {
	--bafw-badge-live-bg: #0a7d33;
	--bafw-badge-ending-soon-bg: #b32d2e;
	--bafw-urgent-color: #b32d2e;
	--bafw-status-winning-bg: #e6f4ea;
}

Every badge has a -bg and a -color property: --bafw-badge-live-*, --bafw-badge-starts-soon-*, --bafw-badge-ending-soon-*, --bafw-badge-ended-*, --bafw-badge-sold-*, --bafw-badge-no-reserve-* and --bafw-badge-reserve-met-*. The bidder status uses --bafw-status-winning-*, --bafw-status-outbid-* and --bafw-status-lost-*.

Shopping Cart
  • Your cart is empty.