Elenco eventi

Lo shortcode [event_list] visualizza gli eventi da un Calendario SportsPress come una tabella ordinabile e paginata con colonne per data, nome dell'evento (o squadre casa/trasferta), ora/risultati, sede, lega, stagione, articolo e giorno di gara.

Cosa visualizza

Una tabella dati di eventi. Le colonne mostrate dipendono dalla configurazione delle colonne del Calendario e dall'override del parametro columns. I risultati o l'ora vengono mostrati in un formato combinato o separato a seconda delle impostazioni time_format e title_format.

Quando usarlo

Usa su qualsiasi pagina o post. Fornisci id per estrarre gli eventi da un Calendario specifico. Senza id, lo shortcode utilizza get_the_ID() come fallback e cercherà un post Calendario con quell'ID — è più utile quando posizionato sulla propria pagina del Calendario (all'interno del Loop) o con un id esplicito.

Parametri

Parametro	Tipo	Predefinito	Descrizione
`id`	intero	`null`	ID post del Calendario SportsPress da visualizzare.
`title`	stringa/booleano	`false`	Sovrascrive l'intestazione visualizzata. `false` usa l'intestazione o il titolo del Calendario quando `show_title` è `1`.
`status`	stringa	`'default'`	Filtro stato evento: `'default'`, `'future'` o `'publish'`.
`format`	stringa	`'default'`	Filtro formato evento.
`date`	stringa	`'default'`	Preimpostazione filtro data.
`date_from`	stringa	`'default'`	Inizio dell'intervallo di date (YYYY-MM-DD).
`date_to`	stringa	`'default'`	Fine dell'intervallo di date (YYYY-MM-DD).
`date_past`	stringa	`'default'`	Giorni nel passato da includere.
`date_future`	stringa	`'default'`	Giorni nel futuro da includere.
`date_relative`	stringa	`'default'`	Modalità data relativa.
`day`	stringa	`'default'`	Filtro giorno di gara.
`league`	intero/stringa	`null`	ID termine o slug della lega.
`season`	intero/stringa	`null`	ID termine o slug della stagione.
`venue`	intero/stringa	`null`	ID termine o slug della sede.
`team`	intero	`null`	ID post della squadra per filtrare gli eventi.
`teams_past`	intero	`null`	Filtra per includere le squadre passate.
`date_before`	stringa	`null`	Esclude gli eventi dopo questa data.
`player`	intero	`null`	ID post del giocatore per filtrare gli eventi.
`number`	intero	`-1`	Numero massimo di eventi da visualizzare. `-1` mostra tutti.
`columns`	stringa/array	`null`	Slug di colonne separati da virgola per sovrascrivere la selezione delle colonne del Calendario (es. `'event,time,venue'`).
`order`	stringa	`'default'`	Ordinamento: `'ASC'` o `'DESC'`.
`show_team_logo`	booleano	Dalle impostazioni	`1` per visualizzare i loghi delle squadre nella colonna evento.
`link_events`	booleano	Dalle impostazioni	`1` per collegare le date/titoli degli eventi alle pagine degli eventi.
`link_teams`	booleano	Dalle impostazioni	`1` per collegare i nomi delle squadre alle pagine delle squadre.
`link_venues`	booleano	Dalle impostazioni	`1` per collegare i nomi delle sedi.
`sortable`	booleano	Dalle impostazioni	`1` per abilitare l'ordinamento delle colonne lato client.
`responsive`	booleano	Dalle impostazioni	`1` per abilitare la modalità tabella responsive.
`scrollable`	booleano	Dalle impostazioni	`1` per abilitare lo scorrimento orizzontale su schermi stretti.
`paginated`	booleano	Dalle impostazioni	`1` per paginare la tabella.
`rows`	intero	Dalle impostazioni	Righe per pagina quando la paginazione è attiva. Predefinito `10`.
`show_all_events_link`	booleano	`false`	`1` per mostrare un link "View all events" sotto la tabella (richiede `id`).
`show_title`	booleano	Dalle impostazioni	`1` per visualizzare il nome del Calendario come intestazione sopra la tabella.
`title_format`	stringa	Dalle impostazioni	Layout della colonna: `'title'` (titolo evento), `'teams'` (nomi squadre impilati) o `'homeaway'` (colonne casa/trasferta separate).
`time_format`	stringa	Dalle impostazioni	Formato colonna ora/risultati: `'combined'`, `'separate'`, `'time'` o `'results'`.

Esempi di utilizzo

Minimo — tutti gli eventi da un calendario specifico:

[event_list id="30"]

Solo eventi futuri, nomi squadre collegati, paginato con 5 righe per pagina:

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

Formato casa/trasferta, con loghi e un link "View all events":

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