Covid Attest plugin pour Jeedom

Permet de générer une attestation dérogatoire au confinement en France. Génère un document PDF et/ou PNG de l'attestation ainsi qu'une image (png) du QRcode

!! l'auteur n'est pas responsable des amendes et sanctions que vous pourrez subir avec son utilisation !!

|Configuration|

1. activer le plugin

2. Installer les dépendance : imagemagik (convertir les pdf au format png)

3. Configurations :

• bouton Effacer : permet de supprimer tous les fichiers d'attestation présents pour tous les équipements créés, pour faire le ménage, particulièrement si la suppression auto est désactivée

• bouton Test Params : Permet de générer une attestation test soit couvre feu soit quarantaine selon le certificat choisi.

• bouton Mettre à jour : Permet de mettre à jour les fichiers de définition des certificats

|Paramétrage|

1/ créer un équipement par membre à notifier,

2/ dans la configuration de l'équipement, renseigner les informations à faire figurer sur l'attestation

• Nom de l'équipement

• Objet parent

• Catégorie Comme tout équipement classique

• Type :peut être quarantaine ou couvre feu -> pour générer une attestation couvre feu ou quarantaine.

• Nom de l'utilisateur : Le nom à faire figurer sur l'attestation

• Prenom de l'utilisateur : le prénom à faire figurer sur l'attestation

• Date de Naissance : la date de naissance à faire figurer sur l'attestation

• Ville de naissance : la ville de naissance à faire figurer sur l'attestation

• Utiliser l'adresse de jeedom : permet d'utiliser l'adresse renseignée dans la configuration de Jeedom (Réglages->Système->Configuration->Information). Les champs suivants seront alors masqués

• Adresse : l'adresse à faire figurer sur l'attestation masqué si utiliser l'adresse Jeedom est coché

• Code postal : le code postal à faire figurer sur l'attestation masqué si utiliser l'adresse jeedom est coché

• Ville : la ville à faire figurer sur l'attestation masqué si utiliser l'adresse Jeedom est coché

• Ville signature différente : Si vous souhaitez utiliser une autre ville que celle de l'adresse dans la signature

• Ville Signature : la ville à faire figurée dans la signature de l'attestation masqué si 'vlle signature différente' est coché

• Commande d'envoi : commande qui permet d'envoyer les documents

  • commande scénario : Si cochée, vous permet de choisir de déclencher un scénario. Les tags du scénario contiendrons les chemins des fichiers par les tags #pdfURL#, #pngURL#, #qrcURL#, selon les cases cochées pour l'envoi des fichiers ci-dessous, ainsi que #cmdID# et #cmdNAME# avec l'id et le nom de la commande et #eqID# et #eqNAME# pour le l'Id et le nom de l'équipement qui a envoyé la commande. Pour les PNG des pages du PDF, il existe plusieurs tags : #nbPNG# - le nbre de PNG créés et #pngURL-XX#, X étant un numérique de 00 à #nbPNG# -1 représentant les URL des PNGs.

• Type Equipement : le type de l'équipement qui permet l'envoi des documents, qui peut être de 3 types :

  • Telegram : si il s'agit d'une commande du plugin Telegram (lunarok)
  • mail : si il s'agit d'une commande mail du plugin officiel mail (testé configuration SMTP seulement)
  • Pushover : si il s'agit d'une commande du plugin pushover (! n'acceptes pas les pdf -> choisir le format image)
  • Custom : permet de genéré un comportement par défaut, prend alors 4 options :
    • Option de la commande : qui permet de construire la chaine comprenant les chemins des fichiers générés. Utilisez les tags #pdfRUL#, #pngURL# et #qrcURL# qui seront remplacé par les chemin relatifs aux fichiers générés
    • destination : 4 choix choix :
      • titre / message/ files (String): endroit de la commande type message ou sera inséré la chaine de caractère de l'option décrite ci-dessus, au format string avec les URL des fichiers
      • files (Array): option de la commande contiendra un array 'files' avec les url des fichiers

• Cases à cocher Options :

  • Envoi du PDF: si vous souhaitez recevoir le pdf
  • Envoi au format image: convertit le pdf de l'attestation en png pour l'envoi
  • Envoi du QRcode: si vous souhaitez recevoir l'image du QR code
  • Ajout de la seconde page: si vous souhaitez ajouter une seconde page dans l'attestation avec le QR code grand format (du type de l'attestation généré en ligne sur le site du gouvernement)

• Désactiver Auto remove : si cochée, la suppression automatique après l'appel à la commande d'envoi des fichiers est désactivé. Pour supprimer les fichiers il faudra appeler la commande 'supprimer les fichiers' de l'équipement. Cette commande supprimera les fichiers référencés avec le nom et prénom figurant dans la configuration de l'équipement. Peut être utile pour l'utiliser avec notification queue par exemple.

|Utilisation|

envoi des documents

1. direct : utilisez simplement les commandes créées, qui correspondent chacune à un type de motif de dérogation.

2. Pour cocher plusieurs motifs : utiliser la commande envoi Multiple, de type message, avec dans la partie 'message' les motifs séparés par une virgule (',') ou point virgule (';'). Les motifs sont accessibles dans l'équipement par les commandes info nommées par motif (motif TRAVAIL par exemple).

Spécifier la date ou l'heure :

Dans l'equipement, il y a 1 commande par type de motif, plus 2 info : date attestation et heure attestation. => Si vous renseignez ces valeurs, avant d'envoyer la commande, elles seront utilisées pour générer l'attestation. une fois utilisées, elle seront réinitialisées à 0.

Note : si vous avez des problèmes avec la date, utilisez des quote ou double quote (' ou " ).

Exemple : ici on génère une attestation au 1er décembre 1970 à 8h44 avec les motifs enfants et travail de cochés

**note : les nom des commandes info ont changé => date attestation et heure attestation par dédaut

Modifier la ville signature dynamiquement :

1. vous pouvez définir dynamiquement une ville spécifique pour la signature: Pour ce faire, utilisez la commande "Set Ville signature",

!! cela modifiera la configuration de l'équipement : la case à cocher "Ville signature" sera activée la ville signature sera renseignée

2. vous pouvez supprimer dynamiquement la ville signature : Pour ce faire, utilisez la commande "Supprime Ville signature",

!! cela modifiera la configuration de l'équipement : la case à cocher "Ville signature" sera désactivé la ville signature restera renseignée, mais ne sera plus utilisée

widget

Il est celui par défaut, il reprend les commandes d'envoi des notifications.

Utilise les librairies :

• phpQRcode library : http://phpqrcode.sourceforge.net/docs/html/index.html
• Setasign / FPDF : https://github.com/Setasign/FPDF
• Setasign / FPDI : https://github.com/Setasign/FPDI (ajout d'une commande setPage pour naviguer)

Avec les contributions de Naboleo, jjl87, Ludo, arnog23, benj29 et tous les autres qui ont fait avancer le schmilblic, essuyé les platres et passé le torchon,