Il TemplateData è un codice che va implementato nei template che vengono utilizzati nelle voci, per permettere al nuovo editor VisualEditor di capire quali sono i parametri di quel template e di proporre all'utente un'interfaccia grafica semplice e funzionale per l'inserimento dei template. Non bisogna inventarsi o imparare niente di particolare: è solo una trasposizione diversa di dati già a nostra disposizione, contenuti nei manuali dei template. Peraltro più in basso sono elencati diversi strumenti che fanno la maggior parte del lavoro al posto nostro!

Gli screenshot qui a destra mostrano due template, con e senza TemplateData, mentre vengono inseriti in una voce con VisualEditor.

Si noterà come il secondo sia praticamente autoesplicativo e pertanto è molto più semplice da editare rispetto al primo. La differenza consiste in "TemplateData", una modalità di immagazzinamento di informazioni relative ai template - ad esempio i nomi dei parametri o una descrizione - tale da permettere a VisualEditor di recuperare queste ultime.

Una delle cose per cui è più urgente l'intervento dei volontari in questo momento è proprio l'aggiunta di TemplateData ai template, soprattutto a quelli più in evidenza come i template sinottici, perché questo li renderà non solo più semplici da editare, quando sono già presenti in una pagina, ma anche intuitivi da aggiungere la prima volta, perché suggeriranno i vari parametri disponibili e questi potranno essere aggiunti con un click!

A tutti noi vengono subito in mente template vitali per il progetto, potete controllare se non sono ancora ottimizzati con TemplateData. C'è anche una lista dei template più usati, che i volenterosi possono iniziare a spuntare man mano che ne adeguano uno perché dia il meglio di sé con e grazie a VisualEditor.

TemplateData è controllato dall'omonima estensione Mediawiki, già attiva su it.wiki. Quando al template è aggiunto TemplateData, il template funzionerà egregiamente con VisualEditor.

Si noti che VisualEditor supporta i template anche senza TemplateData; per compilarli però è necessario sapere cosa ci andrebbe dentro e quindi conoscere i parametri a memoria, non dimenticarsi di quelli obbligatori, quanto meno avere il manuale davanti che li spieghi, in pratica lo stesso livello di difficoltà che un utente alle prime armi avrebbe adesso.

Il TemplateData va inserito in un'apposita sottopagina del template chiamata , come per esempio Template:Azienda/TemplateData.

La sottopagina va richiamata nella pagina base del template inserendo il template {{TemplateData}} nella parte compresa tra <noinclude>…</noinclude>, alla riga dopo {{man}}.

All'inizio della sottopagina va invece inserita la stringa <noinclude>{{TemplateData sottopagina}}</noinclude>, che ha anche il compito di includerla nella Categoria:TemplateData.

In caso la pagina base del template sia protetta, la sottopagina "/TemplateData" : sarà infatti possibile richiamarla apponendo temporaneamente la stringa <includeonly>{{TemplateData}}</includeonly> nella sottopagina del manuale, prima di <noinclude>…</noinclude>.

Se il template e il relativo TemplateData sono pesanti, il caricamento in VisualEditor risulterà lento. Per questo si consiglia di scrivere TemplateData in una sottopagina a parte. Se il TemplateData è stato richiamato dal manuale (perché il template è protetto e non si hanno i permessi per modificarlo) si consiglia di indicarlo nella pagina di discussione del template, così che un amministratore provveda a spostare il template {{TemplateData}}.

Potrebbe volerci del tempo (anche molte ore) prima che il template risulti effettivamente aggiornato e quindi correttamente visibile e utilizzabile con VisualEditor. Per forzarne l'aggiornamento si può effettuare un null edit sul template stesso.

La struttura di TemplateData è basata sullo standard "JSON" ed è abbastanza semplice. La prima cosa da fare è inserire un paio di tag <templatedata> in questo modo:

<templatedata>
Qui ci vanno le info di TemplateData
</templatedata>

Questo dice al software che tutto quello che si trova tra i due tag è TemplateData e che deve farvi riferimento quando il template è usato. TemplateData segue un layout standard; solo a titolo di esempio, prendiamo il template:Commons, che si usava una volta per linkare alla pagina (o alla categoria) di Commons relativa a una voce. Ha un unico parametro che è, comprensibilmente, il titolo della pagina di Commons che ci interessa linkare. In questo caso il TemplateData relativo sarebbe:

<templatedata>
{
"description":"Un template per linkare la pagina di Commons relativa a una voce",
"params":{
"1":{
"label":"Titolo della pagina",
"description":"La pagina di Commons che si vuole linkare",
"type":"string",
"required":true
}
}
}
</templatedata>

Nel template tutto ciò verrebbe visualizzato per mezzo di una tabella preceduta dalla descrizione, come di seguito:

Parametri template

Parametro		Descrizione	Tipo	Stato
Titolo della pagina	1	La pagina di Commons che si vuole linkare	Stringa	obbligatorio

Passiamo alla spiegazione del codice. Le virgolette, i due punti, le virgole e le parentesi graffe sono elementi importanti del codice di TemplateData e sono da non modificare. Se si vogliono inserire le virgolette nella descrizione del template (o di un parametro) è necessario scrivere ogni virgoletta preceduta da una barra rovesciata, esempio \"testo\".

• "description" (descrizione): dopo i due punti, tra le virgolette, si può inserire una breve descrizione del template.
• "params" (parametri): indica che le sezioni che seguono sono relative a ciascun parametro del template da non modificare.

