Scoreboard Layout
The Scoreboard format is a Pro feature added by the SportsPress Scoreboard module. It displays events in a horizontally scrolling ticker strip, similar to sports broadcast scoreboards.
This feature is part of SportsPress Pro.
How It Looks
Events are laid out side by side in a single horizontal row inside a fixed-width viewport. Left and right arrow buttons scroll the strip forward and backward by a configurable number of events at a time. Each event card shows the competing teams (with optional logos) and the result or kick-off time. Clicking an event card navigates to the event page.
Optional metadata — date, time, league, season, and venue — can be shown above the team names inside each card.
The event whose page is currently being viewed receives the CSS class sp-highlight on its card.
Scoreboard Settings
Global scoreboard settings live at Events > Settings, under the Scoreboard section. Each setting has a corresponding shortcode parameter that overrides it per-instance.
Details
Details controls which metadata lines appear inside each event card:
Date (
sportspress_scoreboard_show_date, default: off) — show the event dateTime (
sportspress_scoreboard_show_time, default: on) — show the kick-off time or result timeLeague (
sportspress_scoreboard_show_league, default: off) — show the event's leagueSeason (
sportspress_scoreboard_show_season, default: off) — show the event's seasonVenue (
sportspress_scoreboard_show_venue, default: off) — show the event's venue
Date Format
Date Format (sportspress_scoreboard_date_format, default: M j) — PHP date format string used to format the date when Date is enabled. For example, M j produces "Apr 25".
Teams
Display logos (sportspress_scoreboard_show_logos, default: off) — show team logo images (featured images) alongside team names inside each card.
Display
Display (sportspress_scoreboard_limit, default: 0) — maximum number of events to show in the scoreboard. 0 means no limit. This setting also controls how many events appear in the site header scoreboard (if the header feature is active).
Width
Width (sportspress_scoreboard_width, default: 180) — width of each event card in pixels. Minimum value: 50.
Scroll
Scroll (sportspress_scoreboard_step, default: 2) — number of events the strip advances with each arrow button click. The pixel distance scrolled equals Width × Scroll.
Event Selection
When used without an id, the scoreboard automatically shows a mix of the most recent past events and the nearest upcoming events, centered on today. When an id is provided, the scoreboard uses that calendar's filter settings.
Header Scoreboard
When Display is set to a non-zero value, the scoreboard also appears automatically in the site header (inside the sportspress_header action hook). This is independent of any calendar post; it queries events globally using the limit value. Themes that declare add_theme_support( 'sportspress' ) suppress this behavior.
Shortcode
[event_scoreboard id="42"]
The id parameter is optional. Omitting it renders a global scoreboard using the limit and settings from the Scoreboard section of Event Settings.
Parameter | Default (setting key) | Description |
| (empty) | Calendar post ID |
|
|
|
|
| Date filter value |
|
| Maximum events; overrides the Display setting when provided |
|
| Card width in pixels |
|
| Events to scroll per click |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| PHP date format string |
|
|
|
|
|
|
