Erfordert: Charitable Pro 1.8.16+ Charitable Ambassadors 3.5.0+

Jemanden zu bitten, ein Passwort zu wählen, ist der Punkt, an dem viele potenzielle Spendeninitiatoren aufgeben. Sie kamen, um fünfzig Dollar für einen guten Zweck zu sammeln, den sie lieben, und das Formular verlangt von ihnen, eine Anmeldeinformation für eine Website zu erfinden und sich zu merken, die sie vielleicht nie wieder besuchen werden.

Passwortlose Konten entfernen diesen Schritt. Das Formular zur Erstellung von Spendenaktionen fragt nicht mehr nach einem Passwort. Ihr Spendeninitiator erhält eine E-Mail, klickt einmal auf den Link darin und landet auf „Meine Kampagnen“, bereits angemeldet. Ihr Konto wird in dem Moment erstellt, in dem sie klicken.

Was es ist und was es nicht ist

Es ist wichtig, präzise zu sein, denn „passwortlos“ bedeutet auf verschiedenen Plattformen unterschiedliche Dinge.

• Ein echtes WordPress-Konto wird trotzdem erstellt. Es hat einfach nie ein Passwort, das die Person wählen musste. Dieses Konto ist es, das es ihnen ermöglicht, ihre Spenden-Seite danach zu besitzen und zu bearbeiten.
• Es gilt für Spendeninitiatoren, nicht für Spender und nicht für Administratoren. Spender brauchten nie ein Konto. Ihr eigener Admin-Login bleibt unberührt.
• Es ist kein Ersatz für funktionierende E-Mails. Der gesamte Ablauf ist das Eintreffen einer E-Mail. Wenn Ihre Website keine zuverlässigen E-Mails senden kann, kommt niemand herein, weshalb die Funktion eigene Zustellungsprüfungen mitbringt.
• Es ist nicht alles oder nichts. Jede einzelne Kampagne kann die Website-Einstellung in beide Richtungen überschreiben.

Einschalten

Gehen Sie zu Charitable > Ambassadors > Templates > Submit Form und aktivieren Sie Passwordless Accounts.

Wenn Sie es zum ersten Mal aktivieren, erstellt Ambassadors eine kleine Datenbanktabelle, um Anmelde-Links zu speichern. Das ist das Einzige, was die Aktivierung an Ihrer Website ändert, und es wird vollständig unter Speicherung von Anmelde-Link-Daten erklärt.

Was Ihr Spendeninitiator sieht

1. Sie füllen das Formular zur Erstellung von Spendenaktionen aus. Es gibt kein Passwortfeld.
2. Sie sehen einen Bildschirm „Überprüfen Sie Ihre E-Mails“, der ihnen sagt, was als Nächstes passiert.
3. Die E-Mail kommt an. Sie enthält einen Link.
4. Sie klicken darauf und landen auf „Meine Kampagnen“, angemeldet, mit ihrer Spenden-Seite bereit.

Was mit der Seite in Schritt 4 passiert, hängt von Ihrer eigenen Moderationseinstellung ab. Wenn die übergeordnete Kampagne eine Genehmigung erfordert, verschiebt das Klicken auf den Link den Spendeninitiator in Ihre Moderationswarteschlange. Wenn die Kampagne Einreichungen automatisch genehmigt, geht die Seite sofort live.

Das ist wichtig für das, was Sie Ihren Unterstützern sagen: Mit aktivierter Moderation lautet die ehrliche Botschaft „Wir werden sie in Kürze überprüfen“, nicht „Ihre Seite ist live“.

Festlegen pro Kampagne

Die meisten Websites möchten eine Antwort für die gesamte Website, aber nicht alle. Eine Schule möchte vielleicht passwortlose Konten für Familien und echte Konten für Mitarbeiter.

Bearbeiten Sie eine beliebige Peer-to-Peer-Überkampagne und öffnen Sie das Panel Peer to Peer Fundraising. Sie haben drei Auswahlmöglichkeiten:

