Gestion des plugins

Plugins → Gestion des plugins

Cette page permet d’accéder aux configurations des plugins. Vous pouvez également manipuler les plugins, à savoir : les télécharger, les mettre à jour et les activer, …​

On y trouve donc la liste des plugins dans l’ordre alphabétique et un lien vers le market.

• Les plugins désactivés sont grisés.
• Les plugins qui ne sont pas en version stable on un point orange devant leur nom.

En cliquant sur un plugin, vous accédez à sa configuration. En haut, vous retrouvez le nom du plugin, puis entre parenthèses, son nom dans Jeedom (ID) et enfin, le type de version installée (stable, beta).

Important

Lors du téléchargement d’un plugin, celui-ci est désactivé par défaut. Il faut donc que vous l’activiez par vous-même.

Gestion

Vous avez ici trois boutons :

• Synchroniser Market : Si vous installez un plugin depuis un navigateur internet sur votre compte Market (en dehors de Jeedom), vous pouvez forcer une synchronisation pour l’installer.
• Market : Ouvre le Market Jeedom, pour sélectionner un plugin et l’installer sur votre Jeedom.
• Plugins : Vous pouvez ici installer un plugin depuis une source Github, Samba, …

Synchroniser Market

Depuis un navigateur, rendez-vous sur le Market. Connectez vous à votre compte. Cliquez sur un plugin, puis choisissez Installer stable ou Installer beta (si votre compte Market le permet).

Si votre compte Market est bien configuré sur votre Jeedom (Configuration→Mises à jour/Market→Onglet Market), vous pouvez cliquer sur Synchroniser Market ou attendre qu’il s’installe tout seul.

Market

Pour installer un nouveau plugin, il suffit de cliquer sur le bouton “Market” (et que Jeedom soit relié à Internet). Après un petit temps de chargement, vous obtiendrez la page.

Conseil

Vous devez avoir saisi les informations de votre compte du Market dans l’administration (Configuration→Mises à jour/Market→Onglet Market) afin de retrouver les plugins que vous avez déjà achetés par exemple.

En haut de la fenêtre, vous avez des filtres :

• Gratuit/Payant : permet d’afficher uniquement les gratuits ou les payants.
• Officiel/Conseillé : permet d’afficher uniquement les plugins officiels ou les conseillés.
• Menu déroulant Catégorie : permet d’afficher uniquement certaines catégories de plugins.
• Rechercher : permet de rechercher un plugin (dans le nom ou la description de celui-ci).
• Nom d’utilisateur : affiche le nom d’utilisateur utilisé pour la connexion au Market ainsi que le statut de la connexion.

Conseil

La petite croix permet de réinitialiser le filtre concerné

Une fois que vous avez trouvé le plugin voulu, il suffit de cliquer sur celui-ci pour faire apparaître sa fiche. Cette fiche vous donne beaucoup d’informations sur le plugin, notamment :

• S’il est officiel/recommandé ou s’il est obsolète (il faut vraiment éviter d’installer des plugins obsolètes).
• 4 actions :
  • Installer stable : permet d’installer le plugin dans sa version stable.
  • Installer beta : permet d’installer le plugin dans sa version beta (seulement pour les betatesteurs).
  • Installer pro : permet d’installer la version pro (très peu utilisé).
  • Supprimer : si le plugin est actuellement installé, ce bouton permet de le supprimer.

En dessous, vous retrouvez la description du plugin, la compatibilité (si Jeedom détecte une incompatibilité, il vous le signalera), les avis sur le plugin (vous pouvez ici le noter) et des informations complémentaires (l’auteur, la personne ayant fait la dernière mise à jour, un lien vers la doc, le nombre de téléchargements). Sur la droite vous retrouvez un bouton “Changelog” qui vous permet d’avoir tout l’historique des modifications, un bouton “Documentation” qui renvoie vers la documentation du plugin. Ensuite vous avez la langue disponible et les diverses informations sur la date de la dernière version stable.

Important

Il n’est vraiment pas recommandé de mettre un plugin beta sur un Jeedom non beta, beaucoup de soucis de fonctionnement peuvent en résulter.

Important

Certains plugins sont payants, dans ce cas la fiche du plugin vous proposera de l’acheter. Une fois cela fait, il faut attendre une dizaine de minutes (temps de validation du paiement), puis retourner sur la fiche du plugin pour l’installer normalement.

Plugins

Vous pouvez ajouter un plugin à Jeedom à partir d’un fichier ou depuis un dépôt Github. Pour cela, il faut, dans la configuration de Jeedom, activer la fonction adéquate dans la partie “Mises à jour/Market”.

