Skip to main content

Blocks Layout

The **Blocks** format displays events as card-style blocks, one block per event, typically showing team logos, the date, and the result or kick-off time. This layout is well suited for a fixtures-and-results widget or section where visual identity (…

Updated today

Blocks Layout

The Blocks format displays events as card-style blocks, one block per event, typically showing team logos, the date, and the result or kick-off time. This layout is well suited for a fixtures-and-results widget or section where visual identity (team crests) is important.

How It Looks

Each block occupies one table row with a single cell. Inside the cell, from top to bottom:

  1. Team logos (if Display logos is enabled)

  2. Event date

  3. Match day number in parentheses (if Match Day display is enabled)

  4. Result or time — displayed as Score - Score for completed events, or a time for upcoming events

  5. League name (if enabled)

  6. Season name (if enabled)

  7. Venue name (if enabled)

  8. Event title

All text elements link to the event page when Link events is enabled.

When the calendar's Sort by is set to Match Day, group headings appear above the blocks for each distinct match day value.

Available Options

The following display options are configured in Events > Settings > Event Blocks and can be overridden per-shortcode:

  • Display logos (show_team_logo) — show team featured images as logos inside each block

  • Show title (show_title) — show the calendar heading above the blocks

  • Show League (show_league) — show the event's league name inside each block

  • Show Season (show_season) — show the event's season inside each block

  • Show Venue (show_venue) — show the event's venue inside each block

  • Show Match Day (show_matchday) — show the match day number inside each block

  • Pagination (paginated) — break blocks into pages; default rows per page is 5

  • Rows (rows) — number of blocks per page when paginated

Shortcode

[event_blocks id="42"]

Parameter

Default

Description

id

(empty)

Calendar post ID

event

(empty)

Single event ID to display

status

default

default, publish, or future

date

default

w for this week, day for today, or any Date option value

number

-1

Maximum events; -1 shows all

link_teams

0

1 to link team names to team pages

paginated

1

1 to enable pagination

rows

10

Rows per page

order

default

ASC or DESC

show_all_events_link

0

1 to show a View all events link

The date parameter respects the WordPress Settings > General > Week Starts On setting when w (this week) is used.

Did this answer your question?