AddOn

Maintenance-Mode

Beschreibung

Wartungsmodus / Maintenance-Mode / Wartungsarbeiten

Das AddOn ermöglicht die Sperrung des Frontends für Besucher und/oder des Backends für Redakteure bei Wartungsarbeiten oder in der Entwicklungsphase. Der Zugang zum Frontend kann über festgelegte IPs und per Login in REDAXO freigegeben werden.

Umsetzung

FriendsOfREDAXO

Versionen

4.1.0

Für REDAXO
^5.17.0
Veröffentlicht am
18.03.2026
Require / PHP
>=8.2

Version 4.1.0 – 2026-03-18

  • IP-CIDR-Support: Die IP-Whitelist unterstützt jetzt CIDR-Bereiche (z.B. 192.168.1.0/24, 2001:db8::/32). IPv4 und IPv6 werden vollständig unterstützt. Einzelne IPs und CIDR-Ranges können gemischt, kommagetrennt eingetragen werden.
  • search_it-Integration: Der search_it-Crawler wird automatisch erkannt und darf das Frontend auch während der Wartung crawlen. Der Crawler-Request wird anhand des Parameters search_it_build_index und der Absender-IP (Loopback/Server-IP) identifiziert. Ein manueller IP-Eintrag in der Whitelist ist nicht mehr nötig. @skerbis

Bugfixes

  • Cronjob-Whoops behoben: Der Aufruf von rex_cronjob_manager::registerType() wurde aus dem direkten Boot-Kontext in den PACKAGES_INCLUDED-Extension-Point verschoben. Damit ist garantiert, dass der Cronjob-Manager bereits geladen ist, und es kommt kein Whoops mehr bei bestimmten Ladeszenarien (z.B. Console-Kontext). - Danke @olien

4.0.1

Für REDAXO
^5.17.0
Veröffentlicht am
16.11.2025
Require / PHP
>=8.2

Fix: manchmal wurde der cron manager nicht gefunden

4.0.0

Für REDAXO
^5.17.0
Veröffentlicht am
06.11.2025
Require / PHP
>=8.2

Release Notes - Maintenance AddOn 4.0.0

Was ist beim Update zu beachten?

⚠️ Breaking Change: Die manuelle Domain-Whitelist (allowed_yrewrite_domains) wurde entfernt. Domain-basierte Wartung läuft jetzt ausschließlich über die neue Seite Maintenance > Domains.

Was ist neu?

Zeitgesteuerte Wartung – Der Wartungsmodus kann jetzt automatisch zu bestimmten Zeiten aktiviert und deaktiviert werden (nur über Cronjob).

Silent Mode – Sendet nur HTTP-Status-Code ohne HTML-Inhalt, ideal für Staging-Umgebungen.

Planungs-Seite – Neue Übersichtsseite unter Maintenance > Frontend > Planung für zeitgesteuerte Wartung und Wartungsankündigungen.

Mehrsprachige Sperrseite – Language-Switcher (DE/EN) mit SessionStorage-Unterstützung.

Backend Sperrseite mit LogOut

Im Impersonate mode kann der Admin immer noch als User agieren : Zusätzliche Info wird angezeigt.

Domain-Verwaltung – YRewrite-Domains können jetzt direkt über Maintenance > Domains verwaltet werden (keine manuelle Eingabe mehr nötig).

Erweiterte Console-Kommandos – Wartungsmodus kann jetzt granular über die Konsole gesteuert werden:

php redaxo/bin/console maintenance:mode status
php redaxo/bin/console maintenance:mode frontend on|off
php redaxo/bin/console maintenance:mode backend on|off
php redaxo/bin/console maintenance:mode all on|off
php redaxo/bin/console maintenance:mode domain example.com --lock|--unlock

Was hat sich geändert?

UX-Verbesserungen

  • Einstellungen reorganisiert: Frontend > Planung, Frontend > Erweitert
  • IP-Whitelist vereinfacht: Click-to-Add-Buttons, komma-getrennte Liste
  • Sidebar mit Quick-Links und Bypass-URLs (nur für gesperrte Domains)
  • Toggle-Buttons für Domain-Verwaltung
  • Moderne Card-basierte UI mit Dark Mode Support

Performance & Code-Qualität

  • YRewrite-Check nur einmal pro Request
  • Redundante Checks entfernt
  • PHP CS Fixer, externe Assets, REDAXO-Standards

Nach dem Update:

Cronjob einrichten (nur für zeitgesteuerte Wartung):

  • System > Cronjobs > Neuen Cronjob erstellen
  • Typ: "Geplante Wartung prüfen"
  • Ausführungsart: "Jede Minute" oder "Alle 5 Minuten"
  1. Domain-Einstellungen prüfen (falls YRewrite verwendet):
    • Öffnen Sie Maintenance > Domains
    • Aktivieren/Deaktivieren Sie Domains per Toggle

