Liste de joueurs

Le shortcode [player_list] affiche un tableau de roster des joueurs avec leurs colonnes de statistiques configurées. Les joueurs peuvent être triés, paginés, regroupés par position et filtrés par équipe ou saison.

Ce qu'il affiche

Un tableau de données avec une ligne par joueur. La première colonne affiche le nom du joueur (avec photo optionnelle et drapeau de nationalité). Les colonnes suivantes affichent les statistiques de performance configurées. Les joueurs peuvent être regroupés sous des titres de position lorsque grouping="position" est défini.

Quand l'utiliser

Utilisez sur n'importe quelle page. Fournissez id pointant vers une publication Liste de joueurs SportsPress. Dans la boucle sur une page de publication Liste de joueurs, id peut être omis.

Paramètres

Paramètre	Type	Défaut	Description
`id`	entier	`get_the_ID()`	ID de publication de la Liste de joueurs. Obligatoire hors de la boucle.
`title`	chaîne/booléen	`false`	Remplace le titre affiché.
`number`	entier	`-1`	Nombre maximum de joueurs à afficher. `-1` affiche tous (ou utilise le propre réglage de nombre de la liste).
`columns`	chaîne/tableau	`null`	Slugs de colonnes de performance séparés par des virgules pour remplacer la sélection de colonnes de la liste (par exemple `'appearances,goals'`). Accepte également le nom de paramètre ancien `performance`.
`grouping`	chaîne/null	Depuis la liste	Regrouper les joueurs : `'position'` pour regrouper par position, ou laisser vide pour aucun regroupement. Par défaut depuis le réglage de regroupement de la Liste de joueurs.
`grouptag`	chaîne	`'h4'`	Balise HTML de titre pour les libellés de groupe lorsque le regroupement est actif (par exemple `'h3'`, `'h4'`).
`orderby`	chaîne	`'default'`	Slug de colonne sur lequel trier. `'default'` utilise le propre réglage de tri de la liste.
`order`	chaîne	`'ASC'`	Direction de tri : `'ASC'` ou `'DESC'`.
`leagues`	entier/chaîne	`null`	ID(s) de terme de ligue pour filtrer les statistiques des joueurs par ligue.
`seasons`	entier/chaîne	`null`	ID(s) de terme de saison pour filtrer les statistiques des joueurs par saison.
`team`	entier	`null`	ID de publication d'équipe pour filtrer les joueurs par équipe actuelle.
`show_all_players_link`	booléen	`false`	`1` pour afficher un lien « Voir tous les joueurs » sous le tableau (nécessite `id`).
`show_title`	booléen	Depuis les réglages	`1` pour afficher le titre de la Liste de joueurs comme titre.
`show_player_photo`	booléen	Depuis les réglages	`1` pour afficher les photos des joueurs dans la colonne des noms.
`show_player_flag`	booléen	Depuis les réglages	`1` pour afficher les drapeaux de nationalité dans la colonne des noms.
`team_format`	chaîne	Depuis les réglages	Comment afficher la colonne d'équipe : `'name'`, `'logo'` ou `'both'`.
`link_posts`	booléen	Depuis les réglages	`1` pour lier les noms de joueurs aux pages de joueurs.
`link_teams`	booléen	Depuis les réglages	`1` pour lier les noms d'équipes aux pages d'équipes.
`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.
`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 depuis le réglage Listes > Lignes (`10`).

Exemples d'utilisation

Minimal — liste de joueurs complète :

[player_list id="55"]

Top 10 buteurs, trié décroissant, regroupé par position :

[player_list id="55" number="10" orderby="goals" order="DESC" grouping="position" grouptag="h3"]

Liste de joueurs pour une équipe spécifique, avec photos, noms liés et lien « Voir tous les joueurs » :

[player_list id="55" team="12" show_player_photo="1" link_posts="1" show_all_players_link="1"]

Liste compacte sans pagination, colonnes personnalisées :

[player_list id="55" columns="appearances,goals,assists" paginated="0"]