Auction board card

A silent auction: the running total against the goal, and every lot with its high bid, bidder paddle and time left.

Category: Events. Tags: Events and venues, Numbers and metrics.

Previews

Auction board
Canvas
Auction board
Corner
Auction board
Chip

Views and forms

Views: canvas, corner, chip. Canvas forms: landscape, portrait, square, strip.

Card views, themes and publishing. Browse the gallery.

Data and privacy

This card uses its configured properties and live card data.

Properties

For theme, background, accent and position, see Common properties.

Set static properties in params. Bind data to a project card data key for live values; that document holds only dynamic properties. Without a data key, put the complete configuration in params. Nested rows describe the contents of their parent property.

Static properties

NameTypeDefaultValues and limitsDescription
titlestring"Silent auction"maxLength: 40
currencystring"$"maxLength: 3The symbol before every amount.
goalnumber0minimum: 0; maximum: 1000000000The amount to raise. 0 shows the total without a goal.
sortstring"lot""lot", "closing", "bid"lot keeps the order given; closing puts the lot that closes next first and closed lots last; bid puts the highest bid first.
perPageinteger6minimum: 3; maximum: 10
pageSecondsinteger10minimum: 4; maximum: 60
soonMinutesinteger15minimum: 1; maximum: 240A lot is closing soon this many minutes before it closes.
showBiddersbooleantrueShow the high bidder's paddle on each lot.

Dynamic properties

NameTypeDefaultValues and limitsDescription
raisednumber0minimum: 0; maximum: 1000000000The running total, when it is more than the lots' high bids (tickets, donations). 0 uses the sum of the high bids.
closesAtstring""maxLength: 32When bidding closes, ISO 8601. A lot without its own closesAt closes then.
itemsarray[]minItems: 0; maxItems: 60
items[].lotstring, integerThe lot number or code; left out, the lot's place in the list.
items[].namestringminLength: 1; maxLength: 120; Required
items[].bidnumber0minimum: 0; maximum: 1000000000The high bid. 0 means no bids yet.
items[].openingnumber0minimum: 0; maximum: 1000000000The opening bid, shown until the first bid.
items[].bidsinteger0minimum: 0; maximum: 100000How many bids the lot has.
items[].bidderstring""maxLength: 12The high bidder's paddle number or initials.
items[].closesAtstring""maxLength: 32When this lot closes, ISO 8601.
items[].statusstring"open""open", "closed", "sold", "withdrawn"Closed and sold end bidding; withdrawn hides the lot.
items[].imagestring""maxLength: 200A project media reference for the lot's photo.
footnotestring""maxLength: 160

Canvas example

Add this item to a playlist page’s primitives. Publish the playlist and assign a screen.

{
  "id": "auction-board",
  "primitive": "card",
  "card": "auction-board",
  "major": 1,
  "params": {
    "theme": "neomustard"
  },
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "fill",
  "data": "auction-board-main"
}

Write live data

Create this document before showing the card, then replace it to update the screen without republishing. Use the same project as the playlist. Supply your API authorization through the environment; see API authentication.

curl --request PUT "https://api.screenrig.ai/api/card-data/auction-board-main" \
  --header "Authorization: Bearer $SCREENRIG_TOKEN" \
  --header "ScreenRig-Project: $SCREENRIG_PROJECT" \
  --header "Content-Type: application/json" \
  --data '{"document":{"raised":0,"closesAt":"","items":[],"footnote":""}}'