Visualizza wikitesto di Template:Wikidata/man

Il template '''{{tl|Wikidata}}''' serve per leggere il valore di una proprietà di [[Aiuto:Wikidata|Wikidata]]. Il template fornisce un utilizzo più avanzato, a volte senza alternativa, rispetto a quello che si può ottenere con la funzione: [[Aiuto:Wikidata#Proprietà|<nowiki>{{#property:proprietà}}</nowiki>]].

Di default il template legge le proprietà relative all'elemento Wikidata collegato alla pagina in cui è utilizzato il template. Specificando il parametro ''from'' è possibile leggere le proprietà di qualunque altro elemento, così come avviene con #property (si veda [[d:Wikidata:How_to_use_data_on_Wikimedia_projects/it#Accesso_arbitrario|accesso arbitrario]]).<ref>La funzionalità è presente in it.wiki dal 1º giugno 2015.</ref>

== Parametri posizionali ==
Il template ha due parametri posizionali:
:'''<code><nowiki>{{Wikidata|Pxxx|{{{parametro|}}}}}</nowiki></code>'''

# il codice della proprietà su Wikidata (obbligatorio): esempio: <code><nowiki>{{Wikidata|P19}}</nowiki></code> usato nella voce [[Dante Alighieri]] restituirà: [[Firenze]] ([[:d:Property:P19|P19]] è il luogo di nascita)
# il secondo parametro posizionale è facoltativo: se valorizzato, il template restituisce il valore di questo parametro invece di quello su Wikidata, formattandolo eventualmente secondo il pattern se specificato. Serve quando si usa il template all'interno di un altro template, per dare la precedenza al valore passato al template rispetto a quello su Wikidata. Esempio: <code><nowiki>{{Wikidata|P19|{{{LuogoNascita|}}}}}</nowiki></code> restituirà: il valore di LuogoNascita se valorizzato, altrimenti quello della proprietà P19 su Wikidata

Nel caso una proprietà abbia più di un valore (detto ''statement'', dichiarazione) il template li può restituire tutti, separandoli con una virgola e inserendo la congiunzione "e" prima dell'ultimo, oppure filtrarli se si specifica un rank, un qualificatore o un indice. È possibile formattare l'output attraverso delle opzioni. 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, i valori delle proprietà sono restituiti con wikilink, compresa eventuale disambiguazione nascosta con la barra verticale (es. <code><nowiki>[[Savoia (dipartimento)|Savoia]]</nowiki></code>). 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.

== Parametri con nome ==
=== Parametri di selezione ===
* ''from'': permette di specificare un elemento Wikidata arbitrario, potendo così leggere le proprietà anche di elementi diversi da quello collegato alla pagina in cui si è utilizzato il template. Così come per #property, l'accesso agli elementi tramite il parametro "from" rende la funzione una "expensive parser function" (si veda [[:mw:Manual:$wgExpensiveParserFunctionLimit]]). Queste ultime non possono essere usate più di 500 volte in una stessa pagina.
** esempio: <code><nowiki>{{Wikidata|P36|from=Q38}}</nowiki></code> restituirà: {{Wikidata|P36|from=Q38}} ([[:d:Property:P36|P36]] è la capitale e [[:d:Q38|Q38]] è l'Italia).
* ''rank'': è valorizzato in modo predefinito al valore 'best'. Se valorizzato con un certo rank, il template restituisce solo le dichiarazioni che hanno quel valore. I rank disponibili sono i tre definiti da Wikidata: ''deprecated'', ''normal'' e ''preferred'', più il tipo ''best''. Con quest'ultimo vengono restituiti le dichiarazioni a partire dal rank più alto: i ''preferred'' se presenti altrimenti i ''normal''.
* ''snaktype'': se valorizzato a "value" (default), "novalue", "somevalue" o "all" verranno restituite rispettivamente solo le dichiarazioni con valore noto, "nessun valore", "valore sconosciuto" (si veda [[d:Help:Statements#Unknown or no values]]), o tutte. Il default è "value", quindi normalmente vengono ignorate le dichiarazioni di tipo novalue e somevalue, che altrimenti apparirebbero come "nessun valore" e "valore sconosciuto".
* ''qualifier'': codice di un qualificatore di una proprietà. Verranno restituite solo le dichiarazioni che posseggono quel qualificatore. Se viene utilizzato anche il parametro qualifiervalue il qualificatore dovrà anche avere il valore specificato.
* ''noqualifier'': codice di un qualificatore di una proprietà. Al contrario del precedente parametro qualifier, verranno restituite solo le dichiarazioni che non posseggono quel qualificatore.
* ''qualifieroptnovalue'': codice di un qualificatore di una proprietà. Verranno restituite solo le dichiarazioni che non posseggono quel qualificatore, oppure se lo posseggono quelle con valore diverso da quello specificato nel parametro qualifiervalue.
* ''qualifiervalue'': valore del qualificatore, da usare in accoppiata con i parametri qualifier o qualifieroptnovalue. Si possono specificare più valori separati da virgola, ad es. Q123,Q456
* ''qualifiertype'': ulteriore filtro sul qualificatore specificato. Ha attualmente un unico valore accettato, <code>qualifiertype=latest</code>: se il qualificatore contiene un valore di tipo "time", verrà restituito solo la dichiarazione che possiede quel qualificatore e con il valore più recente.
* ''n'': se la proprietà ha più dichiarazioni restituisce l'n-esimo. Nota: la selezione è applicata per ultima, dopo i filtri per rank e qualificatore, quindi se per esempio una proprietà ha dieci dichiarazioni di cui una con rank preferred, con n=1 continuerà a essere restituita sempre quella.
** esempio: <code><nowiki>{{Wikidata|P106|from=Q1067|n=1}}</nowiki></code> restituirà: {{Wikidata|P106|from=Q1067|n=1}} ([[:d:Property:P106|P106]] è l'occupazione e [[d:Q1067|Q1067]] è Dante Alighieri, con cinque dichiarazioni con rank normale per P106), mentre con n=2 avrebbe restituito {{Wikidata|P106|from=Q1067|n=2}}, con n=3 {{Wikidata|P106|from=Q1067|n=3}} (senza wikilink perché [[d:Q4964182|Q4964182]] non è collegato a una voce in it.wiki).
* ''wd'': se impostato a "no" il template restituisce unicamente il valore impostato nel secondo parametro posizionale, se presente, altrimenti una stringa vuota, disabilitando quindi la lettura da Wikidata.

=== Parametri per la formattazione del risultato ===
* ''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>{{Wikidata|P106|from=Q1067|separator=/|conjunction=/}}</nowiki></code> restituirà: {{Wikidata|P106|from=Q1067|separator=/|conjunction=/}}
* ''pattern'': pattern utilizzato per ogni dichiarazione, sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore restituito per ogni sua occorrenza. È possibile inserire wikitesto, ma eventuali caratteri "{" e "}" potrebbero dover essere preceduti da "\", e il carattere "|" sostituito con <nowiki>{{!}}</nowiki>.
** esempio: <code><nowiki>{{Wikidata|P18|from=Q1067|pattern=[[File:$1|thumb|Il nome del file è $1]]}}</nowiki></code> restituirà: <code><nowiki>[[File:Portrait de Dante.jpg|thumb|Il nome del file è Portrait de Dante.jpg]]</nowiki></code> ([[:d:Property:P18|P18]] è l'immagine)
** esempio con value: <code><nowiki>{{Wikidata|P18|{{{Immagine|}}}|from=Q1067|pattern=[[File:$1|thumb|Il nome del file è $1]]}}</nowiki></code> In un template, se il parametro Immagine fosse valorizzato a "Test.png" allora restituirerebbe <code><nowiki>[[File:Test.png|thumb|Il nome del file è Test.png]]</nowiki></code>, altrimenti se Immagine non fosse valorizzato, lo stesso risultato dell'esempio precedente. 
* ''list'': formatta il risultato restituito come elenco puntato, si deve assegnargli un valore qualunque, es: "list=sì". Eventuali parametri ''separator'' e ''conjunction'' vengono ignorati.
** esempio: <code><nowiki>{{Wikidata|P106|from=Q1067|list=1}}</nowiki></code>
* ''orderedlist'': formatta il risultato restituito come elenco numerato, 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 creato un elenco puntato
** esempio: <code><nowiki>{{Wikidata|P106|from=Q1067|orderedlist=1}}</nowiki></code>
* ''formatting'': se impostato a raw, esempio "formatting=raw", restituisce l'identificativo numerico nel caso di proprietà di tipo elemento (esempio "Q123456") e il timestamp nel caso di proprietà di tipo time (esempio "+00000002013-01-01T00:00:00Z")
* ''showqualifiers'': aggiunge al risultato uno o più qualificatori, tra parentesi.
** esempio: <code><nowiki>{{Wikidata|P38|showqualifiers=P580|from=Q38}}</nowiki></code> → {{Wikidata|P38|showqualifiers=P580|from=Q38}}
** con due qualificatori: <code><nowiki>{{Wikidata|P38|showqualifiers=P580,P582|rank=normal|from=Q38}}</nowiki></code> → {{Wikidata|P38|showqualifiers=P580,P582|rank=normal|from=Q38}}

; Per il solo tipo stringa
* ''urlencode'': se impostato a qualunque valore, esempio "urlencode=sì", codifica la stringa per l'utilizzo in un [[URL]], nella query string
; Per il solo tipo coordinate geografiche
* ''coord'': se impostato a latitude o longitude, esempio "coord=latitude" o "coord=longitude", restituisce rispettivamente solo la latitudine o la longitudine. Con "coord=globe" restituisce l'URL dell'elemento Wikidata a cui si riferiscono le coordinate, per la Terra <nowiki>http://</nowiki>www.wikidata.org/entity/Q2.
; Per il solo tipo url
* ''extlink'': se impostato a qualunque valore, esempio "extlink=sì", e la proprietà o il valore inserito localmente sono un [[URL]] valido, lo restituisce come link esterno senza il protocollo. Per esempio se l'URL vale <code><nowiki>http://www.sitoesterno.it</nowiki></code> → si otterrà <code><nowiki>[http://www.sitoesterno.it www.sitoesterno.it]</nowiki></code>. È utile nei sinottici per leggere l'URL da Wikidata e ottenere al contempo la rimozione del protocollo, altrimenti eseguita solitamente voce per voce. Esempio in un template basato su {{tl|Infobox}}:
: <code><nowiki>|Valore1 = {{Wikidata|P856|{{{sito|}}}|extlink=sì}}</nowiki></code>
: Nel caso invece si voglia una etichetta prestabilita per il link, allora non è necessario il parametro extlink ma è sufficiente pattern, esempio:
: <code><nowiki>|Valore1 = {{Wikidata|P856|{{{sito|}}}|pattern=[$1 Sito ufficiale]}}</nowiki></code>
; Per il solo tipo elemento
* ''showprop'': nel caso di proprietà di tipo elemento, restituisce la proprietà specificata invece dell'elemento.<ref>Come per il parametro "from", l'utilizzo di showprop rende la chiamata al template una expensive parser function, quindi non utilizzabile più di 500 volte in una stessa pagina.</ref>
** esempio: normalmente con <code><nowiki>{{Wikidata|P17|from=Q10285}}</nowiki></code> si otterrebbe →  {{Wikidata|P17|from=Q10285}} (Q10285 è [[Colosseo]] e P17 è "nazione"). Aggiungendo showprop=P298 (P298 è il codice [[ISO 3166-1 alpha-3]]) si otterrà invece <code><nowiki>{{Wikidata|P17|showprop=P298|from=Q10285}}</nowiki></code> →  {{Wikidata|P17|showprop=P298|from=Q10285}}
; Per il solo tipo testo monolingua
* ''showlang'': se impostato a qualunque valore, esempio "showlang=sì", antepone a ciascun valore l'indicazione della lingua (utilizza il [[Modulo:Linguaggi]]).
** esempio: <code><nowiki>{{Wikidata|P1705|showlang=sì|from=Q1757}}</nowiki></code> → {{Wikidata|P1705|showlang=sì|from=Q1757}} (Q1757 è [[Helsinki]] e P1705 è "nome originale locale").
* ''includelang'': permette di definire i soli linguaggi da visualizzare, che vanno inseriti come uno o più codici separati dalla virgola, esempio <code>includelang=it,fr</code>
* ''excludelang'': permette di definire i linguaggi da non visualizzare, che vanno inseriti come uno o più codici separati dalla virgola, esempio <code>excludelang=en,es</code>
; Per il solo tipo quantità
* ''unit'': effettua la conversione all'unità di misura specificata. Sono supportate tutte le unità di misura configurate nel [[modulo:Conversione]] ([[Modulo:Conversione/Configurazione|qui]] la configurazione, vedere da "config.alias" in poi), tramite il quale viene effettuata l'operazione di conversione.
** esempio: <code><nowiki>{{Wikidata|P2048|unit=chilometro|from=Q243}}</nowiki></code> → {{Wikidata|P2048|unit=chilometro|from=Q243}} (Q243 è [[Torre Eiffel]] e P2048 è "altezza")
* ''showunit'': se impostato a qualunque valore, esempio "showunit=sì", verrà restituto anche il simbolo dell'unità di misura dopo il valore.<ref>Se ''showunit'' è utilizzato senza il parametro ''unit'' (quindi senza ulteriore conversione) il simbolo è ottenuto direttamente da Wikidata dalla proprietà {{WikidataProp|P5061}}. Se invece è usato in unione a ''unit'', il simbolo dell'unità di misura, come il valore convertito, è ottenuto dal [[modulo:Conversione]] (e quindi limitato alle [[Modulo:Conversione/Configurazione|unità configurate]]).</ref>
** esempio: <code><nowiki>{{Wikidata|P2048|showunit=sì|from=Q243}}</nowiki></code> → {{Wikidata|P2048|showunit=sì|from=Q243}}
* ''showunitlink'': quando è utilizzato showunit, se impostato a qualunque valore, esempio "showunitlink=sì", crea il wikilink del simbolo dell'unità.
** esempio: <code><nowiki>{{Wikidata|P2048|unit=cm|showunit=sì|showunitlink=sì|from=Q243}}</nowiki></code> → {{Wikidata|P2048|unit=cm|showunit=sì|showunitlink=sì|from=Q243}}
* ''formatnum'': se impostato a qualunque valore, esempio "formatnum=sì", formatta il risultato come con la funzione parser [[Aiuto:Funzioni_parser#formatnum|formatnum]].
** esempio: <code><nowiki>{{Wikidata|P2048|formatnum=sì|unit=chilometro|from=Q243}}</nowiki></code> → {{Wikidata|P2048|formatnum=sì|unit=chilometro|from=Q243}}
* ''formatduration'': se impostato a qualunque valore, esempio "formatduration=sì", e su Wikidata l'unità di misura è di tempo fra quelle supportate dal modulo:Conversione (secondo, minuto e ora), restituisce il risultato espresso in giorni, ore, minuti e secondi.
** esempio: <code><nowiki>{{Wikidata|P2147|formatduration=sì|from=Q111}}</nowiki></code> → {{Wikidata|P2147|formatduration=sì|from=Q111}}
* ''rounding'': arrotonda il risultato al numero di decimali richiesto:
** esempio: <code><nowiki>{{Wikidata|P2370|formatnum=sì|rounding=3|from=Q3710}}</nowiki></code> → {{Wikidata|P2370|formatnum=sì|rounding=3|from=Q3710}} (senza rounding=3 avrebbe restituito 0,3048)
; Per il solo tipo data e ora
* ''time'': a seconda del valore a cui è impostato (es. "time=precision") permette di ottenere rispettivamente:
** "calendarmodel": l'URL dell'elemento Wikidata del modello di calendario a cui si riferisce la data/ora
** "precision": il livello di precisione: 0 - miliardi di anni, 1 - centinaia di milioni di anni, 2 - decine di milioni di anni, 3 - milioni di anni, 4 - centinaia di millenni, 5 - decine di millenni, 6 - millennio, 7 - secolo, 8 - decade, 9 - anno, 10 - mese, 11 - giorno (la precisione 12 - ora, 13 - minuto, 14 - secondo non è ancora supportata, si veda [[phab:T57755]]).
** "year": la data con precisione anno (la precisione su Wikidata deve essere maggiore o uguale a 9)
** "month": la data con precisione mese (la precisione su Wikidata deve essere maggiore o uguale a 10)
** "day": la data con precisione giorno (la precisione su Wikidata deve essere maggiore o uguale a 11)

== Pagine correlate ==
{{Wikidata/Correlate}}

== Note ==
<references/>

{{progetto|Template|Wikidata}}

<noinclude>[[Categoria:Manuali dei template]]</noinclude>