• In ogni sottosezione, il primo tag è quello del nome effettivo del parametro del template "per come è richiamato nel template": se il parametro si chiama titolo=, il tag sarà "titolo" (se si chiama anno=, il tag sarà "anno", ecc.). Nei casi in cui i parametri del template non hanno un nome ma sono riconosciuti per la loro posizione nel template (vedi per esempio Template:Santiebeati), si devono indicare i numeri ("1", "2", ecc.) come nell'esempio del paragrafo precedente (dove l'unico parametro di template:Commons è "1"). In caso non ci siano parametri vedi più avanti.

• "label" (etichetta): va inserito un titolo idoneo per il parametro che sarà visualizzato dentro l'editor di template di VE per aiutare chi lo modificherà a capire cosa contiene.
• "description" (descrizione): descrizione del parametro specifico, non di tutto il template. Se necessario è possibile inserire un breve esempio.
• "type" (tipo): specificare il modo in cui l'editor di template di VE interpreterà quel parametro; le possibilità sono:

• "string" (testo) una sequenza di caratteri, proprio come questa;
• "number" (numero) serie di cifre;
• "string/wiki-user-name" (testo/nome utente wiki) serie di caratteri che rappresenta il nome di un utente;
• "string/wiki-page-name" (stringa/nome voce wiki) serie di caratteri che rappresenta il titolo di una pagina;
• "wiki-file-name" per indicare il nome di un file;
• "date" (data) secondo lo standard ISO 8601 cioè anno-mese-giorno (esempio oggi è: 2026-04-05).

• "required" (richiesto): può essere true, se la presenza di quel parametro è obbligatoria in quel template, o false nel caso contrario (false è il valore di default).

Alla fine di ogni parametro (tranne l'ultimo) si prega di mettere una virgola dopo le virgolette, come mostrato negli esempi e come indicato nel paragrafo più avanti.

"params":{
"categoria":{
...
"aliases":["1","link"]
}

"params":{
"topic1":{
"label":"Topic",
"description":"A topic mentioned on this disambiguation page",
"type":"string"
},
"topic2":{
"inherits":"topic1"
},
"topic3":{
"inherits":"topic1"
}
}

"params":{
"logo_dimensione":{
...
"default":"200"
}

"params":{
"data":{
...
"autovalue":"{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}"
}

<templatedata>{
"description":"Indica un'orologio seguito dal testo \"in corso\"",
"params":{}
}</templatedata>

"params":{
"1":{
...
},<--notatelavirgolaqui
"2":{
...
},<--equi
"3":{
...
}<--questoèilparametrofinale,quindinonhalavirgola

}

Una volta finito di scrivere il codice bisogna premere "Salva". In caso di errori non sarà possibile salvare! Per trovare l'errore nel codice si può usare il codice JSON oppure scrivere sulla pagina dei feedback su VisualEditor per chiedere aiuto.

Questo è un modello vuoto, contenente solo i parametri più utilizzati, per aggiungere TemplateData "fatti a mano" ancora più facilmente!

<templatedata>
{
"description":"",
"params":{
"1":{
"label":"",
"description":"",
"type":"",
"required":
},
"2":{
"label":"",
"description":"",
"type":"",
"required":
}
},
"paramOrder":[
"1",
"2"
],
"format":""
}
</templatedata>

👁 Image

È disponibile un editor visuale di TemplateData direttamente nella pagina di modifica di Wikipedia. Vi si accede tramite il pulsante "Gestisci TemplateData" dopo aver cliccato su Modifica sorgente nella sottopagina che contiene o dovrà contenere i TemplateData, solitamente la sottopagina Template:NOMETEMPLATE/TemplateData.

L'editor si presenta come una finestra dove sono presenti i parametri (se ve ne sono già) disposti su più linee, ognuna composta da sette caselle che permettono di impostare i relativi attributi di ogni parametro. Nell'esempio a destra è mostrato l'editor dei TemplateData del template {{Commons}} che corrisponde alla struttura:

<templatedata>
{
"description":"Un template per linkare la pagina di Commons relativa a una voce",
"params":{
"1":{
"label":"Titolo della pagina",
"description":"La pagina di Commons che si vuole linkare",
"type":"string",
"required":true
}
}
}
</templatedata>

Dall'interfaccia visuale è possibile modificare i parametri già presenti seguendo le istruzioni indicate nella sezione Codice, cancellarli (pulsante "Cancella parametro") o aggiungerne dei nuovi (pulsante "Aggiungi parametro"). Le modifiche saranno definitivamente memorizzate alla selezione del pulsante "Applica" in basso a destra della finestra dell'editor.

Nel caso di un TemplateData particolarmente lungo può essere difficile scovare un errore e quindi capire perché non riusciamo a salvare la pagina. In questo caso può essere utile avere dei tool per validare il codice. Sono disponibili agli indirizzi JSONLint e JSON Formatter .

Sentitevi liberi di intervenire come volete su questa sezione per organizzare più agevolmente il lavoro. Questi non sono tutti i template di it.wiki, ma i primi 1000: di questi, i primi 300 sono usati ognuno in almeno diecimila pagine. Ovviamente, concentriamoci su quelli che funzionano soprattutto nel namespace delle voci e in quello Utente! Per valutare da dove iniziare, ci si potrebbe porre queste domande:

• Quali template ci sono nelle voci che io stesso scrivo/modifico più spesso?
• Quali sono i template che uso di più o che incontro più di frequente?
• Quali sono quelli che vorrei che un utente inesperto riuscisse facilmente a inserire/modificare?

Questo dovrebbe aiutarci a restringere inizialmente il campo. Inoltre, si possono momentaneamente saltare i template di navigazione. I link rossi possono essere ignorati. Grazie a Oliver (WMF) per aver generato questo elenco.

• Coordinamento lavori presso il progetto Template
• mw:Help:TemplateData/it
• (EN) mw:Help:TemplateData/en