Liste des événements

Le shortcode [event_list] affiche les événements d'un Calendrier SportsPress sous forme de tableau triable et paginé avec des colonnes pour la date, le nom de l'événement (ou les équipes domicile/extérieur), l'heure/résultats, le lieu, la ligue, la saison, l'article et la journée de match.

Ce qu'il affiche

Un tableau de données d'événements. Les colonnes affichées dépendent de la configuration des colonnes du Calendrier et du remplacement par le paramètre columns. Les résultats ou l'heure sont affichés dans un format combiné ou séparé selon les réglages time_format et title_format.

Quand l'utiliser

Utilisez sur n'importe quelle page ou article. Fournissez id pour extraire les événements d'un Calendrier spécifique. Sans id, le shortcode utilise get_the_ID() comme valeur de repli et cherchera une publication Calendrier avec cet ID — il est plus utile lorsqu'il est placé sur la propre page d'un Calendrier (dans la boucle) ou avec un id explicite.

Paramètres

Paramètre	Type	Défaut	Description
`id`	entier	`null`	ID de publication du Calendrier SportsPress à afficher.
`title`	chaîne/booléen	`false`	Remplace le titre affiché. `false` utilise la légende ou le titre du Calendrier lorsque `show_title` est `1`.
`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 é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 sélection de colonnes du Calendrier (par exemple `'event,time,venue'`).
`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 dans la colonne événement.
`link_events`	booléen	Depuis les réglages	`1` pour lier les dates/titres d'événements aux pages d'événements.
`link_teams`	booléen	Depuis les réglages	`1` pour lier les noms d'équipes aux pages d'équipes.
`link_venues`	booléen	Depuis les réglages	`1` pour lier les noms de lieux.
`sortable`	booléen	Depuis les réglages	`1` pour activer le tri de colonnes côté client.
`responsive`	booléen	Depuis les réglages	`1` pour activer le mode tableau responsive.
`scrollable`	booléen	Depuis les réglages	`1` pour activer le défilement horizontal sur les écrans étroits.
`paginated`	booléen	Depuis les réglages	`1` pour paginer le tableau.
`rows`	entier	Depuis les réglages	Lignes par page lorsque la pagination est active. Par défaut `10`.
`show_all_events_link`	booléen	`false`	`1` pour afficher un lien « Voir tous les événements » sous le tableau (nécessite `id`).
`show_title`	booléen	Depuis les réglages	`1` pour afficher le nom du Calendrier comme titre au-dessus du tableau.
`title_format`	chaîne	Depuis les réglages	Mise en page des colonnes : `'title'` (titre de l'événement), `'teams'` (noms d'équipes empilés) ou `'homeaway'` (colonnes domicile/extérieur séparées).
`time_format`	chaîne	Depuis les réglages	Format de la colonne heure/résultats : `'combined'`, `'separate'`, `'time'` ou `'results'`.

Exemples d'utilisation

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

[event_list id="30"]

Événements futurs uniquement, noms d'équipes liés, paginé avec 5 lignes par page :

[event_list id="30" status="future" link_teams="1" paginated="1" rows="5"]

Format domicile/extérieur, avec logos et lien « Voir tous les événements » :

[event_list id="30" title_format="homeaway" show_team_logo="1" show_all_events_link="1"]