Personnaliser les messages mails de connexion

  pour mieux informer les nouveaux utilisateurs

Cette page va vous guider à la découverte des entrailles de SPIP, avec un objectif à atteindre : savoir où aller modifier le contenu des messages automatiques de SPIP

Article publié le 19 juin 2024, et actualisé en juin 2024

   

Vos utilisateurs peuvent recevoir des messages automatiques depuis le site, correspondant à plusieurs situations, en particulier pour récupérer un code de connexion, exemple :

Mon Site des Bords du Golfe

(ceci est un message automatique)

Bonjour Marie Germaine,

Voici vos identifiants pour proposer des articles sur
le site "Mon Site des Bords du Golfe" (http://monsitedugolfee.bzh/ecrire/) :

– login : mariegermain......
– mot de passe : UUdfdLMoDuSTJrStU

On pourra parfois préférer plus convivial, ou plus explicite...

Naturellement, vous savez déjà que SPIP raffole de fichiers squelettes HTML (qu’il utilisera donc comme modèle de fond de page pour les mails), mais aussi de fichiers de "chaines de langues" pour proposer les diverses traductions des libellés nécessaires !

Si vous voulez directement intervenir en modification...sautez directement au paragraphe n°2 , qui vous pointerera les fichiers à modifier !
Mais si vous voulez en profiter pour mieux comprendre le processus de découverte de SPIP, nous vous engageons à parcourir d’abord l’explication de la gestion des formulaires de SPIP : ceux-ci sont toujorus gérés par deux fichiers homonymes du répertoire ./formulaires/, l’un de source-écran HTML et l’autre de fonctions en php (avec les trois fonctions _charger() _verifier() et _traiter() ), avant de pratiquer le &var_mode=inclure, facilité SPIP que nous n’expliciterons pas non plus dans cette page. !

 Le mail de réception de mot de passe

Lors de l’inscription de nouveaux auteurs SPIP propose dans l’écran de saisie, un bouton pour leur générer un mot de passe...
- 1. Identifier l’enchaînement des actions :
qui leur est envoyé par mail, à partir de l’écran auteur_edit qui appelle le formulaire editer_auteur.html (dans ./prive/formulaires/ )

Par référence à l’écran de saisie (cf. extrait visualisé ci-dessous),

On peut identifier dans le source HTML de la page d’édition (repris ci-dessous) le nom de champ du bouton pour générer un nouveau mot de passe, en correspondance avec le l’instr

<div class='editer editer_new_pass2'>
                                                        <label for='new_pass2'><:info_confirmer_passe:></label>[
                                                        <span class='erreur_message'>(#ENV*{erreurs/new_pass2})</span>
                                                        ]<input type='password' autocomplete="new-password" class='password' name='new_pass2' id='new_pass2' value="" />
                                                        [(#ENV{config/edit_pass}|oui)
                                                        <input type="submit" class="over offscreen" name="submit" value="submit" />
                                                        <button class="btn submit reset_password" type="submit" name="reset_password" value="1"><:bouton_reset_password:></button>
                                                        ]
                                                </div>]

]
Il faut donc se reporter dans le code de la fonction _verifeir(), pour identifier l’action engagée, programméer par

  1.         // quand c'est un auteur existant on fait le reset password ici
  2.         if (!(is_countable($erreurs) ? count($erreurs) : 0) and _request('reset_password') and intval($id_auteur)) {
  3.                 $erreurs = auteur_reset_password($id_auteur, $erreurs);
  4.                 return $erreurs;
  5.         }

Télécharger

  1. function auteur_reset_password($id_auteur, $erreurs = []) {
  2.         $auteur = sql_fetsel('*', 'spip_auteurs', 'id_auteur=' . intval($id_auteur));
  3.         $config = auteurs_edit_config($auteur);
  4.  
  5.         if ($config['edit_pass']) {
  6.                 if ($email = auteur_regenerer_identifiants($id_auteur)) {
  7.                         $erreurs['message_ok'] = _T('message_nouveaux_identifiants_ok', ['email' => $email]);
  8.                         $erreurs['message_erreur'] = '';
  9.                 } elseif ($email === false) {
  10.                         $erreurs['message_erreur'] = _T('message_nouveaux_identifiants_echec_envoi');....
  11. }

Télécharger

En parcourant cette fonction, définie en fin du fichier php, et sa subordonnée function auteur_regenerer_identifiants($id_auteur, $notifier = true, $contexte = []) { on aboutit donc à identifier une ligne $fond = 'modeles/mail_nouveaux_identifiants'), façon élégante de dire que SPIP va charger le fond de squelette nommé mail_nouveaux_identifiants.html du sous-répertoire ./modeles/ , dont la bonne exécution provoquera l’affichage du message d’erreur réussi...

- 2. Le source a modifier
Pour modifier un squelette HTML, on utilise une surcharge des squelettes, donc il faut dupliquer le fichier source trouvé dans ./prive/modeles/

 Le mail de renouvellement de mot de passe

Ce mail correspond à un "oubli" du mot de passe (pensez au libellé "mot de passe oublié" dans l’écran de connexion SPIP), donc cible des utilisateurs normalement déjà mieux informés ! Car on remarque (à coté du fichier précédent dans les modèles du privé, ou bien en refaisant un processus analogue à partir du fichier login.html..) le squelette de fond mail_oubli.html !

 Le mail de réponse à une demande d’inscription

Ce cas est plus rare, correspondant aux sites laissés "ouverts" à de nouvelles inscriptions (comme SPN !) ; il est intéressant de donner plus d’information à de nouveaux lecteurs potentiels...
Nous modifierons donc le squelette mail_nouveaux_identifiants.html


Merci de nous signaler les coquilles, imprécisions ou erreurs qui figureraient dans cette page.

Liens A2A visibles seulement pour les inscrits.
Liens visibles seulement pour les inscrits.
   

Article publié le 19 juin 2024, et actualisé en juin 2024 .

Répondre à cet article