Guida · Il plugin
Il form è del pacchetto
Non si spegne, e non chiede un plugin di Payload installato. È acceso di default perché quasi ogni sito ha un contatto, e perché il blocco form non avrebbe niente da citare senza.
Dove siamo
Hai visto il blocco form e la collection che lo alimenta. Alla fine di questo capitolo saprai da dove arrivano e come cambiarle.
Il gesto
Non c’è un gesto per accenderlo: forms e form-submissions arrivano col plugin. Il gesto è cambiarle.
Le regoli passando un override alle opzioni, oppure chiamando direttamente la fabbrica: è la stessa funzione che monta il plugin, quindi ciò che passi tu e ciò che monta lui sono la stessa cosa.
defaultToEmail è il destinatario di riserva, per le mail dichiarate su un form che non ne indica uno proprio.
// src/payload.config.ts
import { uimsPlugin, makeUimsForms } from '@woodylab/uims/plugin'
uimsPlugin({
forms: { admin: { group: 'Contenuti' } },
defaultToEmail: 'segreteria@esempio.it',
})
// per AGGIUNGERE un campo si parte dal default, altrimenti lo sostituisci
makeUimsForms({ fields: [...makeUimsForms().fields, { name: 'note', type: 'text' }] })Cos’è appena successo
Le due collection sono codice del pacchetto, non di una dipendenza. Un form qui è composto come tutto il resto — ogni campo è un blocco, con il suo viewMode e i suoi stili — e una collection che arrivasse da fuori porterebbe con sé i propri campi, da sostituire uno a uno.
C’è anche una ragione più dura: un pacchetto che importa un modulo di terze parti chiede al tuo progetto di averlo installato perché il NOSTRO import si risolva. Se manca, non degrada — non compila, dentro un file che non hai scritto tu.
Non esiste un false: il blocco form cita la collection forms, e spegnerla lascerebbe un riferimento rotto prodotto da un’opzione supportata.
Quando non funziona
Passa fields invece di partire da makeUimsForms().fields. La sovrascrittura è di superficie: sostituisce la chiave, non la fonde. Il form perde content, e da quel momento non ha più campi da comporre.
I campi del form stanno in content, non in fields: è il nome che il motore proietta negli slot, ed è quello in cui la validazione dei campi obbligatori scende a cercare. Sbagliarlo dà un form che rende vuoto, senza un errore.
Avanti
Ultima opzione del plugin, e la più interessante: mettere roba tua dentro l’editor.