WordPress-Integration

Sendity in WordPress nutzen.

Das Plugin Sendity Login bindet den Browser-Client ein, prüft signierte Ergebnisse direkt in WordPress, weist Wiederverwendung zurück und setzt für verifizierte E-Mail-Identitäten normale WordPress-Anmelde-Cookies.

Öffnen Sie in WordPress Plugins → Neues Plugin hinzufügen, suchen Sie nach Sendity und wählen Sie Jetzt installieren und Aktivieren. Sie können das Plugin auch mit WP-CLI installieren. In Bedrock-Projekten können Sie stattdessen Composer verwenden.

wp plugin install sendity --activate

# Bedrock / Composer alternative
composer require wp-plugin/sendity:^0.1

Sendity auf WordPress.org öffnen

Sendity konfigurieren

Legen Sie Ihre Kampagne in Sendity Cloud an oder öffnen Sie sie, fügen Sie den Origin Ihrer WordPress-Seite hinzu und kopieren Sie die Kampagnen-ID. Öffnen Sie dann in WordPress Einstellungen → Sendity. Mit der Cloud brauchen Sie meist nur die Kampagnen-ID und den Zweck der Kampagne. Schlüsselermittlung und Prüfung nutzen die gehosteten Standardwerte.

Einstellung	Was sie steuert
Sendity Campaign ID	Die Kampagnen-ID aus Sendity Cloud (wird als Attribut public-key gesendet). Sie ist zugleich die erwartete Token-Audience, sofern Sie keinen eigenen erweiterten Wert festlegen.
Campaign Purpose	WordPress-Anmeldung (E-Mail) legt eine WordPress-Session an; Nur Verifizierung zeigt den Ablauf an, ohne Nutzer oder Login-Cookies anzulegen.
Show on wp-login.php	Fügt Sendity bei Kampagnen für die Anmeldung per E-Mail zur Standard-Login-Seite von WordPress hinzu.
Create WordPress Users	Legt nach einer verifizierten Anmeldung per E-Mail einen Nutzer mit wenigen Rechten an. Deaktivieren Sie die Option, um nur bestehende Nutzer zuzulassen.
Default Role for New Users	Wählt die Rolle mit wenigen Rechten für Nutzer, die Sendity anlegt. Privilegierte Rollen sind ausgeschlossen.
After Login Redirect	Legt das lokale Ziel fest, nachdem WordPress das signierte Ergebnis akzeptiert und die Session angelegt hat.
Sendity Server URL	Standardmäßig Sendity Cloud. Ändern Sie den Wert nur, wenn Sie einen kompatiblen Sendity-Server betreiben.
JWKS URL Override	Überschreibt die automatische Ermittlung der Signaturschlüssel. Lassen Sie das Feld für Sendity Cloud leer.
Transport	Auto wird empfohlen; Polling und Push sind gezielte Alternativen für eingeschränkte Umgebungen.
Replay TTL	Legt fest, wie lange ein bereits verwendetes Token gespeichert und als Wiederverwendung zurückgewiesen wird.

Selbst betriebene oder verwaltete Installationen können die Prüfwerte in wp-config.php festlegen. Legen Sie private Sendity-Zugangsdaten nie in Beiträgen, Blöcken oder Shortcodes ab.

define('SENDITY_SERVER_URL', 'https://sendity.io/api');
define('SENDITY_ISSUER', 'https://sendity.io');
define('SENDITY_AUDIENCE', 'app_01HX...');
define('SENDITY_APP_PUBLIC_KEY', 'app_01HX...');
define('SENDITY_JWKS_URL', 'https://sendity.io/api/.well-known/jwks.json');

Den Gutenberg-Block verwenden

Fügen Sie im Block-Editor Sendity Login hinzu. Der Editor zeigt eine sichere Vorschau. Die veröffentlichte Seite nutzt die Kampagne, die unter Einstellungen → Sendity konfiguriert ist.

Block-Option	Werte	Beschreibung
Layout-Variante	Karte, Modal	Die Karte bettet den gesamten Ablauf in die Seite ein. Das Modal zeigt ihn als Overlay.
Position	Mitte, Oben, Unten	Richtet das Modal vertikal aus. Auf die Karten-Variante hat die Option keine Wirkung.
Vorschau-Zustand	Challenge, Warnung, Abgelaufen, Verifiziert, Fehler	Ändert nur die Vorschau im Editor, damit Sie jeden Zustand prüfen können. Das echte Anmeldeergebnis bleibt unberührt.
Eckenradius	CSS-Länge, zum Beispiel 1.25rem	Überschreibt den Eckenradius der Sendity-Komponente für diesen Block.

Den WordPress-Shortcode verwenden

Verwenden Sie den Shortcode [sendity_login] in einem Shortcode-Block, im klassischen Editor, in einem Widget, einem wiederverwendbaren Pattern oder einem kompatiblen Page Builder. Das Plugin registriert keinen Alias [sendity].

[sendity_login]

[sendity_login variant="modal" position="top" sendity_border_radius="1.25rem"]

Attribut	Beschreibung
`variant="modal"`	Nutzt das Modal-Overlay. Lassen Sie das Attribut weg, um die eingebettete Standardkarte zu erhalten.
`position="top\|center\|bottom"`	Legt die Position des Modals fest und wird ignoriert, wenn variant nicht modal ist.
`sendity_border_radius="1.25rem"`	Setzt das unterstützte Design-Token für den Eckenradius von Sendity für diese Instanz.
`class="my-class"`	Fügt dem Sendity-Element Ihre CSS-Klasse hinzu.
`style="..."`	Ergänzt Inline-CSS für diese Instanz, einschließlich weiterer Sendity-Design-Tokens aus dem Konfigurator.

Public Key, Server-URL, Transport, Übersetzungen und die Regeln zur Token-Prüfung stammen immer aus den Einstellungen der Administration und lassen sich per Shortcode nicht überschreiben.

Anmeldung oder reine Verifizierung wählen

Kampagnen für die Anmeldung per E-Mail können einen WordPress-Nutzer anlegen oder wiederverwenden und schließen die Übergabe auf derselben Origin unter /sendity/session ab. Kampagnen nur zur Verifizierung, auch die Verifizierung per Telefon, verzichten auf die Session-Übergabe und legen weder Nutzer noch Login-Cookies an.

Das Plugin bringt Sendity Client 0.3.4 lokal mit. Die Sprachpakete von WordPress liefern Übersetzungen über den Übersetzungsvertrag des Clients.