Intégration iCal et flux

Chaque publication de calendrier dans SportsPress expose un flux iCal que les applications de calendrier externes peuvent s'abonner. Le flux se met à jour automatiquement chaque fois que des événements sont ajoutés ou modifiés.

Liens de flux dans l'administration

Lors de la modification d'une publication de calendrier, la boîte de méta Flux (sur le côté droit de l'éditeur) affiche trois liens d'abonnement prêts à l'emploi :

Apple Calendar — une URL webcal:// que macOS Calendar et iOS Calendar ouvrent directement
Outlook — une URL webcal:// pour Microsoft Outlook
Google — une URL webcal:// préfixée de http://www.google.com/calendar/render?cid= afin qu'un clic dessus ouvre la boîte de dialogue « Ajouter par URL » de Google Calendar

Chaque lien est affiché à la fois comme une icône cliquable et comme une saisie texte en lecture seule que vous pouvez copier.

Format de l'URL de flux

L'URL brute du flux est :

https://example.com/calendar-slug/?feed=sp-ical

Où calendar-slug est le permalien de la publication du calendrier. Le paramètre de requête feed=sp-ical déclenche le modèle de flux iCal.

Le flux génère une réponse text/calendar avec le nom de fichier <post-slug>.ics.

Ce que contient le flux

Chaque événement dans le calendrier devient un bloc VEVENT dans la sortie iCal :

SUMMARY — le titre de l'événement, ou une chaîne de score (par exemple « FC Domicile 2 FC Extérieur 1 ») quand des résultats sont disponibles
DTSTART — la date et l'heure programmées de l'événement
DTEND — calculé en ajoutant la durée Temps plein de l'événement (en minutes) à l'heure de début ; par défaut à 90 minutes si non défini
LOCATION — le nom et l'adresse du lieu (depuis sp_address), si l'événement a un lieu assigné
GEO — latitude et longitude (depuis sp_latitude et sp_longitude), si des coordonnées sont stockées sur le lieu
DESCRIPTION — le contenu de publication de l'événement (texte du corps)
UID — l'ID de publication WordPress

L'en-tête du calendrier inclut X-WR-CALNAME et X-WR-CALDESC définis sur le titre de la publication du calendrier, et TZID / X-WR-TIMEZONE définis sur le réglage de fuseau horaire WordPress.

S'abonner dans Apple Calendar

Dans la boîte de méta Flux, copiez le lien Apple Calendar.
Dans Apple Calendar, choisissez Fichier > Nouvel abonnement à un calendrier.
Collez l'URL et cliquez sur S'abonner.
Définissez l'intervalle d'actualisation automatique et cliquez sur OK.

Alternativement, cliquez directement sur l'icône de lien — macOS ouvrira Calendar automatiquement et vous invitera à vous abonner.

S'abonner dans Google Calendar

Dans la boîte de méta Flux, copiez le lien Google.
Cliquez sur le lien ou collez-le dans un navigateur. Google Calendar ouvre l'écran « Ajouter un calendrier » avec l'URL pré-remplie.
Cliquez sur Ajouter un calendrier.

Google Calendar récupère le flux périodiquement (généralement toutes les 24 heures ; le flux demande un intervalle d'actualisation de 2 minutes via REFRESH-INTERVAL;VALUE=DURATION:PT2M mais Google ne respecte pas cela).

S'abonner dans Outlook

Dans la boîte de méta Flux, copiez le lien Outlook.
Dans Outlook, choisissez Fichier > Paramètres du compte > Paramètres du compte, puis l'onglet Calendriers Internet, et cliquez sur Nouveau.
Collez l'URL et cliquez sur Ajouter.

Pour Outlook sur le web, utilisez Ajouter un calendrier > S'abonner depuis le web et collez l'URL.