Aller au contenu principal
Calendrier ICS

Calendrier ICS

Market →

Lire des calendriers (ICS/CalDAV) et déclencher des actions automatiquement selon les événements.

Jeedom 4.4+stableos 11+php 7.4/8.x

✨ Description​

Ce plugin permet de récupérer des calendriers distants (Apple, Google, Nextcloud, CalDAV…) ou locaux.
Il est possible d’interagir avec ces calendriers et de lancer des actions selon les événements.

⚙️ Configuration du plugin​

Après le téléchargement du plugin, il vous suffit de l’activer et de le configurer.

IMPORTANT

Ce plugin ne permet pas de modifier ou éditer un calendrier distant.

En mode Debug, le plugin est très verbeux.
Il est recommandé d'utiliser ce mode seulement si vous devez diagnostiquer un problème particulier.

Il n’est pas recommandé de laisser le plugin en Debug en permanence, surtout si Jeedom fonctionne sur SD-Card.

Une fois le diagnostic terminé, repassez le niveau de log sur Error.

remarque

Le plugin permet de :

  • récupérer un calendrier via URL (Apple, Google, Nextcloud, Synology, CalDAV) et d’interagir en créant des événements
  • récupérer un calendrier ICS local et l’intégrer à Jeedom
  • créer des événements liés à un calendrier avec le même nom, et déclencher des actions au début ou à la fin de l’événement
    (donc en créant un événement sur votre calendrier iOS ou Google, cela peut lancer des actions dans Jeedom)
  • avoir un widget dashboard paramétrable

configuration

?title? : retourne le titre de l'événement
?hour? : retourne l'heure de début de l'événement

Il faut configurer les champs pour le retour des informations avec les commandes today et tomorrow d'un calendrier
(commande à utiliser ensuite via TTS, notification...). Mettre ?title? pour le titre de l'événement et ?hour? pour l'heure.

Une fois activé, aller dans :

Plugins → Organisation → Calendrier ICS

ics1

Cliquer sur le +

ics_create

Vous pourrez alors ajouter :

  • un calendrier
  • un événement
  • un widget (une sorte de virtuel)

📅 Les calendriers​

Ajouter un calendrier (URL ICS)​

Créer un nouvel équipement et renseigner l’URL du calendrier.

ICS

ics3

Paramètres :

  • Couleur : la couleur des événements dans l'agenda
  • Fériés : si un événement existe dans le calendrier le jour sera considéré comme férié (voir la doc sur les commandes)
  • Widget : le nombre de jours sur le widget
  • Jours : le nombre de jours à sauvegarder

Vous pouvez ensuite naviguer via les onglets.

ics4

Dans l’onglet Agenda, votre calendrier apparaît.

ics5

remarque

En cliquant (1 fois) sur un événement d'un calendrier, une fenêtre va s’ouvrir et vous pourrez définir des actions en début et/ou fin d’évènement.

ics6

Dans l’onglet Commandes, les commandes de votre calendrier apparaissent (lire par la suite).

🧩 Les évènements​

remarque

Tout l'intérêt de ce plugin réside dans la gestion des événements.

IMPORTANT

Le plugin est unidirectionnel et récupère seulement les événements d'un calendrier (iOS, Google, Nextcloud, CalDAV…).
Aucune modification ne peut être effectuée.

Important — Événements All-day (journée entière)​

Les événements All-day (journée entière) ont un comportement spécifique :

  • Une seule action “Début” est exécutée, à l’heure configurée dans Heure actions (All-day) (ou 07:00 par défaut).
  • Il n’y a pas d’action de fin pour les All-day.
  • Un All-day sur plusieurs jours ne déclenche pas tous les jours.

Pour filtrer précisément les événements (titre/description), voir : Reconnaissance des événements.

Reconnaissance des événements​

Le plugin peut matcher des événements via :

  • le titre
  • la description
  • des regex

Exemples de configuration​

Configuration

🧱 Les widgets​

info

Les widgets sont des équipements virtuels qui permettent de rassembler les informations de différents calendriers.

ics7

Il faut juste sélectionner les calendriers que vous voulez ajouter au widget.

IMPORTANT

Pour optimiser l'affichage, les widgets affichent seulement les événements sauvegardés du calendrier.

🖥 Affichage​

remarque

Rendu sur le dashboard. Vue mobile OK.

widgetDash

🎛 Les commandes​

Calendriers​

ics11

  • Last Event
  • Is holiday today
  • Is holiday tomorrow
  • Today
  • Tomorrow
  • Next
  • Event Today
  • Event Tomorrow
  • heure
  • titre
  • date
  • togo

Evènements​

ics12

  • Today
  • Tomorrow
  • Description
  • Description (Next)
  • heure
  • titre
  • date
  • Localisation
  • Now
  • Next

⚡ Les actions​

Pour les évènements, la navigation diffère avec l'onglet Configuration où vous pourrez définir les actions que vous souhaitez lancer :

  • au début
  • à la fin
  • en différé

ics10

💡 Tips​

Calendrier iOS​

IMPORTANT

Pour les calendriers iOS (Apple), il faut passer le calendrier en public pour pouvoir y avoir accès.

ics13

Calendrier Google​

ics18

Calendrier scolaire​

http://cache.media.education.gouv.fr/ics/Calendrier_Scolaire_Zone_B.ics

Exemple calendrier Ligue 1​

https://fixtur.es/fr/ligue-1

Utilisation des variables​

ics16

ics17

Scénario utilisant les informations des calendriers​

scenario1

🆘 Support​

IMPORTANT

En cas de problèmes, 2 solutions :

  • ouverture d'un ticket via Jeedom
  • un post via community

Dépannage​

En cas de problèmes :

  • vérifier l’URL
  • activer temporairement le debug