Betrieb

Systemeinstellungen in der Oberfläche

Erreichbar über das Zahnrad im Kopfbereich → Einstellungen, nur für Administratoren. Sechs Bereiche mit eigener Adresse:

Bereich Inhalt
Allgemein Name der Installation, Logo
Erscheinungsbild eigene tokens.css mit Farben und Schrift
E-Mail Versandweg, Absender, SMTP-Zugang, Test-Mail
Funktionen wem die Formulare gehören, Aufbewahrung, Einsicht in Inhalte
Wartung Datenbank herunterladen, Aufräumen mit Testlauf, geltende Fristen
Systemdaten Fassung und Aktualisierung, Zeitsteuerung (Cron), Betriebswerte, Diagnose, Bericht zum Kopieren

Allgemein

Name der Installation erscheint als Wortmarke (wenn kein Logo hinterlegt ist), im Browser-Titel, in allen System-Mails und als Aussteller in der Authenticator-App. Leer lassen setzt den Ausgangswert aus FORMRELAY_NAME.

Logo erscheint im Kopfbereich und im Kopf der Mails. PNG, JPG, WebP oder SVG, höchstens 2 MB. Empfohlen: durchsichtiger Hintergrund, Höhe etwa 32 Pixel. Ohne Logo steht dort der Name.

Bereits eingerichtete Zwei-Faktor-Anmeldungen behalten den alten Namen in der Authenticator-App. Der Aussteller steckt im QR-Code der Einrichtung, nicht auf dem Server.

Erscheinungsbild

Farben und Schrift der gesamten Installation stecken in einer einzigen Datei, tokens.css. Der Weg: herunterladen — im Editor ändern — hochladen.

  1. Gerüst herunterladen. Ist noch kein eigenes Theme hinterlegt, kommt die mitgelieferte Datei; sonst die derzeit aktive. Sie ist durchgehend kommentiert, es steht also an jeder Variablen, was sie bewirkt.
  2. Ändern. Geändert werden die Werte, nicht die Namen. Ein Variablenname, den es nicht gibt, bleibt wirkungslos — die Seite bleibt heil, die Änderung passiert nur nicht. Es wirkt nur, was in :root, in .dark oder in einem anderen gewöhnlichen Selektor steht. :root gilt im hellen Modus (und im dunklen, sofern .dark nichts anderes sagt), .dark nur im dunklen.
  3. Hochladen. Nur .css. Die Datei wird vollständig übernommen und als <style>-Block in den Kopf jeder Seite gesetzt.

Die zwei Ebenen

Die Datei ist in zwei Abschnitte geteilt. Welchen du anfasst, entscheidet, wie viel sich ändert.

Ebene 1 — Grundpalette (--c-…). Acht Werte, und die ganze Installation sieht anders aus. --c-ink ist die Textfarbe, --c-surface-50 der Seitengrund, --c-border die Linienfarbe, --c-brand der Akzent — je einmal für hell (:root) und dunkel (.dark). Alles, was nichts Eigenes sagt, folgt diesen Werten.

Ebene 2 — Element-Tokens (--e-…). Ein Wert je Element. Auszugsweise:

Element Token
Fließtext --e-body
Überschriften --e-heading (h1/h2), --e-subheading (h3/h4)
Feld-Beschriftungen --e-label, Hilfetexte --e-help
Fließtext-Links --e-link, Unterstrich beim Zeigen --e-link-hover
Kopfleiste --e-nav (Fläche), --e-on-nav (Links und Symbole), --e-nav-line
Menüs --e-menu, --e-on-menu, --e-menu-line
Buttons --e-button (Fläche), --e-on-button (Beschriftung), --e-button-line
Buttons, zweite Stufe --e-button-secondary, --e-on-button-secondary, --e-button-secondary-line
Karten --e-card, --e-card-line
Tabellen --e-table, --e-table-head, --e-table-line
Dialoge und Toasts --e-dialog, --e-toast samt -line
Formularfelder --e-input, --e-on-input, --e-input-line, --e-input-hint
Trennlinien allgemein --e-line
Fußzeile --e-footer, --e-on-footer, --e-footer-line
Zeigen mit der Maus (alle Bedienelemente) --e-hover und --e-on-hover, je Element zusätzlich --e-button-hover, --e-nav-hover, …

Die vollständige Liste steht kommentiert in der Datei. Jeder dieser Werte zeigt per Vorgabe auf Ebene 1 und erbt, solange du ihn nicht anfasst. Überschriften in einer eigenen Farbe bei unverändertem Fließtext sind deshalb eine Zeile:

:root {
    --e-heading: #1d4ed8;
}

Eine Änderung an --c-ink dagegen erfasst Fließtext, Überschriften, Kartenrahmen und Menütexte in einem Zug.

Ein fester Farbwert gilt in beiden Modi. Sobald ein Element-Token auf eine Farbe statt auf die Palette zeigt, ist die Vererbung unterbrochen — auch im dunklen Modus. Soll er dort anders sein, wiederhole ihn im Block .dark. Prüfe in diesem Fall den Kontrast in beiden Modi.

Zurücksetzen („Auf mitgeliefertes Theme zurücksetzen") stellt das mitgelieferte Theme wieder her. Die hochgeladene Datei wird dabei gelöscht — wer sie behalten will, lädt sie vorher herunter.

Wo die Datei liegt: storage/app/private/theme/tokens.css. Das Verzeichnis storage/ ist vom Deployment ausgenommen, eine Aktualisierung überschreibt das Theme also nicht. Ins Backup gehört es trotzdem (siehe Backup).

Wer Farben ändert, ändert Kontraste. Die Statusfarben dieser Anwendung liegen knapp über 4,5:1, in hell und dunkel getrennt. ACCESSIBILITY.md enthält die gemessenen Werte als Ausgangspunkt.

@theme wirkt hier nicht. Wer die Datei resources/css/tokens.css direkt aus dem Quelltext nimmt statt das Gerüst herunterzuladen, findet dort @theme-Blöcke. Ein Browser überliest sie samt Inhalt, ohne Fehlermeldung: Die Farben greifen, Schrift, Radien und Statusfarben nicht. Das heruntergeladene Gerüst hat diese Blöcke bereits umgesetzt. Wird trotzdem eine Datei mit @theme hochgeladen, meldet die Seite die betroffenen Zeilen — und übernimmt die Datei dennoch.

Hinweis auf fremde Server. Enthält die Datei ein @import oder ein url() auf eine fremde Adresse, zeigt die Seite das nach dem Hochladen mit Zeilennummer an. Das Theme ist trotzdem aktiv. Dann geht bei jedem Seitenaufruf die IP-Adresse jedes Besuchers an diesen Server — das gehört in die Datenschutzerklärung, oder die Dateien werden lokal abgelegt.

Schriften werden nicht über die Oberfläche hochgeladen. Die Dateien (.woff2) kommen von Hand nach public/fonts/, der passende @font-face-Block in die eigene tokens.css. Für die Schrift braucht es eine Lizenz.

E-Mail

Ohne Mail-Versand wird keine Einsendung zugestellt, und es lassen sich keine Konten einrichten, keine Passwörter zurücksetzen und keine Adressen ändern. Zwei Wege:

  • SMTP-Server: Server, Port, Verschlüsselung, Benutzername, Passwort. Port 587 für STARTTLS, 465 für SSL.
  • sendmail (lokal auf dem Server): nutzt das Mailsystem des Servers. Ohne korrekte SPF- und DKIM-Einträge landen solche Nachrichten oft im Spam-Ordner.

Das SMTP-Passwort wird verschlüsselt in der Datenbank abgelegt (mit APP_KEY) und nie wieder angezeigt. Ein leeres Passwortfeld bedeutet „unverändert lassen"; zum Entfernen gibt es „Gespeichertes Passwort löschen".

Werte aus der Datenbank haben Vorrang vor der .env. Leere Felder bedeuten: Es gilt der .env-Wert.

„Test-Mail senden" prüft den gespeicherten Zugang, nicht die Eingaben im Formular — also erst speichern, dann testen. Erst die Verbindung, dann eine Test-Mail an die Adresse des angemeldeten Kontos; scheitert etwas, steht die Meldung des Servers im Klartext da. Geht sie durch, gilt der Zugang als geprüft. Jedes Speichern hebt das wieder auf — ein geänderter Zugang ist ungeprüft, und die Systemdaten warnen, bis wieder eine Test-Mail durchging. Auf der Kommandozeile: php artisan formrelay:mail-test.

Hinweise zur Absenderdomain: Die Seite schlägt SPF und DMARC der Absenderdomain nach. Geprüft wird, ob die Einträge da sind, nicht, ob sie deinen Mailserver erlauben; DKIM lässt sich ohne den Selektor des Mailservers nicht prüfen. Hinweise, keine Voraussetzung. Abschaltbar mit FORMRELAY_DNS_CHECKS=false (Konfiguration).

Das Postfach der Absender-Adresse muss jemand ansehen. Stellt der empfangende Server eine Nachricht nicht zu, geht die Fehlermeldung an die unter Absender-Adresse eingetragene Adresse.

Funktionen

Karte Einstellung Auswahl Vorgabe
Wem die Formulare gehören „Alle Konten sehen und verwalten alle Formulare" an / aus an
Aufbewahrung Vorbelegung für neue Formulare sofort, 1, 3, 7, 14, 30 Tage 7 Tage
Aufbewahrung Höchstdauer dieselbe Liste 30 Tage
Aufbewahrung Unzustellbare Einsendungen löschen nach 7, 14, 30 Tage 30 Tage
Einsicht in Inhalte „Einsicht in Inhalte zulassen" an / aus an
  • Besitz: Ohne Häkchen sieht jedes Konto nur seine eigenen Formulare. Wer umschaltet, bekommt alle Formulare ohne Anleger. Die Endpunkte ändern sich nicht. Wie Formulare gelöschter Konten verteilt werden: Formular-Aufsicht.
  • Vorbelegung darf nicht länger sein als die Höchstdauer.
  • Eine gesenkte Höchstdauer gilt sofort auch für bestehende Formulare und für Einsendungen, die schon gespeichert sind.
  • Die Frist für Unzustellbares gilt auch für gescheiterte Aufträge der Warteschlange.
  • Einsicht: Mit Häkchen kann jedes Formular für sich Einsicht zulassen (dort Vorgabe: aus). Ohne Häkchen sieht niemand Inhalte, auch kein Administrator; die Werte an den Formularen bleiben gespeichert. Siehe Einsendungen.

Wartung

  • Datenbank herunterladen — eine Sicherung der Datenbank als Datei. Was sie enthält und was nicht: Backup.
  • Aufräumen — „Testlauf" zeigt, was entfernt würde; „Jetzt aufräumen" führt es aus und zeigt den Bericht. Kategorien: Wartung.
  • Geltende Fristen — woran sich der Aufräumlauf hält, mit den Werten, die tatsächlich wirken. Die Karte ist eine Anzeige; geändert werden die Fristen unter Funktionen.

Systemdaten

Ganz oben steht, was Handeln erfordert. Es sind genau diese Punkte:

  • APP_ENV steht auf local — dann ist unter anderem die Sperre gegen datenbankleerende Befehle (migrate:fresh, db:wipe) abgeschaltet.
  • APP_DEBUG=true — zeigt bei Fehlern interne Pfade und Konfigurationswerte.
  • APP_URL fehlt oder hat kein Schema — Links in Mails bekommen dann die Domain, über die gerade zugegriffen wird (siehe Konfiguration).
  • Ein Cron-Eintrag fehlt oder ist überfällig — beim Aufräumen nach 48 Stunden ohne Lauf, bei der Warteschlange nach einer Stunde. Ist die Installation jünger als dieser Abstand, gilt ein noch ausstehender erster Lauf nicht als fehlend.

Dieselbe Liste steht für Administratoren unter der Kopfzeile auf jeder Seite. Sie lässt sich nicht schließen und verschwindet von selbst, sobald der Punkt behoben ist. Nutzer ohne Administratorrolle sehen sie nie.

Fassung und Aktualisierung

Die Karte Fassung nennt die installierte Fassung und, sofern die Prüfung eingeschaltet ist, ob es eine neuere gibt. Die installierte Fassung steht in der Datei VERSION im Projektverzeichnis. Paket und Deployment schreiben sie; wer aus dem Quellcode installiert hat, sieht „unbekannt".

„Auf neue Fassungen hinweisen" ist ein Schalter auf dieser Seite. FORMRELAY_UPDATE_CHECK in der .env ist nur der Ausgangswert — er gilt, solange hier niemand etwas entschieden hat; danach gilt die Entscheidung auf der Seite, in beide Richtungen. Woher die Release-Liste kommt, steht nur in der .env (FORMRELAY_UPDATE_SOURCE, wirksam nach php artisan config:cache).

Die Prüfung fragt einmal täglich beim Öffnen der Systemdaten nach. Nach außen geht dabei eine GET-Anfrage — IP-Adresse und Zeitpunkt, keine Kennung dieser Installation, keine Nutzungsdaten. Aktualisiert wird dadurch nichts.

Gibt es eine neuere Fassung, erscheint „Paket bereitstellen". Der Knopf lädt das Release-Archiv, hält es gegen die veröffentlichte SHA256-Prüfsumme und entpackt es nach storage/app/private/updates/. Eingespielt wird dabei nichts. Danach zeigt die Seite den Befehl, der noch fehlt — mit dem Pfad dieser Installation schon eingesetzt:

sh storage/app/private/updates/<fassung>/update.sh /pfad/zu/dieser/installation

Mit --dry-run angehängt zeigt er vorher, was sich ändern würde. Was update.sh im Einzelnen tut und welche Wege es außerdem gibt: Aktualisieren. „Bereitgestelltes Paket entfernen" löscht ein bereitgestelltes Paket wieder; eingespielte Pakete räumt formrelay:cleanup ab.

Zeitsteuerung (Cron)

Beide Cron-Zeilen mit dem Pfad dieser Installation, je ein Knopf zum Kopieren, und wann jeder Befehl zuletzt gelaufen ist. Einzelheiten: Cron einrichten.

Betriebswerte, Diagnose, Bericht

Darunter: Webserver, PHP, Laravel, Datenbank, Betriebsart, Zeitzone, Anzahl der Konten, freier Platz auf der Festplatte, Arbeitsspeicher, PHP-Grenzen sowie Queue, Cache, Sitzungen und Mail-Versand.

Ausführliche Diagnose zeigt auf einen weiteren Klick PHP-Erweiterungen, Verzeichnisse samt Schreibrecht und weitere Einzelwerte. „Bericht kopieren" liefert alles als Klartext. Der Bericht enthält keine Zugangsdaten und keine Schlüssel, auch nicht gekürzt.

Quelle dieser Seite: docs/betrieb/einstellungen.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.