Erforderlich: Charitable Pro 1.8.16+ Charitable Ambassadors 3.5.0+
Passwortlose Spendenkonten funktionieren, indem ein einmaliger Anmelde-Link per E-Mail versendet wird. Diese Links müssen irgendwo gespeichert werden, bis sie verwendet werden. Diese Seite erklärt genau, wo, wie lange und wie sie entfernt werden können.
Wenn Sie die Funktion nur aktivieren, müssen Sie dies nicht lesen. Sie ist für Personen gedacht, die wissen möchten, was ein Plugin in ihrer Datenbank speichert, und für alle, die eine Datenanfrage oder eine Deinstallation bearbeiten.
Die Kurzfassung
- Eine zusätzliche Datenbanktabelle, die beim ersten Einschalten der passwortlosen Funktion erstellt wird.
- Sie speichert Hashes von Anmelde-Links, niemals die Links selbst.
- Einträge sind kurzlebig: Ein Registrierungs-Link ist 24 Stunden gültig, ein Anmelde-Link eine Stunde.
- Wenn Sie die Funktion ausschalten, bleibt die Tabelle unverändert. Es werden keine Daten ohne Ihr Wissen gelöscht.
- Die Deinstallation des Plugins lässt die Tabelle ebenfalls absichtlich unverändert, sodass eine versehentliche Deaktivierung niemals Daten zerstört.
Wann die Tabelle erstellt wird
Die Tabelle wird erstellt, wenn Passwortlose Konten zum ersten Mal auf Charitable > Ambassadors > Templates > Submit Form aktiviert wird. Sie wird nicht bei der Aktivierung des Plugins erstellt und auch nicht auf Websites, die die Funktion nie nutzen.
Ihr Name folgt Ihrem Datenbankpräfix:
wp_charitable_ambassadors_signin_tokens
Wenn Ihr Präfix nicht wp_ lautet, ersetzen Sie ihn durch Ihren.
Was sich in der Tabelle befindet
Eine Zeile pro ausgestelltem Anmelde-Link. Die Spalten:
| Spalte | Was sie enthält |
|---|---|
id |
Zeilen-Identifikator |
token_hash |
Ein HMAC-SHA256-Hash des Links, verschlüsselt mit den Salts Ihrer Website |
Zweck |
signup für ein neues Konto, signin für einen wiederkehrenden Spender |
E-Mail |
Die Adresse, an die der Link gesendet wurde |
user_id |
Das Konto für einen wiederkehrenden Spender. 0 für eine neue Registrierung, da noch kein Konto existiert |
campaign_id |
Die Spende, auf die sich der Link bezieht |
erstellt_am |
Wann er ausgestellt wurde |
expires_at |
Wann er abläuft |
eingelöst_bei |
Als es verwendet wurde, oder leer, wenn es nicht verwendet wurde |
Der Link selbst wird niemals gespeichert. Es wird nur ein gehashter Schlüssel davon gespeichert, sodass jemand, der diese Tabelle liest, keinen funktionierenden Anmeldelink daraus rekonstruieren kann. Der Hash ist mit den eigenen Salts Ihrer Website verschlüsselt, was bedeutet, dass eine Kopie der Tabelle, die auf eine andere Website übertragen wird, inert ist.
Die Adresse wird im Klartext gespeichert, da die Funktion die Person per E-Mail erreichen und Ihnen anzeigen muss, wer wartet.
Wie lange Zeilen bestehen bleiben
| Link-Typ | Lebensdauer |
|---|---|
| Anmeldung (ein brandneuer Spendenläufer) | 24 Stunden |
| Anmeldung (ein wiederkehrender Spendenläufer) | 1 Stunde |
Links sind einmalig verwendbar. Das Einlösen eines Links markiert ihn als verwendet, und die Anforderung eines neuen Links bricht jeden früheren Link für dieselbe Adresse ab, sodass zu jeder Zeit nur ein aktiver Link pro Person existiert.
Die Zustände der Selbstprüfung
Der Bildschirm „Formular übermitteln“ berichtet über diese Tabelle, damit Sie nicht raten müssen. Die Zustände, die Sie möglicherweise sehen:
| Status | Bedeutung | Was zu tun ist |
|---|---|---|
| Aktiviert, Tabelle vorhanden | Normal. | Nichts. |
| Aktiviert, Tabelle fehlt | Anmeldungen und Anmeldungen schlagen fehl. | Schalten Sie die Funktion aus und wieder ein. Dadurch wird die Tabelle neu erstellt. |
| Aktiviert, Schema veraltet | Die Tabelle existiert, ist aber älter als ein Update. | Ein Entwickler kann sie aktualisieren. Siehe Referenz unten. |
| Aktiviert, Links ausstehend | Eine Zählung der gesendeten, aber nicht angeklickten Links. | Informationszwecke. Überprüfen Sie „Auf Anmeldung wartend“, wenn der Wert hoch erscheint. |
| Aktiviert, Anmeldungs-E-Mail deaktiviert | Wiederkehrende Spendenläufer können keinen Link anfordern. | Aktivieren Sie diese E-Mail erneut unter „Charitable > Einstellungen > E-Mails“. |
| Deaktiviert, Tabelle noch vorhanden | Ihre vorhandenen Daten bleiben erhalten. | Nichts. Dies ist eine Beruhigung, kein Problem. |
Deaktivieren der Funktion (Soft-Disable)
Deaktivieren Sie Passwortlose Konten und die Funktion wird gestoppt: Es werden keine neuen Links ausgestellt und das Formular zum Erstellen von Spendenaktionen fragt wieder nach einem Passwort.
Die Tabelle und ihre Zeilen bleiben erhalten. Jeder, der bereits einen gültigen Link hat, kann ihn weiterhin verwenden, und bereits erstellte Konten funktionieren weiterhin wie normale Konten, da dies das ist, was sie sind. Wenn Sie die Funktion wieder aktivieren, machen Sie dort weiter, wo Sie aufgehört haben.
Beim Umschalten geht nichts verloren, und das ist der Sinn der Sache: Eine Einstellung, die beim Deaktivieren stillschweigend Daten zerstört, wäre eine schlechte Einstellung.
Permanentes Löschen der Daten
Zwei separate Elemente können entfernt werden, und sie werden auf unterschiedliche Weise entfernt.
Ausstehende Links. Alle nicht eingelösten Links können auf dem Einstellungsbildschirm auf einmal ungültig gemacht werden. Jeder, der sich gerade im Prozess befindet, benötigt einen neuen. Dies leert die Live-Links, ohne die Konten zu berühren.
Die Tabelle selbst. Die Deinstallation von Charitable Ambassadors löscht diese Tabelle nicht, und das mit Absicht. Derselbe Präzedenzfall gilt wie für Einladungs-Tokens: Eine Deinstallation ist manchmal ein Unfall, und ein Plugin, das eine Tabelle bei der Deaktivierung zerstört, gibt Ihnen keine Möglichkeit zur Rückkehr. Wenn Sie sie wirklich weg haben möchten, kann ein Entwickler sie löschen oder Ihr Hoster über phpMyAdmin.
Konten befinden sich nicht in dieser Tabelle. Spendenaktionskonten sind normale WordPress-Benutzer und leben in Ihrer Benutzertabelle wie alle anderen auch. Das Löschen von Anmelde-Link-Daten löscht nicht die Konten oder die Spendenaktionsseiten von jemandem.
Exporte, Backups und persönliche Daten
- Backups enthalten diese Tabelle wie jede andere. Da sie nur Hashes und Adressen enthält, enthält ein Backup keine nutzbaren Anmelde-Links.
- Ein WordPress-Export persönlicher Daten für einen Spendenaktion gibt dessen Konto und dessen Kampagnen auf normale Weise zurück. Anmelde-Links sind kurzlebige operative Aufzeichnungen und keine Profildaten.
- Eine Löschung persönlicher Daten entfernt das Konto über die eigenen Werkzeuge von WordPress. Jeder ausstehende Link für diese Adresse funktioniert nicht mehr, da er niemandem mehr zugeordnet ist.
Tipps
- Wenn Anmeldungen auf der ganzen Website plötzlich nicht mehr funktionieren, überprüfen Sie zuerst die Warnung über fehlende Tabellen. Dies ist der einzige Fehler, der alles auf einmal bricht und eine Ein-Klick-Lösung hat.
- Eine hohe Anzahl ausstehender Links zu Beginn einer Kampagne bedeutet normalerweise ein Zustellbarkeitsproblem, nicht Desinteresse.
- Kopieren Sie diese Tabelle nicht zwischen Websites. Sie ist an die Salts der Website gebunden, die sie erstellt hat, und funktioniert woanders nicht.
Entwicklerreferenz
Schema-Klasse
Charitable_Ambassadors_Passwordless_Schema
| Mitglied | Zweck |
|---|---|
table_name() |
Präfix-Tabellenname |
exists() |
Ob die Tabelle vorhanden ist |
is_enabled() |
Ob die Funktion aktiviert ist |
SCHEMA_VERSION |
Aktuelle Schemaversion, 1.1 |
SCHEMA_VERSION_OPTION |
charitable_ambassadors_passwordless_schema_version |
Optionsschlüssel
| Option | Zweck |
|---|---|
charitable_ambassadors_passwordless_schema_version |
Die installierte Schemaversion |
charitable_ambassadors_passwordless_rewrite_version |
Protokolliert, wann die Rewrite-Regeln des Endpunkts zuletzt registriert wurden |
Beide werden durch die Deinstallationsroutine des Plugins entfernt. Die Tabelle nicht.
Tokens-Klasse
Charitable_Ambassadors_Passwordless_Tokens
| Methode | Zweck |
|---|---|
issue( $purpose, $email, $user_id, $campaign_id ) |
Einen Link erstellen |
lookup( $token ) |
Eine Zeile lesen, ohne sie zu verbrauchen |
redeem( $token ) |
Einen Link atomar verbrauchen |
invalidate_for_email( $email ) |
Jeden Link für eine Adresse stornieren |
invalidate_for_user( $user_id ) |
Jeden Link für ein Konto stornieren |
purge_all() |
Alles ausstehende stornieren |
effective_ttl( $purpose ) |
Lebensdauer in Sekunden für diesen Zweck |
Filter
| Filter | Zweck |
|---|---|
charitable_ambassadors_passwordless_storage_docs_url |
Die URL, unter der diese Seite zu finden ist, wie im Hilfetext der Einstellungen und in den Selbstprüfungs-Hinweisen verlinkt |
charitable_ambassadors_awaiting_mask_email |
Geben Sie false zurück, um vollständige Adressen in der Ansicht "Warten auf Anmeldung" anzuzeigen |
