Erste Schritte

Öffnen Sie /webadmin und melden Sie sich mit einem aktiven Admin-Konto an.

• super_admin kann auf Bereiche der Installationsebene und der Site-Ebene zugreifen
• site_admin und editor können nur auf die Site-bezogenen Admin-Bereiche ihrer zugewiesenen Sites zugreifen

Wenn Ihre Installation mehr als eine Site verwendet, prüfen Sie zunächst, an welcher Site Sie arbeiten.

• super_admin-Benutzer können Sites im Bereich System verwalten
• site_admin- und editor-Benutzer arbeiten nur innerhalb ihrer zugewiesenen Sites

Bevor Sie eine öffentliche Kontaktseite veröffentlichen, konfigurieren Sie die Site-Identität, die Domain und den Kontakt-Empfänger. Der Kontakt-Empfänger auf Site-Ebene unter Site -> Edit -> Contact ist gegenüber der alleinigen Nutzung von .env zu bevorzugen, da er mit der Site-Konfiguration mitwandert.

Kontaktformular-Benachrichtigungen verwenden den Laravel-Mailversand. Typische .env-Einstellungen sind:

MAIL_* steuert den SMTP-Transport. MAIL_FROM_ADDRESS ist die sichere Absenderadresse und der letzte Empfänger-Fallback. CONTACT_RECIPIENT_EMAIL ist optional; verwenden Sie sie als Fallback auf Umgebungsebene, nicht als Ersatz für den Kontakt-Empfänger der Site, wenn die Site-Einstellung verfügbar ist.

Wenn .env-Maileinstellungen geändert werden, nachdem die Konfiguration zwischengespeichert wurde, führen Sie Folgendes aus:

Die Reihenfolge der Empfängerauflösung ist:

1. Kontaktformular-Block recipient_email
2. Standard-Kontaktempfänger der Site aus Site -> Edit -> Contact
3. .env CONTACT_RECIPIENT_EMAIL
4. sicherer MAIL_FROM_ADDRESS-Fallback

Führen Sie eine geheimnissichere Diagnoseprüfung durch, bevor Sie sich auf Benachrichtigungen verlassen:

Verwenden Sie php artisan contact:mail-diagnose --block=ID, wenn Sie die Fallback-Kette für einen einzelnen Kontaktformular-Block untersuchen müssen.

Öffnen Sie Pages in der Admin-Seitenleiste und erstellen Sie eine Seite.

Neue Seiten beginnen als draft, was bedeutet:

• die Seite ist noch nicht öffentlich
• Editoren können sie weiterhin frei bearbeiten
• die Seite kann zur Prüfung eingereicht werden, sobald sie fertig ist

Verwenden Sie den Seiten-Builder, um Blöcke im Seitenlayout hinzuzufügen oder zu bearbeiten.

Im Wesentlichen können Sie:

• die Seitenstruktur über Layouts und Slots festlegen
• Inhaltsblöcke zur Seite hinzufügen
• Medien anhängen, wo dies unterstützt wird
• die Site-Navigation im Bereich Navigation aufbauen oder bearbeiten

Medien und Navigation werden getrennt vom Seiteneditor verwaltet, arbeiten aber mit dem Seiteninhalt zusammen.

Wenn Sie Gallery verwenden, behandeln Sie sie als Mediensammlungsblock und nicht als Abschnittseinleitungsblock.

• verwenden Sie Content Header plus Plain Text oder Rich Text vor der Gallery, wenn Sie eine Überschrift oder einen erläuternden Text benötigen
• die Gallery rendert keine eigene öffentliche Einleitungsüberschrift und keinen Einleitungsabsatz mehr
• die alten Felder Gallery Title und Description sind keine normalen Gallery-Editorfelder mehr
• Galerie-Elemente werden als kompakte Listenzeilen mit Umsortierung und Bearbeitungssteuerung pro Element verwaltet, statt über das ältere Raster ausgewählter Assets
• Medienauswahl, Reihenfolge und Präsentation der Galerie bleiben über alle Sprachen (Locales) hinweg gemeinsam
• Alt-Text, Bildunterschrift, Overlay-Titel und Overlay-Text pro Element gehören der jeweiligen Sprache (Locale)

Für wiederverwendbare öffentliche Header ist das empfohlene Muster:

• bauen Sie das Menü unter Admin -> Navigation
• erstellen oder bearbeiten Sie einen Header-Shared-Slot für die Site
• fügen Sie Navbar zu diesem Shared Slot hinzu
• fügen Sie darin untergeordnete Blöcke hinzu, etwa Container, Cluster, Navbar Brand, Navbar Navigation und Header Actions
• wählen Sie das Navigationsmenü im untergeordneten Block Navbar Navigation aus, statt Links manuell einzugeben

Navbar rendert nur nav.wb-navbar und seine untergeordneten Blöcke. Es fügt nicht automatisch einen Container, einen Marken-Wrapper, einen Menü-Wrapper oder einen generierten Aktionsbereich hinzu. Wenn eine begrenzte Breite benötigt wird, platzieren Sie einen Container-Block innerhalb der Navbar.

Container ist in erster Linie ein Breiten-Primitiv. Ältere Container rendern standardmäßig weiterhin einen gestapelten Fluss; für die Navbar-Komposition setzen Sie jedoch den Container-Flow auf None, damit nur div.wb-container gerendert wird, und platzieren Sie dann Cluster darin für die horizontale Komposition.

Cluster ist das horizontale oder gruppierte Layout-Primitiv. Verwenden Sie seine Einstellungen, um Width, Justify, Align, Wrap und Gap ohne eigenes CSS zu steuern.

