پودمان:WikidataIB
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 should be used for testing anything other than trivial amendments.
Test cases for the main module and two of the sandboxes are available.
Module | Test cases | |
---|---|---|
Main | پودمان:WikidataIB | Module talk:WikidataIB/testing |
sandbox | Module:WikidataIB/sandbox (diff) | Module talk:WikidataIB/sandbox/testing (diff) |
sandbox1 | Module:WikidataIB/sandbox1 (diff) | Module talk:WikidataIB/sandbox1/testing (diff) |
sandbox2 | Module:WikidataIB/sandbox2 (diff) |
Overview[ویرایش]
The module provides these calls specifically for use in infoboxes at present:
getValue
- obsoleted: usegetPreferredValue
getValue|rank=best
instead.
getCoords
getQualifierValue
getValueByQual
getValueByLang
The obsolete call getSourcedValue has now been removed as it is redundant to getValue which can do the same job using the |onlysourced=true
parameter (which is set by default).
There are also these utility calls:
getLink
getLabel
getAT
getDescription
pageId
formatDate
checkBlacklist
emptyor
labelorid
getLang
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[ویرایش]
Parameters to getValue[ویرایش]
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 خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P580) and خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P582) 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 |noicon=true , 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[ویرایش]
- getValue can also take a named parameter
|qid=
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[ویرایش]
- The name of the field that this function is called from is passed in the named parameter
|name=
, 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. - Specifying
|fetchwikidata=ALL
is a shortcut to return all fields that are not blacklisted. - The name is compulsory when the blacklist or whitelist is used, so the module returns nil if it is not supplied, other than when
|fetchwikidata=ALL
. - The blacklist is passed in the named parameter
|suppressfields=
- The whitelist is passed in the named parameter
|fetchwikidata=
Sourcing[ویرایش]
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 (|onlysourced=
) 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 |onlysourced=yes/no
is recommended for readability).
Link to Wikidata[ویرایش]
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 (|noicon=
) 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 |noicon=true
is recommended for readability).
Dates[ویرایش]
In order to handle the requirement for dates in mdy, dmy or just year formats, getValue accepts a named parameter |df=
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 |bc=
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.
Ranks[ویرایش]
The |rank=
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. |rank=p n
returns all the preferred and normal values (which is the default), although "best" overrides any other parameters.
Specific value-type handlers[ویرایش]
The module has specific handlers for the following data types:
- 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.
- Items that represent dates. These may be centuries, years, years and months, or years, months and days.
- Items that represent Commons media, urls, external ids, or other sorts of plain text.
- Items that represent quantities. All of these may have an associated unit, or be dimensionless, and may have a range.
- 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:
|prefix=
,|postfix=
,|linkprefix=
,|linkpostfix=
If you don't supply at least one of |linkprefix=
or |linkpostfix=
, then just |prefix=
and |postfix=
are used. For example, when getting the خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P717) in خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q532127):
{{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix="before " |postfix=" after" |qid=Q532127}}
→ خطای اسکریپتی: پودمان «WikidataIB/sandbox» وجود ندارد.
Use double-quotes to enclose the parameter value if it has leading or trailing spaces (otherwise they are stripped out). If you supply |linkprefix=
or |linkpostfix=
, 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 خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P717) in خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q532127) we can make the links:
{{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix= |postfix= |linkprefix="List of observatory codes#" |linkpostfix= |qid=Q532127}}
→ خطای اسکریپتی: پودمان «WikidataIB/sandbox» وجود ندارد.
The parameters |prefix=
, |postfix=
, |linkprefix=
, |linkpostfix=
are also applied to wikibase-items if they are linked.
Formatting multiple returned values[ویرایش]
|sorted=<yes|no>
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 "[[ ..."|sep=<separator characters>
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.|sep=" - "
). Any double quotes are stripped from the separator. The pipe character (|
) must be escaped as{{!}}
. For reasons of accessibility (see ویکیپدیا:شیوهنامه/دسترسیپذیری), do not use|sep=<br>
for vertical unbulleted lists; use|list=ubl
instead.|list=<hlist|ubl>
allows multiple returned values to be displayed as a horizontal list (|list=hlist
), or a vertical unbulleted list (|list=ubl
). These override the separator and do not display the 'pen icon' linked to "Edit at Wikidata"
Limiting the returned values[ویرایش]
Sometimes a property is expected to have a single value, such as خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P18), but may have multiple values on Wikidata. Setting |maxvals=1
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[ویرایش]
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 |linked=no
.
Unit abbreviations[ویرایش]
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 |unitabbr=true
.
Qualifiers[ویرایش]
A parameter |qual=
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 |qual=ALL
, then all of the qualifier values are returned. If the value is set to |qual=DATES
then the خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P580) and the خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P582) 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 |qsep=
(which may be enclosed in double-quotes, which are stripped out, so that spaces can be included). Setting the parameter |qsorted=yes
will sort the returned qualifier values alphanumerically.
Short form of parameters[ویرایش]
Some of the longer parameters may be abbreviated to make infobox designs more compact:
fwd → fetchwikidata
osd → onlysourced
spf → suppressfields
wdl → wdlinks
Wrapper template[ویرایش]
The template {{wdib}} can be used as a convenient wrapper for {{#invoke:WikidataIB |getValue}}
.
Other main functions[ویرایش]
Function getPreferredValue[ویرایش]
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[ویرایش]
- getCoords can also take a named parameter
|qid=
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 الگو: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
|suppressfields=
and|fetchwikidata=
Function getQualifierValue[ویرایش]
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
|1=
) - The target value for that property in
|pval=
- The qualifier ID for that target value in
|qual=
- 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
|onlysourced=
- Optional item ID for arbitrary access in
|qid=
- The same parameters to format output as in getValue
Example of getQualifierValue[ویرایش]
In خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q1513315) there is a property خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P793), which has a value خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q385378). That has two qualifiers, خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P580) and خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P582). To get the start date:
{{#invoke:WikidataIB |getQualifierValue |P793 |pval=Q385378 |qual=P580 |name=xyz |fetchwikidata=ALL }}
In تلسکوپ قطب جنوب it returns:
- خطای لوآ در خط 171: attempt to index field 'wikibase' (a nil value).
Function getValueByQual[ویرایش]
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
|1=
) - The property ID for a qualifier (or "ALL" or "DATES") in
|qualID=
- The Wikibase-entity ID of a value for that qualifier in
|qvalue=
- 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
|onlysourced=
- Optional item ID for arbitrary access in
|qid=
- The same parameters to format output as in getValue
Example of getValueByQual[ویرایش]
In خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q10990) there is a property خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P443) that has multiple values, each of which has a qualifier خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P407). We can return the property value whose qualifier has the value خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q7979)
{{#invoke:WikidataIB |getValueByQual |qid=Q10990 |P443 |qualID=P407 |qvalue=Q7979 |fwd=ALL |osd=no |noicon=true}}
→ خطای اسکریپتی: پودمان «WikidataIB/sandbox» وجود ندارد.
Function getValueByLang[ویرایش]
The getValueByLang function returns the value of a property which has a qualifier خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P407) whose value has the given language code. The parameters are:
- The property ID passed in the unnamed parameter (or
|1=
) - The MediaWiki language code to match the language whose code is given by
|lang=xx[-yy]
. 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
|onlysourced=
- Optional item ID for arbitrary access in
|qid=
- The same parameters to format output as in getValue
Utility functions[ویرایش]
Function getLink[ویرایش]
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: خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q29016906) and خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q3621491)
{{#invoke:WikidataIB |getLink |Q29016906}}
→ خطای لوآ در خط 537: attempt to index field 'wikibase' (a nil value).{{#invoke:WikidataIB |getLink |Q3621491}}
→ خطای لوآ در خط 537: attempt to index field 'wikibase' (a nil value).
Function getLabel[ویرایش]
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: خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q29016906) and خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q3621491)
{{#invoke:WikidataIB |getLabel |Q29016906}}
→ خطای لوآ در خط 110: attempt to index field 'wikibase' (a nil value).{{#invoke:WikidataIB |getLabel |Q3621491}}
→ خطای لوآ در خط 110: attempt to index field 'wikibase' (a nil value).
Function getAT[ویرایش]
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: خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q29016906) and خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q3621491)
{{#invoke:WikidataIB |getAT |Q29016906}}
→ خطای لوآ در خط 565: attempt to index field 'wikibase' (a nil value).{{#invoke:WikidataIB |getAT |Q3621491}}
→ خطای لوآ در خط 565: attempt to index field 'wikibase' (a nil value).
Function getDescription[ویرایش]
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: خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q29016906) and خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q3621491)
{{#invoke:WikidataIB |getDescription |qid=Q29016906 |wikidata}}
→ خطای اسکریپتی: تابع «getDescription» وجود ندارد.{{#invoke:WikidataIB |getDescription |qid=Q29016906 |A painting}}
→ خطای اسکریپتی: تابع «getDescription» وجود ندارد.{{#invoke:WikidataIB |getDescription |qid=Q29016906 |none}}
→ خطای اسکریپتی: تابع «getDescription» وجود ندارد.{{#invoke:WikidataIB |getDescription |qid=Q3621491 |wikidata}}
→ خطای اسکریپتی: تابع «getDescription» وجود ندارد.{{#invoke:WikidataIB |getDescription |qid=Q3621491 |A profession}}
→ خطای اسکریپتی: تابع «getDescription» وجود ندارد.{{#invoke:WikidataIB |getDescription |qid=Q3621491 |none}}
→ خطای اسکریپتی: تابع «getDescription» وجود ندارد.
Function formatDate[ویرایش]
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 BCE{{#invoke:WikidataIB |formatDate | 1 August 30 BCE |bc=BC |df=mdy}}
→ August 1, 30 BC- df = "dmy" / "mdy" / "y" - default is "dmy"
- bc = "BC" / "BCE" - default is "BCE"
Function checkBlacklist[ویرایش]
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}}
→ blacklisted{{#if:{{#invoke:WikidataIB |checkBlacklist |name=birth_place |suppressfields=residence; nationality; citizenship}} | not blacklisted | blacklisted}}
→ not blacklisted
Function emptyor[ویرایش]
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[ویرایش]
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[ویرایش]
- getQid works with the current page and its associated Wikidata entry.
- It returns qid, if supplied as the first unnamed parameter or as
|qid=
; - failing that, the Wikidata entity ID of the "category's main topic (P301)", if it exists;
- failing that, the Wikidata entity ID associated with the current page, if it exists;
- otherwise, nothing
Function examine[ویرایش]
examine provides a dump of the entire property given in the first unnamed parameter (or in |pid=
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 پودمان:Wikidata function, but only loads a single claim, rather than the whole Wikidata entry.
- Example:
{{#invoke:WikidataIB |examine |qid=Q1396889 |P50}}
Function url2[ویرایش]
url2 takes a parameter url= that is a proper url and formats it for use in an infobox.
Examples: خطای اسکریپتی: پودمان «Template test case» وجود ندارد.خطای اسکریپتی: پودمان «Template test case» وجود ندارد.خطای اسکریپتی: پودمان «Template test case» وجود ندارد.خطای اسکریپتی: پودمان «Template test case» وجود ندارد.
Comparison with output of {{URL}}: خطای اسکریپتی: پودمان «Template test case» وجود ندارد.خطای اسکریپتی: پودمان «Template test case» وجود ندارد.خطای اسکریپتی: پودمان «Template test case» وجود ندارد.خطای اسکریپتی: پودمان «Template test case» وجود ندارد.
Coding into an infobox[ویرایش]
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 خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (P50).
The name of the field is passed in |name=
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 |suppressfields=author
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 |author=جرج اورول
, for example, in the infobox. It also accepts |authors=
. If the name of the field is on the whitelist, e.g. |fetchwikidata=author; genre; pub_date; pages; dewey; congress
, 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, |fetchwikidata=ALL
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 پودمان: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 خطای لوآ در پودمان:Wikibase در خط 40: attempt to index field 'wikibase' (a nil value). (Q1396889) produces:- خطای لوآ در خط 171: attempt to index field 'wikibase' (a nil value).
Example of calls in an infobox[ویرایش]
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 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 |list=hlist
where a series of short words is expected; whereas another field could use |list=ubl
where an unbulleted vertical list of several words on each line is required.
Coordinates[ویرایش]
The getCoords call will display the output of الگو: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[ویرایش]
Since the parameter |fetchwikidata=
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 |fetchwikidata=ALL
, 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 |suppressfields=
to the list of unwanted fields.
Verifiability[ویرایش]
Where it will always be essential for a particular field to only contain values that are referenced, use getValue
, making sure that |onlysourced=
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 |onlysourced=no
. 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.
Helper templates[ویرایش]
- الگو:If then show
- tests whether the first unnamed parameter is not an empty string and returns it if it isn't. Otherwise it returns the second unnamed parameter. Optional third and fourth unnamed parameters provide a prefix and a suffix for the first parameter when returned. Useful when the first parameter is a call to Wikidata.
- Template:Ifnoteq then show
- tests whether the first unnamed parameter is equal to the second unnamed parameter and returns the third unnamed parameter if it does. Otherwise it returns the first unnamed parameter. This is useful when the first parameter is a
{{#invoke:
of a Lua module that returns a value for which a specific exception is required. - Template:If then wikilink
- tests whether the first unnamed parameter is not an empty string and if it isn't, it returns the parameter formatted as piped wiki-link using an optional namespace prefix.
- Template:Formatter link
- takes an external identifier code as
|code=
and uses a formatter url as|url=
to construct a link to the external resource, which uses the code as display. - Template:Emptyor
- tests a piece of text to ascertain whether it's effectively empty or contains some text. If the unnamed parameter consists only of html tags, punctuation (e.g. Wiki-markup) and whitespace, then Emptyor returns nothing; otherwise it returns the parameter unchanged. Wrapper for p.emptyor function.
Example of use: Infobox book[ویرایش]
This section is taken from Template:Infobox book/Wikidata/Sandbox/doc.
No Wikidata[ویرایش]
{{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 = [[جرج اورول]] | 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 = [[جرج اورول]] | country = United Kingdom | language = English | genre = Political satire }}
The blacklist and whitelist can be omitted if unused
All Wikidata[ویرایش]
{{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 |fetchwikidata=
parameter can be set to ALL to fetch all available fields.
Any field can be suppressed by naming it in |suppressfields=
, or overridden by supplying a local value.
Never display genre[ویرایش]
{{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[ویرایش]
{{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[ویرایش]
{{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[ویرایش]
- پودمان:Wikidata, handling Wikidata more basically
Tracking categories[ویرایش]
-- Module to try out use of a blacklist and whitelist for infobox fields
-- can take a named parameter |qid which is the Wikidata ID for the article. This will not normally be used
-- Fields in blacklist are never to be displayed, i.e. module must return nil in all circumstances
-- Fields in whitelist return local value if it exists or the Wikidata value otherwise
-- The name of the field that this function is called from is passed in named parameter |name
-- The name is compulsory when blacklist or whitelist is used, so the module returns nil if it is not supplied
-- blacklist is passed in named parameter |suppressfields
-- whitelist is passed in named parameter |fetchwikidata
local p = {}
local i18n =
{
["errors"] =
{
["property-not-found"] = "Property not found.",
["entity-not-found"] = "Wikidata entity not found.",
["unknown-claim-type"] = "Unknown claim type.",
["unknown-entity-type"] = "Unknown entity type.",
["qualifier-not-found"] = "Qualifier not found.",
["site-not-found"] = "Wikimedia project not found.",
["unknown-datetime-format"] = "Unknown datetime format.",
["local-article-not-found"] = "Article is available on Wikidata, but not on Wikipedia"
},
["months"] =
{
"January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"
}
}
-------------------------------------------------------------------------------
-- Private functions
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
-- formatDate takes 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
-- df = ["dmy" / "mdy" / "y"] default will be "dmy"
-- bc = ["BC" / "BCE"] default will be "BCE"
-- first the local version
local format_Date = function(datetime, dateformat, bc)
local datetime = datetime or "1 August 30 BCE" -- in case of nil value
-- chop off multiple vales and/or any hours, mins, etc.
-- keep anything before punctuation - we just want a single date:
local dateval = string.match( datetime, "[%w ]+")
local dateformat = string.lower(dateformat or "dmy") -- default to dmy
local bc = string.upper(bc or "") -- can't use nil for bc
-- we only want to accept two possibilities: BC or default to BCE
if bc=="BC" then
bc = " BC" -- prepend the space. **internationalise later**
else
bc = " BCE"
end
local postchrist = true -- start by assuming no BCE
local dateparts = {}
for word in string.gmatch(dateval, "%w+") do
if word == "BCE" or word == "BC" then -- **internationalise later**
postchrist = false
else
-- we'll keep the parts that are not 'BCE' in a table
dateparts[#dateparts + 1] = word
end
end
if postchrist then bc = "" end -- set AD dates to no suffix **internationalise later**
local sep = " " -- separator is nbsp
local fdate = table.concat(dateparts, " ") -- formatted date defaults to same order as input
-- if we have day month year, check dateformat
if #dateparts == 3 then
if dateformat == "y" then
fdate = dateparts[3]
elseif dateformat == "mdy" then
fdate = dateparts[2] .. sep .. dateparts[1] .. "," .. sep .. dateparts[3]
end
elseif #dateparts == 2 and dateformat == "y" then
fdate = dateparts[2]
end
return fdate .. bc
end
-------------------------------------------------------------------------------
-- parseParam takes a (string) parameter, e.g. from the list of frame arguments,
-- and makes "false", "no", and "0" into the (boolean) false
-- it makes the empty string and nil into the (boolean) value passed as default
-- allowing the parameter to be true or false by default.
local parseParam = function(param, default)
if param and (#param > 0) then
param = param:lower()
if (param == "false") or (param == "no") or (param == "0") then
return false
else
return true
end
else
return default
end
end
-------------------------------------------------------------------------------
-- The label in a Wikidata item is subject to vulnerabilities
-- that an attacker might try to exploit.
-- It needs to be 'sanitised' by removing any wikitext before use.
-- If it doesn't exist, just return the id for the item
local labelOrId = function (id)
local label = mw.wikibase.label(id)
if label then
return mw.text.nowiki(label)
else
return id
end
end
-------------------------------------------------------------------------------
-- sourced takes a table representing a statement that may or may not have references
-- it counts how many references are sourced to something not contianing the word "wikipedia"
-- the reference string "ref" is available for debugging
-- it returns a boolean = true if there are any sourced references.
local sourced = function(claim)
local refs = 0
if claim.references then
for kr, vr in pairs(claim.references) do
local ref = mw.wikibase.renderSnaks(vr.snaks)
if not ref:find("Wikipedia") then refs = refs + 1 end
end
end
return refs > 0
end
-- parseInput processes the Q-id , the blacklist and the whitelist
-- if an input parameter is supplied, it returns that and ends the call.
-- it returns a boolean indicating whether or not the call should continue
-- and an object containing all of the Wikidata for the Qid supplied or the current page
local parseInput = function(frame, input_parm, property_id)
-- can take a named parameter |qid which is the Wikidata ID for the article.
-- This will not normally be used because it's an expensive call.
local qid = frame.args.qid
if qid and (#qid == 0) then qid = nil end
-- The blacklist is passed in named parameter |suppressfields
local blacklist = frame.args.suppressfields
-- The whitelist is passed in named parameter |fetchwikidata
local whitelist = frame.args.fetchwikidata
-- The name of the field that this function is called from is passed in named parameter |name
local fieldname = frame.args.name
if blacklist then
-- The name is compulsory when blacklist is used, so return nil if it is not supplied
if not fieldname or (#fieldname == 0) then return false, nil, nil end
-- If this field is on the blacklist, then return nil
if blacklist:find(fieldname) then return false, nil, nil end
end
-- If we got this far then we're not on the blacklist
-- The blacklist overrides any locally supplied parameter as well
-- If a non-blank input parameter was supplied return it
if input_parm then return false, input_parm, nil end
-- Otherwise see if this field is on the whitelist:
if not (whitelist and (whitelist == 'ALL' or whitelist:find(fieldname))) then
-- not on the whitelist so just return what should be a nil input parameter
return false, input_parm, nil
end
-- See what's on Wikidata:
local entity = mw.wikibase.getEntityObject(qid)
if entity and entity.claims then
local props = entity.claims[property_id]
if props and props[1] then
return true, entity, props
end
end
-- no property on Wikidata
return false, input_parm, nil
end
local function _getvalue(frame, entity, props, filter, propertyID)
-- onlysourced is a boolean passed to return only values sourced to other than Wikipedia
-- if nothing or an empty string is passed set it true
-- if "false" or "no" or "0" is passed set it false
local onlysrc = parseParam(frame.args.onlysourced, true)
-- noicon is a boolean passed to suppress the trailing "edit at Wikidata" icon
-- for use when the value is processed further by the infobox
-- if nothing or an empty string is passed set it false
-- if "false" or "no" or "0" is passed set it false
local noic = parseParam(frame.args.noicon, false)
-- wdlinks is a boolean passed to enable links to Wikidata when no article exists
-- if nothing or an empty string is passed set it false
-- if "false" or "no" or "0" is passed set it false
local wdl = parseParam(frame.args.wdlinks, false)
-- sorted is a boolean passed to enable sorting of the values returned
-- if nothing or an empty string is passed set it false
-- if "false" or "no" or "0" is passed set it false
local sorted = parseParam(frame.args.sorted, false)
-- separator is a string that is used to separate multiple returned values
-- if nothing or an empty string is passed set it to the default
-- any double-quotes " are stripped out, so that spaces may be passed
-- e.g. |sep=" - "
local sepdefault = ", " -- **internationalise later**
local separator = frame.args.sep or ""
separator = string.gsub(separator, '"', '')
if #separator == 0 then
separator = sepdefault
end
-- list is a string that may be "", "hlist" or "ubl"
-- this controls whether multiple values are output as comma-separated
-- as a horizontal list (hlist) or unbulleted list (ubl)
local list = frame.args.list or ""
if list~="hlist" and list~="ubl" then list = "" end
-- So now we have something to return: deal with (1) a Wikibase-entity; (3) a date; (3) anything else
local lang = mw.language.getContentLanguage().code
local thisQid = entity.id
-- table 'out' is going to to store the return value(s):
local out = {}
local icon = " [[File:Blue pencil.svg |frameless |text-top |10px |alt=Edit this on Wikidata |link=https://www.wikidata.org/wiki/" .. thisQid .. "?uselang=" .. lang .. "#" .. propertyID .. "|Edit this on Wikidata]]"
if props[1].mainsnak.datatype == "wikibase-item" then
-- it's wiki-linked value, so output as link if possible
for k, v in pairs(props) do
if filter(v) and ((onlysrc == false) or sourced(v)) then -- has valid refs or all values required
if v.mainsnak.snaktype == "somevalue" then -- check for value is unknown
out[#out + 1] = "Unknown"
elseif v.mainsnak.snaktype == "novalue" then -- check for value is none
-- out[#out + 1] = "No value" -- don't return a value for this
else
local qnumber = "Q" .. v.mainsnak.datavalue.value["numeric-id"]
local sitelink = mw.wikibase.sitelink(qnumber)
local label = labelOrId(qnumber)
if sitelink then
out[#out + 1] = "[[" .. sitelink .. "|" .. label .. "]]"
else
-- no sitelink, so check first for a redirect with that label
local artitle = mw.title.new(label, 0)
if artitle.id > 0 then
if artitle.isRedirect then
-- no sitelink, but there's a redirect with the same title as the label
-- let's link to that
out[#out + 1] = "[[" .. label .. "|" .. label .. "]]"
else
-- no sitelink and not a redirect but an article exists with the same title as the label
-- that's probably a dab page, so output the plain label
out[#out + 1] = label
end
else
-- no article or redirect with the same title as the label
if wdl then
-- show that there's a Wikidata entry available
out[#out + 1] = "[[:d:Q" .. v.mainsnak.datavalue.value["numeric-id"] .. "|" .. label .. "]] <span title='" .. i18n["errors"]["local-article-not-found"] .. "'>[[File:Wikidata-logo.svg|16px|alt=|link=]]</span>"
else
-- no wikidata links required, so just give the plain label
out[#out + 1] = label
end
end
end
end
end
end
elseif props[1].mainsnak.datatype == "time" then
-- it's a date value, so output according to formatting preferences
for k, v in pairs(props) do
-- check for references, and count valid references
if filter(v) and ((onlysrc == false) or sourced(v)) then
if v.mainsnak.snaktype == "somevalue" then -- check for value is unknown
out[#out + 1] = "Unknown"
elseif v.mainsnak.snaktype == "novalue" then -- check for value is none
-- out[#out + 1] = "No value" -- don't return a value for this
else
local timestamp = v.mainsnak.datavalue.value.time
-- A year can be stored like this: "+1872-00-00T00:00:00Z",
-- which is processed here as if it were the day before "+1872-01-01T00:00:00Z",
-- and that's the last day of 1871, so the year is wrong.
-- So fix the month 0, day 0 timestamp to become 1 January instead:
timestamp = timestamp:gsub("%-00%-00T", "-01-01T")
local dateprecision = v.mainsnak.datavalue.value.precision
local dateformat = "y"
local fpvdate = tonumber(timestamp:sub(2, 5))
if timestamp:sub(1, 1) == "-" then
fpvdate = fpvdate .. " BCE"
end
if dateprecision > 9 then -- add month
fpvdate = i18n.months[tonumber(timestamp:sub(7, 8))] .. " " .. fpvdate
dateformat = frame.args.df
end
if dateprecision > 10 then -- add day
fpvdate = tonumber(timestamp:sub(10, 11)) .. " " .. fpvdate
end
out[#out+1] = format_Date(fpvdate, dateformat, frame.args.bc)
end -- check for unknown value
end -- check for sourced
end -- loop through k-v pairs
else
-- not a linkable article title or a date
-- this needs to be expanded to cater for multiple values
local reflist = ""
local refs = 0
for k, v in pairs(props) do
-- check for references,
-- construct a reference list for debugging
-- and count valid references
if v.references then
for kr, vr in pairs(v.references) do
local ref = mw.wikibase.renderSnaks(vr.snaks)
reflist = reflist .. " <span style='color:#0DD;'>" .. ref .. "</span>"
if not ref:find("Wikipedia") then refs = refs + 1 end
end
end
end
local propertyValue = entity:formatPropertyValues(propertyID).value
if (refs > 0) or (onlysrc == false) then -- has valid refs or all values required
out[#out+1] = propertyValue
end
end
-- if there's anything to return, then return a list
-- comma-separated by default, but may be specified by the sep parameter
-- optionally specify a hlist or
if #out > 0 then
if sorted then table.sort(out) end
if list == "hlist" then
return frame:expandTemplate{title = 'Hlist', args = out}
elseif list == "ubl" then
return frame:expandTemplate{title = 'Unbulleted list', args = out}
else
if noic then
return table.concat(out, separator)
else
return table.concat(out, separator) .. icon
end
end
else
return nil -- no items had valid reference
end
end
-------------------------------------------------------------------------------
-- Public functions
-------------------------------------------------------------------------------
-- getValue is used to get a value, or a comma separated list of them if multiple values exist
--
p.getValue = function(frame)
local propertyID = mw.text.trim(frame.args[1] or "")
-- There may be a local parameter supplied, if it's blank, set it to nil
local input_parm = mw.text.trim(frame.args[2] or "")
if input_parm and (#input_parm == 0) then input_parm = nil end
local success, errorOrEntity, props = parseInput(frame, input_parm, propertyID)
if not success then
return errorOrEntity
else
entity = errorOrEntity
end
local function filter(claim)
return true
end
return _getvalue(frame, entity, props, filter, propertyID)
end
-------------------------------------------------------------------------------
-- getPreferredValue is used to get a value, or a comma separated list of them if multiple values exist
-- If preferred ranks are set, it will return those values, otherwise values with normal ranks
--
p.getPreferredValue = function(frame)
local propertyID = mw.text.trim(frame.args[1] or "")
-- There may be a local parameter supplied, if it's blank, set it to nil
local input_parm = mw.text.trim(frame.args[2] or "")
if input_parm and (#input_parm == 0) then input_parm = nil end
local success, errorOrEntity, props = parseInput(frame, input_parm, propertyID)
if not success then
return errorOrEntity
else
entity = errorOrEntity
end
local prefflag = false
for k, v in pairs(props) do
if v.rank == "preferred" then
prefflag = true
break
end
end
local function filter(claim)
return claim.rank == "preferred" or prefflag == false
end
return _getvalue(frame, entity, props, filter, propertyID)
end
-------------------------------------------------------------------------------
-- getSourcedValue is used to get a value, or a comma separated list of them if multiple values exist
-- but only values that are sourced are returned
-- redundant to getValue with onlysourced=true but kept for backwards compatibility
-- now defined via getValue
--
p.getSourcedValue = function(frame)
frame.args.onlysourced = "yes"
return p.getValue(frame)
end
-------------------------------------------------------------------------------
-- getCoords is used to get coordinates for display in an infobox
-- whitelist and blacklist are implemented
-- optional 'display' parameter is allowed, defaults to "inline, title"
--
p.getCoords = function(frame)
local propertyID = "P625"
local input_parm = mw.text.trim(frame.args[1] or "")
if input_parm and (#input_parm == 0) then input_parm = nil end
-- if there is a 'display' parameter supplied, use it
-- otherwise default to "inline, title"
local disp = frame.args.display
if (not disp) or (#disp == 0) then
disp = "inline, title"
end
local success, errorOrEntity = parseInput(frame, input_parm, property_id)
if not success then
return errorOrEntity
else
local entity = errorOrEntity
local lat_long = {}
local coords = entity:formatPropertyValues(propertyID).value
-- the latitude and longitude are returned like this: nn°nn'nn.n"
-- using html entities with hex values really screws up parsing the numbers - thanks devs
local lat = mw.ustring.match(coords, "^[^,]*") -- everything from the start to before the comma
local long = mw.ustring.match(coords, "[^ ]*$") -- everything from after the space to the end
lat = lat:gsub("&#%d%d;", ":") -- clean out the html entities
long = long:gsub("&#%d%d;", ":") -- clean out the html entities
-- read the latitude numbers into a table
for num in mw.ustring.gmatch(lat, "%d+%.?%d*") do
lat_long[#lat_long + 1] = num
end
-- add the N/S
lat_long[#lat_long + 1] = lat:sub(-1)
-- read the longitude numbers into a table
for num in mw.ustring.gmatch(long, "%d+%.?%d*") do
lat_long[#lat_long + 1] = num
end
-- add E/W for long
lat_long[#lat_long + 1] = long:sub(-1)
-- add named parameter for display
lat_long["display"] = disp
-- invoke template Coord with the values stored in the table
return frame:expandTemplate{title = 'coord', args = lat_long}
end
end
-------------------------------------------------------------------------------
-- getQualifierValue is used to get a formatted value of a qualifier
--
-- The call needs: a property (the unnamed parameter or 1=)
-- a target value for that property (pval=)
-- a qualifier for that target value (qual=)
-- The usual whitelisting and blacklisting of the property is implemented
-- The boolean onlysourced= parameter can be set to return nothing
-- when the property is unsourced (or only sourced to Wikipedia)
--
p.getQualifierValue = function(frame)
local propertyID = mw.text.trim(frame.args[1] or "")
-- The PropertyID of the target value of the property
-- whose qualifier is to be returned is passed in named parameter |pval=
local propvalue = frame.args.pval
-- The PropertyID of the qualifier
-- whose value is to be returned is passed in named parameter |qual=
local qualifierID = frame.args.qual
-- onlysourced is a boolean passed to return qualifiers
-- only when property values are sourced to something other than Wikipedia
-- if nothing or an empty string is passed set it false
-- if "false" or "no" or 0 is passed set it false
local onlysrc = parseParam(frame.args.onlysourced,false)
local success, errorOrEntity, props = parseInput(frame,nil, propertyID)
if not success then
return errorOrEntity
else
local entity = errorOrEntity
-- Scan through the values of the property
-- we want something like property is P793, significant event (in propertyID)
-- whose value is something like Q385378, construction (in propvalue)
-- then we can return the value(s) of a qualifier such as P580, start time (in qualifierID)
for k1, v1 in pairs(props) do
if v1.mainsnak.snaktype == "value" and v1.mainsnak.datavalue.type == "wikibase-entityid" then
-- It's a wiki-linked value, so check if it's the target (in propvalue)
-- and if it has qualifiers
if v1.mainsnak.datavalue.value.id == propvalue and v1.qualifiers then
if (onlysrc == true) and not sourced(v1) then
return
end
-- if we've got this far, we have a (sourced) claim with qualifiers
-- which matches the target, so find the value(s) of the qualifier we want
local quals = v1.qualifiers[qualifierID]
local out = {}
if quals then
if quals[1].datatype == "wikibase-item" then
for k2, v2 in pairs(quals) do
local valueID = v2.datavalue.value.id
local sitelink = mw.wikibase.sitelink(valueID)
local label = labelOrId(valueID)
if sitelink then
out[#out + 1] = "[[" .. sitelink .. "|" .. label .. "]]"
else
out[#out + 1] = "[[:d:" .. valueID .. "|" .. label .. "]] <span title='" .. i18n["errors"]["local-article-not-found"] .. "'>[[File:Wikidata-logo.svg|16px|alt=|link=]]</span>"
end
end
return table.concat(out, ", ")
else
return mw.wikibase.renderSnaks(quals)
end
end
end
end -- of loop through values of propertyID
end
end
return nil
end
-------------------------------------------------------------------------------
-- getLink returns the label for a Qid wiki-linked to the local article (if the article exists)
-- if label doesn't exist, it returns the Qid wiki-linked to the local article (if the article exists)
--
p.getLink = function(frame)
local itemID = mw.text.trim(frame.args[1] or "")
if itemID == "" then return end
local sitelink = mw.wikibase.sitelink(itemID)
local label = labelOrId(itemID)
if sitelink then
return "[[" .. sitelink .. "|" .. label .. "]]"
else
return label
end
end
-------------------------------------------------------------------------------
-- getLabel returns the label for a Qid
-- if label doesn't exist, it returns the Qid
--
p.getLabel = function(frame)
local itemID = mw.text.trim(frame.args[1] or "")
if itemID == "" then return end
return labelOrId(itemID)
end
-------------------------------------------------------------------------------
-- getAT returns the article title for a Qid
-- or nothing if it doesn't exist
--
p.getAT = function(frame)
local itemID = mw.text.trim(frame.args[1] or "")
if itemID == "" then return end
return mw.wikibase.sitelink(itemID)
end
-------------------------------------------------------------------------------
-- formatDate is a wrapper to export the private function format_Date
--
p.formatDate = function(frame)
return format_Date(frame.args[1], frame.args.df, frame.args.bc)
end
-------------------------------------------------------------------------------
-- checkBlacklist allows a test to check whether a named field is suppressed
-- {{#if:{{#invoke:WikidataIB |checkBlacklist |name=Joe |suppressfields=Dave; Joe; Fred}} | not blacklisted | blacklisted}}
-- displays "blacklisted"
-- {{#if:{{#invoke:WikidataIB |checkBlacklist |name=Jim |suppressfields=Dave; Joe; Fred}} | not blacklisted | blacklisted}}
-- displays "not blacklisted"
--
p.checkBlacklist = function(frame)
local blacklist = frame.args.suppressfields
local fieldname = frame.args.name
if blacklist and fieldname then
if blacklist:find(fieldname) then return nil end
return true
end
end
return p