=== APlug Wartungs- und StagingZentrale ===
Contributors: aplug
Tags: maintenance, staging, deployment, development, noindex
Requires at least: 6.4
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Wartungsseiten, Testumgebungsschutz, technische Umgebungsvergleiche und kontrollierte Übergaben an Backup- und Transferadapter.

== Description ==

APlug Wartungs- und StagingZentrale unterstützt sichere Wartungsarbeiten und nachvollziehbare Staging-Abläufe auf bestehenden WordPress-Websites.

Der Wartungsmodus bietet:

* zeitgesteuerte Aktivierung und automatische Beendigung,
* anpassbare Wartungsvorlagen, Überschriften, Mitteilungen und Kontaktangaben,
* HTTP-Status 503 mit Retry-After oder optional 200,
* Ausnahmen für berechtigte Rollen, Benutzer und IP-/CIDR-Bereiche,
* Noindex-, Nofollow- und Noarchive-Hinweise,
* weiterhin erreichbare Anmeldung, Administration, Cron- und REST-Systemwege.

Der Testumgebungsschutz bietet:

* Erkennung von `WP_ENVIRONMENT_TYPE`,
* zusätzliche manuelle Staging-Kennzeichnung,
* Suchmaschinen-Sperre und X-Robots-Tag,
* E-Mail-Blockierung oder Umleitung an ein Testpostfach,
* Sperre unterstützter WooCommerce- und Easy-Digital-Downloads-Zahlungswege,
* optionalen Schutz vor externen HTTP-Anfragen mit Host-Freigabeliste,
* sichtbare Testumgebungswarnungen für berechtigte Benutzer.

Für Staging-Abläufe können mehrere WordPress-Installationen sicher verbunden werden. Die Gegenstelle stellt nach authentifizierter Anfrage ein technisches Manifest bereit. Verglichen werden WordPress-, PHP-, Plugin- und Theme-Versionen, Komponenten-Fingerabdrücke sowie Tabellenstrukturen, geschätzte Zeilenzahlen und Größen. Tabelleninhalte, Passwörter und Kundendaten werden dabei nicht übertragen.

Aus einem Vergleich entsteht ein Übertragungsplan mit:

* betroffenen Komponenten und Tabellen,
* Konflikt- und Schweregradübersicht,
* ausdrücklicher Freigabe,
* Backup-Pflicht,
* dokumentierter Vorgangskennung,
* manueller Übergabe oder registriertem Transferadapter.

Das Plugin enthält bewusst keine zweite Backup-Engine und keinen unkontrollierten Hosting-Klon. Sicherungen werden über den dokumentierten Dienst `aplug.backup.create` an eine Backup-Lösung übergeben. Serverübergreifende Datei- und Datenbankübertragungen werden nur über ausdrücklich registrierte Transferadapter ausgeführt.

Das Grundplugin sendet keine Telemetrie und verwendet keine externen SaaS-Dienste.

== Installation ==

1. Den Ordner `aplug-wartungs-stagingzentrale` nach `/wp-content/plugins/` hochladen oder die ZIP-Datei im WordPress-Backend installieren.
2. Das Plugin aktivieren.
3. Unter **APlug Wartung → Wartungsmodus** die Wartungsseite konfigurieren.
4. Auf Testinstallationen unter **Testschutz** Noindex, E-Mail- und Zahlungsregeln prüfen.
5. Für Umgebungsvergleiche den Zugriffsschlüssel der Zielinstallation kopieren und die Gegenstelle unter **Umgebungen** verbinden.
6. Vor einer produktiven Übertragung einen kompatiblen Backup- und Transferadapter registrieren und einen vollständigen Test durchführen.

== Frequently Asked Questions ==

= Erstellt das Plugin selbst eine vollständige Staging-Kopie? =

Nein. Der Prototyp verwaltet Wartungsmodus, Testschutz, sichere Gegenstellenverbindungen, technische Vergleiche, Konfliktpläne, Freigaben und Adapterübergaben. Die tatsächliche Server- oder Hosting-Kopie muss durch einen dafür registrierten Transferadapter oder die Hostingumgebung ausgeführt werden.

= Warum enthält das Plugin keine eigene Backup-Funktion? =

