Per iniziare

Aprite /webadmin ed effettuate l'accesso con un account amministratore attivo.

• super_admin può accedere alle aree a livello di installazione e a livello di sito
• site_admin ed editor possono accedere solo alle aree di amministrazione limitate ai siti loro assegnati

Se la vostra installazione utilizza più di un sito, iniziate confermando su quale sito state lavorando.

• Gli utenti super_admin possono gestire i siti nella sezione System
• Gli utenti site_admin ed editor lavorano solo all'interno dei siti loro assegnati

Prima di pubblicare una pagina di contatto pubblica, configurate l'identità del sito, il dominio e il destinatario Contact. Il destinatario Contact a livello di sito in Site -> Edit -> Contact è preferibile all'affidarsi solo a .env, perché viaggia insieme alla configurazione del sito.

Le notifiche del Contact Form utilizzano la consegna email di Laravel. Le impostazioni .env tipiche sono:

MAIL_* controlla il trasporto SMTP. MAIL_FROM_ADDRESS è l'indirizzo mittente sicuro e il destinatario di riserva finale. CONTACT_RECIPIENT_EMAIL è facoltativo: utilizzatelo come riserva a livello di ambiente, non come sostituto del destinatario Contact del sito quando l'impostazione del sito è disponibile.

Se le impostazioni email di .env vengono modificate dopo che la configurazione è stata memorizzata nella cache, eseguite:

L'ordine di risoluzione del destinatario è:

1. recipient_email del blocco Contact Form
2. Destinatario di contatto predefinito del sito da Site -> Edit -> Contact
3. CONTACT_RECIPIENT_EMAIL in .env
4. Riserva sicura MAIL_FROM_ADDRESS

Eseguite un controllo diagnostico sicuro per i segreti prima di affidarvi alle notifiche:

Utilizzate php artisan contact:mail-diagnose --block=ID quando dovete ispezionare la catena di riserva di un singolo blocco Contact Form.

Aprite Pages nella barra laterale di amministrazione e create una pagina.

Le nuove pagine iniziano come draft, il che significa che:

• la pagina non è ancora pubblica
• gli editor possono continuare a modificarla liberamente
• la pagina può essere inviata in revisione quando è pronta

Utilizzate il page builder per aggiungere o modificare i blocchi nel layout della pagina.

A grandi linee, potete:

• scegliere la struttura della pagina tramite layout e slot
• aggiungere blocchi di contenuto alla pagina
• allegare media dove supportato
• costruire o modificare la navigazione del sito dall'area Navigation

I media e la navigazione sono gestiti separatamente dall'editor di pagina, ma funzionano insieme al contenuto della pagina.

Quando utilizzate Gallery, trattatelo come un blocco di raccolta media e non come un blocco di introduzione di sezione.

• utilizzate Content Header più Plain Text o Rich Text prima di Gallery quando vi serve un titolo o un testo esplicativo
• Gallery non genera più un proprio titolo o paragrafo introduttivo pubblico
• i vecchi campi Gallery Title e Description non sono più normali campi dell'editor di Gallery
• gli elementi della galleria sono gestiti come righe di elenco compatte con controlli di riordino e di modifica per singolo elemento, invece della precedente griglia di risorse selezionate
• la selezione dei media, l'ordinamento e la presentazione della galleria restano condivisi tra le lingue (locale)
• testo alternativo, didascalia, titolo e testo dell'overlay di ciascun elemento appartengono alla singola lingua (locale)

Per intestazioni pubbliche riutilizzabili, il modello consigliato è:

• costruite il menu in Admin -> Navigation
• create o modificate uno Shared Slot Header per il sito
• aggiungete Navbar a quello Shared Slot
• aggiungete blocchi figli al suo interno, come Container, Cluster, Navbar Brand, Navbar Navigation e Header Actions
• scegliete il menu di navigazione sul blocco figlio Navbar Navigation invece di inserire i link manualmente

Navbar genera solo nav.wb-navbar e i suoi blocchi figli. Non aggiunge automaticamente un Container, un wrapper del marchio, un wrapper del menu o un'area di azioni generata. Quando serve una larghezza vincolata, inserite un blocco Container all'interno del Navbar.

Container è principalmente una primitiva di larghezza. I container legacy continuano a generare un flusso impilato per impostazione predefinita, ma per la composizione della navbar impostate Flow di Container su None in modo che generi solo div.wb-container, quindi inserite Cluster al suo interno per la composizione orizzontale.

Cluster è la primitiva di layout orizzontale o raggruppato. Utilizzate le sue impostazioni per controllare Width, Justify, Align, Wrap e Gap senza CSS personalizzato.

