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 durante la creazione di argomenti, in modo da garantire che gli utenti forniscano tutte le informazioni che desideri o di cui hai bisogno per supportarli, ad esempio per segnalazioni di bug, 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

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

Creazione di modelli di modulo

È possibile creare e gestire i modelli di modulo accedendo a Admin > Aspetto > Modelli di modulo (/admin/customize/form-templates).

Per creare un modello di modulo:

1. Fare clic su Nuovo modello.

2. Aggiornare il campo Nome modello con un nome interno per il modello.

3. Utilizzare i pulsanti nella parte superiore della pagina per aggiungere i vari campi al modulo e aggiornare gli attributi del campo (illustrati 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 tag: Gli utenti possono selezionare uno o più tag da un gruppo specifico.

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

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

5. Fare clic sul pulsante Anteprima per assicurarsi che tutto appaia corretto.

6. Fare clic su Salva.

Attributi dei campi

Attributi comuni per tutti i tipi di campo:

• label: Il nome del campo visibile
• placeholder: Testo di aiuto mostrato nei campi vuoti (input, area di testo, menu a discesa, selezione multipla)
• description: Contesto aggiuntivo o istruzioni 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

Attributi del selettore del gruppo tag:

• tag_group: (proprietà di primo livello del campo) Il nome del gruppo di tag da cui popolare le scelte
• none_label: Testo mostrato quando non è selezionata alcuna opzione
• multiple: Booleano che indica se gli utenti possono selezionare più tag (lo scaffold predefinito lo imposta su true)

Opzioni di convalida

Chiave	Tipo	Descrizione
required	boolean	Richiede che il campo sia compilato per inviare il modulo.
minimum	integer	Per i campi di testo, specifica il numero minimo di caratteri consentiti.
maximum	integer	Per i campi di testo, specifica il numero massimo di caratteri consentiti.
pattern	regex; string	Per i campi di testo, un’espressione regolare che specifica l’input consentito.
type	string	Per i campi di input, è possibile specificare il tipo di input previsto (text, email, date, number, url, tel, color, password)

Aggiunta di modelli di modulo a una categoria

Dopo aver creato un modello:

1. Navigare alla categoria in cui si desidera utilizzare il modello.
2. Fare clic sul pulsante per modificare la categoria.

3. Attivare il pulsante Impostazioni avanzate (se si utilizza il nuovo setup semplificato della categoria).
4. Andare alla scheda Modello.
5. Attivare l’interruttore Modello di modulo.
6. Selezionare il modello di modulo nel menu a discesa.
7. Fare clic su Salva categoria.

Quando più modelli sono assegnati a una categoria, gli utenti vedranno un selettore di modelli durante la creazione di argomenti.

Esperienza utente

Creazione di argomenti con modelli di modulo

Quando un utente crea un argomento in una categoria con modelli di modulo, il modulo appare automaticamente nel compositore. Se più modelli sono applicati alla stessa categoria, gli utenti possono scegliere il modello corretto da un menu a discesa. Se gli utenti tentano di creare un argomento senza compilare correttamente 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.

[Eingang]

Che aspetto hanno i pattern regex e quale flavor di regex è previsto? Ho provato i seguenti e tutti sono stati superati, ma non me lo aspettavo:

• 2[6-9][0-1][0-9][0-3][0-9] con un inserimento di 180918;
• /2[6-9][0-1][0-9][0-3][0-9]/ con un inserimento di 180918;
• /2[6-9][0-1][0-9][0-3][0-9]/ con un inserimento di 12;