Die alte Konfiguration wird automatisch migriert.

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/3.4.0...4.0.0

4.0.0-beta2

Für REDAXO
^5.17.0
Veröffentlicht am
30.10.2025
Require / PHP
>=8.2

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/4.0.0-beta1...4.0.0-beta2

4.0.0-beta1

Für REDAXO
^5.17.0
Veröffentlicht am
29.10.2025
Require / PHP
>=8.2

Release Notes - Maintenance AddOn 4.0.0-beta1

Was ist beim Update zu beachten?

⚠️ Breaking Change: Die manuelle Domain-Whitelist (allowed_yrewrite_domains) wurde entfernt. Domain-basierte Wartung läuft jetzt ausschließlich über die neue Seite Maintenance > Domains.

Was ist neu?

Zeitgesteuerte Wartung – Der Wartungsmodus kann jetzt automatisch zu bestimmten Zeiten aktiviert und deaktiviert werden (nur über Cronjob).

Silent Mode – Sendet nur HTTP-Status-Code ohne HTML-Inhalt, ideal für Staging-Umgebungen.

Planungs-Seite – Neue Übersichtsseite unter Maintenance > Frontend > Planung für zeitgesteuerte Wartung und Wartungsankündigungen.

Mehrsprachige Sperrseite – Language-Switcher (DE/EN) mit SessionStorage-Unterstützung.

Domain-Verwaltung – YRewrite-Domains können jetzt direkt über Maintenance > Domains verwaltet werden (keine manuelle Eingabe mehr nötig).

Erweiterte Console-Kommandos – Wartungsmodus kann jetzt granular über die Konsole gesteuert werden:

php redaxo/bin/console maintenance:mode status
php redaxo/bin/console maintenance:mode frontend on|off
php redaxo/bin/console maintenance:mode backend on|off
php redaxo/bin/console maintenance:mode all on|off
php redaxo/bin/console maintenance:mode domain example.com --lock|--unlock

Was hat sich geändert?

UX-Verbesserungen

  • Einstellungen reorganisiert: Frontend > Planung, Frontend > Erweitert
  • IP-Whitelist vereinfacht: Click-to-Add-Buttons, komma-getrennte Liste
  • Sidebar mit Quick-Links und Bypass-URLs (nur für gesperrte Domains)
  • Toggle-Buttons für Domain-Verwaltung
  • Moderne Card-basierte UI mit Dark Mode Support

Performance & Code-Qualität

  • YRewrite-Check nur einmal pro Request
  • Redundante Checks entfernt
  • PHP CS Fixer, externe Assets, REDAXO-Standards

Nach dem Update:

Cronjob einrichten (nur für zeitgesteuerte Wartung):

  • System > Cronjobs > Neuen Cronjob erstellen
  • Typ: "Geplante Wartung prüfen"
  • Ausführungsart: "Jede Minute" oder "Alle 5 Minuten"
  1. Domain-Einstellungen prüfen (falls YRewrite verwendet):
    • Öffnen Sie Maintenance > Domains
    • Aktivieren/Deaktivieren Sie Domains per Toggle

Die alte Konfiguration wird automatisch migriert.

3.4.0

Für REDAXO
^5.17.0
Veröffentlicht am
03.08.2025
Require / PHP
>=8.2

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/3.3.1...3.4.0

3.3.1

Für REDAXO
^5.17.0
Veröffentlicht am
17.04.2025
Require / PHP
>=8.2

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/3.3.0...3.3.1

3.3.0

Für REDAXO
^5.17.0
Veröffentlicht am
18.03.2025
Require / PHP
>=8.2

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/3.2.2...3.3.0

3.2.2

Für REDAXO
^5.17.0
Veröffentlicht am
17.12.2024
Require / PHP
>=8.2

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/3.2.1...3.2.2

3.2.1

Für REDAXO
^5.17.0
Veröffentlicht am
27.08.2024
Require / PHP
>=8.2

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/3.1.0...3.2.1

3.1.0

Für REDAXO
^5.17.0
Veröffentlicht am
01.08.2024
Require / PHP
>=8.2

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/3.0.0...3.1.0

3.0.0

Für REDAXO
^5.17.0
Veröffentlicht am
22.07.2024
Require / PHP
>=8.2

Das Maintenance-Addon wurde von Grund auf neu programmiert, um die zukünftige Weiterentwicklung und Wartung zu vereinfachen.

Neue Funktionen

  • [x] #78 Wartungsfenster-Meldungen definieren und zeitgesteuert Ausgeben inkl. Hilfsfragment
  • [x] Automatisch Secret bei Installation vergeben (bin2hex())
  • [x] Automatisch aktuelle IP bei Installation als Ausnahme hinzufügen
  • [x] Auswahl von YRewrite-Domains, die freigegeben werden können (wenn installiert)
  • [x] Migration der Einstellungen via update.php von maintenance 2.x zu dieser Version
  • [x] Neues Icon (toggle-off / toggle-on) und zusätzliche Ausgabe, ob Frontend und/oder Backend gesperrt sind.

