Refuser dans WordPress les inscriptions d'adresses mortes

1. 1
   Dans PricklyMails

   Créer une clé API dans PricklyMails

   1. Dans le tableau de bord, ouvrez Clés API et cliquez sur Nouvelle clé.
   2. À l'étape Environnement, choisissez d'abord Test : la clé commence par pm_test_, répond par des résultats prédéfinis, ne facture rien et ne contacte aucun serveur de messagerie.
   3. Copiez la clé dès qu'elle s'affiche : elle n'est montrée qu'une fois.

   Astuce

   L'offre Free ne compte qu'une clé : une fois que tout fonctionne, révoquez la clé de test, puis créez-en une en Production.

2. 2
   Dans WordPress

   Ranger la clé et ajouter l'extension dans WordPress

   La clé va dans wp-config.php, sous forme de constante, et le code dans une extension indispensable (must-use plugin), que WordPress exécute sans activation et qu'on ne peut pas désactiver depuis le tableau de bord.

   1. Ouvrez wp-config.php, à la racine des fichiers de WordPress.
   2. Juste au-dessus de la ligne « C'est tout, ne touchez pas à ce qui suit ! » (That's all, stop editing! dans un fichier en anglais), ajoutez define( 'PRICKLYMAILS_KEY', 'pm_test_votre_cle' );, avec votre clé de test pour valeur.
   3. Dans wp-content, créez un dossier mu-plugins, s'il n'existe pas déjà.
   4. Enregistrez-y le code ci-dessous sous le nom pricklymails-signup-check.php.

   Le code demande à PricklyMails de répondre en quelques secondes (Prefer: wait) et cesse d'attendre peu après, pour qu'une inscription ne reste jamais suspendue à la réponse. Il ne refuse l'inscription que si la recommandation est remove, et la laisse passer sinon : adresse risquée, pas de réponse à temps, erreur.

   wp-content/mu-plugins/pricklymails-signup-check.php

   <?php
   /**
    * Plugin Name: PricklyMails signup check
    */
   
   defined( 'ABSPATH' ) || exit;
   
   function pricklymails_refusal() {
       return __( 'This email address cannot receive mail.', 'pricklymails' ) . ' '
           . __( 'Check it for a typo, or use another one.', 'pricklymails' );
   }
   
   // The person waits at the form: wait 4 for the answer, give up at 5.
   function pricklymails_recommendation( $email ) {
       $response = wp_remote_post(
           'https://api.pricklymails.com/api/verify',
           array(
               'timeout' => 5,
               'headers' => array(
                   'Authorization' => 'Bearer ' . PRICKLYMAILS_KEY,
                   'Content-Type' => 'application/json',
                   'Prefer' => 'wait=4',
               ),
               'body' => wp_json_encode( array( 'email' => $email ) ),
           )
       );
       if ( 200 !== wp_remote_retrieve_response_code( $response ) ) {
           return null;
       }
       $result = json_decode( wp_remote_retrieve_body( $response ), true );
   
       return $result['verification']['recommendation'] ?? null;
   }
   
   function pricklymails_check_signup( $errors, $user_login, $user_email ) {
       // A signup WordPress already refused costs no verification.
       if ( $errors->has_errors() || ! defined( 'PRICKLYMAILS_KEY' ) ) {
           return $errors;
       }
       if ( 'remove' === pricklymails_recommendation( $user_email ) ) {
           $errors->add( 'user_email', pricklymails_refusal() );
       }
   
       return $errors;
   }
   add_filter( 'registration_errors', 'pricklymails_check_signup', 10, 3 );
   

   Comment l'API répond en un seul appel

   Attention

   Si wp-config.php met WP_HTTP_BLOCK_EXTERNAL à true, WordPress n'envoie de requêtes qu'à votre propre site et aux hôtes listés dans WP_ACCESSIBLE_HOSTS : ajoutez-y api.pricklymails.com, sinon le code n'atteint jamais PricklyMails et laisse passer toutes les inscriptions.

   À noter

   Laissez le fichier directement dans mu-plugins : WordPress ne charge pas les fichiers de ses sous-dossiers.

   SourceAide officielle de WordPress

   • registration_errors (nouvel onglet)developer.wordpress.org
   • Must-Use Plugins (nouvel onglet)developer.wordpress.org
   • Editing wp-config.php (nouvel onglet)developer.wordpress.org
   • Header Requirements (nouvel onglet)developer.wordpress.org
   • wp_remote_post() (nouvel onglet)developer.wordpress.org
   • WP_Http::request() (nouvel onglet)developer.wordpress.org
   • wp_remote_retrieve_response_code() (nouvel onglet)developer.wordpress.org
   • WP_Error::add() (nouvel onglet)developer.wordpress.org
3. 3
   Dans WordPress

   Ouvrir les inscriptions dans WordPress

   Une extension indispensable ne s'active pas : WordPress l'exécute dès que le fichier est en place. Reste à permettre aux visiteurs de créer un compte, et à vérifier que WordPress voit l'extension.

   1. Dans le tableau de bord, ouvrez Réglages puis Général.
   2. Sous Inscription, cochez Tout le monde peut s'inscrire.
   3. Cliquez sur Enregistrer les modifications.
   4. Ouvrez Extensions et cliquez sur Indispensable, au-dessus de la liste.
   5. Vérifiez que PricklyMails signup check y figure.

   Astuce

   Le formulaire d'inscription se trouve à l'adresse wp-login.php?action=register de votre site : c'est là que se fait l'essai de l'étape suivante.

   À noter

   Votre administration est en anglais ? Ces menus s'y appellent Settings puis General, Membership, Anyone can register, Save Changes, Plugins et Must-Use, comme dans la documentation citée, rédigée en anglais.

   SourceAide officielle de WordPress

   • Settings General screen (nouvel onglet)wordpress.org
   • Must-Use Plugins (nouvel onglet)developer.wordpress.org
   • Header Requirements (nouvel onglet)developer.wordpress.org
   • wp_registration_url() (nouvel onglet)developer.wordpress.org
4. 4
   Dans WordPress

   Essayer avec la clé de test

   1. Inscrivez-vous avec une adresse qui commence par invalid, comme invalid@example.com : la clé de test répond remove, et l'inscription est refusée.
   2. Inscrivez-vous avec une autre adresse, comme valid@example.com : le compte est créé.
   3. Là où vous avez rangé la clé, remplacez-la par une clé créée en Production, qui commence par pm_live_ : dès lors, chaque inscription est vérifiée pour de vrai et facturée comme toute vérification.

Ce que devient chaque inscription

Questions fréquentes