Integrazione iCal e feed

Ogni post calendario in SportsPress espone un feed iCal a cui le applicazioni di calendario esterne possono iscriversi. Il feed si aggiorna automaticamente ogni volta che gli eventi vengono aggiunti o modificati.

Link feed nella dashboard

Quando si modifica un post calendario, il meta box Feed (sul lato destro dell'editor) mostra tre link di iscrizione pronti all'uso:

Apple Calendar — un URL webcal:// che macOS Calendar e iOS Calendar aprono direttamente
Outlook — un URL webcal:// per Microsoft Outlook
Google — un URL webcal:// preceduto da http://www.google.com/calendar/render?cid= in modo che facendo clic si apra la finestra di dialogo "Aggiungi tramite URL" di Google Calendar

Ogni link è visualizzato sia come icona cliccabile che come input di testo di sola lettura che puoi copiare.

Formato URL del feed

L'URL grezzo del feed è:

https://esempio.com/slug-calendario/?feed=sp-ical

Dove slug-calendario è il permalink del post calendario. Il parametro di query feed=sp-ical attiva il template del feed iCal.

Il feed emette una risposta text/calendar con il nome file <slug-post>.ics.

Cosa contiene il feed

Ogni evento nel calendario diventa un blocco VEVENT nell'output iCal:

SUMMARY — il titolo dell'evento, o una stringa punteggio (ad es. "Casa FC 2 Trasferta FC 1") quando i risultati sono disponibili
DTSTART — la data e l'ora programmate dell'evento
DTEND — calcolata aggiungendo la durata Tempo pieno dell'evento (in minuti) all'ora di inizio; il valore predefinito è 90 minuti se non impostato
LOCATION — il nome e l'indirizzo della sede (da sp_address), se l'evento ha una sede assegnata
GEO — latitudine e longitudine (da sp_latitude e sp_longitude), se le coordinate sono memorizzate sulla sede
DESCRIPTION — il contenuto del post dell'evento (testo del corpo)
UID — l'ID post di WordPress

L'intestazione del calendario include X-WR-CALNAME e X-WR-CALDESC impostati al titolo del post calendario, e TZID / X-WR-TIMEZONE impostati all'impostazione del fuso orario di WordPress.

Iscrizione in Apple Calendar

Nel meta box Feed, copia il link Apple Calendar.
In Apple Calendar, scegli File > Nuova iscrizione calendario.
Incolla l'URL e fai clic su Iscriviti.
Imposta l'intervallo di aggiornamento automatico e fai clic su OK.

In alternativa, fai clic sull'icona del link direttamente — macOS aprirà Calendar automaticamente e ti chiederà di iscriverti.

Iscrizione in Google Calendar

Nel meta box Feed, copia il link Google.
Fai clic sul link o incollalo in un browser. Google Calendar apre la schermata "Aggiungi calendario" con l'URL pre-compilato.
Fai clic su Aggiungi calendario.

Google Calendar recupera nuovamente il feed periodicamente (tipicamente ogni 24 ore; il feed richiede un intervallo di aggiornamento di 2 minuti tramite REFRESH-INTERVAL;VALUE=DURATION:PT2M ma Google non rispetta questo).

Iscrizione in Outlook

Nel meta box Feed, copia il link Outlook.
In Outlook, scegli File > Impostazioni account > Impostazioni account, poi la scheda Calendari Internet, e fai clic su Nuovo.
Incolla l'URL e fai clic su Aggiungi.

Per Outlook sul web, usa Aggiungi calendario > Iscriviti dal web e incolla l'URL.