Creazione di modelli di modulo

[lindsey (Lindsey Fogle)]

Questa guida spiega come utilizzare i modelli di modulo per strutturare i contenuti in Discourse.

Livello utente richiesto: Amministratore

I modelli di modulo ti consentono di creare moduli strutturati con regole di convalida che gli utenti possono compilare quando creano argomenti, in modo da poter garantire che gli utenti forniscano tutte le informazioni che desideri o di cui hai bisogno per supportarli, come per i rapporti di bug, le richieste di funzionalità, ecc.

Nota: Per i modelli che funzionano più come linee guida anziché come un modulo strutturato, considera l’utilizzo dei modelli di argomento.

Abilitazione dei modelli di modulo

Puoi attivare i modelli di modulo in Modifiche imminenti impostando Abilita modelli di modulo su “Tutti”.

Creazione di modelli di modulo

Puoi creare e gestire i modelli di modulo andando su Admin > Aspetto > Modelli di modulo (/admin/customize/form-templates).

Per creare un modello di modulo:

1. Fai clic su Nuovo modello.

2. Aggiorna il campo Nome modello con un nome interno per il tuo modello.

3. Utilizza i pulsanti nella parte superiore della pagina per i vari campi del modulo e aggiorna gli attributi del campo (dettagliati di seguito). Molte delle opzioni sono tipi di campo modulo standard (ad esempio, casella di controllo, risposta breve, menu a discesa, ecc.), ma ci sono alcuni campi specifici:

   • Selettore gruppo di tag: Gli utenti possono selezionare uno o più tag da un gruppo specifico.

   • Risposta Markdown: Gli utenti possono aggiungere contenuti direttamente in una mini-versione del compositore. Questo è l’ideale quando i membri devono inserire direttamente Markdown, come il codice, o necessitano di altre formattazioni supportate dall’editor ricco.

4. Aggiungi eventuali convalide desiderate agli input. Fai clic sul pulsante Convalida per una chiave (mostrata anche di seguito).

5. Fai clic sul pulsante Anteprima per assicurarti che tutto sia corretto.

6. Fai clic su Salva.

Attributi del campo

Attributi comuni per tutti i tipi di campo:

• label: Il nome del campo visibile
• placeholder: Testo di aiuto mostrato nei campi vuoti (input, textarea, dropdown, multi-select)
• description: Contesto o istruzioni aggiuntive visualizzate sotto il campo.

Attributi specifici per il caricamento:

• file_types: Elenco separato da virgole delle estensioni di file consentite (ad esempio, .jpg, .png, .pdf)
• allow_multiple: Booleano che indica se gli utenti possono caricare più file

Attributi per menu a discesa e selezione multipla:

• none_label: Testo mostrato quando non è selezionata alcuna opzione
• choices: Array di opzioni disponibili

Opzioni di convalida

Chiave	Tipo	Descrizione
required	booleano	Richiede che il campo sia completato per inviare il modulo.
minimum	intero	Per i campi di testo, specifica il numero minimo di caratteri consentiti.
maximum	intero	Per i campi di testo, specifica il numero massimo di caratteri consentiti.
pattern	regex; stringa	Per i campi di testo, un’espressione regolare che specifica l’input consentito.
type	stringa	Per i campi di input, è possibile specificare il tipo di input che ci si aspetta (text, email, date, number, url, tel, color

Aggiunta di modelli di modulo a una categoria

Dopo aver creato un modello:

1. Vai alla categoria in cui desideri utilizzare il modello.
2. Fai clic sul pulsante per modificare la categoria.

3. Attiva il pulsante Impostazioni avanzate (se si utilizza il nuovo design semplificato della categoria).
4. Vai alla scheda Modello.
5. Attiva l’interruttore Modello di modulo.
6. Seleziona il modello di modulo nel menu a discesa.
7. Fai clic su Salva categoria.

Quando più modelli sono assegnati a una categoria, gli utenti vedranno un selettore di modelli quando creano argomenti.

Esperienza membro

Creazione di argomenti con modelli di modulo

Quando un membro crea un argomento in una categoria con modelli di modulo, il modulo appare automaticamente nel compositore. Se più modelli sono applicati alla stessa categoria, i membri possono scegliere il modello giusto da un menu a discesa. Se gli utenti tentano di creare un argomento senza popolare accuratamente ogni campo, vedranno un errore di convalida.

Pre-compilazione dei valori del modulo

I campi del modulo possono essere pre-popolati utilizzando parametri URL che corrispondono agli ID dei campi. Ad esempio: /new-topic?software-version=2.4.1&severity=Critical

Questo è utile per collegarsi alla creazione di argomenti con alcuni campi già compilati.