Résolution d'une issue 1 : #38

https://framagit.org/framasoft/framadate/issues/38

Collecter les adresses emails des sondés
Je trouverai interessant d’avoir la possibilité pour l’administrateur d’un sondage de collecter les adresses mail des sondés (visibles uniquement sur le formulaire admin). Un peu comme le nom/pseudo, mais cachés au sondés, donc. Afin de faciliter la vie de l’administrateur en cloture de sondage : parfois, on envoie un sondage à 200 personnes. Et on ne souhaite recontacter que les 20 qui ont répondu “OK”.
C’était à la base une demande de Mozilla.

Il s’agit d’abord d’une demande fréquente au sein des utilisateurs de Framadate. Par ailleurs, cette modification ferait de Framadate un concurrent de taille face à Doodle où cette fonctionnalité est payante.
J’ai également choisi cette issue car elle me permettait de travailler sur presque tous les niveaux du projet (base de données, classes, fichiers .php, fichiers .tpl et fichiers .js).

• Ajout d’un fichier de migration dans le répertoire framadate/app/classes/Framadate/Migration pour ajouter le nouvel attribut mail à la table vote(poll_id, name, choices, uniqId) dans la base de données
• Ajout d’un appel à ce fichier de migration dans /framadate/admin/migration.php

• MAJ de la méthode insert($pollid, $name, $choices, $token) * MAJ de la méthode update($pollid, $vote_id, $name, $choices)

• MAJ de la méthode updateVote($pollid, $voteid, $name, $choices, $slothash) * MAJ de la méthode addVote($pollid, $name, $choices, $slot_hash)
• MAJ de la méthode splitVote($votes)

• MAJ des appels à updateVote et addVote

• Création du nouveau champ

• Pour un sondage de type date (côté admin et côté user)

• Pour un sondage de type classic (côté admin et côté user)

• Ajout d’un bouton enveloppe associé à chaque colonne

• Ajout d’un traitement lorsqu’on clique sur le bouton enveloppe d’une colonne : récupération des adresses mails renseignées dans des tableaux de chaînes de caractères
• Transmission de ces tableaux à $smarty et appel du nouveau fichier display_mails.tpl

• Affichage des adresses mails transmises

• Icône enveloppe pour un sondage de type date et pour un sondage de type classic

• Exemple d’affichage de collecte de mails pour un sondage (correspond à l’option Avatar du sondage classic)

Afin que la première version soit intégrable dans le code source de Framadate, il est nécessaire de passer la collecte de mail comme une fonctionnalité optionnelle : à la création d’un sondage, l’administrateur choisit (ou non) de collecter les adresses mails des sondés.

• Ajout d’un fichier de migration pour ajouter le nouvel attribut collectusersmail dans la table poll(id, adminid, title, description, adminname, adminmail, enddate, format, editable, receiveNewVotes, receiveNewComments, hidden, passwordhash, resultspubliclyvisible, ValueMax) * Ajout d’un appel à ce fichier de migration dans /framadate/admin/migration.php === Modifications des classes Form et PollRepository === * Ajout d’un attribut collectusersmail à la classe Form * MAJ de la méthode insertPoll de la classe PollRepository === Passage de la collecte de mail en fonctionnalité admin === * Sur la création d’un sondage : ajout d’un paramètre optionnel (modification des fichiers createpoll.php et createpoll.tpl) * Sur l’administration d’un sondage : ajout du paramètre dans les infos (modification du fichier pollinfo.tpl)
• Sur le vote : affichage ou non du champ mail et des boutons enveloppe (modification des fichiers votetabledate.tpl et votetableclassic.tpl

(La saisie devient obligatoire si la collecte de mail est activée.)

• Lors de la création du sondage (modification des fichiers createpoll.php, createpoll.tpl et createpoll.js) * Lors de l’ajout d’un nouveau vote (modification des fichiers votetabledate.tpl et votetable_classic.tpl)

• Affichage du nouveau paramètre optionnel dans la création d’un sondage

• Affichage du nouveau paramètre dans les infos d’un sondage

• Avertissement lors de la création d’un sondage

• Avertissement lors du vote

https://framagit.org/framasoft/framadate/merge_requests/266