Lista de Jogadores

O shortcode [player_list] exibe uma tabela de elenco de jogadores com suas colunas de estatísticas configuradas. Os jogadores podem ser classificados, paginados, agrupados por posição e filtrados por time ou temporada.

O Que Exibe

Uma tabela de dados com uma linha por jogador. A primeira coluna mostra o nome do jogador (com foto e bandeira de nacionalidade opcionais). As colunas subsequentes mostram estatísticas de desempenho configuradas. Os jogadores podem ser agrupados sob cabeçalhos de posição quando grouping="position" está definido.

Quando Usar

Use em qualquer página. Forneça id apontando para um post de Lista de Jogadores do SportsPress. Dentro do Loop em uma página de Lista de Jogadores, id pode ser omitido.

Parâmetros

Parâmetro	Tipo	Padrão	Descrição
`id`	inteiro	`get_the_ID()`	ID do post da Lista de Jogadores. Obrigatório fora do Loop.
`title`	string/booleano	`false`	Substituir o cabeçalho exibido.
`number`	inteiro	`-1`	Número máximo de jogadores a exibir. `-1` mostra todos (ou usa a própria configuração de número da lista).
`columns`	string/array	`null`	Slugs de colunas de desempenho separados por vírgula para substituir a seleção de colunas da lista (por exemplo, `'appearances,goals'`). Também aceita o nome de parâmetro legado `performance`.
`grouping`	string/null	Da lista	Agrupar jogadores: `'position'` para agrupar por posição, ou deixar vazio para sem agrupamento. O padrão segue a configuração de agrupamento da Lista de Jogadores.
`grouptag`	string	`'h4'`	Tag de cabeçalho HTML para rótulos de grupo quando o agrupamento está ativo (por exemplo, `'h3'`, `'h4'`).
`orderby`	string	`'default'`	Slug de coluna para classificar. `'default'` usa a própria configuração de classificação da lista.
`order`	string	`'ASC'`	Direção de classificação: `'ASC'` ou `'DESC'`.
`leagues`	inteiro/string	`null`	ID(s) do termo de liga para filtrar estatísticas de jogadores por liga.
`seasons`	inteiro/string	`null`	ID(s) do termo de temporada para filtrar estatísticas de jogadores por temporada.
`team`	inteiro	`null`	ID do post do time para filtrar jogadores pelo time atual.
`show_all_players_link`	booleano	`false`	`1` para mostrar um link "Ver todos os jogadores" abaixo da tabela (requer `id`).
`show_title`	booleano	Das configurações	`1` para exibir o título da Lista de Jogadores como cabeçalho.
`show_player_photo`	booleano	Das configurações	`1` para exibir fotos de jogadores na coluna de nome.
`show_player_flag`	booleano	Das configurações	`1` para exibir bandeiras de nacionalidade na coluna de nome.
`team_format`	string	Das configurações	Como exibir a coluna de time: `'name'`, `'logo'` ou `'both'`.
`link_posts`	booleano	Das configurações	`1` para vincular nomes de jogadores a páginas de jogadores.
`link_teams`	booleano	Das configurações	`1` para vincular nomes de times a páginas de times.
`sortable`	booleano	Das configurações	`1` para habilitar classificação de colunas no lado do cliente.
`responsive`	booleano	Das configurações	`1` para habilitar modo de tabela responsivo.
`scrollable`	booleano	Das configurações	`1` para habilitar rolagem horizontal.
`paginated`	booleano	Das configurações	`1` para paginar a tabela.
`rows`	inteiro	Das configurações	Linhas por página quando a paginação está ativa. Padrão da configuração Listas > Linhas (`10`).

Exemplos de Uso

Mínimo — lista completa de jogadores:

[player_list id="55"]

Top 10 artilheiros, classificados em ordem decrescente, agrupados por posição:

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

Lista de jogadores para um time específico, com fotos, nomes vinculados e um link "Ver todos os jogadores":

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

Lista compacta sem paginação, colunas personalizadas:

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