Pour créer un widget, cliquez sur "Ajouter un widget", sélectionnez ensuite le type de widget que vous souhaitez créer dans la liste déroulante de gauche puis renseignez les différents champs affichés à l'écran avant de finaliser la création en appuyant sur le bouton "Sauvegarder".
Quelques éléments sont standard et seront demandés pour l'ensemble des widgets :
- Actif : Le widget sera (ou pas) affiché dans l'application. Pratique si vous voulez par exemple gérer un groupe de lumières, mais ne pas afficher certaines d'entre elles.
- Visible sous condition : Permet d'ajouter une condition pour afficher ou masquer cet élément (uniquement si 'actif' est coché).
- Pièce : Sélection de la pièce associée (identique aux objets gérés dans Jeedom)
- Nom : Nom du widget, affiché sur le widget
- Nom d'affichage : Nom affiché sur les pages de configuration. Si vide, alors le nom est utilisé.
- Sous-titre Information complémentaire affichée dans l'application. Le mode personalisé permet de mettre une phrase quelconque, ou un texte dynamique
- Affichage forcé : De façon standard, chaque widget (sauf exception) possède 3 types d'affichage : carte, vignette et détail. Les affichages carte et vignettes peuvent être choisis via l'icône en haut à droite dans l'application. L'affichage détail est une page entière affichée quand on clique sur le widget. Vous pouvez ici forcer un widget à s'afficher d'une de ces 3 façons.
Attention pour le mode détail, le widget doit être seul sur sa page.
- Sécuriser les actions : Toutes les commandes de type action peuvent être sécurisées à l'aide de ces trois boutons :
Le premier permet de faire une simple demande de confirmation de l'action.
Le second demande une donnée biométrique (empreinte digitale, reconnaissance faciale) pour exécuter l'action (sur appareils disposant d'un capteur).
Le dernier demandera le mot de passe configuré dans les paramètres de l'équipement JC.
- Images : Les images de l'application sont stockées dans le dossier
plugins/JeedomConnect/data/img/. Si vous souhaitez ajouter des images persos, utilisez l'assistant, ou bien copiez vos images dans plugins/JeedomConnect/data/img/user_files/. Il est conseillé d'utiliser des images PNG en 128x128. Vous pouvez aussi mettre des GIF animés.
- Images sous conditions : Vous pouvez dans certains widgets définir une image en fonction des valeurs d'une commande. L'ordre de ces conditions sera pris en compte par l'appli (les plus hautes sont prioritaires).
- Ajouter des infos : vous permet d'ajouter des commandes de type
info de votre Jeedom et de vous en servir pour les autres champs du formulaire 'Images sous conditions', 'Nom', 'Sous-titre'.
Textes dynamiques
Les champs Nom et Sous-titre, ainsi que les conditions d'affichage d'images peuvent être personnalisés. Ils sont évalués dans l'application en JavaScript. Les raccourcis suivants sont aussi disponibles (liste non exhaustive mais disponible dans la configuration de chaque widget côté plugin) :
#room# : Nom de la pièce associée au widget#status# ou #value# (selon les widgets) : donne la valeur courante de la commande info principale du widget#formatedValue# (selon les widgets) : valeur formatée en mot de la commande info principale (par exemple Allumé, Eteint)#elapsedTime# : durée depuis laquelle la commande info principale du widget a été modifiée
Exemple :
La lumière de #room# est formatedValue depuis elapsedTime et consomme power W
pourra donner :
La lumière de jardin est allumée depuis 1h12min et consomme 15W
Fonctions disponibles
Les fonctions suivantes sont également disponibles, pour une commande info notée ici #cmd# :
time(#cmd#) : durée depuis laquelle la commande info principale du widget a été modifiéedate(#cmd#) : date et heure de dernière modification de la valeur, au format "DD MMM - HH:mm"collect(#cmd#) : date et heure de dernière collecte de la valeur, au format "DD MMM - HH:mm"average(#cmd#) : moyenne des valeurs de la commande (#cmd# doit être historisée)min(#cmd#) : minimum des valeurs de la commande (#cmd# doit être historisée)max(#cmd#) : maximum des valeurs de la commande (#cmd# doit être historisée)tendance(#cmd#) : renvoie up, down ou stable selon la tendance des valeurs (#cmd# doit être historisée)modifiedDate(#cmd#) : donne le timestamp en ms de la dernière modificationcollectDate(#cmd#) : donne le timestamp en ms de la dernière collecte
De plus, pour la manipulation des dates, vous avez accès à la bibliothèque momentjs (documentation). Exemple :
`La tondeuse est {#cmd# > 0 ? "en marche" : "au repos"} depuis le moment(modifiedDate(#cmd#)).format("DD MMMM à HH-mm")`
pourra donner :
La tondeuse est au repos depuis le 30 Septembre à 13:31
(notez l'usage des backquote qui entourent le texte)
La duplication d'un widget est réalisable dès que celui-ci a été sauvegardé une première fois. Cliquez simplement sur le bouton "Dupliquer", réalisez vos modifications (ou pas), et enregistrez (impérativement) en validant avec le bouton "Sauvegarder".
La suppression est également possible. Attention toutefois, si un widget est supprimé, alors il disparaîtra de l'ensemble des équipements auxquels il avait été ajouté !
Cliquez sur un widget pour accéder à sa page détaillée (options, commandes attendues, variables).
Éclairage et prises
Ouvrants
Capteurs
Chauffage et climatisation
| Widget | Description |
|---|
 | Thermostat | Gère un thermostat. Compatible avec le plugin officiel |
 | Climatiseur | Gère un climatiseur |
Sécurité
Caméras et multimédia
| Widget | Description |
|---|
 | Caméra | Permet d'afficher une caméra |
 | Caméra Frigate | Permet d'afficher le live et l'historique d'une caméra Frigate |
 | Lecteur multimedia | Gère un équipement multimedia |
 | Image | Permet d'afficher une image |
 | Web View | Permet d'afficher un design, le dashboard ou n'importe quelle page Web. Astuce : Pour un affichage direct dans un menu, configurez l'affichage forcé sur Détail (ce widget doit être unique dans le menu) |
Génériques
Historiques
Localisation
Résumés et favoris
| Widget | Description |
|---|
 | Résumé | Affiche un résumé de plusieurs widgets |
 | Résumé de pièce | Affiche le résumé d'une pièce associée à un objet Jeedom |
 | Favoris | Affiche des widgets favoris |
Autres
