Begegnungsblöcke

Der Shortcode [event_blocks] zeigt Begegnungen als vertikales Block-Layout an — jede Begegnung in ihrer eigenen Karte mit Mannschaftslogos, Datum, Ergebnis oder Uhrzeit und optional dem Begegnungstitel, der Liga, der Saison, dem Austragungsort und dem Spieltag.

Was angezeigt wird

Eine paginierte Block-Stil-Tabelle. Jede Zeile ist eine Begegnung mit nebeneinander platzierten Mannschaftslogos, dem Datum und dem Spielstand oder der geplanten Uhrzeit. Optionale Metadatenfelder (Liga, Saison, Austragungsort, Spieltag) erscheinen unterhalb des Spielstands.

Wann zu verwenden

Auf einer beliebigen Seite, einem Beitrag oder einem Widget verwenden. id angeben, um Begegnungen aus einem bestimmten SportsPress-Kalender abzurufen. Ohne id verwendet der Shortcode get_the_ID().

Parameter

Parameter	Typ	Standard	Beschreibung
`id`	Ganzzahl	`null`	Beitrags-ID des SportsPress-Kalenders.
`event`	Ganzzahl	`null`	Filter auf eine bestimmte Begegnungs-Beitrags-ID.
`title`	Zeichenfolge/Boolescher Wert	`false`	Überschreibt die angezeigte Überschrift.
`status`	Zeichenfolge	`'default'`	Begegnungsstatus-Filter: `'default'`, `'future'` oder `'publish'`.
`format`	Zeichenfolge	`'default'`	Begegnungsformat-Filter.
`date`	Zeichenfolge	`'default'`	Voreingestellter Datumsfilter.
`date_from`	Zeichenfolge	`'default'`	Beginn des Datumsbereichs (JJJJ-MM-TT).
`date_to`	Zeichenfolge	`'default'`	Ende des Datumsbereichs (JJJJ-MM-TT).
`date_past`	Zeichenfolge	`'default'`	Vergangene Tage, die einbezogen werden sollen.
`date_future`	Zeichenfolge	`'default'`	Zukünftige Tage, die einbezogen werden sollen.
`date_relative`	Zeichenfolge	`'default'`	Relativer Datumsmodus.
`day`	Zeichenfolge	`'default'`	Spieltag-Filter.
`league`	Ganzzahl/Zeichenfolge	`null`	Liga-Begriff-ID oder Slug.
`season`	Ganzzahl/Zeichenfolge	`null`	Saison-Begriff-ID oder Slug.
`venue`	Ganzzahl/Zeichenfolge	`null`	Austragungsort-Begriff-ID oder Slug.
`team`	Ganzzahl	`null`	Mannschafts-Beitrags-ID zum Filtern von Begegnungen.
`teams_past`	Ganzzahl	`null`	Filter, um vergangene Mannschaftszuordnungen einzuschließen.
`date_before`	Zeichenfolge	`null`	Begegnungen nach diesem Datum ausschließen.
`player`	Ganzzahl	`null`	Spieler-Beitrags-ID zum Filtern von Begegnungen.
`number`	Ganzzahl	`-1`	Maximale Anzahl der anzuzeigenden Begegnungen. `-1` zeigt alle.
`columns`	Zeichenfolge/Array	`null`	Kommagetrennte Spalten-Slugs zum Überschreiben der Spaltenkonfiguration des Kalenders.
`orderby`	Zeichenfolge	`'default'`	Feld zum Sortieren (z. B. `'date'`, `'day'`).
`order`	Zeichenfolge	`'default'`	Sortierreihenfolge: `'ASC'` oder `'DESC'`.
`show_team_logo`	Boolescher Wert	Aus Einstellungen	`1` um Mannschaftslogos anzuzeigen. Standard folgt der Einstellung Begegnungsblöcke > Logos anzeigen (`yes`).
`link_teams`	Boolescher Wert	Aus Einstellungen	`1` um Mannschaftslogos mit Mannschaftsseiten zu verlinken.
`link_events`	Boolescher Wert	Aus Einstellungen	`1` um Daten und Titel mit Begegnungsseiten zu verlinken.
`paginated`	Boolescher Wert	Aus Einstellungen	`1` um zu paginieren. Standard folgt der Einstellung Begegnungsblöcke > Paginiert.
`rows`	Ganzzahl	Aus Einstellungen	Zeilen pro Seite. Standard folgt der Einstellung Begegnungsblöcke > Zeilen (Standard `5`).
`show_all_events_link`	Boolescher Wert	`false`	`1` um einen „Alle Begegnungen anzeigen"-Link anzuzeigen (erfordert `id`).
`show_title`	Boolescher Wert	Aus Einstellungen	`1` um den Kalendernamen als Überschrift anzuzeigen.
`show_league`	Boolescher Wert	Aus Einstellungen	`1` um die Liga unterhalb jedes Begegnungsergebnisses anzuzeigen.
`show_season`	Boolescher Wert	Aus Einstellungen	`1` um die Saison unterhalb jedes Begegnungsergebnisses anzuzeigen.
`show_matchday`	Boolescher Wert	Aus Einstellungen	`1` um den Spieltag unterhalb jedes Begegnungsergebnisses anzuzeigen.
`show_venue`	Boolescher Wert	Aus Einstellungen	`1` um den Austragungsort unterhalb jedes Begegnungsergebnisses anzuzeigen.
`hide_if_empty`	Boolescher Wert	`false`	`1` um alle Ausgaben zu unterdrücken, wenn keine Begegnungen vorhanden sind.

Verwendungsbeispiele

Minimal — alle Begegnungen aus einem bestimmten Kalender:

[event_blocks id="30"]

Zukünftige Begegnungen mit Logos und Austragungsort, auf 5 begrenzt:

[event_blocks id="30" status="future" show_team_logo="1" show_venue="1" number="5"]

Block-Layout nach Spieltag gruppiert, mit Liga- und Saison-Metadaten:

[event_blocks id="30" orderby="day" show_league="1" show_season="1"]

Verwandte Artikel