APlug verwendet für jeden Datentyp und zentralen Dienst eine eindeutige Zuständigkeit. Sicherungen gehören zur APlug Backup- und WiederherstellungsZentrale oder zu einem anderen ausdrücklich registrierten Backup-Adapter. Dadurch entstehen keine parallelen und widersprüchlichen Sicherungslogiken.

= Werden Datenbankinhalte an die Gegenstelle übertragen? =

Nicht beim Umgebungsvergleich. Übertragen werden technische Metadaten wie Tabellenname, Schema-Fingerabdruck, Engine, Größe und geschätzte Zeilenzahl. Inhalte, Passwörter und personenbezogene Datensätze werden nicht ausgelesen.

= Kann ich Administratoren vom Wartungsmodus ausnehmen? =

Ja. Berechtigte Benutzer mit `aplug_wsz_bypass_maintenance`, ausgewählte Rollen und konfigurierte IP-/CIDR-Bereiche können die Website weiterhin aufrufen.

= Werden alle Zahlungsplugins automatisch blockiert? =

Nein. Der Prototyp enthält Adapter für WooCommerce und Easy Digital Downloads. Andere Zahlungs- oder Buchungssysteme müssen den Filter `aplug_wsz_payments_enabled` oder einen eigenen dokumentierten Adapter verwenden. Jede Testumgebung muss fachlich geprüft werden.

= Ist die Suchmaschinen-Sperre eine Garantie gegen Indexierung? =

Nein. Das Plugin setzt technische Noindex-, Nofollow- und Noarchive-Hinweise. Bereits indexierte Inhalte, falsch konfigurierte Proxies oder Systeme, die diese Hinweise ignorieren, können dadurch nicht garantiert entfernt werden. Eine Staging-Umgebung sollte zusätzlich durch Authentifizierung oder Netzwerkschutz abgesichert werden.

= Kann das Plugin E-Mails blockieren, ohne Formulare als fehlerhaft erscheinen zu lassen? =

Ja. Im Modus „Blockieren“ wird der Versand kurzgeschlossen und technisch als erfolgreich behandelt. Der Vorgang wird datensparsam protokolliert. Alternativ können E-Mails an ein festes Testpostfach umgeleitet werden.


= Was passiert nach einem Klon oder Domainwechsel? =

Ändert sich die Website-Adresse, sperrt das Plugin gespeicherte Gegenstellenverbindungen vorsorglich. Ein berechtigter Administrator muss Ziele und Schlüssel prüfen und die Verbindungen anschließend ausdrücklich für die neue Adresse freigeben.

= Welche externen Dienste werden verwendet? =

Im Grundplugin keine. Entfernte WordPress-Installationen werden nur nach ausdrücklicher Einrichtung über deren eigene WordPress-REST-API angesprochen. Externe Backup- oder Transferdienste werden nur über getrennte, aktiv registrierte Adapter verwendet.

== Screenshots ==

1. Übersicht mit Wartungs-, Umgebungs- und Sicherheitsstatus.
2. Konfiguration der Wartungsseite und Zugriffsregeln.
3. Verbundene Staging- und Produktionsumgebungen.
4. Umgebungsvergleich mit Konflikten und betroffenen Komponenten.
5. Freigabe eines Übertragungsplans mit Backup-Pflicht.
6. Testumgebungsschutz für E-Mail, Zahlungen, Suchmaschinen und externe HTTP-Anfragen.
7. Technisches Prüf- und Vorgangsprotokoll.

== Changelog ==

= 1.0.0 =

* Erster funktionsfähiger Prototyp.
* Wartungsmodus mit Zeitsteuerung, Vorlagen, HTTP-Status und Zugriffsregeln.
* Staging-Schutz für Suchmaschinen, E-Mail, unterstützte Zahlungswege und externe HTTP-Anfragen.
* Verschlüsselte Gegenstellen-Zugriffsschlüssel.
* Authentifizierte technische Umgebungsmanifeste.
* Plugin-, Theme-, Datei- und Datenbankstrukturvergleich.
* Konfliktberichte und Übertragungspläne.
* Freigabe-, Backup- und Transferadapterablauf.
* APlug-Modulmanifest, REST-Schnittstellen, Ereignisse und Datenschutzwerkzeuge.

== Upgrade Notice ==

= 1.0.0 =

Erste Prototypversion. Vor produktiven Übertragungen müssen Backup- und Transferadapter sowie der vollständige Ablauf in einer separaten Testinstallation geprüft werden.
