{"id":290,"date":"2019-12-23T18:46:39","date_gmt":"2019-12-23T18:46:39","guid":{"rendered":"http:\/\/jeedom.sigalou-domotique.fr\/plugin-diaporama-documentation"},"modified":"2024-04-21T13:17:26","modified_gmt":"2024-04-21T11:17:26","slug":"plugin-diaporama-documentation","status":"publish","type":"post","link":"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation","title":{"rendered":"Slideshow Plugin Documentation"},"content":{"rendered":"<table style=\"width: 100%;\">\n<tbody>\n<tr>\n<td style=\"width: 180px;\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-284\" src=\"http:\/\/jeedom.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_icon.png\" alt=\"Icon Slideshow\" width=\"150\" height=\"170\" srcset=\"https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_icon.png 309w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_icon-264x300.png 264w\" sizes=\"auto, (max-width: 150px) 100vw, 150px\" \/><\/td>\n<td>\n<ul>\n<li><span style=\"background-color: #ffff99;\">Documentation<\/span><\/li>\n<li><a href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-changelog-todolist\/\">Todo-List and Changelog<\/a><\/li>\n<li><a href=\"https:\/\/community.jeedom.com\/tags\/plugin-diaporama\">Dedicated Forum<\/a><\/li>\n<li><a href=\"http:\/\/alexaapi.slack.com\">Beta-testing cat<\/a><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><!--more--><\/p>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_88 counter-hierarchy ez-toc-counter ez-toc-light-blue ez-toc-container-direction\">\n<label for=\"ez-toc-cssicon-toggle-item-6ab4375549779\" class=\"ez-toc-cssicon-toggle-label\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewbox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewbox=\"0 0 24 24\" version=\"1.2\" baseprofile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/label><input type=\"checkbox\"  id=\"ez-toc-cssicon-toggle-item-6ab4375549779\"  aria-label=\"Toggle\" \/><nav><ul class='ez-toc-list ez-toc-list-level-1' ><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Presentation_du_plugin\" >Presentation of the plugin<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Installation_du_Plugin_Diaporama\" >Installation of the Slideshow Plugin<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Installer_le_Plugin_depuis_le_Market\" >Install the Plugin from the Market<\/a><\/li><\/ul><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Options_de_configuration_du_plugin\" >Plugin configuration options<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Format_DateHeure\" >Format Date\/Time<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#API_Google_Maps_pour_identification_GPS\" >Google Maps API for GPS identification<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Token_Facebook\" >Token Facebook<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Retourner_automatiquement_les_photos\" >Automatically return photos<\/a><\/li><\/ul><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Obtenir_un_Token_dacces_utilisateur_Facebook\" >Get a Facebook User Access Token<\/a><ul class='ez-toc-list-level-2' ><li class='ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Limitations_API_Facebook\" >Facebook API Limitations<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Mettre_ses_photos_sur_un_Design_ou_DashBoard\" >Put your photos on a Design or DashBoard<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Obtenir_le_changement_de_photos\" >Get the photo(s) change<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Problemes_connus\" >Known problems<\/a><ul class='ez-toc-list-level-2' ><li class='ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-14\" href=\"https:\/\/www.sigalou-domotique.fr\/en\/plugin-diaporama-documentation\/#Erreur_Syslog_Samba\" >Syslog Samba error<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n<h1><span class=\"ez-toc-section\" id=\"Presentation_du_plugin\"><\/span>Presentation of the plugin<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<p>This plugin will allow you to display a photo frame on your Design or Dashboard. In this context, you will be able to see your photographs scrolling.<\/p>\n<p>At this stage of the development of the plugin, you can view your photos, which are:<\/p>\n<ul>\n<li>Either in a dedicated folder on the same device that hosts Jeedom<\/li>\n<li>Either in a remote folder linked to Jeedom by Samba (a NAS or a Samba network disk)<\/li>\n<li>Either on your Facebook account, you will also be able in this case to choose the \"albums\" that you want to display or not<\/li>\n<\/ul>\n<h1><span class=\"ez-toc-section\" id=\"Installation_du_Plugin_Diaporama\"><\/span><a id=\"Installation\"><\/a>Installation of the Slideshow Plugin<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<h3><span class=\"ez-toc-section\" id=\"Installer_le_Plugin_depuis_le_Market\"><\/span>Install the Plugin from the Market<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<table border=\"2\">\n<tbody>\n<tr>\n<td><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-190\" src=\"http:\/\/jeedom.sigalou-domotique.fr\/wp-content\/uploads\/2019\/03\/installationalexaapi1.png\" alt=\"installationalexaapi1\" width=\"617\" height=\"265\" \/><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Then go to the Market and select <strong>Slideshow<\/strong><\/p>\n<p>Then <strong>Activate the plugin<\/strong><\/p>\n<h1><span class=\"ez-toc-section\" id=\"Options_de_configuration_du_plugin\"><\/span><a id=\"Config_Plugin\"><\/a>Plugin configuration options<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<h3><span class=\"ez-toc-section\" id=\"Format_DateHeure\"><\/span>Format Date\/Time<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<div class=\"form-group\">\n<div class=\"form-group\">\n<p>This field allows you to choose how to display the date on your slideshow.<\/p>\n<ul>\n<li>d-m-y H:i:s will display 30-01-2020 18:58:33<\/li>\n<\/ul>\n<p>For this field, use the synthaxis of the Date command in php: <a href=\"https:\/\/www.php.net\/manual\/fr\/function.date.php\">https:\/\/www.php.net\/manual\/fr\/function.date.php<\/a><\/p>\n<h3><span class=\"ez-toc-section\" id=\"API_Google_Maps_pour_identification_GPS\"><\/span>Google Maps API for GPS identification<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>If you want the plugin to be able to find the location of the photo taken (thanks to the GPS location tags left on the photo), fill in this field.<\/p>\n<p>Documentation is incomplete at this stage but here is a link explaining <a href=\"https:\/\/www.e-monsite.com\/pages\/tutoriels\/configuration-avancee-du-site\/obtenir-une-cle-google-maps-api.html\" target=\"_blank\" rel=\"noopener noreferrer\">How do I get a Google Maps API?<\/a> or <a href=\"https:\/\/youtu.be\/OY60sAsPqos\" target=\"_self\" rel=\"noopener noreferrer\">this video<\/a><\/p>\n<h3><span class=\"ez-toc-section\" id=\"Token_Facebook\"><\/span>Token Facebook<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>If you want to use your Facebook account to view photos from your albums, you need a Facebook Authorisation Token<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Retourner_automatiquement_les_photos\"><\/span>Automatically return photos<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Some photos can be taken upside down or sideways, this feature correlates this by straightening the photos (thanks to the orientation tags left on the photo)<\/p>\n<\/div>\n<h1><span class=\"ez-toc-section\" id=\"Obtenir_un_Token_dacces_utilisateur_Facebook\"><\/span><a id=\"Token\"><\/a>Get a Facebook User Access Token<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<div><\/div>\n<ul>\n<li>Go to <a href=\"https:\/\/developers.facebook.com\/tools\/explorer\/\">https:\/\/developers.facebook.com\/tools\/explorer\/<\/a><\/li>\n<li>Create an application<\/li>\n<li>Add the product \"Facebook Login\"<\/li>\n<li>Go to<a href=\"https:\/\/developers.facebook.com\/tools\/explorer\/\" target=\"_blank\" rel=\"noopener noreferrer\"> the Graph API Explorer<\/a><\/li>\n<li>On the right, allow \"user_photos\" (to see if there is no need for more, for the tests, I had authorised everything)<\/li>\n<li>Click on <strong><em>Get Access Token<\/em><\/strong><\/li>\n<li>Press at the top right on <strong>Send<\/strong>, you should see your name appear<\/li>\n<li>In the path of <em><strong>test<\/strong><\/em>, replace <em><strong>me?fields=id,name<\/strong> <\/em>by <strong>me\/photos <\/strong>If all goes well, you should see a list of photos in JSON format<\/li>\n<\/ul>\n<div><\/div>\n<div><strong>To extend the life of your Token<\/strong>, copy your access token and go to the <a href=\"https:\/\/developers.facebook.com\/tools\/debug\/accesstoken\/\" target=\"_self\" rel=\"noopener noreferrer\">Access token debugger<\/a><\/div>\n<ul>\n<li>Copy your access token to the \u2018Enter \u2026 token\u2019 field and click on <strong>Debug<\/strong><\/li>\n<li>At the bottom, click on <strong>Extend the access token<\/strong><\/li>\n<li>So take the new Token provided to use it on the plugin<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Limitations_API_Facebook\"><\/span>Facebook API Limitations<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Facebook appears to impose limitations on the use of its API <em><strong>\u2018The total number of calls your app can make per hour is 200 times the number of users\u2019<\/strong><\/em><\/p>\n<p>Thus, if you multiply the images and put a refresh too fast, you can get errors due to this limitation. To view your quotas, go to <a href=\"https:\/\/developers.facebook.com\/apps\/\">https:\/\/developers.facebook.com\/apps\/<\/a> select your application and then \"\u00a0<em><strong><span class=\"_c24  _50f4 _50f7\">Application ceiling<\/span><\/strong><\/em>\u00a0\u00bb<\/p>\n<h1><span class=\"ez-toc-section\" id=\"Mettre_ses_photos_sur_un_Design_ou_DashBoard\"><\/span><a id=\"Mettresesphotos\"><\/a>Put your photos on a Design or DashBoard<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<p>A photo is an order in Jeedom.<\/p>\n<ul>\n<li>On the <strong>Dashboard<\/strong>, it will appear in a box if you tick \u2018Show\u2019 in front of the command<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-286\" src=\"http:\/\/jeedom.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Diaporama_-_Jeedom.png\" alt=\"Screenshot 2020 01 24 Slide show Jeedom\" width=\"1006\" height=\"36\" srcset=\"https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Diaporama_-_Jeedom.png 1006w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Diaporama_-_Jeedom-600x21.png 600w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Diaporama_-_Jeedom-300x11.png 300w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Diaporama_-_Jeedom-768x27.png 768w\" sizes=\"auto, (max-width: 1006px) 100vw, 1006px\" \/><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-287\" src=\"http:\/\/jeedom.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Dashboard_-_Jeedom.png\" alt=\"Screenshot 2020 01 24 Jeedom Dashboard\" width=\"369\" height=\"147\" srcset=\"https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Dashboard_-_Jeedom.png 369w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-24_Dashboard_-_Jeedom-300x120.png 300w\" sizes=\"auto, (max-width: 369px) 100vw, 369px\" \/><\/p>\n<ul>\n<li>On <strong>Design<\/strong>, you have to edit the design, add a command and add photo 1 for example<\/li>\n<\/ul>\n<p>If you want to display the other fields, you must reproduce the same principle as phot1 but with the fields to add. You can write the date, place or other information on the image:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-288\" src=\"http:\/\/jeedom.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_screenshot1.png\" alt=\"diaporama _screenshot1.png\" width=\"350\" height=\"219\" srcset=\"https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_screenshot1.png 1032w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_screenshot1-600x374.png 600w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_screenshot1-300x187.png 300w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_screenshot1-1024x639.png 1024w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/diaporama_screenshot1-768x479.png 768w\" sizes=\"auto, (max-width: 350px) 100vw, 350px\" \/><\/p>\n<h1><span class=\"ez-toc-section\" id=\"Obtenir_le_changement_de_photos\"><\/span><a id=\"Refresh\"><\/a>Get the photo(s) change<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<p>The change of photo(s) is achieved by means of an automatic CRON function.<\/p>\n<p>This is configured in each slideshow:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-289\" src=\"http:\/\/jeedom.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-09_Diaporama_-_Jeedom.png\" alt=\"Screenshot 2020 01 09 Slide show Jeedom\" width=\"701\" height=\"32\" srcset=\"https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-09_Diaporama_-_Jeedom.png 701w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-09_Diaporama_-_Jeedom-600x27.png 600w, https:\/\/www.sigalou-domotique.fr\/wp-content\/uploads\/2019\/12\/Screenshot_2020-01-09_Diaporama_-_Jeedom-300x14.png 300w\" sizes=\"auto, (max-width: 701px) 100vw, 701px\" \/><\/p>\n<p>The small green button on the right is an assistant that can help to find the right synthaxis of the refresh rate.<\/p>\n<p>Note: Updates cannot be made faster than one change per minute.<\/p>\n<h1><span class=\"ez-toc-section\" id=\"Problemes_connus\"><\/span><a id=\"problemes\"><\/a>Known problems<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<h2><span class=\"ez-toc-section\" id=\"Erreur_Syslog_Samba\"><\/span>Syslog Samba error<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>On users of \"home\" Samba servers you can uncomment (delete the #) in \/etc\/samba\/smb.conf on the syslog line = 0<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>Documentation Todo-List et\u00a0Changelog Forum d\u00e9di\u00e9 Chat beta-testeurs<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[14,23],"tags":[],"class_list":["post-290","post","type-post","status-publish","format-standard","hentry","category-domotique","category-jeedom-2"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/posts\/290","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/comments?post=290"}],"version-history":[{"count":0,"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/posts\/290\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/media?parent=290"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/categories?post=290"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sigalou-domotique.fr\/en\/wp-json\/wp\/v2\/tags?post=290"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}