• Standardeinstellung der Website verwenden (das Label gibt an, was dies derzeit ist)
• Ein – kein Passwortfeld
• Aus – Spendenwerber erstellen ein echtes Konto

Sehen, wer noch nicht geklickt hat

Die eine Frage, die jeder Organisator stellt, ist: „Ist mein Spendenwerber tatsächlich eingetreten?“. Charitable > Botschafter > Verzeichnis > Anmelden ausstehend beantwortet sie.

Es listet jeden auf, der einen Spendenwerber eingereicht hat, aber noch nicht auf seinen Link geklickt hat, mit der Kampagne, für die er sich angemeldet hat, und einer Erneut senden-Schaltfläche für jeden.

Zwei Dinge, die Sie über diesen Bildschirm wissen sollten:

• E-Mail-Adressen sind standardmäßig teilweise ausgeblendet und werden als s****@example.com angezeigt. Die Maskierung hat eine feste Breite, sodass sie niemals auf die Länge der Adresse hinweist. Entwickler können dies deaktivieren. Siehe Referenz unten.
• Erneutes Senden bricht den vorherigen Link ab. Es gibt immer nur einen aktiven Link pro Person. Wenn jemand nach einem neuen fragt, funktioniert jeder frühere Link nicht mehr.

Die beiden E-Mails

Passwordless fügt zwei Transaktions-E-Mails hinzu, beide unter Charitable > Einstellungen > E-Mails:

E-Mail	Wann es sendet
Ersteller: Schließen Sie Ihre Spendenaktion ab	Ein neuer Spendenwerber reicht zum ersten Mal ein
Ersteller: Anmelde-Link	Ein wiederkehrender Spendenwerber bittet um erneute Anmeldung

Beide sind wie jede andere Charitable-E-Mail bearbeitbar. Die erste enthält den einzigen Link, der eine Anmeldung abschließen kann. Sie wird also gesendet, unabhängig davon, ob Ihre gespeicherten E-Mail-Einstellungen älter als diese Funktion sind.

Zustellungsstatus

Da die gesamte Funktion von E-Mails abhängt, warnt Sie der Bildschirm „Submit Form“, wenn etwas einen Spendenwerber daran hindert, teilzunehmen. Die Prüfungen, die Sie am wahrscheinlichsten sehen:

Warnung	Was es bedeutet
Die E-Mail mit dem Anmelde-Link ist deaktiviert	Wiederkehrende Spendenwerber können keinen neuen Link anfordern. Neuanmeldungen funktionieren weiterhin.
Die Datenbanktabelle fehlt	Anmeldungen und Anmeldungen schlagen fehl. Siehe die Speicherseite.
Links sind ausstehend	Eine Zählung der gesendeten, aber noch nicht angeklickten Links. Informativ, kein Problem.
Cache-Kompatibilität ist aus	Anmelde-Links funktionieren möglicherweise nicht hinter einigen Caches.

Tipps, die man sich merken sollte

• Testen Sie mit einer Adresse, die Sie tatsächlich lesen können. Der Ablauf ist nur so gut wie Ihre E-Mail-Zustellung, und der schnellste Weg, ein E-Mail-Problem zu finden, ist, den Ablauf selbst einmal durchzugehen.
• Anmelde-Links verfallen. Sie sind einmalig verwendbar und zeitlich begrenzt. Wer die E-Mail vierzehn Tage liegen lässt, benötigt eine neue, wofür der Button „Erneut senden“ sorgt.
• Das Klicken auf den Link schließt die Anmeldung ab. Das Öffnen der E-Mail reicht nicht aus, und eine Vorschau auch nicht. Das ist beabsichtigt, siehe unten.
• Beobachten Sie „Warten auf Anmeldung“ in der ersten Woche einer Kampagne. Eine Gruppe von Personen, die nie geklickt haben, bedeutet normalerweise ein Zustellbarkeitsproblem, nicht Desinteresse.

