Blocos de Eventos

O shortcode [event_blocks] exibe eventos como um layout de blocos vertical — cada evento em seu próprio cartão mostrando logos de times, data, resultado ou hora, e opcionalmente o título do evento, liga, temporada, local e rodada.

O Que Exibe

Uma tabela paginada em estilo de bloco. Cada linha é um evento com logos de times lado a lado, a data e o placar ou hora agendada. Campos de metadados opcionais (liga, temporada, local, rodada) aparecem abaixo do placar.

Quando Usar

Use em qualquer página, post ou widget. Forneça id para obter eventos de um Calendário específico do SportsPress. Sem id, o shortcode usa get_the_ID().

Parâmetros

Parâmetro	Tipo	Padrão	Descrição
`id`	inteiro	`null`	ID do post do Calendário do SportsPress.
`event`	inteiro	`null`	Filtrar para um ID de post de evento específico.
`title`	string/booleano	`false`	Substituir o cabeçalho exibido.
`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 associações de 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 mostrar. `-1` mostra todos.
`columns`	string/array	`null`	Slugs de colunas separados por vírgula para substituir a configuração de colunas do Calendário.
`orderby`	string	`'default'`	Campo para ordenar (por exemplo, `'date'`, `'day'`).
`order`	string	`'default'`	Ordem de classificação: `'ASC'` ou `'DESC'`.
`show_team_logo`	booleano	Das configurações	`1` para exibir logos de times. O padrão segue a configuração Blocos de Eventos > Exibir logos (`yes`).
`link_teams`	booleano	Das configurações	`1` para vincular logos de times a páginas de times.
`link_events`	booleano	Das configurações	`1` para vincular datas e títulos a páginas de eventos.
`paginated`	booleano	Das configurações	`1` para paginar. O padrão segue a configuração Blocos de Eventos > Paginado.
`rows`	inteiro	Das configurações	Linhas por página. O padrão segue a configuração Blocos de Eventos > Linhas (padrão `5`).
`show_all_events_link`	booleano	`false`	`1` para mostrar um link "Ver todos os eventos" (requer `id`).
`show_title`	booleano	Das configurações	`1` para mostrar o nome do Calendário como cabeçalho.
`show_league`	booleano	Das configurações	`1` para mostrar a liga abaixo de cada placar do evento.
`show_season`	booleano	Das configurações	`1` para mostrar a temporada abaixo de cada placar do evento.
`show_matchday`	booleano	Das configurações	`1` para mostrar a rodada abaixo de cada placar do evento.
`show_venue`	booleano	Das configurações	`1` para mostrar o local abaixo de cada placar do evento.
`hide_if_empty`	booleano	`false`	`1` para suprimir toda saída quando não há eventos.

Exemplos de Uso

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

[event_blocks id="30"]

Eventos futuros com logos e local, limitados a 5:

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

Layout de blocos agrupado por rodada, mostrando metadados de liga e temporada:

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