Module:Wikidata/doc

2013-09-29T17:31:46Z

82.45.65.97: /* Example:birth place */ correct the typo: spouse -> birth place

{{module rating|alpha}}
This module is a modification of the original at [[Module:Sandbox/Tom Morris]] which was created 19 May 2013.

The module "{{BASEPAGENAME}}" contains:
* a call (getValue) that allows the calling script to retrieve the wiki-linked value(s) for any property from Wikidata by supplying the property ID as the first parameter.
* a call (getRawValue) that allows the calling script to retrieve the non-linked value(s) for any property from Wikidata by supplying the property ID as the first parameter.
* a call (getDateValue) that allows the calling script to retrieve the date value(s) for any property from Wikidata by supplying the property ID as the first parameter. It allows specifying that the date be returned in dmy or mdy format by supplying "dmy" or "mdy" as an optional third parameter.

If the property is not defined in Wikidata for the article that invokes this code, then an empty string ("") is returned.

== Parameters ==
* For the generalised linked case (getValue), two unnamed parameters are supplied. The first is the ID of the property that is to be retrieved (e.g. p19 for birthplace or p26 for spouse). The second may be null, "FETCH_WIKIDATA", or any other string, which becomes the returned value.
* For the generalised unlinked case (getRawValue), two unnamed parameters are supplied. The first is the ID of the property that is to be retrieved (e.g. p21 for gender). The second may be null, "FETCH_WIKIDATA", or any other string, which becomes the returned value.
* For the generalised date case (getDateValue), three unnamed parameters are supplied. The first is the ID of the property that is to be retrieved (e.g. p569 for date of birth). The second may be null, "FETCH_WIKIDATA", or any other string, which becomes the returned value. The third is the format that the date should be returned in, either dmy or mdy.

== Usage ==
=== Example:spouse ===
* <code><nowiki>{{#invoke:Wikidata|getValue|p26|}}</nowiki></code> = returns nothing, so suppresses the display of spouse in an infobox
* <code><nowiki>{{#invoke:Wikidata|getValue|p26|FETCH_WIKIDATA}}</nowiki></code> = returns the linked value(s) of property p26 (spouse) stored in wikidata for the corresponding article (e.g. for article [[Bill Clinton]], it returns [[Hillary Rodham Clinton]])
* <code><nowiki>{{#invoke:Wikidata|getValue|p26|[[Hillary Clinton]]}}</nowiki></code> = returns [[Hillary Clinton]], allowing an infobox to use a local value rather than the value stored in Wikidata.

=== Example in Infobox template ===
Inside an infobox definition, it may be called like this:
* <code><nowiki>| data55 = {{#invoke:Wikidata|getValue|p26|{{{spouse|FETCH_WIKIDATA}}} }}</nowiki></code>
which causes the infobox to:
# not display spouse if the infobox parameter <code>|spouse</code> is set to be blank (as <code>"| spouse ="</code>}
# display the linked value(s) from Wikidata if the infobox parameter <code>|spouse</code> is not supplied
# display the local infobox parameter <code>|spouse</code> if it is supplied (e.g. <code>"|spouse = Hillary Clinton"</code>)

Optionally, it could be called as:
* <code><nowiki>| data55 = {{#invoke:Wikidata|getValue|p26|{{{spouse|}}} }}</nowiki></code>
which should behave as the parameter does now, unless the parameter is set to FETCH_WIKIDATA when it displays the linked value(s) fetched from Wikidata.

=== Example:birth place ===
This works in just the same way as the calls above:
* <code><nowiki>{{#invoke:Wikidata|getValue|p19|}}</nowiki></code> = returns nothing, so suppresses the display of birth place in an infobox
* <code><nowiki>{{#invoke:Wikidata|getValue|p19|FETCH_WIKIDATA}}</nowiki></code> = returns the linked value(s) of property p19 (place of birth) stored in wikidata for the corresponding article (e.g. for article [[Bill Clinton]], it returns [[Hope, Arkansas]])
* <code><nowiki>{{#invoke:Wikidata|getValue|p19|[[Hope, Arkansas|Hope]]}}</nowiki></code> = returns [[Hope, Arkansas|Hope]], allowing an infobox to use a local value rather than the value stored in Wikidata.

=== Example:gender ===
We don't want the returned value linked, so use:
* - <code><nowiki>{{#invoke:Wikidata|getRawValue|p21|FETCH_WIKIDATA}}</nowiki></code>

=== Example:date of birth ===
If we want the date of birth in dmy format, we use:
* - <code><nowiki>{{#invoke:Wikidata|getDateValue|p569|FETCH_WIKIDATA|dmy}}</nowiki></code>

If we want the date of birth in mdy format, we use:
* - <code><nowiki>{{#invoke:Wikidata|getDateValue|p569|FETCH_WIKIDATA|mdy}}</nowiki></code>

== Testing ==
=== Testing spouse ===
Copy and paste the following into any article and preview it (please don't save!):
<pre>
* - {{#invoke:Wikidata|getValue|p26|}}
* - {{#invoke:Wikidata|getValue|p26|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|p26|[[Hillary Clinton]]}}
</pre>

In [[Bill Clinton]] you should get:
* -
* - [[Hillary Rodham Clinton]]
* - [[Hillary Clinton]]

In [[Barack Obama]] you should get:
* -
* - [[Michelle Obama]]
* - [[Hillary Clinton]]

In [[Richard Burton]] you should get:
* -
* - [[Sally Burton]], [[Elizabeth Taylor]]
* - [[Hillary Clinton]]

In [[Franz Kafka]] you should get:
* -
* -
* - [[Hillary Clinton]]

=== Testing birthplace ===
Copy and paste the following into any article and preview it (please don't save!):
<pre>
* - {{#invoke:Wikidata|getValue|p19|}}
* - {{#invoke:Wikidata|getValue|p19|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|p19|[[Newport]]}}
</pre>
Try [[William Ellery]] and check that the Wikidata call correctly disambiguates.

=== Testing getValue, getRawValue and getDateValue ===
Copy and paste the following into any article and preview it (please don't save!):
<pre>
* - {{#invoke:Wikidata|getValue|p19|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|p26|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|p27|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|p140|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getRawValue|p21|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getDateValue|p569|FETCH_WIKIDATA|dmy}}
* - {{#invoke:Wikidata|getDateValue|p569|FETCH_WIKIDATA|mdy}}
</pre>
This should return the Wikidata values for birthplace, spouse, citizenship, religion, gender and date of birth (twice) if they exist. The dob is first in dmy format and then in mdy.

[[Category:Wikidata]]

The Official Website for Mark Eitzel & American Music Club - User contributions [en]

Module:Wikidata/doc