Description
Plugin pour personnaliser Jeedom.
Permet d’installer, de modifier ou de supprimer les widgets tiers et les widgets réalisés par Salvialf ainsi que les menus de designs avec navigation par iframe réalisés par Noodom.
Installation et accès
Comme tout plugin Jeedom, celui-ci doit être installé et activé.
Ensuite rendez vous dans Plugins → Programmation → Pimp my Jeedom pour l’utiliser.
Info Le plugin utilise un cronDaily afin de vérifier la présence d’une mise à jour pour les widgets “made by Salvialf”. En cas de besoin celui-ci peut être désactivé sur la page de configuration du plugin (Plugins->Gestion des plugins->Pimp my Jeedom).
Utilisation
Widgets tiers
A l’accès au plugin, vous arrivez sur l’onglet Général.
Le plugin liste automatiquement l’ensemble des widgets tiers présents dans le répertoire data/customTemplates en les regroupant par version (dashboard | mobile) :
Ajouter un widget Tiers
Pour ajouter un widget tiers cliquez sur le bouton “Ajouter un Widget Tiers” :
Une fenêtre s’ouvre afin de renseigner les caractéristiques du nouveau widget (Nom, Version, Type, Sous-Type), Validez en cliquant sur le bouton Créer :
Le nouveau widget est enregistré et vous arrivez directement sur la page de gestion de ce widget :
Gérer un widget Tiers
Pour accéder aux détails d’un widget tiers il suffit de cliquer dessus au sein de l’onglet Général. Vous arrivez alors sur la page de gestion du widget :
La page est divisée en plusieurs parties :
-
Général : Permet de modifier les propriétés du widget (Nom, Version, Type, Sous-Type).
- Commandes liées :
Pour connaitre les commandes sur lesquelles le widget est appliqué.
Astuce Cliquez sur le nom de la commande pour accéder directement à ses paramètres de configuration.
-
Prévisualisation : Permet de visualiser le rendu du widget en temps réel.
-
Édition : Pour voir et modifier le code du widget.
- Boutons du menu:
- Appliquer sur : Pour choisir les commandes sur lesquelles appliquer ou désappliquer le widget.
- Ajouter des fichiers : Pour ajouter ou supprimer des fichiers au widget.
- Sauvegarder : Pour sauvegarder les modifications faites sur le widget.
- Supprimer : Pour supprimer le widget.
Widgets made by Salvialf
Pour accéder aux widgets réalisés par Salvialf, cliquez sur le bouton Widgets made by Salvialf ou sur l’onglet Widgets by 
:
Sur la page d’accueil nous retrouvons en haut à droite un bouton bleu permettant de vérifier les mises à jour de widgets ainsi qu’une icône en forme de livre qui ouvre un lien vers la documentation du plugin spécifique à cette partie.
Au milieu se trouvent les tuiles représentant la liste des widgets disponibles dont vous pouvez trouver la liste ainsi que la documentation associée en cliquant ici.
Info Les widgets non installés apparaissent en grisés et sont colorés si le widget est installé.
Installer un widget by Salvialf
Pour installer un widget “made by Salvialf” cliquez dessus puis sur le bouton Installer :
Gérer un widget by Salvialf
Pour accéder aux détails d’un widget made by Salvialf il suffit de cliquer dessus au sein de l’onglet Widgets by . Vous arrivez alors sur la page de gestion du widget :
La page est divisée en plusieurs parties :
- Informations:
- Installé ? : la case est cochée si le widget est installé. Des symboles sont présents sur cette ligne pour indiquer la compatibilité du widget avec les versions dashboard et/ou mobile (icône_écran = dashboard, icône_smartphone = mobile).
- Nom du widget : Nom du widget.
- Version : Date de version du widget (“need_update” si une mise à jour est disponible).
- Type/Sous-Type : Type et sous-type de commandes sur lesquelles le widget peut être appliqué.
- Visuel par défaut : Image du visuel par défaut.
- Description : Courte description des possiblités offertes par le widget.
-
Commandes liées : Permet de visualiser les commandes sur lesquelles le widget est appliqué. Cocher la case présente juste avant le nom de la commande donne accès aux paramètres optionnels du widget sur cette commande (voir chapitre “Modifier les paramètres optionnels”).
- Boutons du menu:
- Appliquer sur : Pour choisir les commandes sur lesquelles appliquer ou désappliquer le widget.
- Mettre à jour : Pour mettre à jour le widget. Ce bouton apparait uniquement si une mise à jour est disponible pour le widget concerné.
- Envoyer une image / Envoyer une police : Pour ajouter des images ou polices d’écriture directement dans le bon répertoire. Ne s’affiche que si l’option est existante sur le widget.
- Désinstaller : Pour désinstaller le widget.
- Icône_Livre : Pour accéder à la documentation du widget.
Modifier les paramètres optionnels
Pour les widgets offrant des options de personnalisation, il est possible d’accéder aux paramètres optionnels en cochant la case présente juste avant le nom de la commande à personnaliser :
La gestion des paramètres optionnels se veut intuitive tant que possible avec simplement 2 boutons :
- Par défaut : Pour renseigner les paramètres par défaut du widget. Il sera nécessaire de cliquer sur le bouton “Sauvegarder” pour enregistrer le retour aux paramètres par défaut.
- Sauvegarder : Pour enregistrer les nouveaux paramètres optionnels et les voir immédiatement appliqués sur la prévisualisation.
Mettre à jour un widget by Salvialf
Chaque nuit le plugin va vérifier si des mises à jour sont disponibles pour les widgets et afficher un message dans le centre de messages si c’est le cas :
De plus une pastille de couleur orange avec un point d’exclamation apparait dans la liste sur le widget concerné par une mise à jour disponible :
En cliquant sur le widget disposant d’une mise à jour on constate que le champ Version fait apparaitre la mention “need_update” et qu’un bouton de couleur orange nommé Mettre à jour est apparu. Il suffit de cliquer sur ce bouton pour procéder à la mise à jour du widget :
Menus made by Noodom
Les menus de designs réalisés par Noodom fonctionnent sur le principe de la navigation par iframe ce qui offre, entre autres, un gain de performance lors de l’accès à vos designs car le menu ne sera chargé qu’une seule fois par le navigateur.
Un menu est un design général qui va intégrer la visualisation des designs dits “standard” auxquels seront liés les boutons de navigation du menu. L’accès par défaut doit donc s’effectuer sur le design de menu. Pour plus d’informations, consultez la documentation des menus by Noodom.
Pour accéder aux menus réalisés par Noodom, cliquez sur le bouton Menus made by Noodom ou sur l’onglet Menus by 
:
Nous retrouvons sur cette page un bouton pour ajouter un nouveau menu, un lien vers la documentation spécifique à cette partie ainsi que la liste des menus déjà installés.
Ajouter un menu by Noodom
Pour ajouter un menu by Noodom, cliquez sur le bouton “Ajouter un menu” :
Une fenêtre s’ouvre afin de renseigner les caractéristiques du nouveau design de menu (Nom, Version du menu, Longueur et Hauteur du design), validez en cliquant sur le bouton Ajouter :
Le nouveau menu est enregistré et vous arrivez directement sur la page de gestion de ce menu :
Important Il est nécessaire de rafraîchir la page pour voir apparaitre le nouveau design dans le menu général Accueil → Design.
Gérer un menu by Noodom
Pour accéder aux détails d’un menu made by Noodom il suffit de cliquer dessus au sein de l’onglet Menus by . Vous arrivez alors sur la page de gestion du menu :
La page est divisée en plusieurs parties :
- Général:
- Nom du design général : le nom donné au design par lequel s’effectue l’accès.
- Taille du design (en pixels) : Longueur et Hauteur du design général.
Information La taille du design de menu doit correspondre à la taille des designs qui seront liés.
- Nom du menu : Liste déroulante permettant de choisir le menu qui doit être appliqué.
- Taille du menu (en pixels) : Longueur et Hauteur du menu.
- Description : Courte description des possibilités offertes par le menu.
- Designs liés et paramètres :
- Ajouter : Permet de sélectionner les designs liés et les paramètres de personnalisation des boutons du menu (voir chapitre “Modifier les paramètres”).
- Boutons du menu :
- Sauvegarder : Permet de sauvegarder les dernières modifications.
- Supprimer : Pour supprimer le design de menu.
Modifier les paramètres
Tous les menus proposent différentes options de personnalisation mais ont en commun la sélection d’un design lié à chaque bouton du menu via une liste déroulante reprenant les designs existants.
Les autres options disponibles sont :
- Icône : Pour sélectionner une icône ou une image à appliquer sur le bouton. Le bouton Choisir sur la droite permet de sélectionner, selon l’onglet, une icône présente dans Jeedom ou une image présente dans le répertoire
data/img/.Astuce Sur l’onglet Image, le bouton Envoyer permet d’ajouter des images directement dans le dossier
data/img/. -
Label : Permet de saisir le texte du bouton.
- Couleur : Permet de choisir la couleur du bouton.