Şablon:Module rating

This module is designed specifically to implement a mechanism which moves control of whether Wikidata values are used in an infobox from the template coder at the infobox design level to the editor at the article level. It is only intended to be used inside an infobox.

One of the three sandboxes at Module:WikidataIB/sandbox, Module:WikidataIB/sandbox1 or Module:WikidataIB/sandbox2 should be used for testing anything other than trivial amendments.

Test cases for the main module can be found at Module talk:WikidataIB/testing. Test cases for two of the sandboxes are at Module talk:WikidataIB/sandbox/testing and Module talk:WikidataIB/sandbox1/testing.

Overview

değiştir

The module provides these calls specifically for use in infoboxes at present:

  1. getValue
    getPreferredValue - obsoleted: use getValue|rank=best instead.
  2. getCoords
  3. getQualifierValue
  4. getValueByQual
  5. getValueByLang

The obsolete call getSourcedValue has now been removed as it is redundant to getValue which can do the same job using the Şablon:Para parameter (which is set by default).

There are also these utility calls:

  1. getLink
  2. getLabel
  3. getAT
  4. getDescription
  5. pageId
  6. formatDate
  7. checkBlacklist
  8. emptyor
  9. labelorid
  10. getLang
  11. getQid

Example form of each call:

{{#invoke:WikidataIB |getValue |<PropertyID> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no> |noicon=<yes/no> |df=<dmy/mdy/y> |bc=<BC/BCE> |qual=<ALL/DATES/P999> |list=<ubl/hlist/prose> |linked=<yes/no> |<local parameter>}}
{{#invoke:WikidataIB |getCoords |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |<local parameter>}}
{{#invoke:WikidataIB |getQualifierValue |<PropertyID> |pval=<ID of target value for the property> |qual=<qualifier ID for that target value> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}
{{#invoke:WikidataIB |getValueByQual |<PropertyID> |qualID=<qualifier property ID to match> |qvalue=<QID of target value for the qualifier property> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}
{{#invoke:WikidataIB |getValueByLang |<PropertyID> |lang=<language code to match> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}


Function getValue

değiştir

Parameters to getValue

değiştir
Name Alias Function Default
(first unnamed) 1 The property-ID whose values are returned. Required.
(second unnamed) 2 A locally supplied value that, if it is not empty, will be returned in preference to the value on Wikidata. empty
qid The Q-number (entity-ID) of the entity that the property belongs to. If not supplied or empty, defaults to the associated Wikidata entry of the current page – uses mw.wikibase.getEntityIdForCurrentPage(). Item id for current page
rank [Case insensitive] When set to best, returns preferred values if present, otherwise returns normal values. When set to preferred returns preferred values. When set to normal, returns normal values. When set to deprecated returns deprecated values. Any parameter value beginning with "b" is "best"; beginning with "p" is "preferred"; beginning with "n" is "normal"; beginning with "d" is deprecated. Multiple values are allowed: "p n d" would return all ranks. "Best" overrides the other flags. Other values are ignored and if no ranks are requested, preferred and normal are returned. preferred and normal
qual The property-ID of a qualifier that is to be returned in parentheses after the property. Setting qual=ALL returns all qualifiers. Setting qual=DATES returns Şablon:Q and Şablon:Q with a date separator. none
fetchwikidata fwd List of fields to fetch values from. ALL fetches all fields. A value of NONE or blank or omitting the parameter fetches no fields. none
suppressfields spf List of fields which will never display. This will even force a local value in the field not to display. none
name Name of the field. When encoding an infobox, this is the name that fetchwikidata and suppressfields will recognise. Required if fetchwikidata or suppressfields is specified (except when fetchwikidata=ALL). nil
onlysourced osd A boolean which will filter out Wikidata values that are unsourced or only sourced to Wikipedia. Values no, false and 0 are all false; anything else is true. true
df Date format: may be dmy (day before month) or mdy (month before day) or y (year alone). dmy
bc Format of the BC/BCE suffix for dates. BCE
linked A boolean that enables the link to a local page via its sitelink on Wikidata. Values no, false and 0 are all false; anything else is true. true
wdlinks wdl A boolean that enables the display of links to Wikidata when no local article exists. Values no, false and 0 are all false; anything else is true. false
unitabbr A boolean that enables unit abbreviations for common units. Values no, false and 0 are all false; anything else is true. false
maxvals Sets the maximum number of values to be returned when multiple values are available. Setting it to 1 is useful where the returned string is used within another call, e.g. image. Values 0 and empty return all values. 0 (all)
collapse Sets the maximum number of values to be returned before the content is auto-collapsed. Values 0 and empty allow all content to be displayed uncollapsed. 0 (all)
linkprefix A link prefix that is prepended to the linked value when linked. Applies only to items that have articles and to strings (e.g. url). It triggers linking of strings. Any double-quotes " are stripped out, so that spaces may be passed. empty
linkpostfix A link postfix that is appended to the linked value when linked. Applies only to items that have articles and to strings (e.g. url). It triggers linking of strings. Any double-quotes " are stripped out, so that spaces may be passed. empty
prefix A prefix that is prepended to the displayed value of strings (e.g. url). Any double-quotes " are stripped out, so that spaces may be passed. empty
postfix A postfix that is appended to the displayed value of strings (e.g. url). Any double-quotes " are stripped out, so that spaces may be passed. empty
qlinkprefix Qualifier link prefix (see linkprefix). empty
qlinkpostfix Qualifier link postfix (see linkpostfix). empty
qprefix Qualifier prefix (see prefix). empty
qpostfix Qualifier postfix (see postfix). empty
sorted A boolean which enables sorting of the values returned. Values no, false and 0 are all false; anything else is true. false
qsorted A boolean which enables sorting of the qualifier values within each item returned. Values no, false and 0 are all false; anything else is true. false
noicon A boolean which will suppress the trailing "edit at Wikidata" pen-icon. Useful for when the returned value is to be further processed. Values no, false and 0 are all false; anything else is true. false
list The name of a template that the list of multiple values is then passed through. Examples include "hlist" and "ubl". Setting it to "prose" produces something like "1, 2, 3, and 4" none
sep Customises the string that is used to separate multiple returned values. Any double-quotes " are stripped out, so that spaces may be passed. If nothing or an empty string is passed it is set to the default list separator (", " in English). ", "
qsep Customises the string that is used to separate multiple returned qualifier values. Any double-quotes " are stripped out, so that spaces may be passed. If nothing or an empty string is passed it is set to the default list separator (", " in English). ", "
format Determines whether global coordinates should be rendered as degree/minute/second or as decimal degrees. Any value beginning "dec" (case insensitive) will render as decimal. Anything else will render as DMS. dms
show Determines how global coordinates should be returned. The value "longlat" will return longitude, latitude. Any other value beginning "lon" (case insensitive) will return just longitude. Any value beginning "lat" (case insensitive) will return just latitude. When used with Şablon:Para, all of these will be pure numbers in decimal degrees (signed: N and E as positive), which are intended for use in mapping templates, etc. Anything other value (or nothing) will render the usual coordinate values as DMS or decimal with "NSEW" qualifiers, etc. empty
lang Allows an unlinked value to be returned in the chosen language. Takes a standard ISO language code recognised by MediaWiki. If not supplied or blank, the local language (or set language for multi-lingual wikis) is used as normal. local language

Base parameters

değiştir
  • getValue can also take a named parameter Şablon:Para which is the Wikidata ID for an article. This will not normally be used as omitting it defaults to the current article.
  • The property whose value is to be returned is passed in the first unnamed property and is required.
  • The second unnamed parameter, if supplied, will become the returned value and no call to Wikidata will be made.

Whitelist and blacklist

değiştir
  • The name of the field that this function is called from is passed in the named parameter Şablon:Para, which is first checked against a blacklist of fields that are never to be displayed, (i.e. the call must return nil in all circumstances). If the field is not on the blacklist, it is then checked against a whitelist. If the name of the field matches, the call will return any locally supplied value if it is supplied as the second unnamed parameter, or the Wikidata value otherwise.
  • The name is compulsory when the blacklist or whitelist is used, so the module returns nil if it is not supplied, other than when Şablon:Para.
  • The blacklist is passed in the named parameter Şablon:Para
  • The whitelist is passed in the named parameter Şablon:Para

Sourcing

değiştir

The getValue function will accept a boolean parameter onlysourced which will suppress return of Wikidata values that are unsourced or only sourced to Wikipedia. The absence of the parameter, an empty parameter (Şablon:Para) and the empty string ("") all default to true (i.e. only referenced values are returned). The values no, false and 0 are treated as false (i.e. all values are returned); any other value is true (although Şablon:Para is recommended for readability).

değiştir

The getValue function will accept a boolean parameter noicon which will suppress the trailing "edit at Wikidata" icon and link for cases when the returned value is to be further processed by the infobox (e.g. a url). The absence of the parameter or an empty parameter (Şablon:Para) default to false (i.e. the icon is added). The empty string ("") and the values no, false and 0 are treated as false; any other value is true (although Şablon:Para is recommended for readability).

In order to handle the requirement for dates in mdy, dmy or just year formats, getValue accepts a named parameter Şablon:Para that may take the values "dmy", "mdy", or "y" - default is "dmy".

As an article may require either of suffixes BC and BCE, getValue accepts a named parameter Şablon:Para that may take the values "BC", or "BCE" - default is "BCE". Some test cases are shown at Module talk:WikidataIB/testing #Calls to getValue for dates.

The Şablon:Para parameter, when set to preferred, returns only preferred values; when set to normal, returns only normal values; when set to deprecated, returns only deprecated values. If the parameter is set to best, it returns preferred values if present, otherwise normal values. Any parameter value beginning with "p" is "preferred"; any parameter value beginning with "n" is "normal"; any parameter value beginning with "d" is "deprecated"; any parameter value beginning with "b" is "best". Combinations of values are allowed, e.g. Şablon:Para returns all the preferred and normal values (which is the default), although "best" overrides any other parameters.

Specific value-type handlers

değiştir

The module has specific handlers for the following data types:

  1. Items that correspond to an article in some Wikipedia, called "wikibase-items". These will be linked to the corresponding (and disambiguated) article on English Wikipedia where possible.
  2. Items that represent dates. These may be centuries, years, years and months, or years, months and days.
  3. Items that represent Commons media, urls, external ids, or other sorts of plain text.
  4. Items that represent quantities. All of these may have an associated unit, or be dimensionless, and may have a range.
  5. Items that represent global coordinates. These will be in degrees of latitude and longitude and will have an associated precision.

Items that represent other types of data are not handled at present.

The third class of data types may be used with the parameters:

If you don't supply at least one of Şablon:Para or Şablon:Para, then just Şablon:Para and Şablon:Para are used. For example, when getting the Şablon:Q in Şablon:Q:

  • {{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix="before " |postfix=" after" |qid=Q532127}}Betik hatası: Böyle bir "WikidataIB/sandbox" modülü yok.

Use double-quotes to enclose the parameter value if it has leading or trailing spaces (otherwise they are stripped out). If you supply Şablon:Para or Şablon:Para, then all four parameters are used and a link is made for each value like this:

  • [[ linkprefix WikidataValue1 linkpostfix | prefix WikidataValue1 postfix]], [[ linkprefix WikidataValue2 linkpostfix | prefix WikidataValue2 postfix]], etc.

That allows multiple links to be made to different sections of a list article, such as List of observatory codes. For example, when getting the Şablon:Q in Şablon:Q we can make the links:

  • {{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix= |postfix= |linkprefix="List of observatory codes#" |linkpostfix= |qid=Q532127}}Betik hatası: Böyle bir "WikidataIB/sandbox" modülü yok.

The parameters Şablon:Para, Şablon:Para, Şablon:Para, Şablon:Para are also applied to wikibase-items if they are linked.

Formatting multiple returned values

değiştir
  • Şablon:Para is a boolean passed to enable sorting of the values returned. No parameter, or an empty string, or "false", or "no", or "0" disables sorting. It's only a very dumb alphabetical sort and sorts linked values as "[[ ..."
  • Şablon:Para allows the separator between multiple returned values to be defined. The default is ", " (comma plus normal space). If the separator has leading or trailing spaces, enclose it in double quotes (e.g. Şablon:Para). Any double quotes are stripped from the separator. The pipe character (|) must be escaped as {{!}}. For reasons of accessibility (see ), do not use Şablon:Para for vertical unbulleted lists; use Şablon:Para instead.
  • Şablon:Para allows multiple returned values to be displayed as a horizontal list (Şablon:Para), or a vertical unbulleted list (Şablon:Para). These override the separator and do not display the 'pen icon' linked to "Edit at Wikidata"

Limiting the returned values

değiştir

Sometimes a property is expected to have a single value, such as Şablon:Q, but may have multiple values on Wikidata. Setting Şablon:Para will limit the number of values returned to 1. Any other value is possible and functions as expected, but zero is treated as "no limit".

Unlinking

değiştir

A returned value that represents an article on the local wiki will be linked by default. This includes redirects, but not dab pages. Sometimes there is a need not to link that returned values and this may be accomplished by setting Şablon:Para.

Unit abbreviations

değiştir

When the returned value is a quantity, the name of the units in which it is expressed is appended. Infoboxes may wish to use abbreviations instead for common units. This can be done by setting Şablon:Para.

Qualifiers

değiştir

A parameter Şablon:Para may be supplied, which will return qualifiers of the required property, if they exist. If the value is set to a property id (P12345), then only the values of qualifiers with that property will be returned. If the value is set to Şablon:Para, then all of the qualifier values are returned. If the value is set to Şablon:Para then the Şablon:Q and the Şablon:Q of the property are returned with a date separator. In each case, any qualifier values returned follow the property value, and are enclosed in parentheses. If multiple qualifier values are returned, they will be separated by commas by default, although the separator can be changed by specifying Şablon:Para (which may be enclosed in double-quotes, which are stripped out, so that spaces can be included). Setting the parameter Şablon:Para will sort the returned qualifier values alphanumerically.

Short form of parameters

değiştir

Some of the longer parameters may be abbreviated to make infobox designs more compact:

  • fwd → fetchwikidata
  • osd → onlysourced
  • spf → suppressfields
  • wdl → wdlinks

Wrapper template

değiştir

The template {{wdib}} can be used as a convenient wrapper for {{#invoke:WikidataIB |getValue}}.

Other main functions

değiştir

Function getPreferredValue

değiştir

The getPreferredValue function works exactly like getValue, taking the same parameters, but if any values for a property have the preferred rank set, it will only return those values. This is now deprecated in favour of getValue|rank=best.

Function getCoords

değiştir
  • getCoords can also take a named parameter Şablon:Para which is the Wikidata ID for an article. This will not normally be used as omitting it defaults to the current article.
  • The first unnamed parameter, if supplied, will become the returned value and no call to Wikidata will be made.
  • The coordinates from Wikidata are parsed and passed to Template:Coord which returns the display as if it were called manually.
  • The blacklist of fields that are never to be displayed, and the whitelist are implemented in the same way as for getValue using Şablon:Para and Şablon:Para

Function getQualifierValue

değiştir

The getQualifierValue function is for use when we want to fetch the value of a qualifier. We need to know the property and the value of the property that the qualifier relates to. The parameters are:

  • The property ID passed in the unnamed parameter (or Şablon:Para)
  • The target value for that property in Şablon:Para
  • The qualifier ID for that target value in Şablon:Para
  • The same parameters to implement whitelisting and blacklisting of the property as in getValue
  • Optional boolean to specify whether only sourced values of the property are returned (defaults to "no") in Şablon:Para
  • Optional item ID for arbitrary access in Şablon:Para
  • The same parameters to format output as in getValue

Example of getQualifierValue

değiştir

In Şablon:Q there is a property Şablon:Q, which has a value Şablon:Q. That has two qualifiers, Şablon:Q and Şablon:Q. To get the start date:

  • {{#invoke:WikidataIB |getQualifierValue |P793 |pval=Q385378 |qual=P580 |name=xyz |fetchwikidata=ALL }}

In South Pole Telescope it returns:

  • Kasım 2006  

Function getValueByQual

değiştir

The getValueByQual function returns the value of a property which has a qualifier with a given entity value. The parameters are:

  • The property ID passed in the unnamed parameter (or Şablon:Para)
  • The property ID for a qualifier (or "ALL" or "DATES") in Şablon:Para
  • The Wikibase-entity ID of a value for that qualifier in Şablon:Para
  • The same parameters to implement whitelisting and blacklisting of the property as in getValue
  • Optional boolean to specify whether only sourced values of the property are returned (defaults to "no") in Şablon:Para
  • Optional item ID for arbitrary access in Şablon:Para
  • The same parameters to format output as in getValue

Example of getValueByQual

değiştir

In Şablon:Q there is a property Şablon:Q that has multiple values, each of which has a qualifier Şablon:Q. We can return the property value whose qualifier has the value Şablon:Q

  • {{#invoke:WikidataIB |getValueByQual |qid=Q10990 |P443 |qualID=P407 |qvalue=Q7979 |fwd=ALL |osd=no |noicon=true}}Betik hatası: Böyle bir "WikidataIB/sandbox" modülü yok.

Function getValueByLang

değiştir

The getValueByLang function returns the value of a property which has a qualifier Şablon:Q whose value has the given language code. The parameters are:

  • The property ID passed in the unnamed parameter (or Şablon:Para)
  • The MediaWiki language code to match the language whose code is given by Şablon:Para. If no code is supplied, it uses the default language.
  • The same parameters to implement whitelisting and blacklisting of the property as in getValue
  • Optional boolean to specify whether only sourced values of the property are returned (defaults to "no") in Şablon:Para
  • Optional item ID for arbitrary access in Şablon:Para
  • The same parameters to format output as in getValue

Utility functions

değiştir
değiştir

getLink has the qid of a Wikidata entity passed as the first unnamed parameter or as |qid=

If there is a sitelink to an article on the local Wiki, it returns a link to the article with the Wikidata label as the displayed text. If there is no sitelink, it returns the label as plain text. If there is no label in the local language, it displays the qid instead.

Wikidata: Şablon:Q and Şablon:Q
  • {{#invoke:WikidataIB |getLink |Q29016906}} → Corisca and the Satyr
  • {{#invoke:WikidataIB |getLink |Q3621491}} → arkeolog

Function getLabel

değiştir

getLabel has the qid of a Wikidata entity passed as the first unnamed parameter or as |qid=

It returns the Wikidata label for the local language as plain text. If there is no label in the local language, it displays the qid instead. Note that this is the label given to the Wikidata entry in the same language as the current Wiki, if the label exists.

Wikidata: Şablon:Q and Şablon:Q
  • {{#invoke:WikidataIB |getLabel |Q29016906}} → Corisca and the Satyr
  • {{#invoke:WikidataIB |getLabel |Q3621491}} → arkeolog

Function getAT

değiştir

getAT has the qid of a Wikidata entity passed as the first unnamed parameter or as |qid=

If there is a sitelink to an article on the local Wiki, it returns the sitelink as plain text, i.e. the article title. If there is no sitelink, it returns nothing. Note that this is the title of the article in the current Wikipedia, if the interlanguage link exists in the Wikidata entry.

Wikidata: Şablon:Q and Şablon:Q
  • {{#invoke:WikidataIB |getAT |Q29016906}}
  • {{#invoke:WikidataIB |getAT |Q3621491}}

Function getDescription

değiştir

getDescription has the qid of a Wikidata entity passed as |qid= (it defaults to the associated qid of the current article if omitted). It has a local parameter passed as the first unnamed parameter. Any local parameter passed (other than "Wikidata" or "none") becomes the return value. It returns the article description for the Wikidata entity in plain text if the local parameter is "Wikidata". Nothing is returned if the description doesn't exist or "none" is passed as the local parameter.

Wikidata: Şablon:Q and Şablon:Q
  • {{#invoke:WikidataIB |getDescription |qid=Q29016906 |wikidata}} → painting by Artemisia Gentileschi
  • {{#invoke:WikidataIB |getDescription |qid=Q29016906 |A painting}} → A painting
  • {{#invoke:WikidataIB |getDescription |qid=Q29016906 |none}}
  • {{#invoke:WikidataIB |getDescription |qid=Q3621491 |wikidata}} → meslek, kazı bilimci.
  • {{#invoke:WikidataIB |getDescription |qid=Q3621491 |A profession}} → A profession
  • {{#invoke:WikidataIB |getDescription |qid=Q3621491 |none}}

Function formatDate

değiştir

formatDate accepts a datetime of the usual format from mw.wikibase.entity:formatPropertyValues, like "1 August 30 BCE" as parameter 1 and formats it according to the df (date format) and bc parameters.

  • {{#invoke:WikidataIB |formatDate | 1 August 30 BCE |bc=BCE |df=dmy}} → 1 August 30 MÖ
  • {{#invoke:WikidataIB |formatDate | 1 August 30 BCE |bc=BC |df=mdy}} → August 1, 30 MÖ
  • df = "dmy" / "mdy" / "y" - default is "dmy"
  • bc = "BC" / "BCE" - default is "BCE"

Function checkBlacklist

değiştir

checkBlacklist allows a test to check whether a named field is allowed. It returns true if the field is not blacklisted (i.e. allowed) It returns false if the field is blacklisted (i.e. disallowed)

Example:

  • {{#if:{{#invoke:WikidataIB |checkBlacklist |name=nationality |suppressfields=residence; nationality; citizenship}} | not blacklisted | blacklisted}} → not blacklisted
  • {{#if:{{#invoke:WikidataIB |checkBlacklist |name=birth_place |suppressfields=residence; nationality; citizenship}} | not blacklisted | blacklisted}} → not blacklisted

Function emptyor

değiştir

emptyor returns nil if its first unnamed argument is just punctuation, whitespace or html tags otherwise it returns the argument unchanged (including leading/trailing space).

If the argument could contain "=", then it must be called explicitly:

  • | 1 = whatever-the-argument-is

In that case, leading and trailing spaces are trimmed.

It finds use in infoboxes where it can replace tests like:

  • {{#if: {{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}} | <span class="xxx">{{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}}</span> | }}

with a form that uses just a single call to Wikidata:

  • {{#invoke |WikidataIB |emptyor |1= <span class="xxx">{{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}}</span> }}

Function labelorid

değiştir

labelorid is a public function to expose the output of labelOrId().

The Q-number (entity ID) is passed as |qid= or as an unnamed parameter.

It returns the Wikidata label for that entity or the qid if no label exists.

Function getQid

değiştir
  • getQid works with the current page and its associated Wikidata entry.
  • It returns qid, if supplied as the first unnamed parameter or as Şablon:Para;
  • failing that, the Wikidata entity ID of the "category's main topic (P301)", if it exists;
  • failing that, the Wikidata entity ID asociated with the curent page, if it exists;
  • otherwise, nothing

Function examine

değiştir

examine provides a dump of the entire property given in the first unnamed parameter (or in Şablon:Para as a named alias) from the item given by the parameter 'qid', or from the item corresponding to the current page if qid is not supplied. It works in a similar manner to the Dump function, but only loads a single claim, rather than the whole Wikidata entry.

  • Example: {{#invoke:WikidataIB |examine |qid=Q1396889 |P50}}

Coding into an infobox

değiştir

Typically, the getValue call will be invoked in an infobox definition, using appropriate template parameters. One simple implementation is given as an example in Template:Infobox book/Wikidata/Sandbox. As an illustration, the 'author' field in the infobox is coded like this:

| label2  = Author{{#if:{{{authors|}}}|s}}
|  data2  = {{#invoke:WikidataIB |getValue |P50 |name=author |fetchwikidata={{{fetchwikidata|}}} |suppressfields={{{suppressfields|}}} |{{{authors|{{{author|}}}}}} }}

The property to be fetched is the first unnamed parameter. In this case it is Şablon:Q.

The name of the field is passed in Şablon:Para and that name is checked against the blacklist and the whitelist. To always suppress the author field in a particular article, an editor will set Şablon:Para in the infobox. The author field will then never be displayed.

If the field is not blacklisted, then the infobox can be set to display a locally supplied value for author simply by setting Şablon:Para, for example, in the infobox. It also accepts Şablon:Para. If the name of the field is on the whitelist, e.g. Şablon:Para, and the local value is not supplied, then the infobox will display the value retrieved from Wikidata. Any separators can be used, except | and {}.

As a shorthand, Şablon:Para will fetch all of the fields that are not blacklisted, as long as no local value is already provided in the article for a given field.

Since Wikidata labels are normally lower case, the sentence case function from Module:String2 can be used to capitalise the first letter of the returned text, e.g.

  • {{#invoke:String2 | sentence | {{#invoke:WikidataIB |getValue |P136 |name=genre |fetchwikidata=ALL |onlysourced=false}} }} in Şablon:Q produces:
  • Anahtarlı roman, satirical fiction, fabl, distopik kurgu  

Example of calls in an infobox

değiştir

Basic use of getValue:

  • {{#invoke:WikidataIB |getValue |P000 |name=fieldname |qid={{{qid|}}} |fetchwikidata={{{fetchwikidata|}}} |onlysourced={{{onlysourced|}}} |{{{localparameter|}}} }}

Full collection of parameters:

  • {{#invoke:WikidataIB |getValue |P000 |name=fieldname |qid={{{qid|}}} |suppressfields={{{suppressfields|}}} |fetchwikidata={{{fetchwikidata|}}} |onlysourced={{{onlysourced|}}} |noicon={{{noicon|}}} |wdl={{{wikidatalink|}}} |df={{dateformat|}} |bc={{{bc|}}} |prefix= |postfix= |linkprefix= |linkpostfix= |sorted={{{sorted|}}} |sep={{{separator|}}} |list={{listtype|}}} |{{{localparameter|}}} }}

Any of the parameters can, of course, be be fixed for a given field in an infobox, rather than taking the parameter supplied to the infobox, which will affect all fields. For example, one field may set Şablon:Para where a series of short words is expected; whereas another field could use Şablon:Para where an unbulleted vertical list of several words on each line is required.

Coodinates

değiştir

The getCoords call will display the output of Template:Coord when supplied with the coordinates returned from Wikidata. It can be coded like this:

|label20 = Coordinates
| data20 = {{#invoke:WikidataIB |getCoords |name=coordinates |suppressfields={{{suppressfields|}}} |fetchwikidata={{{fetchwikidata|}}} |{{{coordinates|}}} }}

An example is Template:Infobox biosphere reserve

{{Infobox biosphere reserve
| fetchwikidata = ALL
}}

Displays coordinates in the usual positions when used in an article where Wikidata has coordinates.

Upgrading existing infoboxes

değiştir

Since the parameter Şablon:Para is needed for any Wikidata functionality, an existing infobox may be replaced by an infobox incorporating these calls without any change whatsoever to any article. Each article using the new infobox can later be enabled by supplying Şablon:Para, or a list of required fields for that article. At that point, the onus is on the editor enabling the functionality to check that no unwanted fields are now being displayed. If so, they can be added to a blacklist for the article by setting Şablon:Para to the list of unwanted fields.

Verifiability

değiştir

Where it will always be essential for a particular field to only contain values that are referenced, use getValue, making sure that Şablon:Para is not set to 'false', '0' or 'no'. By default it will exclude values that are unsourced or only sourced to a Wikipedia, thus making the job of checking easier at the article level. If unsourced data is acceptable (!), set Şablon:Para. As it is beyond my wit to produce an automated mechanism that knows whether an existing source is reliable or not in a given context, that job must still be performed at the article level by an editor familiar with the subject. It should always be done when first enabling Wikidata for that article.

Example of use: Infobox book

değiştir

This section is taken from Template:Infobox book/Wikidata/Sandbox/doc.

No Wikidata

değiştir
{{Infobox book/Wikidata/Sandbox
| suppressfields =
| fetchwikidata  =
| name           = Animal Farm
| title_orig     = Animal Farm: A Fairy Story
| image          = Animal Farm - 1st edition.jpg
| image_size     = 200px
| caption        = First edition cover
| author         = [[George Orwell]]
| country        = United Kingdom
| language       = English
| genre          = Political satire
}}

Works as a non-aware infobox: only locally supplied parameters are displayed.

{{Infobox book/Wikidata/Sandbox
| name           = Animal Farm
| title_orig     = Animal Farm: A Fairy Story
| image          = Animal Farm - 1st edition.jpg
| image_size     = 200px
| caption        = First edition cover
| author         = [[George Orwell]]
| country        = United Kingdom
| language       = English
| genre          = Political satire
}}

The blacklist and whitelist can be omitted if unused

All Wikidata

değiştir
{{Infobox book/Wikidata/Sandbox
| fetchwikidata  = author; genre; pub_date; pages; dewey; congress
}}

Fetches the author, publication date, number of pages, Dewey index, and Library of Congress catalogue number values from Wikidata.

{{Infobox book/Wikidata/Sandbox
| fetchwikidata  = ALL
}}

As shorthand, the Şablon:Para parameter can be set to ALL to fetch all available fields. Any field can be suppressed by naming it in Şablon:Para, or overridden by supplying a local value.

Never display genre

değiştir
{{Infobox book/Wikidata/Sandbox
| suppressfields = genre
| fetchwikidata  = author; genre; pub_date; pages; dewey; congress
}}

The genre field will always be suppressed, even if a local value is supplied.

{{Infobox book/Wikidata/Sandbox
| suppressfields = genre
| fetchwikidata  = author; genre; pub_date; pages; dewey; congress
| genre          = Political satire
}}

Local override

değiştir
{{Infobox book/Wikidata/Sandbox
| fetchwikidata  = author; genre; pub_date; pages; dewey; congress
| genre          = Political satire
}}

The genre field is set to display "Political satire", no matter what is stored in Wikidata.

{{Infobox book/Wikidata/Sandbox
| fetchwikidata  = ALL
| genre          = Novel
}}

The genre field is set to display "Novel", no matter what is stored in Wikidata.

Don't fetch genre

değiştir
{{Infobox book/Wikidata/Sandbox
| suppressfields = 
| fetchwikidata  = author; pub_date; pages; dewey; congress
}}

The genre field will not be fetched from Wikidata. Only the author, publication date, number of pages, Dewey index, and Library of Congress catalogue number are imported. A local value for genre will display.

See also

değiştir

Tracking categories

değiştir

Şablon:Wikidata infoboxes


Bu Modül:WikidataIB belgelendirme sayfası içindir