Modulo:Wikidata/man: differenze tra le versioni

Il [[Aiuto:Moduli|modulo]] [[Aiuto:Lua|Lua]] '''Wikidata''' serve per leggere il valore delle proprietà di [[Aiuto:Wikidata|Wikidata]], relative alla pagina corrente, cioè la pagina in cui è utilizzato il modulo. Sarà in futuro possibile leggere le proprietà anche di pagine diverse da quella corrente. Il modulo fornisce un utilizzo più avanzato, a volte senza alternativa, rispetto a quello che si può ottenere con la ''magic word'': <code><nowiki>{{#property:NumProprietà}}</nowiki></code>.

* '''formatStatements''': restituisce il valore di una proprietà di Wikidata. Nel caso una proprietà ha più di un valore (''statement'') li può restituire tutti, separandoli con una virgola e inserendo la congiunzione "e" prima dell'ultimo valore, oppure filtrarli se si specifica un rank, un qualifier o un indice. Permette di formattare l'output attraverso delle opzioni (da qui il nome formatStatements). Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà è a sua volta un elemento che non ha un'etichetta in italiano, non restituisce nulla. Se possibile ([[#nolink|e se non diversamente specificato]]), i valori delle proprietà sono restituiti con wikilink, compresa eventuale disambiguazione nascosta con la barra verticale (es. <ttcode><nowiki>[[Savoia (dipartimento)|Savoia]]</nowiki></ttcode>). Il nome italiano della voce viene ricavato dall'interlink del rispettivo elemento su Wikidata; se il soggetto non è presente su Wikidata, il valore viene restituito senza wikilink.

* '''N''': ritorna il numero di statement della proprietà richiesta.

* '''<span style="color:blue;">checkStatements</span>'''<ref name="newpedia">:Funzionalità nuova e aggiuntiva rispetto al corrispondente modulo su Wikipedia.</ref> verifica se una proprietà di Wikidata ha un determinato valore. Nel caso una proprietà ha più di un valore (''statement'') li verifica tutti. Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà non corrisponde a quello da verificare, non restituisce nulla; altrimenti restituisce ''true''un numero corrispondente allo statement verificato.

* ''property'': l'identificatore della proprietà;

** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p19}}</nowiki></code> ritornerà: [[Firenze]] ([[d:P19]] è il luogo di nascita).

* ''n'': se la proprietà ha più statement ritorna l'n-esimo;

** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|n=1}}</nowiki></code> ritornerà: [[poeta]] ([[d:P101]] è la professione, mentre con n=2 avrebbe ritornato [[scrittore]], con n=3 [[politico]]).

* ''value'': se valorizzato, il modulo ritorna il valore di questo parametro invece di quello su Wikidata, formattandolo eventualmente secondo il pattern se specificato. Serve quando si usa il modulo da un template, per dare la precedenza al valore passato al template rispetto a quello su Wikidata.;

** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p19|value={{{LuogoNascita|}}}}}</nowiki></code> ritornerà: il valore di LuogoNascita se valorizzato, altrimenti quello della proprietà p19 su Wikidata.

* ''entityId'': per ora '''<span style="color:red;">NON FUNZIONANTE</span>''', quando sarà attivato permetterà di specificare un'entity di Wikidata relativa a una pagina diversa da quella in cui ci si trova.

* ''separator'': separatore tra valori multipli, se diverso da virgola_spazio;

* ''conjunction'': separatore tra gli ultimi due valori, se diverso da spazio_e_spazio;

** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|separator=/|conjunction=/}}</nowiki></code> ritornerà: [[scrittorepoeta]]/[[politicoscrittore]]/[[poetapolitico]].

* ''pattern'': pattern utilizzato per ogni statement, sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore ritornato per ogni sua occorrenza.

** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p18|pattern=[[File:$1|thumb|Il nome del file è $1]]}}</nowiki></code> ritornerà: <code><nowiki>[[File:Portrait de Dante.jpg|thumb|Il nome del file è Portrait de Dante.jpg]]</nowiki></code> ([[d:P18]] è l'immagine).

* ''list'': formatta il risultato ritornato come lista non ordinata; si deve assegnargli un valore qualunque, es: "list=sì". Eventuali parametri ''separator'' e ''conjunction'' vengono ignorati.;

** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|list=1}}</nowiki></code>.

* ''orderedlist'': formatta il risultato ritornato come lista ordinata; si deve assegnargli un valore qualunque, es: "orderedlist=sì". Eventuali parametri ''separator'' e ''conjunction'' vengono ignorati. Se sono presenti entrambi i parametri ''list'' e ''orderedlist'' viene creata una lista non ordinata;

** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|orderedlist=1}}</nowiki></code>.

* ''formatting'': esegue formattazioni speciali, attulmente i valori consentiti sono: <code><span style="color:blue;">formatting=nolink</span></code><ref name="newpedia" /> per ritornare il risultato senza wikilink (anche se disponibile); <code>formatting=latitude</code> e <code>formatting=longitude</code> per ritornare solo latitudine o longitudine in caso di proprietà di tipo coordinata.

* ''value-module'': nome di un modulo che effettua una formattazione speciale.

* ''value-function'': funzione nel modulo ''value-module''.

* esempio: <code><nowiki>{{#invoke:Wikidata|N|p40}}</nowiki></code> ritornerà: 2 ([[d:P40]] è "figlio").

La funzione checkStatements ha tredue parametri, di cui ''property'' eè ''value'' sono '''obbligatoriobbligatorio'''.

* ''property'': l'identificatore della proprietà.

* ''value'': il valore da verificare; ''value'' viene generalmentepuò espresso sia come stringa di testo (nonsia facome differenzaidentificatore tradell'elemento maiuscolecorrispondente esu minuscole)Wikidata;

** esempio: <code><nowiki>{{#invoke:Wikidata|checkStatements|property=p101|value=poeta}}</nowiki></code> ritornerà: true1 ([[d:P101]] è la professione, ed effettivamentee "poeta" è unala delleprima professioni presentiprofessione),