Un formulaire d'inscription à une liste de discussion/diffusion avec Formidable

Maïeul — 2014-08-07T13:06:03Z

Certains hébergeurs proposent des services de listes de diffusion / de discussion sans proposer pour autant de formulaire d'inscription aux dites listes. C'est par exemple le cas de TuxFamily ou de Toile-Libre. L'inscription se fait alors par courriel. Il en est cependant possible d'afficher un formulaire d'inscription sur son site SPIP, pour faciliter la vie du public [1].

Du reste, on peut également le souhaiter pour les hébergeurs proposant des listes avec formulaire d'inscription : cela permet d'afficher le formulaire sur son propre site, en gardant ainsi une interface uniforme.

Une manière simple de faire ceci est d'utiliser le plugin nommé à juste titre "Formidable".

1 - Principe de base

Les listes de discussions suivent la norme suivante : une adresse nom_de_la_liste-request@domaine.tld peut recevoir des inscriptions de configuration de la liste. Pour la liste des utilisateurs de eledmac, l'adresse est donc : eledmac-request [arobase] lists.tuxfamily.org.

Il suffit d'envoyer un mail avec la requête comme objet. Dans le cas qui nous intéresse, il suffit de mettre :

subscribe si on veut s'inscrire à la liste
unsubscribe si on veut se désinscrire de la liste.

Évidement, cette email doit être envoyé depuis l'adresse qui souhaite s'inscrire.

Notre formulaire est donc un simple formulaire qui se contente de faire cela... c'est tout.

2 - Création du formulaire

Nous supposons que vous avez installé formidable.

Dans le menu « édition », se rendre dans « formulaires », puis choisir « créer un nouveau formulaire ».

2.1 - Configuration de base du formulaire

Donnez un titre à votre formulaire, un identifiant pour le mémoriser (par exemple « inscription-liste-eledmac »), indiquez un message de retour pour prévenir l'internaute qu'il doit confirmer son inscription via le courriel qu'il recevra, et conservez les autres paramètres.

Validez alors.

2.2 - Création des champs

Vous arrivez alors sur la page d'ajout des champs.

Ajout de champs dans un formulaire

2.2.1 - Champ courriel

Choisissez d'ajouter une « Ligne de texte » en cliquant sur le bouton ad hoc. Votre champ « ligne de texte » est alors ajouté au formulaire. Il vous faut maintenant le configurer en cliquant sur le bouton avec un crayon sur une page.

Bascule vers l'édition d'une ligne de texte

Dans le champ « Description », entrez « Courriel » (ou « email », si vous êtes sur un site anglophone).

Basculez ensuite dans l'onglet « Validation ». Cochez la case « Champ obligatoire », et dans le menu déroulant, choisissez comme vérification « Adresse de courriel ».

Validez ensuite le champ.

2.2.2 - Champ action

Il vous faut maintenant ajouter le bouton radio pour permettre aux utilisateurs de choisir entre l'inscription et la désinscription. Cliquez donc sur le bouton ad hoc, puis éditez le champ, via l'icône avec un crayon sur une page.

Édition des boutons radio

Dans le champ « Label », saissiez « Action » (ou tout autre terme adéquat). Dans « liste des choix possibles », ajouter les lignes suivantes :

subscribe|Inscription unsubscribe|Désinscription

Vous pouvez bien sûr changez « Inscription » / « Désinscription » par tous termes appropriés.

Dans « Valeur par défaut », choisissez « Subscribe ».

Validez ensuite le champ.

2.2.3 - Validation des champs

Il est important de ne pas oubliez de valider les champs, en cliquant sur le bouton en bas de page.

Validation des champs du formulaire

2.3 - Configuration des traitements

Il ne vous reste plus qu'à configurer le formulaire pour qu'il envoie les mails.

Cliquez à gauche sur « Configurez les traitements ». Cochez alors « Envoyez par courriel ». Dans le formulaire qui apparaît alors, remplissez ainsi les champs :

« Destinataires supplémentaires » : mettre l'adresse -request. Par exemple : eledmac-request[arobase]tuxfamily.org (en remplaçant bien sûr le [arobase]
« Courriel de l'envoyeur » : choisissez « Courriel » (étonnant non ?)
Ne pas oubliez de cochez « Insérer le courriel de l'envoyeur dans le champ "From" »
Dans sujet du message, mettre @radio_1@.

À partir de la version 3.7.0 de formidable, il faut aussi cocher la case « Valeurs brutes ». Sinon l'objet du message sera « Inscription » et pas "subscribe.

Options valeur brutes

Validez alors le formulaire.

Il vous reste alors à faire un test, en remplissant le formulaire avec un email, extérieur au domaine de votre site. Par exemple un yopmail.

Il se peut cependant que votre hébergeur refuse d'envoyer de tels courriels depuis votre site. Dans ce cas, il faudra voir avec lui... ou bien tester via un SMTP externe, grâce au plugin facteur.

3 - Insertion du formulaire dans un article

Il ne vous reste plus qu'à insérer le formulaire dans un article, via le raccourci :

4 - Pour allez plus vite

Formulaire d'inscription à une liste de discussion

J'ai exporté mon formulaire en .yaml. Vous pouvez le télécharger, puis l'importer avec le bouton ad hoc.

Importer un formulaire depuis un ficher .YAML

Il vous faut ensuite :

modifier le formulaire, pour lui donner un titre et un identifiant bien à vous.
configurer les traitements, pour modifier l'option « Destinataires supplémentaires ».

[1] Comme je l'ai fait pour la listes des utilisateurs de eledmac.

Gérer le statut des articles directement depuis le site public sous SPIP 3

Maïeul — 2012-08-12T19:43:32Z

J'avais publié il y a plus d'un an et demi un article sur la manière de gérer directement le statut des articles depuis le site public.

Voici son adaptation pour SPIP 3. Comme vous pourrez le voir, le code est beaucoup plus simple.

Il suffit en effet de mettre dans son squelette, dans la boucle (ARTICLES) :

[(#AUTORISER{publier,article,#ID_ARTICLE}|oui)
#FORMULAIRE_INSTITUER_OBJET{article,#ID_ARTICLE,#SELF|parametre_url{var_mode,preview}}
]

L. 1 et 3 : On vérifie que la personne connectée à bien le droit de publier l'article en question. Voir la documentation sur #AUTORISER.
L. 2 : appel du formulaire permettant de changer le statut d'un objet. Ici on précise que l'on veut pouvoir modifier le statut d'un article, dont l'identifiant est #ID_ARTICLE Le troisième argument SELF|parametre_url{var_mode,preview} sert à ne pas tomber sur une erreur 404 si on dépublie l'article : il indique qu'après l'exécution du formulaire on retourne sur la même page, en mode previsualisation [1].

[1] Attention, cela ne fonctionne pas si l'on passe le statut à « refusé » ou « à la poubelle ».

Geekographie Maïeulesque