Lista de Eventos

O shortcode [event_list] exibe eventos de um Calendário do SportsPress como uma tabela classificável e paginada com colunas para data, nome do evento (ou times casa/fora), hora/resultados, local, liga, temporada, artigo e rodada.

O Que Exibe

Uma tabela de dados de eventos. As colunas mostradas dependem da configuração de colunas do Calendário e da substituição do parâmetro columns. Resultados ou hora são mostrados em formato combinado ou separado dependendo das configurações time_format e title_format.

Quando Usar

Use em qualquer página ou post. Forneça id para obter eventos de um Calendário específico. Sem id, o shortcode usa get_the_ID() e procurará um post de Calendário com aquele ID — é mais útil quando colocado na própria página de um Calendário (dentro do Loop) ou com um id explícito.

Parâmetros

Parâmetro	Tipo	Padrão	Descrição
`id`	inteiro	`null`	ID do post do Calendário do SportsPress a exibir.
`title`	string/booleano	`false`	Substituir o cabeçalho exibido. `false` usa a legenda ou título do Calendário quando `show_title` é `1`.
`status`	string	`'default'`	Filtro de status do evento: `'default'`, `'future'` ou `'publish'`.
`format`	string	`'default'`	Filtro de formato do evento.
`date`	string	`'default'`	Filtro de preset de data.
`date_from`	string	`'default'`	Início do intervalo de datas (AAAA-MM-DD).
`date_to`	string	`'default'`	Fim do intervalo de datas (AAAA-MM-DD).
`date_past`	string	`'default'`	Dias no passado a incluir.
`date_future`	string	`'default'`	Dias no futuro a incluir.
`date_relative`	string	`'default'`	Modo de data relativa.
`day`	string	`'default'`	Filtro de rodada.
`league`	inteiro/string	`null`	ID do termo ou slug da liga.
`season`	inteiro/string	`null`	ID do termo ou slug da temporada.
`venue`	inteiro/string	`null`	ID do termo ou slug do local.
`team`	inteiro	`null`	ID do post do time para filtrar eventos.
`teams_past`	inteiro	`null`	Filtrar para incluir times anteriores.
`date_before`	string	`null`	Excluir eventos após esta data.
`player`	inteiro	`null`	ID do post do jogador para filtrar eventos.
`number`	inteiro	`-1`	Número máximo de eventos a exibir. `-1` mostra todos.
`columns`	string/array	`null`	Slugs de colunas separados por vírgula para substituir a seleção de colunas do Calendário (por exemplo, `'event,time,venue'`).
`order`	string	`'default'`	Ordem de classificação: `'ASC'` ou `'DESC'`.
`show_team_logo`	booleano	Das configurações	`1` para exibir logos de times na coluna do evento.
`link_events`	booleano	Das configurações	`1` para vincular datas/títulos de eventos a páginas de eventos.
`link_teams`	booleano	Das configurações	`1` para vincular nomes de times a páginas de times.
`link_venues`	booleano	Das configurações	`1` para vincular nomes de locais.
`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 em telas estreitas.
`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 `10`.
`show_all_events_link`	booleano	`false`	`1` para mostrar um link "Ver todos os eventos" abaixo da tabela (requer `id`).
`show_title`	booleano	Das configurações	`1` para exibir o nome do Calendário como cabeçalho acima da tabela.
`title_format`	string	Das configurações	Layout de coluna: `'title'` (título do evento), `'teams'` (nomes de times empilhados), ou `'homeaway'` (colunas separadas de casa/fora).
`time_format`	string	Das configurações	Formato da coluna de hora/resultados: `'combined'`, `'separate'`, `'time'` ou `'results'`.

Exemplos de Uso

Mínimo — todos os eventos de um calendário específico:

[event_list id="30"]

Apenas eventos futuros, nomes de times vinculados, paginados com 5 linhas por página:

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

Formato casa/fora, com logos e um link "Ver todos os eventos":

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