What's Changed

  • [x] Überarbeitung der Klassen-, Methoden- und Variablen-Namen
  • [x] Überarbeitung der rex_config-Schlüssel
  • [x] Überarbeitung der Einstellungsseiten, standardisierter Aufbau mit rex_config_form
  • [x] Überarbeitung der gesamten boot.php Logik (ganz schön ~kompliziert~ historisch gewachsen!)
  • [x] Überarbeitung der Beschriftungen, überall Einsatz von i18n-Methoden
  • [x] Übersetzung der dotlang-Dateien in 10 gängige Sprachen
  • [x] Hilfe / Docs aktualisiert
  • [x] Wiederherstellung der Konformität mit rexstan-Prüfung LVL >= 8

In dieser Version derzeit leider entfernt

  • Automatische Tests e2e. Unterstützung gesucht!

Außerdem zu beachten

  • Mindest-Version REDAXO 5.17 (wegen neuer Icons)

Geplante Funktionen nach dem Release von 3.0.0

  • Erweitertes Fragment für die Ausgabe im Frontend #82

nderungen im Einzelnen (Nur PRs)

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/2.9.2...3.0.0

Danke auch für Tests und Feedback an @olien und @dpf-dd

2.9.2

Für REDAXO
^5.13.0
Veröffentlicht am
01.08.2023
Require / PHP
>=8.0

Small changes and fixes.
Added return types to methods

2.9.1

Für REDAXO
^5.13.0
Veröffentlicht am
31.01.2023
Require / PHP
>=8.0

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/2.9.0...2.9.1

2.9.0

Für REDAXO
^5.7.0
Veröffentlicht am
28.01.2023
Require / PHP
>=8.0

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/2.8.7...2.9.0

2.8.7

Für REDAXO
^5.7.0
Veröffentlicht am
15.01.2023
Require / PHP
>=7.4

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/2.8.6...2.8.7

2.8.6

Für REDAXO
^5.7.0
Veröffentlicht am
12.01.2023
Require / PHP
>=7.4

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/2.8.5...2.8.6

2.8.5

Für REDAXO
^5.7.0
Veröffentlicht am
20.09.2022
Require / PHP
>=7.4
  • CS fixes powered by rexstan level 9 @staabm thx

2.8.4

Für REDAXO
^5.7.0
Veröffentlicht am
20.09.2022
Require / PHP
>=7.4
  • small fix, wrong return type in frontend form

2.8.3

Für REDAXO
^5.7.0
Veröffentlicht am
19.09.2022
Require / PHP
>=7.4

Code fixes for PHP 8.1

2.8.2

Für REDAXO
^5.7.0
Veröffentlicht am
16.08.2022
Require / PHP
>=7.4

fixed: undefined $admin

2.8.1

Für REDAXO
^5.7.0
Veröffentlicht am
11.06.2022
Require / PHP
>=7.4

What's Changed

New Contributors

2.7.7

Für REDAXO
^5.7.0
Veröffentlicht am
03.06.2022
Require / PHP
>=7.4

Fixed: Better
Better domain check via rex_server

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/2.7.6...2.7.7

2.7.6

Für REDAXO
^5.7.0
Veröffentlicht am
13.05.2022
Require / PHP
>=7.4

Prüfung auf $_SERVER['HTTP_HOST'] anstelle von $_SERVER['SERVER_NAME']
Fix: u.U. funktionierte die Sperrung in 2.7.4 nicht.

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/maintenance/compare/2.7.5...2.7.6

2.7.3

Für REDAXO
^5.7.0
Veröffentlicht am
16.03.2022
Require / PHP
>=7.4

Fix: Laden des AddOns während des Setups vermeiden.

2.7.2

Für REDAXO
^5.7.0
Veröffentlicht am
11.03.2022
Require / PHP
>=7.4
  • Das Maintenance Addon steht nun auch im Safe-Mode zur Verfügung und kann dort konfiguriert werden.
  • PHP ab 7.4 ist erforderlich.

2.6.5

Für REDAXO
^5.7.0
Veröffentlicht am
16.02.2022
Require / PHP
>=7.1

fixed wrong return code of maintenance off command @rene-mueller @sysix
https://github.com/FriendsOfREDAXO/maintenance/pull/48

2.6.4

Für REDAXO
^5.7.0
Veröffentlicht am
30.11.2021
Require / PHP
>=7.1

@danspringer small fix in fragment

2.6.3

Für REDAXO
^5.7.0
Veröffentlicht am
28.07.2021
Require / PHP
>=7.1

Fixes: Admin could not get back into backend in impersonate mode when editors were excluded.