Attention, dans le cas de l’ajout par un fichier zip, le nom du zip doit être le même que l’ID du plugin et dès l’ouverture du ZIP un dossier plugin_info doit être présent.

Mes plugins

En cliquant sur l’icône d’un plugin, vous ouvrez sa page de configuration.

Conseil

Vous pouvez faire un Ctrl Clic ou Clic Centre pour ouvrir sa configuration dans un nouvel onglet du navigateur.

En haut à droite, quelques boutons :

• Détails : Permet de retrouver la page du plugin sur le market.
• Documentation : Permet d’accéder directement à la page de documentation du plugin.
• Changelog : Permet de voir le changelog du plugin si il existe.
• Assistance : Permet de créer automatiquement une demande d’aide sur le forum.
• Supprimer : Supprime le plugin de votre Jeedom. Attention, cela supprime également définitivement tous les équipements de ce plugin.

En dessous à gauche, on retrouve une zone état avec :

• Statut : Permet de voir le statut du plugin (actif / inactif).
• Catégorie : La catégorie du plugin, indiquant dans quel sous-menu le trouver.
• Auteur : L’auteur du plugin, lien vers la market et les plugins de cet auteur.

• Licence : Indique la licence du plugin qui sera généralement AGPL.

• Action : Permet d’activer ou désactiver le plugin. Le bouton Ouvrir Permet de vous rendre directement sur la page du plugin.
• Version : La version du plugin installée.
• Pré-requis : Indique la version de Jeedom minimum requise pour le plugin.

A droite, on retrouve la zone Log et surveillance qui permet de définir :

• Le niveau de logs spécifique au plugin (on retrouve cette même possibilité dans Administation → Configuration sur l’onglet logs, en bas de page).
• Voir les logs du plugin.
• Heartbeat : Toute les 5 mins, Jeedom regarde si au moins un équipement du plugin a communiqué dans les X dernières minutes (si vous voulez désactiver la fonctionnalité, il suffit de mettre 0).
• Redémarrer démon : Si le hertbeat tombe en erreur alors Jeedom va redémarrer le démon.

Si le plugin possède des dépendances et/ou un démon, ces zones supplémentaires s’affichent sous les zones citées ci-dessus.

Dépendances :

• Nom : Généralement sera local.
• Statut : Statut des dépendances, OK ou NOK.
• Installation : Permet d’installer ou réinstaller les dépendances (si vous ne le faites pas manuellement et qu’elles sont NOK, Jeedom s’en chargera de lui-même au bout d’un moment).
• Dernière installation : Date de la dernière installation des dépendances.

Démon :

• Nom : Généralement sera local.
• Statut : Statut du démon, OK ou NOK.
• Configuration : OK si tous les critères pour que le démon tourne sont réunis, ou donne la cause du blocage.
• (Re)Démarrer : Permet de lancer ou relancer le démon.
• Arrêter : Permet d’arrêter le démon (Uniquement dans le cas où la gestion automatique est désactivée).
• Gestion automatique : Permet d’activer ou désactiver la gestion automatique (ce qui permet à Jeedom de gérer lui même le démon et le relancer si besoin. Sauf contre indication, il est conseillé de laisser la gestion automatique active).
• Dernier lancement : Date du dernier lancement du démon.

Conseil

Certains plugins ont une partie configuration. Si tel est le cas, elle apparaîtra sous les zones dépendances et démon décrites ci-dessus. Dans ce cas, il faut se référer à la documentation du plugin en question pour savoir comment le configurer.

En dessous, on retrouve une zone fonctionnalités. Celle-ci permet de voir si le plugin utilise une des fonctions core Jeedom tel que :

• Interact : Des interactions spécifiques.
• Cron : Un cron à la minute.
• Cron5 : Un cron toutes les 5 minutes.
• Cron10 : Un cron toutes les 10 minutes.
• Cron15 : Un cron toutes les 15 minutes.
• Cron30 : Un cron toutes les 30 minutes.
• CronHourly : Un cron toutes les heures.
• CronDaily : Un cron journalier.
• deadcmd : Un cron pour les commanders dead.
• health : Un cron health.

Conseil

Si le plugin utilise une de ces fonctions, vous pourrez spécifiquement lui interdire de le faire en décochant la case “activer” qui sera présente à côté.

Panel

On peut retrouver une section Panel qui permettra d’activer ou désactiver l’affichage du panel sur le dashboard ou en mobile si le plugin en propose un.