Navbar Brand und Navbar Navigation müssen sich innerhalb des Navbar-Baums befinden, müssen aber keine direkten Kinder von Navbar sein. Ein empfohlenes Muster ist Navbar -> Container (Flow: None) -> Cluster (Width: Full, Justify: Between, Align: Center, Wrap: Nowrap); platzieren Sie dann Navbar Brand plus einen inneren Cluster (Justify: End, Align: Center, Wrap: Nowrap), der Navbar Navigation und Header Actions enthält.

Wenn ein Navbar Navigation-Block sichtbare Einträge hat, rendert das CMS jetzt automatisch einen mobilen Burger-Umschalter. Auf Mobilgeräten werden die Inline-Desktop-Links hinter diesem Umschalter eingeklappt, die Marke bleibt sichtbar, die Header-Aktionen bleiben verfügbar und das geöffnete Menü wird über das bestehende Dropdown-Verhalten der WebBlocks UI unterhalb der Zeile gerendert.

Navbar Brand unterstützt die reine Logo-Nutzung, wenn ein Logobild vorhanden ist. Sichtbarer Titeltext ist in diesem Fall optional, und das Barrierefreiheits-Label fällt auf das konfigurierte Marken-Label oder den aufgelösten Site-Namen zurück.

Position ist die einzige eingebaute Navbar-Einstellung: static, sticky oder fixed. Visuelle Varianten und Navbar-Styling gehören zur Verwendung von WebBlocks-UI-Klassen, nicht zu Navbar-blockspezifischen CMS-Einstellungen.

Im Slot-Editor:

• der Blockauswahldialog öffnet sich standardmäßig auf einem kuratierten Common-Tab, jeder Tab und jedes Suchergebnis bleibt in der Sortierung Name A-Z, die Modal-Kopfzeile zeigt an, wie viele Blocktypen gerade gelistet sind, und lange Ergebnislisten scrollen innerhalb des Modals, ohne die Suchleiste zu verdecken
• der Ziehgriff verwendet eine schlichte Fallback-Griffmarkierung, sodass sortierbare Zeilen auch dann nutzbar bleiben, wenn ein Icon-Font-Eintrag nicht verfügbar ist
• Delete All Blocks erscheint nur, wenn der aktuelle Seiten-Slot oder Shared Slot bereits Blöcke enthält, und das Bestätigungsmodal zeigt an, wie viele Blöcke auf oberster Ebene und wie viele verschachtelte Blöcke entfernt werden

Wenn Sie eine Seite aus einer gefilterten Pages-Liste erreichen, behält der Admin-Bereich diesen Pages-Listenkontext jetzt bei, während Sie sich durch Seitenbearbeitung, Slot-Bearbeitung, Übersetzungsbearbeitung und Speicherabläufe bewegen; die Rückkehr zu Pages führt Sie also zu denselben Filtern und derselben Sortierreihenfolge zurück.

Seiten durchlaufen diese Status:

• draft
• in_review
• published
• archived

Typischer Ablauf:

1. erstellen Sie die Seite als draft
2. bearbeiten Sie die Seite und ihre Blöcke
3. reichen Sie sie zur Prüfung ein
4. veröffentlichen Sie sie nach der Freigabe

Editoren können Inhalte vorbereiten und zur Prüfung einreichen. Das Veröffentlichen erfordert einen site_admin oder super_admin.

Nur Seiten mit dem Status published sind öffentlich.

• Seiten mit dem Status draft, in_review und archived geben auf öffentlichen Routen 404 zurück
• eine veröffentlichte Seite beachtet weiterhin die Sichtbarkeitsregeln auf Blockebene innerhalb der Seite

Öffnen Sie die Seite nach dem Veröffentlichen über ihre öffentliche Route oder verwenden Sie den Vorschau-/Öffnen-Link im Admin-Bereich für diese Seite.

In Multisite-Installationen folgen öffentliche URLs dem aufgelösten Site- und Sprachkontext (Locale).

Verwenden Sie für Kontaktseiten den nativen contact_form-Block. Verwenden Sie kein Trusted HTML, kein rohes <form>-Markup und keine mailto:-Links als normalen Übermittlungsweg. Der CMS-Renderer erzeugt das versteckte Anti-Spam-Prüffeld; Editoren und KI-/Operator-Tools sollten dieses Feld nicht manuell anlegen, und das alte website-Feld ist nicht mehr Teil des öffentlichen Vertrags.

Führen Sie einen Smoke-Test durch, bevor Sie die Seite ankündigen:

1. Zeigen Sie eine Seite mit contact_form in der Vorschau an oder veröffentlichen Sie sie.
2. Senden Sie einen Testnamen, eine E-Mail-Adresse, einen Betreff und eine Nachricht.
3. Öffnen Sie /webadmin/contact-messages.
4. Bestätigen Sie, dass die Nachricht gespeichert wurde.
5. Prüfen Sie den Benachrichtigungsstatus und die sicheren Fehlerdetails, falls die Zustellung fehlgeschlagen ist.

Angenommene echte Übermittlungen werden gespeichert, bevor eine Benachrichtigung versucht wird. Ein Benachrichtigungsfehler bedeutet nicht, dass die Übermittlung des Besuchers fehlgeschlagen ist, und öffentliche Besucher sollten keine Mail-Diagnosen sehen.

• Benutzer und Rollen: docs/users-and-permissions.md
• Kontaktformulare und Nachrichten: docs/contact-forms-and-messages.md
• Workflow und Freigaben: docs/editorial-workflow.md
• Wiederherstellung von Revisionen: docs/revisions.md
• Backups, Updates, Export/Import: docs/operations.md