Blocs d'événements

Le shortcode [event_blocks] affiche les événements sous forme de mise en page en blocs verticaux — chaque événement dans sa propre carte montrant les logos d'équipes, la date, le résultat ou l'heure, et optionnellement le titre de l'événement, la ligue, la saison, le lieu et la journée de match.

Ce qu'il affiche

Un tableau paginé en style blocs. Chaque ligne est un événement avec les logos d'équipes côte à côte, la date et le score ou l'heure programmée. Les champs de métadonnées optionnels (ligue, saison, lieu, journée de match) apparaissent sous le score.

Quand l'utiliser

Utilisez sur n'importe quelle page, article ou widget. Fournissez id pour extraire les événements d'un Calendrier SportsPress spécifique. Sans id, le shortcode utilise get_the_ID().

Paramètres

Paramètre	Type	Défaut	Description
`id`	entier	`null`	ID de publication du Calendrier SportsPress.
`event`	entier	`null`	Filtre sur un ID de publication d'événement spécifique.
`title`	chaîne/booléen	`false`	Remplace le titre affiché.
`status`	chaîne	`'default'`	Filtre de statut d'événement : `'default'`, `'future'` ou `'publish'`.
`format`	chaîne	`'default'`	Filtre de format d'événement.
`date`	chaîne	`'default'`	Préréglage de filtre de date.
`date_from`	chaîne	`'default'`	Début de la plage de dates (AAAA-MM-JJ).
`date_to`	chaîne	`'default'`	Fin de la plage de dates (AAAA-MM-JJ).
`date_past`	chaîne	`'default'`	Jours dans le passé à inclure.
`date_future`	chaîne	`'default'`	Jours dans le futur à inclure.
`date_relative`	chaîne	`'default'`	Mode de date relative.
`day`	chaîne	`'default'`	Filtre de journée de match.
`league`	entier/chaîne	`null`	ID ou slug de terme de ligue.
`season`	entier/chaîne	`null`	ID ou slug de terme de saison.
`venue`	entier/chaîne	`null`	ID ou slug de terme de lieu.
`team`	entier	`null`	ID de publication d'équipe pour filtrer les événements.
`teams_past`	entier	`null`	Filtre pour inclure les associations d'équipes passées.
`date_before`	chaîne	`null`	Exclure les événements après cette date.
`player`	entier	`null`	ID de publication de joueur pour filtrer les événements.
`number`	entier	`-1`	Nombre maximum d'événements à afficher. `-1` affiche tous.
`columns`	chaîne/tableau	`null`	Slugs de colonnes séparés par des virgules pour remplacer la configuration des colonnes du Calendrier.
`orderby`	chaîne	`'default'`	Champ sur lequel trier (par exemple `'date'`, `'day'`).
`order`	chaîne	`'default'`	Ordre de tri : `'ASC'` ou `'DESC'`.
`show_team_logo`	booléen	Depuis les réglages	`1` pour afficher les logos d'équipes. La valeur par défaut suit le réglage Blocs d'événements > Afficher les logos (`yes`).
`link_teams`	booléen	Depuis les réglages	`1` pour lier les logos d'équipes aux pages d'équipes.
`link_events`	booléen	Depuis les réglages	`1` pour lier les dates et titres aux pages d'événements.
`paginated`	booléen	Depuis les réglages	`1` pour paginer. La valeur par défaut suit le réglage Blocs d'événements > Paginé.
`rows`	entier	Depuis les réglages	Lignes par page. La valeur par défaut suit le réglage Blocs d'événements > Lignes (par défaut `5`).
`show_all_events_link`	booléen	`false`	`1` pour afficher un lien « Voir tous les événements » (nécessite `id`).
`show_title`	booléen	Depuis les réglages	`1` pour afficher le nom du Calendrier comme titre.
`show_league`	booléen	Depuis les réglages	`1` pour afficher la ligue sous chaque score d'événement.
`show_season`	booléen	Depuis les réglages	`1` pour afficher la saison sous chaque score d'événement.
`show_matchday`	booléen	Depuis les réglages	`1` pour afficher la journée de match sous chaque score d'événement.
`show_venue`	booléen	Depuis les réglages	`1` pour afficher le lieu sous chaque score d'événement.
`hide_if_empty`	booléen	`false`	`1` pour supprimer toute sortie lorsqu'il n'y a aucun événement.

Exemples d'utilisation

Minimal — tous les événements d'un calendrier spécifique :

[event_blocks id="30"]

Événements futurs avec logos et lieu, limité à 5 :

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

Mise en page en blocs groupée par journée de match, affichant les métadonnées de ligue et de saison :

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