Erste Schritte

Systemvoraussetzungen

FG DocCheck WP enthält im Plugin-Header keine expliziten Angaben zu einer WordPress- oder PHP-Mindestversion. Für den Betrieb müssen jedoch die im Code verwendeten WordPress-APIs, PHP-Sessions und ausgehende HTTPS-Anfragen verfügbar sein.

Für die vollständige Funktion werden benötigt:

• WordPress
• PHP mit Session-Unterstützung
• DocCheck Login Access mit Client-ID und Client-Secret
• ausgehender HTTPS-Zugriff auf https://auth.doccheck.com
• Browserzugriff auf das Login-Button-Script unter https://dccdn.de
• Multibyte-String-Unterstützung in PHP, wenn der Gastzugang verwendet wird

Weitere Hinweise stehen unter Kompatibilität.

Installation

1. Den Plugin-Ordner in wp-content/plugins/ ablegen oder das Plugin als ZIP über WordPress installieren.
2. FG DocCheck WP in der WordPress-Pluginverwaltung aktivieren.
3. Unter Einstellungen → FG DocCheck Access die Zugangsdaten und URLs konfigurieren.
4. Eine WordPress-Seite für den Login anlegen.
5. Auf dieser Loginseite den Shortcode einfügen:

[fg_doccheck_login]

6. Die URL dieser Seite als Restricted Login URL hinterlegen.
7. Beiträge oder Seiten, die geschützt werden sollen, im Editor über die Meta-Box FG DocCheck Schutz markieren.

DocCheck-Zugangsdaten konfigurieren

Mindestens erforderlich sind:

• Login-Client-ID
• Login-Client-Secret
• Redirect URI

Die Redirect URI wird sowohl an den DocCheck-Login-Button als auch beim serverseitigen Token-Austausch übergeben. Sie muss deshalb mit der bei DocCheck Login Access hinterlegten Redirect URI übereinstimmen.

Client-ID und Client-Secret können alternativ in wp-config.php gesetzt werden:

define('FG_DOCCHECK_CLIENT_ID', '...');
define('FG_DOCCHECK_CLIENT_SECRET', '...');

Wenn diese Konstanten definiert sind, überschreiben sie die entsprechenden gespeicherten Plugin-Einstellungen zur Laufzeit.

Erste Konfiguration

Die Standardwerte des Plugins sind:

Einstellung	Standard
Redirect URI	home_url('/fachkreise/')
Restricted Login URL	home_url('/restricted-login/')
Scope	unique_id profession country language
Button-Sprache	de
Button-Größe	large
Gast-Passwort	nicht gesetzt
DocCheck-Login gültig für	12 Stunden

Alle Einstellungen sind unter Konfiguration beschrieben.

Funktion nach der Installation prüfen

1. Einen Testbeitrag oder eine Testseite über FG DocCheck Schutz schützen.
2. Den Inhalt in einem privaten Browserfenster aufrufen.
3. Prüfen, ob die Weiterleitung zur Restricted-Login-Seite erfolgt.
4. Prüfen, ob der DocCheck-Login-Button sichtbar ist.
5. Nach erfolgreichem DocCheck-Login prüfen, ob zur ursprünglich aufgerufenen Seite zurückgeleitet wird.
6. Falls ein Gast-Passwort konfiguriert ist, zusätzlich den Gastzugang testen.
7. Falls Secure-Deeplink verwendet wird, den Zugriff mit dem konfigurierten ?secure=...-Wert separat prüfen.

Deaktivierung und Deinstallation

Der aktuelle Projektstand enthält weder einen Deaktivierungs-Hook noch uninstall.php oder einen Uninstall-Hook. Gespeicherte Optionen und Post-Metadaten werden daher durch das Plugin nicht automatisch entfernt.

Zu den gespeicherten Daten gehören insbesondere:

• Option fg_doccheck_wp_options
• Post-Meta _fg_doccheck_restricted
• Post-Meta doccheck_temp
• Post-Meta doccheck_temp_string

Bei einer vollständigen manuellen Bereinigung müssen diese Daten gezielt entfernt werden. Details stehen unter Datenverarbeitung.