FAQ

Kurze Antworten auf die Fragen, die Redakteure am haeufigsten stellen. Ist deine Frage nicht dabei, schau ins Playbook fuer haeufige Fehler fuer eine Schritt-fuer-Schritt-Diagnose oder ins Glossar, wenn ein Begriff unklar ist.

Login & Session

Q: Warum werde ich mitten in der Sitzung ausgeloggt?

Sitzungen sind an deine IP-Adresse gebunden. Wenn sich dein Netzwerk aendert (VPN an/aus, WLAN-Wechsel, Mobilfunk-Hotspot), sieht das Backend eine andere IP und verwirft die Sitzung. Melde dich neu an.

Sitzungen laufen ausserdem nach 2 Stunden Inaktivitaet ab. Ein geplanter Task raeumt abgelaufene Sitzungen auf. Bleib aktiv oder erwarte eine neue Anmeldung jeden halben Tag.

Q: Ich habe meinen 2FA-Code verloren — wie komme ich rein?

Bei der 2FA-Einrichtung hat das Backend 8 Wiederherstellungs-Codes angezeigt. Jeder Code funktioniert einmal. Oeffne die 2FA-Abfrage, klick auf Mit Recovery-Code anmelden, gib einen der Codes ein und melde dich an.

Wenn keine Wiederherstellungs-Codes mehr vorhanden sind, muss ein Admin-Benutzer deinen 2FA-Status direkt in der Datenbank zuruecksetzen — eine UI-Schaltflaeche dafuer existiert noch nicht. Der Admin setzt in der users-Tabelle die Spalten totp_secret und totp_enabled fuer den betroffenen Benutzer auf NULL/0; bei der naechsten Anmeldung startet die 2FA-Einrichtung neu.

Q: Login schlaegt fehl, obwohl das Passwort stimmt. Warum?

Fail2Ban sperrt deine IP nach 5 Fehlversuchen in 10 Minuten. Warte 15 Minuten und versuch es erneut. Wenn du dir eine IP teilst (NAT, Buero-Router), zaehlen die Fehlversuche anderer mit — erwaege, eure Buero-IP unter Administration → Allgemeine Einstellungen → Sicherheit auf die Erlaubtliste zu setzen.

Seiten & Veroeffentlichen

Q: Meine Aenderung ist auf der Live-Seite nicht sichtbar.

Drei haeufigste Ursachen, in dieser Reihenfolge:

1. Du hast die Aenderung gespeichert, aber nicht veroeffentlicht. Oeffne die Seite im Pagebuilder, klick auf Veröffentlichen, dann auf Jetzt veröffentlichen.
2. Der API-Antwort-Cache liefert noch die alte Seite. Oeffne Administration → Cache und klick auf Cache leeren.
3. Dein Browser cached. Hartes Neuladen mit Ctrl+F5 / Cmd+Shift+R.

Siehe Entwuerfe, Veroeffentlichen, Versionen fuer den kompletten Ablauf.

Q: Ich habe aus Versehen eine Seite geloescht. Kann ich sie wiederherstellen?

Ja — wenn mindestens eine veroeffentlichte Version existiert hat. Oeffne Inhalt → Seiten, nutz den Filter Geloeschte anzeigen, suche die Seite und klick Wiederherstellen. Die Seite kommt im letzten veroeffentlichten Zustand zurueck; Entwuerfe, die seit dem Loeschen entstanden, sind verloren.

Seiten, die nie veroeffentlicht wurden, lassen sich nicht wiederherstellen.

Q: Die Vorschau sieht anders aus als die Live-Seite.

Die Vorschau rendert den Entwurf; die Live-Seite rendert die Veroeffentlichte Version plus zwischengespeicherte Assets. Wenn sie auseinanderdriften selbst nach dem Veroeffentlichen, bau den CSS-Cache unter Administration → Cache → CSS neu kompilieren neu auf — Custom CSS aus dem Pagebuilder wird in den Frontend-Cache gebacken und braucht einen Neubau, um rauszugehen.

Pagebuilder

Q: Wo finde ich den Widget-Auswahldialog?

Oeffne den Pagebuilder, waehl eine leere Zeile (klick auf ihren Rand), dann klick auf die +-Schaltflaeche in der Spalte. Der Widget-Auswahldialog oeffnet sich als Modal. Wenn die Spalte keine +-Schaltflaeche hat, enthaelt sie schon ein Widget — waehl das Widget und nutz seine Werkzeugleiste, um Geschwister hinzuzufuegen.