Fehlerbehebung

„Die E-Mail ist nie angekommen.“ Überprüfen Sie zuerst den Spam-Ordner, dann die allgemeine E-Mail-Zustellung Ihrer Website. Die Warnungen des Formulars „Einreichen“ teilen Ihnen mit, ob die E-Mail selbst deaktiviert ist. Wenn auch andere Charitable-E-Mails fehlen, liegt das Problem bei der Mail-Konfiguration, nicht bei dieser Funktion.

„Der Link besagt, dass er bereits verwendet wurde.“ Entweder wurde er tatsächlich verwendet, oder ein neuerer Link wurde ausgestellt und hat ihn ungültig gemacht. Senden Sie ihn erneut aus „Warten auf Anmeldung“ und bitten Sie die Person, die neueste E-Mail zu verwenden.

„Jemand hat sich angemeldet, aber nichts ist in meiner Moderationswarteschlange.“ Überprüfen Sie „Warten auf Anmeldung“. Wenn die Person dort aufgeführt ist, hat sie noch nicht geklickt, daher wartet die Spendenaktion noch auf sie und nicht auf Sie.

„Ich muss die vollständige E-Mail-Adresse sehen.“ Die Maskierung ist standardmäßig aktiviert. Ein Entwickler kann sie mit dem unten stehenden Filter deaktivieren.

---

Entwicklerreferenz

Der Ablauf

Eine Einreichung gibt ein Einmal-Token aus, das als Link per E-Mail versendet wird. Das Öffnen des Links zeigt eine Seite an; das Absenden dieser Seite ist es, was das Token einlöst, das Konto erstellt oder auflöst, die Entwurfs-Spendenaktion beansprucht und die Person anmeldet. Die zweistufige Form existiert, damit ein E-Mail-Scanner oder eine Link-Vorschau den Link nicht verbrauchen kann, bevor der Mensch darauf klickt.

Tokens sind 256 Bit CSPRNG-Ausgabe, gespeichert als HMAC-SHA256-Hash, der auf wp_salt() basiert, niemals im Klartext. Die Einlösung ist ein einzelnes bedingtes UPDATE, sodass ein Scanner-Prefetch und ein menschlicher Klick nicht beide erfolgreich sein können.

Funktionen

Ein auf diese Weise erstelltes Konto erhält die Rolle campaign_creator, die edit_campaigns und read trägt und nichts weiter. Es gibt bewusst keinen Filter, um das zu ändern.

Filter

Filter	Zweck
charitable_ambassadors_awaiting_mask_email	Geben Sie false zurück, um vollständige Adressen in der Ansicht „Warten auf Anmeldung“ anzuzeigen. Standardmäßig maskiert.
charitable_ambassadors_passwordless_storage_docs_url	Die Dokumentations-URL, auf die im Hilfetext der Einstellungen und in den Selbstüberprüfungshinweisen verwiesen wird.

// Show full addresses in Awaiting Sign-In to anyone who can open that screen.
add_filter( 'charitable_ambassadors_awaiting_mask_email', '__return_false' );

Aktionen

Aktion	Feuer
charitable_ambassadors_passwordless_redeemed	Nachdem ein Token eingelöst und das Konto aufgelöst wurde. Empfängt die Benutzer-ID, den Zweck und die Kampagnen-ID.

Vorlagen

Beide öffentlichen Bildschirme können in Ihrem Theme überschrieben werden:

your-theme/charitable/charitable-ambassadors/passwordless/redeem.php
your-theme/charitable/charitable-ambassadors/passwordless/notice.php

Ratenbegrenzung

Die Ausgabe von Links ist pro E-Mail-Adresse begrenzt, nicht pro IP. Das ist beabsichtigt: Eine ganze Liste hinter einem Büro- oder Schulnetzwerk teilt sich eine Adresse, und eine IP-Obergrenze würde legitime Familien aussperren. Brute-Force wird durch die Token-Entropie und nicht durch Drosselung behandelt.