Navbar Brand e Navbar Navigation devono trovarsi all'interno dell'albero della Navbar, ma non devono necessariamente essere figli diretti di Navbar. Un modello consigliato è Navbar -> Container (Flow: None) -> Cluster (Width: Full, Justify: Between, Align: Center, Wrap: Nowrap), quindi inserite Navbar Brand più un Cluster (Justify: End, Align: Center, Wrap: Nowrap) interno che contenga Navbar Navigation e Header Actions.

Quando un blocco Navbar Navigation ha elementi visibili, il CMS genera ora automaticamente un pulsante hamburger per dispositivi mobili. Su mobile i link desktop in linea si richiudono dietro quel pulsante, il marchio resta visibile, le azioni dell'intestazione restano disponibili e il menu aperto viene generato sotto la riga tramite il comportamento dropdown esistente di WebBlocks UI.

Navbar Brand supporta l'uso con solo logo quando è presente un'immagine del logo. In quel caso il testo del titolo visibile è facoltativo e l'etichetta accessibile ricade sull'etichetta del marchio configurata o sul nome del sito risolto.

Position è l'unica impostazione integrata della Navbar: static, sticky o fixed. Le varianti visive e lo stile della navbar appartengono all'uso delle classi di WebBlocks UI, non a impostazioni CMS specifiche del blocco Navbar.

Nell'editor degli slot:

• il selettore dei blocchi si apre per impostazione predefinita su una scheda Common curata, ogni scheda o risultato di ricerca resta nell'ordine Name A-Z, l'intestazione della finestra modale mostra quanti tipi di blocco sono attualmente elencati e gli elenchi di risultati lunghi scorrono all'interno della finestra modale senza nascondere la barra degli strumenti di ricerca
• la maniglia di trascinamento utilizza un semplice indicatore di presa di riserva, così le righe ordinabili restano utilizzabili anche se una voce del font delle icone non è disponibile
• Delete All Blocks compare solo quando lo slot di pagina o lo Shared Slot corrente contiene già dei blocchi, e la finestra modale di conferma mostra quanti blocchi di primo livello e annidati verranno rimossi

Quando raggiungete una pagina da un elenco Pages filtrato, l'amministrazione mantiene ora quel contesto dell'elenco Pages mentre passate attraverso Edit Page, la modifica degli slot, la modifica delle traduzioni e i flussi di salvataggio, così tornando a Pages ritrovate gli stessi filtri e lo stesso ordinamento.

Le pagine attraversano questi stati:

• draft
• in_review
• published
• archived

Flusso tipico:

1. create la pagina in draft
2. modificate la pagina e i suoi blocchi
3. inviatela in revisione
4. pubblicatela una volta approvata

Gli editor possono preparare i contenuti e inviarli in revisione. La pubblicazione richiede un site_admin o un super_admin.

Solo le pagine published sono pubbliche.

• le pagine draft, in_review e archived restituiscono 404 sulle rotte pubbliche
• una pagina pubblicata rispetta comunque le regole di visibilità a livello di blocco al suo interno

Dopo la pubblicazione, aprite la pagina tramite la sua rotta pubblica oppure utilizzate il link di anteprima/apertura dell'amministrazione per quella pagina.

Nelle installazioni multisito, gli URL pubblici seguono il contesto di sito e di lingua (locale) risolto.

Utilizzate il blocco nativo contact_form per le pagine di contatto. Non utilizzate Trusted HTML, markup <form> grezzo o link mailto: come normale percorso di invio. Il renderer del CMS crea il campo nascosto di controllo antispam; gli editor e gli strumenti IA/operatore non devono creare quel campo manualmente, e il vecchio campo website non è più il contratto pubblico.

Prova di funzionamento prima di annunciare la pagina:

1. Visualizzate in anteprima o pubblicate una pagina con contact_form.
2. Inviate un nome, un'email, un oggetto e un messaggio di prova.
3. Aprite /webadmin/contact-messages.
4. Verificate che il messaggio sia stato memorizzato.
5. Controllate lo stato della notifica e i dettagli sicuri dell'errore se la consegna non è riuscita.

Gli invii reali accettati vengono memorizzati prima che venga tentata la notifica. Un errore di notifica non significa che l'invio del visitatore sia fallito, e i visitatori pubblici non devono vedere le diagnostiche email.

• Utenti e ruoli: docs/users-and-permissions.md
• Moduli di contatto e messaggi: docs/contact-forms-and-messages.md
• Flusso di lavoro e approvazioni: docs/editorial-workflow.md
• Recupero delle revisioni: docs/revisions.md
• Backup, aggiornamenti, esportazione/importazione: docs/operations.md