Plugin Diaporama Documentation

diaporama icon

Présentation du plugin

Ce plugin va vous permettre d’afficher sur votre Design ou Dashboard un cadre photos. Dans ce cadre, vous pourrez voir dĂ©filer vos photographies.

Vous pouvez à ce stade du développement du plugin visualiser vos photos qui se trouvent :

  • Soit dans un dossier dĂ©diĂ© sur le mĂŞme appareil que celui qui hĂ©berge Jeedom
  • Soit dans un dossier distant liĂ© Ă  Jeedom par Samba (un NAS ou un disque rĂ©seau Samba)
  • Soit sur votre compte Facebook, vous pourrez Ă©galement dans ce cas choisir les “albums” que vous souhaitez afficher ou pas

Installation du Plugin Diaporama

Installer le Plugin depuis le Market

installationalexaapi1

Aller ensuite dans le Market et sélectionner Diaporama

Puis Activer le plugin

Options de configuration du plugin

Format Date/Heure

Ce champ vous permet de choisir le mode d’affichage de la date sur votre diaporama.

  • d-m-y H:i:s affichera 30-01-2020 18:58:33

Pour ce champs, utilisez la synthaxe de la commande Date en php : https://www.php.net/manual/fr/function.date.php

API Google Maps pour identification GPS

Si vous souhaitez que le plugin puisse trouver la localisation de la prise de la photo (grace aux tags de localisation GPS laissées sur la photo), remplissez ce champ.

La documentation est incomplète à ce stade mais voici un lien expliquant Comment obtenir une API Google Maps ? ou cette vidéo

Token Facebook

Si vous souhaitez utiliser votre compte Facebook pour afficher les photos de vos albums, il est nĂ©cessaire d’obtenir un Token d’autorisation Facebook

Retourner automatiquement les photos

Certaines photos peuvent ĂŞtre prises Ă  l’envers ou de cĂ´tĂ©, cette fonctionnalitĂ© corrge cela en remettant droite les photos (grace aux tags d’orientation laissĂ©es sur la photo)

Obtenir un Token d’accès utilisateur Facebook

  • Allez dans https://developers.facebook.com/tools/explorer/
  • CrĂ©ez une application
  • Ajoutez le produit “Facebook Login”
  • Allez dans l’explorateur de l’API Graph
  • A droite, autorisez “user_photos” (Ă  voir s’il n’en faut pas d’autres, pour les tests, j’avais tout autorisĂ©)
  • Cliquez sur Get Access Token
  • Appuyez en haut Ă  droite sur Envoyer, vous devriez voir apparaitre votre nom
  • Dans le chemin de test, remplacez me?fields=id,name par me/photos si tout va bien, vous devriez voir une liste de photos au format JSON
Pour prolonger la durĂ©e de vie de votre Token, copiez votre Token d’accès puis allez sur le DĂ©bogueur de tokens d’accès
  • Copiez votre token d’accès dans le champ “Entrez un token…” Puis cliquez sur DĂ©buger
  • Tout en bas, cliquez sur Etendre le token d’accès
  • Prenez donc le nouveau Token fourni pour l’utiliser sur le plugin

Limitations API Facebook

Facebook semble imposer des limitations Ă  l’utilisation de son API “Le nombre total des appels que votre app peut passer par heure est 200 fois le nombre d’utilisateurs”

Ainsi, si vous multipliez les images et mettez un rafraichissement trop rapide, vous pouvez obtenir des erreurs dĂ»es Ă  cette limitation. Pour consultez vos quotas, allez sur https://developers.facebook.com/apps/ sĂ©lectionnez votre application puis “Plafond de l’application

Mettre ses photos sur un Design ou DashBoard

Un photo est une commande dans Jeedom.

  • Sur le Dashboard, elle va s’afficher dans un cadre si vous cocher “Afficher” en face de la commande

Screenshot 2020 01 24 Diaporama Jeedom

Screenshot 2020 01 24 Dashboard Jeedom

  • Sur Design, il faut Ă©diter le design, ajouter une commande et ajouter la photo 1 par exemple

Si vous souhaitez afficher les autres champs, il faut reproduire le mĂŞme principe que phot1 mais avec les champs Ă  ajouter. Vous pouvez ainsi Ă©crire la date, le lieu ou autres infos sur l’image :

diaporama_screenshot1.png

Obtenir le changement de photo(s)

Le changement de photo(s) s’obtient grace Ă  une fonction automatique de CRON.

Cela se configure dans chaque diaporama :

Screenshot 2020 01 09 Diaporama Jeedom

Le petit bouton vert Ă  droite est un assistant qui peut aider Ă  trouver la bonne synthaxe du rythme d’actualisation.

Nota : On ne peut pas mettre d’actualisation plus rapide qu’un changement par minute.

Problèmes connus

Erreur Syslog Samba

Sur les utilisateurs de serveurs Samba “maison” vous pouvez dĂ©commenter (supprimer le #) dans /etc/samba/smb.conf sur la ligne syslog = 0