Q: Spacing-Einstellungen greifen nicht.

Spacing ist pro Breakpoint. Pruef, dass du den richtigen Breakpoint editierst — Desktop, Laptop, Tablet oder Mobile. Der Breakpoint-Umschalter liegt in der Pagebuilder-Kopfleiste. Ein Padding auf Desktop gilt nur ueber 1200px; darunter uebernimmt der Wert des jeweiligen Breakpoints (oder dessen geerbter Wert).

Q: Mein Custom CSS wirkt nicht.

Custom CSS wird in den Frontend-Cache kompiliert. Nach dem Speichern erscheint das CSS sofort in der Pagebuilder-Vorschau, aber noch nicht auf der Live-Seite. Klick auf Administration → Cache → CSS neu kompilieren, um es rauszuschieben.

Pruef ausserdem, dass dein Selektor die Wrapper-Klasse nutzt, die der Pagebuilder erzeugt — .widget_{id} fuer Widgets, .row_{id} fuer Zeilen, .col_{id} fuer Spalten.

E-Commerce

Q: Ein Produkt ist im Shop-Frontend nicht sichtbar.

Arbeite die Liste in dieser Reihenfolge ab:

1. Sichtbarkeit: visible=0 versteckt das Produkt. Setz es auf 1 unter E-Commerce → Produkte → {Produkt} → Sichtbarkeit.
2. Aktiv-Kennzeichen: Archivierte Produkte erscheinen nicht. Setz Aktiv auf Ja.
3. Kategorie-Zuweisung: Ein Produkt ohne Kategorie ist nicht ueber das Menue erreichbar. Weise mindestens eine Kategorie zu.
4. Lagerbestand: Ist die Behandlung bei nicht vorraetig auf Verstecken gesetzt, verschwindet das Produkt bei leerem Lager aus den Listings.
5. Cache: Leer den API-Antwort-Cache unter Verwaltung → Cache.

Q: Bestellbestaetigungs-Mails kommen nicht an.

Pruef in dieser Reihenfolge:

1. Administration → Allgemeine Einstellungen → E-Mail-Server: gueltiger SMTP-Host, Port und Zugangsdaten.
2. Task Manager → Queue: schau nach email.send-Jobs, die im Status pending haengen. Ein haengender Queue-Worker blockiert jede Mail.
3. Log: Log → Filter: E-Mail zeigt Zustellfehler — Authentifizierung fehlgeschlagen, Relay abgelehnt, Rate-Limit.

Sprachen & Uebersetzungen

Q: Eine neue Seite fehlt in Sprache X.

Seiten haben Sprach-Varianten. Wenn du eine Seite auf Deutsch anlegst, wird die englische Variante nicht automatisch erzeugt. Oeffne die Seite in Inhalt → Seiten, wechsel auf den Ziel-Sprach-Tab, fuell Titel und Meta-Beschreibung aus und speichere. Pagebuilder-Inhalte werden ebenfalls pro Sprache uebersetzt — die Widgets werden geklont, aber ihr Text muss uebersetzt werden.

Q: URL-Uebersetzung funktioniert nicht.

Jede Sprache braucht einen url_rewrite-Eintrag. Oeffne Administration → URL-Uebersetzungen, suche den Basis-Slug der Seite und fueg eine Uebersetzung pro Sprache hinzu. Ohne das Rewrite faellt der Sprach-Umschalter auf die Standard-URL zurueck und die Seite wirft in der anderen Sprache einen 404.

Performance

Q: Das Backend ist langsam.

Drei haeufige Ursachen:

1. APCu ist aus: Ohne APCu fallen der API-Antwort-Cache und der Rate-Limiter auf "immer erlaubt" zurueck. Pruef Administration → Task Manager → System-Status; die APCu-Lampe muss gruen sein.
2. Log-Tabelle ist riesig: Die log-Tabelle waechst ungebremst. Leer sie im Log-Modul (aeltere Eintraege als 90 Tage).
3. Browser-Erweiterungen: Werbeblocker und Privacy-Tools injizieren oft Skripte auf jeder Backend-Seite. Versuch ein privates Fenster zur Isolation.

Siehe auch

• Haeufige Fehler — Schritt-fuer-Schritt-Diagnose fuer konkrete Fehler
• Glossar — Begriffs-Referenz
• Task Manager — Status fuer Queue und geplante Tasks
• Cache — API- und CSS-Cache leeren
• Log — System-Log filtern