Requis : Charitable Pro 1.8.16+ Charitable Ambassadors 3.5.0+
Demander à quelqu'un de choisir un mot de passe est le moment où de nombreux collecteurs de fonds potentiels abandonnent. Ils sont venus pour collecter cinquante dollars pour une cause qui leur tient à cœur, et le formulaire leur demande d'inventer et de retenir un identifiant pour un site Web qu'ils ne visiteront peut-être plus jamais.
Les comptes sans mot de passe suppriment cette étape. Le formulaire de création de collecte de fonds cesse de demander un mot de passe. Votre collecteur de fonds reçoit un e-mail, clique sur le lien qu'il contient une fois, et arrive sur Mes campagnes déjà connecté. Son compte est créé au moment où il clique.
Ce que c'est, et ce que ce n'est pas
Il convient d'être précis, car « sans mot de passe » signifie différentes choses sur différentes plateformes.
- Un vrai compte WordPress est toujours créé. Il n'a simplement jamais de mot de passe que la personne a dû choisir. Ce compte est ce qui lui permet de posséder et de modifier sa page de collecte de fonds par la suite.
- Cela couvre les collecteurs de fonds, pas les donateurs ni les administrateurs. Les donateurs n'ont jamais eu besoin d'un compte. Votre propre connexion d'administrateur n'est pas affectée.
- Ce n'est pas un remplacement pour un e-mail fonctionnel. L'ensemble du processus repose sur l'arrivée d'un e-mail. Si votre site ne peut pas envoyer d'e-mails de manière fiable, personne ne peut se connecter, c'est pourquoi la fonctionnalité est livrée avec ses propres vérifications de livraison.
- Ce n'est pas tout ou rien. Chaque campagne individuelle peut outrepasser le paramètre du site dans un sens ou dans l'autre.
L'activer
Allez dans Charitable > Ambassadeurs > Modèles > Formulaire de soumission et cochez Comptes sans mot de passe.
La première fois que vous l'activez, Ambassadeurs crée une petite table de base de données pour stocker les liens de connexion. C'est la seule chose que l'activation modifie sur votre site, et tout est expliqué dans Comment les données des liens de connexion sont stockées.
Ce que voit votre collecteur de fonds
- Ils remplissent le formulaire de création de collecte de fonds. Il n'y a pas de champ de mot de passe.
- Ils voient un écran « vérifiez votre e-mail » leur indiquant ce qui se passe ensuite.
- L'e-mail arrive. Il contient un seul lien.
- Ils cliquent dessus et arrivent sur Mes campagnes, connectés, avec leur page de collecte de fonds prête.
Ce qui arrive à la page à l'étape 4 dépend de votre propre paramètre de modération. Si la campagne parente nécessite une approbation, cliquer sur le lien déplace le collecteur de fonds dans votre file d'attente de modération. Si la campagne approuve automatiquement les soumissions, la page est mise en ligne immédiatement.
Cela est important pour ce que vous dites à vos supporters : avec la modération activée, le message honnête est « nous l'examinerons sous peu », pas « votre page est en ligne ».
Définir par campagne
La plupart des sites veulent une réponse pour l'ensemble du site, mais pas tous. Une école pourrait vouloir des comptes sans mot de passe pour les familles et de vrais comptes pour le personnel.
Modifiez n'importe quelle campagne parente de collecte de fonds pair-à-pair et ouvrez le panneau Collecte de fonds pair-à-pair. Vous avez trois choix :
- Utiliser la valeur par défaut du site (l'étiquette vous indique quelle est la valeur actuelle)
- Activé – aucun champ de mot de passe
- Désactivé – les collecteurs de fonds créent un compte réel
Voir qui n'a pas encore cliqué
La question que tout organisateur pose est « mon collecteur de fonds a-t-il réellement participé ? ». Charitable > Ambassadeurs > Répertoire > En attente de connexion y répond.
Il répertorie toutes les personnes qui ont soumis une collecte de fonds mais n'ont pas encore cliqué sur leur lien, avec la campagne pour laquelle elles se sont inscrites et un bouton Renvoyer pour chacune.
Deux choses à savoir sur cet écran :
- Les adresses e-mail sont partiellement masquées par défaut, affichées comme
s****@example.com. Le masque a une largeur fixe, de sorte qu'il n'indique jamais la longueur de l'adresse. Les développeurs peuvent désactiver cette option, voir la référence ci-dessous. - Le renvoi annule le lien précédent. Il n'y a qu'un seul lien actif par personne à la fois. Si quelqu'un demande un nouveau lien, tout lien antérieur cesse de fonctionner.
Les deux e-mails
Passwordless ajoute deux e-mails transactionnels, tous deux sous Charitable > Paramètres > E-mails :
| Quand il envoie | |
|---|---|
| Créateur : Terminez votre collecte de fonds | Une nouvelle collecte de fonds est soumise pour la première fois |
| Créateur : Lien de connexion | Un collecteur de fonds existant demande à se connecter à nouveau |
Les deux sont modifiables comme tous les autres e-mails de Charitable. Le premier contient le seul lien qui peut finaliser une inscription, il est donc envoyé que vos paramètres d'e-mail stockés soient antérieurs ou non à cette fonctionnalité.
Santé de la livraison
Comme toute la fonctionnalité dépend de l'e-mail, l'écran du formulaire de soumission vous avertit lorsque quelque chose pourrait empêcher un collecteur de fonds de participer. Les vérifications que vous êtes le plus susceptible de voir :
| Avertissement | Ce que cela signifie |
|---|---|
| L'e-mail de lien de connexion est désactivé | Les collecteurs de fonds existants ne peuvent pas demander un nouveau lien. Les nouvelles inscriptions fonctionnent toujours. |
| Sa table de base de données est manquante | Les inscriptions et les connexions échouent. Voir la page de stockage. |
| Liens en attente | Un décompte des liens envoyés mais pas encore cliqués. Informatif, pas un problème. |
| La compatibilité du cache est désactivée | Les liens de connexion peuvent ne pas fonctionner derrière certains caches. |
Conseils à garder à l'esprit
- Testez avec une adresse que vous pouvez réellement lire. Le processus n'est bon que si votre livraison d'e-mails l'est, et la façon la plus rapide de trouver un problème d'e-mail est de suivre le processus vous-même une fois.
- Les liens de connexion expirent. Ils sont à usage unique et limités dans le temps. Quelqu'un qui laisse l'e-mail pendant une quinzaine aura besoin d'un nouveau lien, ce que le bouton Renvoyer gère.
- Cliquer sur le lien est ce qui le complète. Ouvrir l'e-mail ne suffit pas, pas plus qu'une prévisualisation. C'est délibéré, voir ci-dessous.
- Surveillez les "En attente de connexion" durant la première semaine d'une campagne. Un groupe de personnes qui n'ont jamais cliqué signifie généralement un problème de délivrabilité, pas de désintérêt.
Dépannage
« L'e-mail n'est jamais arrivé. » Vérifiez d'abord le spam, puis la livraison de courrier de votre site en général. Les avertissements du formulaire de soumission vous indiqueront si l'e-mail lui-même est désactivé. Si d'autres e-mails de Charitable sont également manquants, le problème vient de la configuration du courrier, pas de cette fonctionnalité.
« Le lien indique qu'il a déjà été utilisé. » Soit il l'a réellement été, soit un lien plus récent a été émis et l'a annulé. Renvoyez depuis "En attente de connexion" et demandez-leur d'utiliser le dernier e-mail.
« Quelqu'un s'est inscrit mais rien n'apparaît dans ma file d'attente de modération. » Vérifiez "En attente de connexion". S'ils y figurent, ils n'ont pas encore cliqué, donc la collecte de fonds attend toujours d'eux plutôt que de vous.
« J'ai besoin de voir l'adresse e-mail complète. » Le masquage est activé par défaut. Un développeur peut le désactiver avec le filtre ci-dessous.
Référence du développeur
Le flux
Une soumission émet un jeton à usage unique, qui est envoyé par e-mail sous forme de lien. L'ouverture du lien affiche une page ; la soumission de cette page est ce qui valide le jeton, crée ou résout le compte, revendique la campagne de collecte de fonds en brouillon et connecte la personne. La forme en deux étapes existe pour qu'un scanner d'e-mail ou un aperçu de lien ne puisse pas consommer le lien avant que l'humain ne clique dessus.
Les jetons sont 256 bits de sortie CSPRNG, stockés sous forme de hachage HMAC-SHA256 indexé sur wp_salt(), jamais en clair. La validation est une seule UPDATE conditionnelle, donc un pré-fetch du scanner et un clic humain ne peuvent pas réussir tous les deux.
Capacités
Un compte créé de cette manière obtient le rôle campaign_creator, qui porte edit_campaigns et read et rien d'autre. Il n'y a délibérément aucun filtre pour changer cela.
Filtres
| Filtre | Objectif |
|---|---|
charitable_ambassadors_awaiting_mask_email |
Retournez false pour afficher les adresses complètes dans la vue "En attente de connexion". Masqué par défaut. |
charitable_ambassadors_passwordless_storage_docs_url |
L'URL de documentation liée depuis le texte d'aide des paramètres et les notifications d'auto-vérification. |
// Show full addresses in Awaiting Sign-In to anyone who can open that screen.
add_filter( 'charitable_ambassadors_awaiting_mask_email', '__return_false' );
Actions
| Action | Déclenche |
|---|---|
charitable_ambassadors_passwordless_redeemed |
Après qu'un jeton a été validé et le compte résolu. Reçoit l'ID utilisateur, le but et l'ID de la campagne. |
Modèles
Les deux écrans publics sont remplaçables dans votre thème :
your-theme/charitable/charitable-ambassadors/passwordless/redeem.php
your-theme/charitable/charitable-ambassadors/passwordless/notice.php
Limitation du débit
L'émission de liens est limitée par adresse e-mail, pas par IP. C'est délibéré : une liste entière derrière un réseau de bureau ou scolaire partage une adresse, et un plafond IP bloquerait les familles légitimes. La force brute est gérée par l'entropie du jeton plutôt que par la limitation.
