Utente:RaminusFalcon/InvitoParametri
Istruzioni per l'usoLe istruzioni che seguono sono contenute nella sottopagina Utente:RaminusFalcon/InvitoParametri/man (modifica · cronologia)
Sandbox: Utente:RaminusFalcon/InvitoParametri/Sandbox (modifica · cronologia) · Tutte le sottopagine: lista
Il template InvitoParametri serve ad apporre in un template di avviso un invito a correggere la sintassi, se mancano degli argomenti ritenuti necessari.
Questo template permette un invito relativo al massimo a 5 parametri.
Sintassi
{{InvitoParametri|nome_template|parametro1|valore1|parametro2|valore2|…|parametro5|valore5|fisso1=x|fisso2=x|…|fisso5=x|arg=x|dat=x|cat=categoria_collegata|notrattino=x}}
Parametri
- nome_template (obbligatorio): nome del template in cui usiamo "InvitoParametri"
- parametroN: nome dell'N-esimo parametro del nostro template
- valoreN: nome dell'N-esimo valore (atteso dall'utente) corrispondente al parametro N del nostro template
- fissoN (facoltativo): se l'N-esimo parametro va dichiarato esplicitamente (es. data=giugno 2008), si aggiunga al termine dei parametri "fissoN=x" (ma per "x" si può scrivere qualsiasi valore diverso da uno spazio)
- arg (facoltativo): da usare se il template effettua categorizzazione per argomento (verrà effettuato un controllo maiuscole/minuscole, con eventuale avviso di errore, e un controllo di esistenza, con eventuale avviso)
- dat (facoltativo): da usare se il template effettua categorizzazione per data (ma per il momento non ha nessun avviso correlato)
- notrattino (facoltativo): da usare insieme con "arg" e "cat" quando la categoria non usa il trattino separatore (es. Categoria:Da wikificare letteratura)
Esempi
Uso base
Supponiamo di trovarci nel codice del template {{W}}, la cui sintassi è nota essere: {{W|argomento|data}}.
Inseriamo il template "InvitoParametri", così:
{{InvitoParametri|W|argomento|{{{1|}}}|data|{{{2|}}}}}
Simuliamo ora i possibili comportamenti.
- Se l'utente che apporrà il template metterà la sintassi corretta ({{W|letteratura|giugno 2008}}), "InvitoParametri" non mostrerà niente:
- Se invece apporrà soltanto, per esempio, il primo, ma non la data ({{W|letteratura}}), "InvitoParametri" mostrerà:
Uso del parametro "fissoN"
Supponiamo di voler far sì che l'utente usi la sintassi esplicita. Usiamo per comodità il caso precedente.
Se vogliamo che il parametro "data" sia dichiarato esplicitamente, dato che "data" è nel template W il 2º parametro, scriviamo:
{{InvitoParametri|W|argomento|{{{1|}}}|data|{{{2|}}}|fisso2=x}}
Se l'utente si dimentica la data, il risultato sarà:
Uso del parametro "arg" (e "cat")
Supponiamo di trovarci nel codice del template {{O}}. Vogliamo che "InvitoArgomenti" controlli che gli argomenti inseriti esistano, e non siano digitati con le maiuscole sbagliate.
Aggiungiamo allora i parametri "arg" (con una semplice "x") e "cat", a cui assegniamo il nome della categoria di lavoro sporco collegata (in questo caso, Pagine orfane):
{{InvitoParametri|O|argomento|{{{1|}}}{{{argomento|}}}|data|{{{2|}}}{{{data|}}}|arg=x|cat=Pagine orfane}}
- Se l'utente sbaglierà la maiuscola di un argomento, "InvitoParametri" mostrerà:
La sintassi corretta di questo template è: {{O|letteratura|giugno 2008}}
- Se l'utente inserirà un argomento non riconosciuto, "InvitoParametri" mostrerà:
La sintassi corretta di questo template è: {{O|argomento corretto|giugno 2008}}
- Se invece l'utente non inserirà l'argomento, "InvitoParametri" mostrerà: