Module:WикидатаИБ/доc
This is the documentation page for Modul:WikidataIB
| Тҳис модуле ис субжеcт то паге протеcтион. Ит ис а ҳигҳлй висибле модуле ин усе бй а верй ларге нумбер оф артиcлес, ор ис субститутед верй фреқуэнтлй. Беcаусе вандалисм ор мистакес wоулд аффеcт манй пагес, анд эвен тривиал эдитинг мигҳт cаусе субстантиал лоад он тҳе серверс, ит ис ис протеcтед фром эдитинг. |
| Бу модулдан кўплаб саҳифада фойдаланилган. Тажриба ўтказиш учун модулнинг /қумлоқ ёки /тест осцаҳифаларидан фойдаланинг. Ўзгаришлар киритишдан аввал бошқа фойдаланувчилар билан муҳокама қилиш ҳақида ўйлаб кўринг. |
| Фор а море усер-фриэндлй wраппер оф тҳис модуле сеэ {{wдиб}}. |
Тҳис модуле ис интендед то бе усед инсиде {{инфобох}} (леттерс WикидатаИБ станд фор Инфо Бох, ҳенcе тҳе наме) ор отҳер темплатес анд десигнед спеcифиcаллй то аллоw эдиторс оф ан артиcле (ас оппосед то эдиторс оф тҳе инфобох тҳе артиcле усес) то cонтрол wҳетҳер Wикидата валуэс аре дисплаед.
Оне оф тҳе тwо сандбохес шоулд бе усед фор тестинг анйтҳинг отҳер тҳан тривиал амендменц.
Тест эхамплес фор тҳе маин модуле анд тҳе тwо сандбохес аре аваилабле.
| Модуле | Тест cасес | |
|---|---|---|
| Маин | Модуле:WикидатаИБ | Модуле талк:WикидатаИБ/тестинг |
| сандбох | Модуле:WикидатаИБ/сандбох (Андоза:Cомпаре пагес) | Модуле талк:WикидатаИБ/сандбох/тестинг (Андоза:Cомпаре пагес) |
| сандбох1 | Модуле:WикидатаИБ/сандбох1 (Андоза:Cомпаре пагес) | Модуле талк:WикидатаИБ/сандбох1/тестинг (Андоза:Cомпаре пагес) |
Овервиэw
Тҳе модуле провидес тҳесе cаллс спеcифиcаллй фор усе ин инфобохес ат пресент:
getValue- маин cалл, усед то гет тҳе валуэ(с) оф а гивен пропертйgetQualifierValue- гивен: (1) а пропертй; (2) иц валуэ; (3) а қуалифиэр'с пропертйИД, ретурнс валуэс wҳич матчgetValueByQualгец тҳе валуэ оф а пропертй wҳич ҳас а қуалифиэр wитҳ а гивен энтитй валуэgetValueByLangгец тҳе валуэ оф а пропертй wҳич ҳас а қуалифиэр П407("лангуаге оф wорк ор наме") wҳосе валуэ ҳас тҳе гивен лангуаге cодеgetValueByRefSourceгец тҳе валуэ оф а пропертй wҳич ҳас а референcе "статед ин" (П248) wҳосе валуэ ҳас тҳе гивен энтитй-ИДgetPropOfPropиф тҳе валуэ(с) оф проп1 аре оф тйпе "wикибасе-итем" тҳен ит ретурнс тҳе валуэ(с) оф проп2 оф эач оф тҳосе wикибасе-итемсgetAwardCatиф тҳе итем ҳас валуэс оф П166 (аwард реcеивед), тҳен ит эхаминес эач оф тҳосе аwардс фор П2517 (cатегорй фор реcипиэнц оф тҳис аwард) анд ит ретурнс тҳе cорреспондинг cатегорй, wитҳ тҳе итем'с П734 (фамилй наме) ас сорт кей, ор но сорт кей иф тҳере ис но фамилй намеgetIntersectCatфор эач валуэ оф тҳе проп1 ит фетчес тҳе валуэ'с маин cатегорй анд тҳен эач валуэ оф проп2, тҳен ит ретурнс алл оф тҳе cатегориэс репресентинг тҳе интерсеcтион оф тҳосе пропертиэсgetSumOfPartsсcанс тҳе пропертй 'ҳас парт' (П527) фор валуэс матчинг а лист, Иф тҳе матчед валуэс ҳаве а қуалифиэр 'қуантитй' (П1114), тҳосе қуантитиэс аре суммед анд ретурнед (бут зеро ретурнс нил)getCoords- гец cоординатес анд пассес тҳем тҳроугҳ {{Cоорд}}getPreferredValue- Депреcатед бут ретаинед фор баcкwард cомпатибилитй. Усе тҳе|getValue|rank=bestпараметерс инстеад.
Тҳе обсолете cалл гетСоурcедВалуэ ҳас ноw беэн ремовед ас ит ис редундант то гетВалуэ wҳич cан до тҳе саме жоб усинг тҳе |онлйсоурcед=труэ параметер (wҳич ис сет бй дефаулт).
Утилитиэс фунcтионс
getLinkиф тҳере ис а сителинк то ан артиcле он тҳе лоcал Зиё, ит ретурнс а линк то тҳе артиcле wитҳ тҳе Wикидата лабел ас тҳе дисплаед техт. Иф тҳере ис но сителинк, ит ретурнс тҳе лабел ас плаин техт. Иф тҳере ис но лабел ин тҳе лоcал лангуаге, ит ретурнс тҳе энтитй-ИДgetAT(Артиcле Титле) Иф тҳере ис а сителинк то ан артиcле он тҳе лоcал Зиё, ит ретурнс тҳе сителинк ас плаин техт, отҳерwисе нотҳингgetSiteLinkгец тҳе плаин техт линк то ан артиcле он а гивен wикиgetLabelретурнс тҳе Wикидата лабел фор тҳе лоcал лангуаге ас плаин техт. Иф тҳере ис но лабел ин тҳе лоcал лангуаге, ит ретурнс тҳе энтитй-ИДgetAllLabelsфетчес тҳе сет оф лабелс анд формац ит фор дисплай ас wикитехтlabeloridретурнс тҳе лабел wитҳ алл wикитехт ремовед, ор тҳе энтитй-ИД иф но лабелgetDescriptionретурнс тҳе артиcле десcриптион фор тҳе Wикидата энтитй иф тҳе лоcал параметер ис "Wикидата".getAllDescriptionsфетчес тҳе сет оф десcриптионс анд формац ит фор дисплай ас wикитехтgetAliasesретурнс тҳе алиасес фор тҳе энтитй ин тҳе cуррент ор гивен лангуагеgetAllAliasesфетчес тҳе сет оф алиасес анд формац ит фор дисплай ас wикитехтpageIdретурнс тҳе cоннеcтед Wикидата паге ид (энтитй-ИД, Қ-нумбер) оф тҳе cуррент пагеformatDateтакес а датетиме оф тҳе усуал формат фром мw.wикибасе.энтитй:форматПропертйВалуэс анд формац ит аccординг то тҳе дф (дате формат) анд бc параметерсformatNumberформац а нумбер аccординг то тҳе супплиэд лангуаге cодеcheckBlacklistретурнс труэ иф тҳе фиэлд ис нот блаcклистед (и.э. аллоwед)emptyorретурнс нил иф тҳе параметер ис жуст пунcтуатион, wҳитеспаcе ор ҳтмл тагс, отҳерwисе ретурнс тҳе аргумент унчангедgetLangретурнс тҳе МедиаWики лангуаге cоде ор тҳе фулл лангуаге наме оф тҳе cуррент cонтентgetItemLangCodeлоокс фор cоунтрй (П17), тҳен фор тҳат cоунтрй'с оффиcиал лангуаге (П37), анд ретурнс иц лангуаге cоде (П424)findLanguageретурнс (1) супплиэд лангуаге иф валид; ор (2) тҳе усер'с сет лангуаге; ор (3) тҳе лангуаге оф тҳе cуррент wикиgetQidретурнс (1) тҳе энтитй-ИД, иф супплиэд; ор (2) тҳе энтитй ИД оф тҳе "cатегорй'с маин топиc (П301)"; ор (3) тҳе энтитй ИД ассоcиатед wитҳ тҳе cуррент паге; ор (4) нотҳингfollowQidгивен а лист оф пропертиэс, лоокс фор эач пропертй ин турн анд ретурнс тҳе энтитй-ИД оф тҳе фирст валуэ тҳат матчес (оптионаллй, ретурнс алл энтитй-ИДс тҳат матч)getGlobeретурнс тҳе энтитй-ИД оф тҳе глобе усед ин П625 (cоординате лоcатион), ор нил иф тҳере исн'т онеgetCommonsLinkретурнс оне оф тҳе фоллоwинг ин ордер оф преференcе: тҳе Cоммонс сителинк оф тҳе линкед Wикидата итем; тҳе Cоммонс сителинк оф тҳе топиc'с маин cатегорй оф тҳе линкед Wикидата итем;siteIDретурнс тҳе роот оф тҳе глобалСитеИД, э.г. "эн" фор "энwики", "энwикисоурcе", "эн-гб", этc.projIDсаме ас ситеИДlocationсcанс фром тҳе cуррент лоcатион упwардс алонг тҳе чаин оф ҳигҳер-левел лоcатионс, ретурнинг эач оне унтил ит реачес а cоунтрйexamineретурнс а форматтед думп оф тҳе гивен пропертйurl2такес а параметер тҳат ис а пропер урл анд формац ит фор усе ин ан инфобох; ит аccепц иц оwн оутпут ас инпутgetWebsiteфетчес тҳе Оффиcиал wебсите (П856) анд формац ит фор усе ин ан инфобохcheckvalueлоокс тҳроугҳ а пропертй фор а гивен энтитй-ИД ас иц валуэ анд ретурнс тҳат энтитй-ИД иф фоунд; отҳерwисе нилcheckValidityретурнс wҳетҳер тҳе фирст уннамед параметер репресенц а валид энтитй-идshowNoLinksдисплайс тҳе артиcле титлес тҳат шоулд нот бе линкед
Эхамплес оф cаллс
{{#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>}}
Фунcтион гетВалуэ
Параметерс то гетВалуэ
| Наме | Алиас | Фунcтион | Дефаулт | ||||
|---|---|---|---|---|---|---|---|
| (фирст уннамед) | 1 | Тҳе пропертй-ИД wҳосе валуэс аре ретурнед. Реқуиред. | |||||
| (сеcонд уннамед) | 2 | А лоcаллй супплиэд валуэ тҳат, иф ит ис нот эмптй, wилл бе ретурнед ин преференcе то тҳе валуэ он Wикидата. | эмптй | ||||
| қид | Тҳе Қ-нумбер (энтитй-ИД) оф тҳе энтитй тҳат тҳе пропертй белонгс то. Иф нот супплиэд ор эмптй, дефаулц то тҳе ассоcиатед Wикидата энтрй оф тҳе cуррент паге – усес мw.wикибасе.гетентитйИдФорCуррентПаге(). | Итем ид фор cуррент паге | |||||
| эид | Ан алтернативе то қид. Эхcепт фор eid, алл параметерс то гетВалуэ треат нил анд тҳе эмптй стринг тҳе саме. Со, сеттинг |х= гивес тҳе саме ресулт ас омиттинг тҳе параметер. Ҳоwевер, то провиде соме cомпатибилитй wитҳ отҳер модулес, усинг |эид= алwайс ретурнс ан эмптй стринг, wҳиле омиттинг eid аллоwс qid то wорк ас нормал.
|
Итем ид фор cуррент паге | |||||
| ранк | [Cасе инсенситиве] Wҳен сет то best, ретурнс преферред валуэс иф пресент, отҳерwисе ретурнс нормал валуэс. Wҳен сет то preferred ретурнс преферред валуэс. Wҳен сет то normal, ретурнс нормал валуэс. Wҳен сет то deprecated ретурнс депреcатед валуэс. Анй параметер валуэ бегиннинг wитҳ "б" ис "бест"; бегиннинг wитҳ "п" ис "преферред"; бегиннинг wитҳ "н" ис "нормал"; бегиннинг wитҳ "д" ис депреcатед. Мултипле валуэс аре аллоwед: "п н д" wоулд ретурн алл ранкс. "Бест" оверридес тҳе отҳер флагс. Отҳер валуэс аре игноред анд иф но ранкс аре реқуэстед, преферред анд нормал аре ретурнед.
|
преферред анд нормал | |||||
| қуал | А пунcтуатион-сепаратед лист оф пропертй-ИДс оф қуалифиэрс тҳат аре то бе ретурнед ин парентҳесес афтер тҳе пропертй. Сеттинг qual=ALL ретурнс алл қуалифиэрс. Сеттинг qual=DATES ретурнс
|
ноне | |||||
| қуалсонлй | қо | А боолеан wҳич энаблес тҳе дисплай оф жуст тҳе қуалифиэр(с), wитҳоут тҳе пропертй валуэ ор парентҳесес. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | ||||
| фетчwикидата | фwд | Лист оф фиэлдс то фетч валуэс фром. ALL фетчес алл фиэлдс. А валуэ оф NONE ор бланк ор омиттинг тҳе параметер фетчес но фиэлдс.
|
ноне | ||||
| суппрессфиэлдс | спф | Лист оф фиэлдс wҳич wилл невер дисплай. Тҳис wилл эвен форcе а лоcал валуэ ин тҳе фиэлд нот то дисплай. | ноне | ||||
| наме | Наме оф тҳе фиэлд. Wҳен энcодинг ан инфобох, тҳис ис тҳе наме тҳат фетчwикидата анд суппрессфиэлдс wилл реcогнисе. Реқуиред иф фетчwикидата ор суппрессфиэлдс ис спеcифиэд (эхcепт wҳен fetchwikidata=ALL).
|
нил | |||||
| онлйсоурcед | осд | А боолеан wҳич wилл филтер оут Wикидата валуэс тҳат аре унсоурcед ор онлй соурcед то Wикипедиа. Тҳис 2018 РФC реқуирес тҳат Wикидата валуэс дисплаед ин артиcле инфобохес муст бе соурcед. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
труэ | ||||
| дф | Дате формат: май бе dmy (дай бефоре монтҳ) ор mdy (монтҳ бефоре дай) ор y (еар алоне).
|
дмй | |||||
| қдф | Дате формат оф қуалифиэрс. Иф омиттед, дефаулц то параметер df, ор "й" иф df ис алсо омиттед.
|
валуэ оф дф ор "й" | |||||
| бc | Формат оф тҳе БC/БCЕ суффих фор датес. | БCЕ | |||||
| плаиндате | пд | Стринг то модифй форматтинг оф датес. Сеттинг "труэ"/"ес"/"1" дисаблес аддинг "соурcинг cирумстанcес" (П1480) анд анй линкс. Сеттинг "адж" доэс тҳе саме бут усес тҳе аджеcтивал форм оф тҳе дате. | фалсе | ||||
| линкед | А боолеан тҳат энаблес тҳе линк то а лоcал паге виа иц сителинк он Wикидата. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
труэ | |||||
| дисплайтехт | дт | А стринг тҳат оверридес тҳе дисплаед техт оф а линкед итем иф ит ис нон-эмптй. | эмптй | ||||
| шортнаме | сн | А боолеан тҳат энаблес тҳе усе оф шортнаме (П1813) инстеад оф лабел фор а линкед итем. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | ||||
| уселабел | уселбл | А боолеан тҳат форcес тҳе дисплай оф тҳе лабел инстеад оф тҳе дисамбигуатед сителинк фор а линкед итем. Лабелс аре муч море проне то вандалисм тҳат сителинкс. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | ||||
| wдлинкс | wдл | А боолеан тҳат энаблес тҳе дисплай оф линкс то Wикидата wҳен но лоcал артиcле эхисц. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | ||||
| унитаббр | уаббр | А боолеан тҳат энаблес унит аббревиатионс фор cоммон униц. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | ||||
| cонверт | cонв | А боолеан тҳат энаблес пассинг оф қуантитиэс то Темплате:Cвт. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | ||||
| шоwуниц | су | А боолеан тҳат энаблес шоwинг униц фор қуантитиэс. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
труэ | ||||
| сcале | А стринг тҳат сец сcалинг фор формат оф қуантитиэс. Валуэс аре: "а"=аутоматиc; "0"=но сcалинг; "3"=тҳоусанд; "6"=миллион; "9"=биллион; "12"=триллион. | 0 | |||||
| махвалс | Сец тҳе махимум нумбер оф валуэс то бе ретурнед wҳен мултипле валуэс аре аваилабле. Сеттинг ит то 1 ис усефул wҳере тҳе ретурнед стринг ис усед wитҳин анотҳер cалл, э.г. имаге. Валуэс 0 анд эмптй ретурн алл валуэс.
|
0 (алл) | |||||
| cоллапсе | Сец тҳе махимум нумбер оф валуэс то бе ретурнед бефоре тҳе cонтент ис ауто-cоллапсед. Валуэс 0 анд эмптй аллоw алл cонтент то бе дисплаед унcоллапсед.
|
0 (алл) | |||||
| линкпрефих | лп | А линк префих тҳат ис препендед то тҳе линкед валуэ wҳен линкед. Апплиэс онлй то итемс тҳат ҳаве артиcлес анд то стрингс (э.г. урл). Ит триггерс линкинг оф стрингс. Анй доубле-қуотес " аре стриппед оут, со тҳат спаcес май бе пассед. | эмптй | ||||
| линкпостфих | А линк постфих тҳат ис аппендед то тҳе линкед валуэ wҳен линкед. Апплиэс онлй то итемс тҳат ҳаве артиcлес анд то стрингс (э.г. урл). Ит триггерс линкинг оф стрингс. Анй доубле-қуотес " аре стриппед оут, со тҳат спаcес май бе пассед. | эмптй | |||||
| префих | А префих тҳат ис препендед то тҳе дисплаед валуэ оф стрингс (э.г. урл). Анй доубле-қуотес " аре стриппед оут, со тҳат спаcес май бе пассед. | эмптй | |||||
| постфих | А постфих тҳат ис аппендед то тҳе дисплаед валуэ оф стрингс (э.г. урл). Анй доубле-қуотес " аре стриппед оут, со тҳат спаcес май бе пассед. | эмптй | |||||
| қлинкпрефих | қлп | Қуалифиэр линк префих (сеэ линкпрефих). | эмптй | ||||
| қлинкпостфих | Қуалифиэр линк постфих (сеэ линкпостфих). | эмптй | |||||
| қпрефих | Қуалифиэр префих (сеэ префих). | эмптй | |||||
| қпостфих | Қуалифиэр постфих (сеэ постфих). | эмптй | |||||
| сортед | А боолеан wҳич энаблес сортинг оф тҳе валуэс ретурнед. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | |||||
| қсортед | А боолеан wҳич энаблес сортинг оф тҳе қуалифиэр валуэс wитҳин эач итем ретурнед. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе | |||||
| ноиcон | А боолеан wҳич wилл суппресс тҳе траилинг "эдит ат Wикидата" пен-иcон. Усефул фор wҳен тҳе ретурнед валуэ ис то бе фуртҳер проcессед. Валуэс no, false анд 0 аре алл фалсе (и.э. шоwс тҳе иcон); анйтҳинг элсе ис труэ (и.э. суппрессес тҳе иcон).
|
фалсе | |||||
| лист | Тҳе наме оф а темплате тҳат тҳе лист оф мултипле валуэс ис тҳен пассед тҳроугҳ. Эхамплес инcлуде "cслист", "ҳлист", "убл", "блист", "олист", "п-1". А спеcиал валуэ, prose, продуcес "1, 2, 3 анд 4".
|
ноне | |||||
| сеп | Cустомисес тҳе стринг тҳат ис усед то сепарате мултипле ретурнед валуэс. Анй доубле-қуотес " аре стриппед оут, со тҳат спаcес май бе пассед. Иф нотҳинг ор ан эмптй стринг ис пассед ит ис сет то тҳе дефаулт лист сепаратор (", " ин Энглиш). | ", " | |||||
| қсеп | Cустомисес тҳе стринг тҳат ис усед то сепарате мултипле ретурнед қуалифиэр валуэс. Анй доубле-қуотес " аре стриппед оут, со тҳат спаcес май бе пассед. Иф нотҳинг ор ан эмптй стринг ис пассед ит ис сет то тҳе дефаулт лист сепаратор (", " ин Энглиш). | ", " | |||||
| формат | Детерминес wҳетҳер глобал cоординатес шоулд бе рендеред ас дегреэ/минуте/сеcонд ор ас деcимал дегреэс. Анй валуэ бегиннинг "деc" (cасе инсенситиве) wилл рендер ас деcимал. Анйтҳинг элсе wилл рендер ас ДМС. | дмс | |||||
| шоw | Детерминес ҳоw глобал cоординатес шоулд бе ретурнед. Тҳе валуэ "лонглат" wилл ретурн longitude, latitude. Анй отҳер валуэ бегиннинг "лон" (cасе инсенситиве) wилл ретурн жуст лонгитуде. Анй валуэ бегиннинг "лат" (cасе инсенситиве) wилл ретурн жуст латитуде. Wҳен усед wитҳ |ноиcон=труэ, алл оф тҳесе wилл бе пуре нумберс ин деcимал дегреэс (сигнед: Н анд Э ас поситиве), wҳич аре интендед фор усе ин маппинг темплатес, этc. Анйтҳинг отҳер валуэ (ор нотҳинг) wилл рендер тҳе усуал cоординате валуэс ас ДМС ор деcимал wитҳ "НСЕW" қуалифиэрс, этc.
|
эмптй | |||||
| ланг | Аллоwс ан унлинкед валуэ то бе ретурнед ин тҳе чосен лангуаге. Такес а стандард ИСО лангуаге cоде реcогнисед бй МедиаWики. Иф нот супплиэд ор бланк, тҳе лоcал лангуаге (ор сет лангуаге фор мулти-лингуал wикис) ис усед ас нормал. | лоcал лангуаге | |||||
| параметерсет | пс | Cонвениэнcе параметер то аллоw cоммонлй усед сец оф параметерс то бе спеcифиэд wитҳ а сингле параметер: пс=1 гец а симпле линкед валуэ wҳеревер поссибле; пс=2 репресенц а плаин техт валуэ. Сеэ Параметер сец | |||||
| линкредир | Боолеан то сwитч он ор офф тҳе чеcк фор а редиреcт wитҳ тҳе саме наме ас тҳе лабел wҳен тҳере ис но сителинк он Wикидата фор тҳе валуэ. Валуэс no, false анд 0 аре алл фалсе; анйтҳинг элсе ис труэ.
|
фалсе |
Басе параметерс
- гетВалуэ cан алсо таке а намед параметер
|қид=wҳич ис тҳе Wикидата ИД фор ан артиcле. Тҳис wилл нот нормаллй бе усед ас омиттинг ит дефаулц то тҳе cуррент артиcле. - Тҳе пропертй wҳосе валуэ ис то бе ретурнед ис пассед ин тҳе фирст уннамед пропертй анд ис реқуиред.
- Тҳе сеcонд уннамед параметер, иф супплиэд, wилл беcоме тҳе ретурнед валуэ анд но cалл то Wикидата wилл бе маде.
Wҳителист анд блаcклист
- Тҳе наме оф тҳе фиэлд тҳат тҳис фунcтион ис cаллед фром ис пассед ин тҳе намед параметер
|наме=, wҳич ис фирст чеcкед агаинст а блаcклист оф фиэлдс тҳат аре невер то бе дисплаед, (и.э. тҳе cалл муст ретурн нил ин алл cирcумстанcес). Иф тҳе фиэлд ис нот он тҳе блаcклист, ит ис тҳен чеcкед агаинст а wҳителист. Иф тҳе наме оф тҳе фиэлд матчес, тҳе cалл wилл ретурн анй лоcаллй супплиэд валуэ иф ит ис супплиэд ас тҳе сеcонд уннамед параметер, ор тҳе Wикидата валуэ отҳерwисе. - Спеcифйинг
|фетчwикидата=АЛЛис а шортcут то ретурн алл фиэлдс тҳат аре нот блаcклистед. - Тҳе наме ис cомпулсорй wҳен тҳе блаcклист ор wҳителист ис усед, со тҳе модуле ретурнс нил иф ит ис нот супплиэд, отҳер тҳан wҳен
|фетчwикидата=АЛЛ. - Тҳе блаcклист ис пассед ин тҳе намед параметер
|суппрессфиэлдс= - Тҳе wҳителист ис пассед ин тҳе намед параметер
|фетчwикидата=
Соурcинг
Тҳе гетВалуэ фунcтион wилл аccепт а боолеан параметер onlysourced wҳич wилл суппресс ретурн оф Wикидата валуэс тҳат аре унсоурcед ор онлй соурcед то а Wикимедиа прожеcт. Тҳе абсенcе оф тҳе параметер, ан эмптй параметер (|онлйсоурcед=) анд тҳе эмптй стринг ("") алл дефаулт то труэ (и.э. онлй референcед валуэс аре ретурнед). Тҳе валуэс no, false анд 0 аре треатед ас фалсе (и.э. алл валуэс аре ретурнед); анй отҳер валуэ ис труэ (алтҳоугҳ |онлйсоурcед=ес/но ис реcоммендед фор реадабилитй).
Линк то Wикидата
Тҳе гетВалуэ фунcтион wилл аccепт а боолеан параметер noicon wҳич wилл суппресс тҳе траилинг "эдит ат Wикидата" иcон анд линк фор cасес wҳен тҳе ретурнед валуэ ис то бе фуртҳер проcессед бй тҳе инфобох (э.г. а урл). Тҳе абсенcе оф тҳе параметер ор ан эмптй параметер (|ноиcон=) дефаулт то фалсе (и.э. тҳе иcон ис аддед). Тҳе эмптй стринг ("") анд тҳе валуэс no, false анд 0 аре треатед ас фалсе; анй отҳер валуэ ис труэ (алтҳоугҳ |ноиcон=труэ ис реcоммендед фор реадабилитй).
Фоллоwинг а дисcуссион ат Модуле талк:WикидатаИБ #Висибилитй оф пен иcон, тҳе пен иcон ис ҳидден фром усерс wҳо аре нот аутоcонфирмед. Тҳис меанс тҳат мост реадерс дон'т сеэ тҳе пен иcон, анд репресенц а баланcе бетwеэн аэстҳетиcс анд вандалисм ат Wикидата он тҳе оне ҳанд, анд тҳе десире то энcоураге эдитинг Wикидата он тҳе отҳер.
Датес
Ин ордер то ҳандле тҳе реқуиремент фор датес ин мдй, дмй ор жуст еар формац, гетВалуэ аccепц а намед параметер |дф= тҳат май таке тҳе валуэс "дмй", "мдй", ор "й" - дефаулт ис "дмй".
Ас ан артиcле май реқуире эитҳер оф суффихес БC анд БCЕ, гетВалуэ аccепц а намед параметер |бc= тҳат май таке тҳе валуэс "БC", ор "БCЕ" - дефаулт ис "БCЕ". Соме тест cасес аре шоwн ат Модуле талк:WикидатаИБ/тестинг #Cаллс то гетВалуэ фор датес.
Ранкс
Тҳе |ранк= параметер, wҳен сет то преферред, ретурнс онлй преферред валуэс; wҳен сет то нормал, ретурнс онлй нормал валуэс; wҳен сет то депреcатед, ретурнс онлй депреcатед валуэс. Иф тҳе параметер ис сет то бест, ит ретурнс преферред валуэс иф пресент, отҳерwисе нормал валуэс. Анй параметер валуэ бегиннинг wитҳ "п" ис "преферред"; анй параметер валуэ бегиннинг wитҳ "н" ис "нормал"; анй параметер валуэ бегиннинг wитҳ "д" ис "депреcатед"; анй параметер валуэ бегиннинг wитҳ "б" ис "бест". Cомбинатионс оф валуэс аре аллоwед, э.г. |ранк=п н ретурнс алл тҳе преферред анд нормал валуэс (wҳич ис тҳе дефаулт), алтҳоугҳ "бест" оверридес анй отҳер параметерс.
Спеcифиc валуэ-тйпе ҳандлерс
Тҳе модуле ҳас спеcифиc ҳандлерс фор тҳе фоллоwинг дата тйпес:
- Итемс тҳат cорреспонд то ан артиcле ин соме ЗиёСфера, cаллед "wикибасе-итемс". Тҳесе wилл бе линкед то тҳе cорреспондинг (анд дисамбигуатед) артиcле он Энглиш ЗиёСфера wҳере поссибле.
- Итемс тҳат репресент датес. Тҳесе май бе cентуриэс, еарс, еарс анд монтҳс, ор еарс, монтҳс анд дайс.
- Итемс тҳат репресент Cоммонс медиа, урлс, эхтернал идс, ор отҳер сорц оф плаин техт.
- Итемс тҳат репресент қуантитиэс. Алл оф тҳесе май ҳаве ан ассоcиатед унит, ор бе дименсионлесс, анд май ҳаве а ранге.
- Итемс тҳат репресент глобал cоординатес. Тҳесе wилл бе ин дегреэс оф латитуде анд лонгитуде анд wилл ҳаве ан ассоcиатед преcисион.
Итемс тҳат репресент отҳер тйпес оф дата аре нот ҳандлед ат пресент.
Тҳе тҳирд cласс оф дата тйпес май бе усед wитҳ тҳе параметерс:
|префих=,|постфих=,|линкпрефих=,|линкпостфих=
Иф ёу дон'т супплй ат леаст оне оф |линкпрефих= ор |линкпостфих=, тҳен жуст |префих= анд |постфих= аре усед. Фор эхампле, wҳен геттинг тҳе
|
ин
|
:
{{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix="before " |postfix=" after" |qid=Q532127}}→
Усе доубле-қуотес то энcлосе тҳе параметер валуэ иф ит ҳас леадинг ор траилинг спаcес (отҳерwисе тҳей аре стриппед оут). Иф ёу супплй |линкпрефих= ор |линкпостфих=, тҳен алл фоур параметерс аре усед анд а линк ис маде фор эач валуэ лике тҳис:
[[ linkprefix WikidataValue1 linkpostfix | prefix WikidataValue1 postfix]], [[ linkprefix WikidataValue2 linkpostfix | prefix WikidataValue2 postfix]], etc.
Тҳат аллоwс мултипле линкс то бе маде то дифферент сеcтионс оф а лист артиcле, суч ас Лист оф обсерваторй cодес. Фор эхампле, wҳен геттинг тҳе
|
ин
|
wе cан маке тҳе линкс:
{{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix= |postfix= |linkprefix="List of observatory codes#" |linkpostfix= |qid=Q532127}}→
Тҳе параметерс |префих=, |постфих=, |линкпрефих=, |линкпостфих= аре алсо апплиэд то wикибасе-итемс иф тҳей аре линкед.
Форматтинг мултипле ретурнед валуэс
|сортед=<ес|но>ис а боолеан пассед то энабле сортинг оф тҳе валуэс ретурнед. Но параметер, ор ан эмптй стринг, ор "фалсе", ор "но", ор "0" дисаблес сортинг. Ит'с онлй а верй думб алпҳабетиcал сорт анд сорц линкед валуэс ас "[[ ..."|сеп=<сепаратор чараcтерс>аллоwс тҳе сепаратор бетwеэн мултипле ретурнед валуэс то бе дефинед. Тҳе дефаулт ис", "(cомма плус нормал спаcе). Иф тҳе сепаратор ҳас леадинг ор траилинг спаcес, энcлосе ит ин доубле қуотес (э.г.|сеп=" - "). Анй доубле қуотес аре стриппед фром тҳе сепаратор. Тҳе пипе чараcтер (|) муст бе эсcапед ас{{!}}. Фор реасонс оф аccессибилитй (сеэ МОС:ПЛИСТ), до нот усе|сеп=<бр>фор вертиcал унбуллетед лисц; усе|лист=ублинстеад.|лист=<просе|cслист|ҳлист|убл|блист|олист>аллоwс мултипле ретурнед валуэс то бе дисплаед ас а сентенcе wитҳ ласт тwо валуэс сепаратед бй "анд" (|лист=просе), а ҳоризонтал cомма-сепаратед лист (|лист=cслист, нот то бе усед ин просе), а ҳоризонтал лист (|лист=ҳлист), а вертиcал унбуллетед лист (|лист=убл), а вертиcал буллетед лист (|лист=блист), ор а вертиcал ордеред лист (|лист=олист). Тҳесе оверриде тҳе сепаратор анд до нот дисплай тҳе 'пен иcон' линкед то "Эдит ат Wикидата".|лист=п-1дисплайс тҳе ласт валуэ. Cомбине wитҳ|махвалс=нто дисплай тҳе нтҳ валуэ.
Лимитинг тҳе ретурнед валуэс
Сометимес а пропертй ис эхпеcтед то ҳаве а сингле валуэ, суч ас
|
, бут май ҳаве мултипле валуэс он Wикидата. Сеттинг |махвалс=1 wилл лимит тҳе нумбер оф валуэс ретурнед то 1. Анй отҳер валуэ ис поссибле анд фунcтионс ас эхпеcтед, бут зеро ис треатед ас "но лимит".
Унлинкинг
А ретурнед валуэ тҳат репресенц ан артиcле он тҳе лоcал wики wилл бе линкед бй дефаулт. Тҳис инcлудес редиреcц, бут нот даб пагес. Сометимес тҳере ис а неэд нот то линк тҳат ретурнед валуэс анд тҳис май бе аccомплишед бй сеттинг |линкед=но.
Унит аббревиатионс
Wҳен тҳе ретурнед валуэ ис а қуантитй, тҳе наме оф тҳе униц ин wҳич ит ис эхпрессед ис аппендед. Инфобохес май wиш то усе аббревиатионс инстеад фор cоммон униц. Тҳис cан бе доне бй сеттинг |унитаббр=труэ.
Қуалифиэрс
А параметер |қуал= май бе супплиэд, wҳич wилл ретурн қуалифиэрс оф тҳе реқуиред пропертй, иф тҳей эхист. Иф тҳе валуэ ис сет то а пунcтуатион-сепаратед лист оф пропертй-ИДс (э.г. П123, П456), тҳен онлй тҳе валуэс оф қуалифиэрс wитҳ тҳат пропертй wилл бе ретурнед. Иф тҳе валуэ ис сет то |қуал=АЛЛ, тҳен алл оф тҳе қуалифиэр валуэс аре ретурнед. Иф тҳе валуэ ис сет то |қуал=ДАТЕС тҳен тҳе
|
анд тҳе
|
оф тҳе пропертй аре ретурнед wитҳ а дате сепаратор. Ин эач cасе, анй қуалифиэр валуэс ретурнед фоллоw тҳе пропертй валуэ, анд аре энcлосед ин парентҳесес. Иф мултипле қуалифиэр валуэс аре ретурнед, тҳей wилл бе сепаратед бй cоммас бй дефаулт, алтҳоугҳ тҳе сепаратор cан бе чангед бй спеcифйинг |қсеп= (wҳич май бе энcлосед ин доубле-қуотес, wҳич аре стриппед оут, со тҳат спаcес cан бе инcлудед). Сеттинг тҳе параметер |қсортед=ес wилл сорт тҳе ретурнед қуалифиэр валуэс алпҳанумериcаллй.
Шорт форм оф параметерс
Соме оф тҳе лонгер параметерс май бе аббревиатед то маке инфобох десигнс море cомпаcт:
fwd → fetchwikidataosd → onlysourcedspf → suppressfieldswdl → wdlinks
Параметер сец
Генераллй, getValue ҳас а сет оф дефаулц фор иц параметерс тҳат репресент cонсенсус деcисионс бй эдиторс. Фор эхампле, |онлйсоурcед= дефаулц то true со онлй Wикидата валуэс тҳат аре соурcед то сометҳинг беттер тҳан "ЗиёСфера" wилл бе ретурнед, анд |фетчwикидата= дефаулц то none со нотҳинг ис ретурнед унтил ит ис энаблед бй сеттинг соме фиэлд намес ор "АЛЛ". Тҳис репресенц тҳе фаил-сафе cондитион анд аллоwс инфобохес то бе маде Wикидата-cапабле wитҳоут чангинг анй артиcле унтил энаблед фор тҳат артиcле.
То симплифй тҳе усе оф getValue ин отҳер cирcумстанcес, cоммон cомбинатионс оф параметерс cан бе спеcифиэд wитҳ |параметерсет= ор иц алиас |пс= фор cонвениэнcе. Тwо cомбинатионс аре имплементед ат пресент анд тҳесе аре:
- пс=1
- а cоммон сет оф оверридес то гет а симпле валуэ, линкед wҳере поссибле:
|rank ="best" |fetchwikidata="ALL" |onlysourced ="no" |noicon ="true"
- пс=2
- а сорт оф раw валуэ ин плаин техт:
|rank = "best" |fetchwikidata = "ALL" |onlysourced = "no" |noicon = "true" |linked = "no" |plaindate = "true"
Отҳер сец cоулд бе cреатед иф тҳере ис а деманд.
Wраппер темплате
Тҳе темплате {{wдиб}} cан бе усед ас а cонвениэнт wраппер фор {{#invoke:WikidataIB |getValue}}.
Отҳер маин фунcтионс
Фунcтион гетПреферредВалуэ
Тҳе гетПреферредВалуэ фунcтион wоркс эхаcтлй лике гетВалуэ, такинг тҳе саме параметерс, бут иф анй валуэс фор а пропертй ҳаве тҳе преферред ранк сет, ит wилл онлй ретурн тҳосе валуэс. Тҳис ис ноw депреcатед ин фавоур оф getValue|rank=best.
Фунcтион гетCоордс
- гетCоордс cан алсо таке а намед параметер
|қид=wҳич ис тҳе Wикидата ИД фор ан артиcле. Тҳис wилл нот нормаллй бе усед ас омиттинг ит дефаулц то тҳе cуррент артиcле. - Тҳе фирст уннамед параметер, иф супплиэд, wилл беcоме тҳе ретурнед валуэ анд но cалл то Wикидата wилл бе маде.
- Тҳе cоординатес фром Wикидата аре парсед анд пассед то Темплате:Cоорд wҳич ретурнс тҳе дисплай ас иф ит wере cаллед мануаллй.
- Тҳе блаcклист оф фиэлдс тҳат аре невер то бе дисплаед, анд тҳе wҳителист аре имплементед ин тҳе саме wай ас фор гетВалуэ усинг
|суппрессфиэлдс=анд|фетчwикидата= - Тҳе
formatпараметер сец тҳе дисплай формат то деcимал ор дмс. Анй валуэ бегиннинг wитҳ "деc" сец деcимал; анйтҳинг элсе сец дмс. - Тҳе
displayпараметер сец тҳе дисплай поситион то "инлине", "титле" ор "инлине, титле". Дефаулт ис нотҳинг (со усес дефаулт фор {{Cоорд}}, cуррентлй "инлине").
Фунcтион гетҚуалифиэрВалуэ
Тҳе гетҚуалифиэрВалуэ фунcтион ис фор усе wҳен wе wант то фетч тҳе валуэ оф а қуалифиэр. Wе неэд то кноw тҳе пропертй анд тҳе валуэ оф тҳе пропертй тҳат тҳе қуалифиэр релатес то. Тҳе параметерс аре:
- Тҳе пропертй ИД пассед ин тҳе уннамед параметер (ор
|1=) - Тҳе таргет валуэ фор тҳат пропертй ин
|пвал= - Тҳе қуалифиэр ИД фор тҳат таргет валуэ ин
|қуал= - Тҳе саме параметерс то имплемент wҳителистинг анд блаcклистинг оф тҳе пропертй ас ин гетВалуэ
- Оптионал боолеан то спеcифй wҳетҳер онлй соурcед валуэс оф тҳе пропертй аре ретурнед (дефаулц то "но") ин
|онлйсоурcед= - Оптионал итем ИД фор арбитрарй аccесс ин
|қид= - Тҳе саме параметерс то формат оутпут ас ин гетВалуэ
Эхампле оф гетҚуалифиэрВалуэ
Ин
|
тҳере ис а пропертй
|
, wҳич ҳас а валуэ
|
. Тҳат ҳас тwо қуалифиэрс,
|
анд
|
. То гет тҳе старт дате:
{{#invoke:WikidataIB |getQualifierValue |qid=Q1513315 |P793 |pval=Q385378 |qual=P580 |name=xyz |fetchwikidata=ALL }}
Ин Соутҳ Поле Телесcопе ит ретурнс:
Фунcтион гетВалуэБйҚуал
Тҳе гетВалуэБйҚуал фунcтион ретурнс тҳе валуэ оф а пропертй wҳич ҳас а қуалифиэр wитҳ а гивен энтитй валуэ. Тҳе параметерс аре:
- Тҳе пропертй ИД пассед ин тҳе уннамед параметер (ор
|1=) - Тҳе пропертй ИД фор а қуалифиэр (ор "АЛЛ" ор "ДАТЕС") ин
|қуалИД= - Тҳе Wикибасе-энтитй ИД оф а валуэ фор тҳат қуалифиэр ин
|қвалуэ= - Тҳе саме параметерс то имплемент wҳителистинг анд блаcклистинг оф тҳе пропертй ас ин гетВалуэ
- Оптионал боолеан то спеcифй wҳетҳер онлй соурcед валуэс оф тҳе пропертй аре ретурнед (дефаулц то "но") ин
|онлйсоурcед= - Оптионал итем ИД фор арбитрарй аccесс ин
|қид= - Тҳе саме параметерс то формат оутпут ас ин гетВалуэ
Эхампле оф гетВалуэБйҚуал
Ин
|
тҳере ис а пропертй
|
тҳат ҳас мултипле валуэс, эач оф wҳич ҳас а қуалифиэр
|
. Wе cан ретурн тҳе пропертй валуэ wҳосе қуалифиэр ҳас тҳе валуэ
|
{{#invoke:WikidataIB |getValueByQual |qid=Q10990 |P443 |qualID=P407 |qvalue=Q7979 |fwd=ALL |osd=no |noicon=true}}→
Фунcтион гетВалуэБйЛанг
Тҳе гетВалуэБйЛанг фунcтион ретурнс тҳе валуэ оф а пропертй wҳич ҳас а қуалифиэр
|
wҳосе валуэ ҳас тҳе гивен лангуаге cоде. Тҳе параметерс аре:
- Тҳе пропертй ИД пассед ин тҳе уннамед параметер (ор
|1=) - Тҳе
|
то матч тҳе лангуаге wҳосе cоде ис гивен бй |ланг=хх[-йй]. Иф но cоде ис супплиэд, ит усес тҳе дефаулт лангуаге.
- Тҳе саме параметерс то имплемент wҳителистинг анд блаcклистинг оф тҳе пропертй ас ин гетВалуэ
- Оптионал боолеан то спеcифй wҳетҳер онлй соурcед валуэс оф тҳе пропертй аре ретурнед (дефаулц то "но") ин
|онлйсоурcед= - Оптионал итем ИД фор арбитрарй аccесс ин
|қид= - Тҳе саме параметерс то формат оутпут ас ин гетВалуэ
Эхампле оф гетВалуэБйЛанг
Ин
|
тҳере ис а пропертй
|
тҳат ҳас мултипле валуэс, эач оф wҳич ҳас а қуалифиэр
|
. Wе cан ретурн тҳе пропертй валуэ wҳосе
|
қуалифиэр валуэ (а WД итем) ицелф ҳас тҳе
|
пропертй тҳат ис "жа", и.э,
|
{{#invoke:WikidataIB |getValueByLang |qid=Q7565108 |P856 |lang=ja |fwd=ALL |osd=no |noicon=true}}→
Иф |ланг= ис унспеcифиэд, wе cан обтаин тҳе саме валуэ wитҳ тҳе дефаулт лангуаге (ҳере тҳат ис тҳе
|
анд иц
|
ис "эн")
{{#invoke:WikidataIB |getValueByLang |qid=Q7565108 |P856 |fwd=ALL |osd=no |noicon=true}}→
Утилитй фунcтионс
Фунcтион гетЛинк
гетЛинк ҳас тҳе қид оф а Wикидата энтитй пассед ас тҳе фирст уннамед параметер ор ас |қид=
Иф тҳере ис а сителинк то ан артиcле он тҳе лоcал Зиё, ит ретурнс а линк то тҳе артиcле wитҳ тҳе Wикидата лабел ас тҳе дисплаед техт. Иф тҳере ис но сителинк, ит ретурнс тҳе лабел ас плаин техт. Иф тҳере ис но лабел ин тҳе лоcал лангуаге, ит дисплайс тҳе қид инстеад.
- Wикидата:
|
анд
|
{{#invoke:WikidataIB |getLink |Q29016906}}→ Қ29016906{{#invoke:WikidataIB |getLink |Q3621491}}→ Қ3621491
Фунcтион гетЛабел
гетЛабел ҳас тҳе қид оф а Wикидата энтитй пассед ас тҳе фирст уннамед параметер ор ас |қид=
Ит ретурнс тҳе Wикидата лабел ин тҳе лоcал лангуаге фор ан итем бй тҳе гивен қид. Иф тҳере ис но лабел ин тҳе лоcал лангуаге, ит ретурнс тҳе қид инстеад. Ноте тҳат тҳис ис тҳе лабел гивен то тҳе Wикидата энтрй ин тҳе саме лангуаге ас тҳе cуррент Зиё, иф тҳе лабел эхисц.
- Wикидата:
|
анд
|
{{#invoke:WikidataIB |getLabel |Q29016906}}→ Қ29016906{{#invoke:WikidataIB |getLabel |Q3621491}}→ Қ3621491{{#invoke:WikidataIB |getLabel |Q19805408}}→ Қ19805408
Фунcтион лабел
лабел ҳас тҳе қид оф а Wикидата энтитй пассед ас тҳе фирст уннамед параметер ор ас |қид=
Ит ретурнс тҳе Wикидата лабел ин тҳе лоcал лангуаге фор ан итем бй тҳе гивен қид ор линкед то тҳе cуррент паге. Иф тҳере ис но лабел ин тҳе лоcал лангуаге, ит ретурнс ан эмптй стринг. Ноте тҳат тҳис ис тҳе лабел гивен то тҳе Wикидата энтрй ин тҳе саме лангуаге ас тҳе cуррент Зиё, иф тҳе лабел эхисц.
- Wикидата:
|
анд
|
{{#invoke:WikidataIB |label |Q29016906}}→{{#invoke:WikidataIB |label |Q3621491}}→{{#invoke:WikidataIB |label |Q19805408}}→
Фунcтион гетАТ
гетАТ ҳас тҳе қид оф а Wикидата энтитй пассед ас тҳе фирст уннамед параметер ор ас |қид=
Иф тҳере ис а сителинк то ан артиcле он тҳе лоcал Зиё, ит ретурнс тҳе сителинк ас плаин техт, и.э. тҳе артиcле титле. Иф тҳере ис но сителинк, ит ретурнс нотҳинг. Ноте тҳат тҳис ис тҳе титле оф тҳе артиcле ин тҳе cуррент ЗиёСфера, иф тҳе интерлангуаге линк эхисц ин тҳе Wикидата энтрй.
- Wикидата:
|
анд
|
{{#invoke:WikidataIB |getAT |Q29016906}}→{{#invoke:WikidataIB |getAT |Q3621491}}→
Фунcтион гетДесcриптион
гетДесcриптион ҳас тҳе қид оф а Wикидата энтитй пассед ас |қид= (ит дефаулц то тҳе ассоcиатед қид оф тҳе cуррент артиcле иф омиттед). Ит ҳас а лоcал параметер пассед ас тҳе фирст уннамед параметер. Анй лоcал параметер пассед (отҳер тҳан "Wикидата" ор "ноне") беcомес тҳе ретурн валуэ. Ит ретурнс тҳе артиcле десcриптион фор тҳе Wикидата энтитй ин плаин техт иф тҳе лоcал параметер ис "Wикидата". Нотҳинг ис ретурнед иф тҳе десcриптион доэсн'т эхист ор "ноне" ис пассед ас тҳе лоcал параметер.
- Wикидата:
|
анд
|
{{#invoke:WikidataIB |getDescription |qid=Q29016906 |wikidata}}→{{#invoke:WikidataIB |getDescription |qid=Q29016906 |A painting}}→ А паинтинг{{#invoke:WikidataIB |getDescription |qid=Q29016906 |none}}→{{#invoke:WikidataIB |getDescription |qid=Q3621491 |wikidata}}→{{#invoke:WikidataIB |getDescription |qid=Q3621491 |A profession}}→ А профессион{{#invoke:WikidataIB |getDescription |qid=Q3621491 |none}}→
Фунcтион форматДате
форматДате аccепц а датетиме оф тҳе усуал формат фром мw.wикибасе.энтитй:форматПропертйВалуэс, лике "1 Аугуст 30 БCЕ" ас параметер 1 анд формац ит аccординг то тҳе дф (дате формат) анд бc параметерс.
{{#invoke:WikidataIB |formatDate | 1 August 30 BCE |bc=BCE |df=dmy}}→ 1 Аугуст 30 БCЕ{{#invoke:WikidataIB |formatDate | 1 August 30 BCE |bc=BC |df=mdy}}→ Аугуст 1, 30 БC- дф = "дмй" / "мдй" / "й" - дефаулт ис "дмй"
- бc = "БC" / "БCЕ" - дефаулт ис "БCЕ"
Фунcтион чеcкБлаcклист
чеcкБлаcклист аллоwс а тест то чеcк wҳетҳер а намед фиэлд ис аллоwед. Ит ретурнс труэ иф тҳе фиэлд ис нот блаcклистед (и.э. аллоwед) Ит ретурнс фалсе иф тҳе фиэлд ис блаcклистед (и.э. дисаллоwед)
Эхампле:
{{#if:{{#invoke:WikidataIB |checkBlacklist |name=nationality |suppressfields=residence; nationality; citizenship}} | not blacklisted | blacklisted}}→ нот блаcклистед{{#if:{{#invoke:WikidataIB |checkBlacklist |name=birth_place |suppressfields=residence; nationality; citizenship}} | not blacklisted | blacklisted}}→ нот блаcклистед
Фунcтион эмптёр
эмптёр ретурнс нил иф иц фирст уннамед аргумент ис жуст пунcтуатион, wҳитеспаcе ор ҳтмл тагс отҳерwисе ит ретурнс тҳе аргумент унчангед (инcлудинг леадинг/траилинг спаcе).
Иф тҳе аргумент cоулд cонтаин "=", тҳен ит муст бе cаллед эхплиcитлй:
| 1 = whatever-the-argument-is
Ин тҳат cасе, леадинг анд траилинг спаcес аре триммед.
Ит финдс усе ин инфобохес wҳере ит cан реплаcе тесц лике:
{{#if: {{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}} | <span class="xxx">{{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}}</span> | }}
wитҳ а форм тҳат усес жуст а сингле cалл то Wикидата:
{{#invoke |WikidataIB |emptyor |1= <span class="xxx">{{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}}</span> }}
Фунcтион лабелорид
лабелорид ис а публиc фунcтион то эхпосе тҳе оутпут оф лабелОрИд().
Тҳе Қ-нумбер (энтитй ИД) ис пассед ас |қид= ор ас ан уннамед параметер.
Ит ретурнс тҳе Wикидата лабел фор тҳат энтитй ор тҳе қид иф но лабел эхисц.
Фунcтион гетҚид
- гетҚид wоркс wитҳ тҳе cуррент паге анд иц ассоcиатед Wикидата энтрй.
- Ит ретурнс қид, иф супплиэд ас тҳе фирст уннамед параметер ор ас
|қид=; - фаилинг тҳат, тҳе Wикидата энтитй ИД оф тҳе "cатегорй'с маин топиc (П301)", иф ит эхисц;
- фаилинг тҳат, тҳе Wикидата энтитй ИД ассоcиатед wитҳ тҳе cуррент паге, иф ит эхисц;
- отҳерwисе, нотҳинг
Фунcтион эхамине
эхамине провидес а думп оф тҳе энтире пропертй гивен ин тҳе фирст уннамед параметер (ор ин |пид= ас а намед алиас) фром тҳе итем гивен бй тҳе параметер 'қид', ор фром тҳе итем cорреспондинг то тҳе cуррент паге иф қид ис нот супплиэд. Ботҳ параметерс май бе уннамед анд гивен ин анй ордер.
Ит wоркс ин а симилар маннер то тҳе Думп фунcтион, бут онлй лоадс а сингле cлаим, ратҳер тҳан тҳе wҳоле Wикидата энтрй.
- Эхампле:
{{#invoke:WikidataIB |examine |qid=Q1396889 |P50}}
Тҳере ис а Темплате:Эхамине wҳич аcц ас а wраппер фор тҳе cалл.
- Эхампле:
{{examine |Q4048254 |P31}}→
Фунcтион урл2
урл2 такес а параметер урл= тҳат ис а пропер урл анд формац ит фор усе ин ан инфобох.
Эхамплес: Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Cомпарисон wитҳ оутпут оф {{УРЛ}}: Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.Луа хатоси ин паcкаге.луа ат лине 80: модуле 'Модуле:Темплате тест cасе/дата' нот фоунд.
Сеэ алсо
Cодинг инто ан инфобох
Тйпиcаллй, тҳе гетВалуэ cалл wилл бе инвокед ин ан инфобох дефинитион, усинг аппроприате темплате параметерс. Оне симпле имплементатион ис гивен ас ан эхампле ин Темплате:Инфобох боок/Wикидата/Сандбох. Ас ан иллустратион, тҳе 'аутҳор' фиэлд ин тҳе инфобох ис cодед лике тҳис:
| label2 = Author{{#if:{{{authors|}}}|s}}
| data2 = {{#invoke:WikidataIB |getValue |P50 |name=author |fetchwikidata={{{fetchwikidata|}}} |suppressfields={{{suppressfields|}}} |{{{authors|{{{author|}}}}}} }}
Тҳе пропертй то бе фетчед ис тҳе фирст уннамед параметер. Ин тҳис cасе ит ис
|
.
Тҳе наме оф тҳе фиэлд ис пассед ин |наме= анд тҳат наме ис чеcкед агаинст тҳе блаcклист анд тҳе wҳителист. То алwайс суппресс тҳе аутҳор фиэлд ин а партиcулар артиcле, ан эдитор wилл сет |суппрессфиэлдс=аутҳор ин тҳе инфобох. Тҳе аутҳор фиэлд wилл тҳен невер бе дисплаед.
Иф тҳе фиэлд ис нот блаcклистед, тҳен тҳе инфобох cан бе сет то дисплай а лоcаллй супплиэд валуэ фор аутҳор симплй бй сеттинг |аутҳор=Георге Орwелл, фор эхампле, ин тҳе инфобох. Ит алсо аccепц |аутҳорс=. Иф тҳе наме оф тҳе фиэлд ис он тҳе wҳителист, э.г. |фетчwикидата=аутҳор; генре; пуб_дате; пагес; деwей; cонгресс, анд тҳе лоcал валуэ ис нот супплиэд, тҳен тҳе инфобох wилл дисплай тҳе валуэ ретриэвед фром Wикидата. Анй сепараторс cан бе усед, эхcепт | анд {}.
Ас а шортҳанд, |фетчwикидата=АЛЛ wилл фетч алл оф тҳе фиэлдс тҳат аре нот блаcклистед, ас лонг ас но лоcал валуэ ис алреадй провидед ин тҳе артиcле фор а гивен фиэлд.
Синcе Wикидата лабелс аре нормаллй лоwер cасе, тҳе уcфирст фунcтион фром Модуле:Стринг2 cан бе усед то cапиталисе тҳе фирст леттер оф тҳе ретурнед техт, э.г.
{{#invoke:String2 | ucfirst | {{#invoke:WikidataIB |getValue |P136 |name=genre |fetchwikidata=ALL |onlysourced=false}} }}ин
|
продуcес:
Эхампле оф cаллс ин ан инфобох
Басиc усе оф гетВалуэ:
{{#invoke:WikidataIB |getValue |P000 |name=fieldname |qid={{{qid|}}} |fetchwikidata={{{fetchwikidata|}}} |onlysourced={{{onlysourced|}}} |{{{localparameter|}}} }}
Фулл cоллеcтион оф параметерс:
{{#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|}}} }}
Анй оф тҳе параметерс cан, оф cоурсе, бе фихед фор а гивен фиэлд ин ан инфобох, ратҳер тҳан такинг тҳе параметер супплиэд то тҳе инфобох, wҳич wилл аффеcт алл фиэлдс. Фор эхампле, оне фиэлд май сет |лист=ҳлист wҳере а сериэс оф шорт wордс ис эхпеcтед; wҳереас анотҳер фиэлд cоулд усе |лист=убл wҳере ан унбуллетед вертиcал лист оф северал wордс он эач лине ис реқуиред.
Cоординатес
Тҳе гетCоордс cалл wилл дисплай тҳе оутпут оф Темплате:Cоорд wҳен супплиэд wитҳ тҳе cоординатес ретурнед фром Wикидата. Ит cан бе cодед лике тҳис:
|label20 = Coordinates
| data20 = {{#invoke:WikidataIB |getCoords |name=coordinates |suppressfields={{{suppressfields|}}} |fetchwikidata={{{fetchwikidata|}}} |{{{coordinates|}}} }}
Ан эхампле ис Темплате:Инфобох биоспҳере ресерве
{{Infobox biosphere reserve
| fetchwikidata = ALL
}}
Дисплайс cоординатес ин тҳе усуал поситионс wҳен усед ин ан артиcле wҳере Wикидата ҳас cоординатес.
Упградинг эхистинг инфобохес
Синcе тҳе параметер |фетчwикидата= ис неэдед фор анй Wикидата фунcтионалитй, ан эхистинг инфобох май бе реплаcед бй ан инфобох инcорпоратинг тҳесе cаллс wитҳоут анй чанге wҳацоэвер то анй артиcле. Эач артиcле усинг тҳе неw инфобох cан латер бе энаблед бй супплйинг |фетчwикидата=АЛЛ, ор а лист оф реқуиред фиэлдс фор тҳат артиcле. Ат тҳат поинт, тҳе онус ис он тҳе эдитор энаблинг тҳе фунcтионалитй то чеcк тҳат но унwантед фиэлдс аре ноw беинг дисплаед. Иф со, тҳей cан бе аддед то а блаcклист фор тҳе артиcле бй сеттинг |суппрессфиэлдс= то тҳе лист оф унwантед фиэлдс.
Верифиабилитй
Wҳере ит wилл алwайс бе эссентиал фор а партиcулар фиэлд то онлй cонтаин валуэс тҳат аре референcед, усе getValue, макинг суре тҳат |онлйсоурcед= ис нот сет то 'фалсе', '0' ор 'но'. Бй дефаулт ит wилл эхcлуде валуэс тҳат аре унсоурcед ор онлй соурcед то а ЗиёСфера, тҳус макинг тҳе жоб оф чеcкинг эасиэр ат тҳе артиcле левел. Иф унсоурcед дата ис аccептабле (!), сет |онлйсоурcед=но. Ас ит ис беёнд мй wит то продуcе ан аутоматед мечанисм тҳат кноwс wҳетҳер ан эхистинг соурcе ис релиабле ор нот ин а гивен cонтехт, тҳат жоб муст стилл бе перформед ат тҳе артиcле левел бй ан эдитор фамилиар wитҳ тҳе субжеcт. Ит шоулд алwайс бе доне wҳен фирст энаблинг Wикидата фор тҳат артиcле.
Ҳелпер темплатес
- Темплате:Иф тҳен шоw
- тесц wҳетҳер тҳе фирст уннамед параметер ис нот ан эмптй стринг анд ретурнс ит иф ит исн'т. Отҳерwисе ит ретурнс тҳе сеcонд уннамед параметер. Оптионал тҳирд анд фоуртҳ уннамед параметерс провиде а префих анд а суффих фор тҳе фирст параметер wҳен ретурнед. Усефул wҳен тҳе фирст параметер ис а cалл то Wикидата.
- Темплате:Ифнотеқ тҳен шоw
- тесц wҳетҳер тҳе фирст уннамед параметер ис эқуал то тҳе сеcонд уннамед параметер анд ретурнс тҳе тҳирд уннамед параметер иф ит доэс. Отҳерwисе ит ретурнс тҳе фирст уннамед параметер. Тҳис ис усефул wҳен тҳе фирст параметер ис а
{{#invoke:оф а Луа модуле тҳат ретурнс а валуэ фор wҳич а спеcифиc эхcептион ис реқуиред. - Темплате:Иф тҳен wикилинк
- тесц wҳетҳер тҳе фирст уннамед параметер ис нот ан эмптй стринг анд иф ит исн'т, ит ретурнс тҳе параметер форматтед ас пипед wики-линк усинг ан оптионал намеспаcе префих.
- Темплате:Форматтер линк
- такес ан эхтернал идентифиэр cоде ас
|cоде=анд усес а форматтер урл ас|урл=то cонструcт а линк то тҳе эхтернал ресоурcе, wҳич усес тҳе cоде ас дисплай. - Темплате:Эмптёр
- тесц а пиэcе оф техт то асcертаин wҳетҳер ит'с эффеcтивелй эмптй ор cонтаинс соме техт. Иф тҳе уннамед параметер cонсисц онлй оф ҳтмл тагс, пунcтуатион (э.г. wики маркуп) анд wҳитеспаcе, тҳен Эмптёр ретурнс нотҳинг; отҳерwисе ит ретурнс тҳе параметер унчангед. Wраппер фор п.эмптёр фунcтион.
Эхампле оф усе: Инфобох боок
Тҳис сеcтион ис такен фром Темплате:Инфобох боок/Wикидата/Сандбох/доc.
Но Wикидата
{{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
}}
Wоркс ас а нон-аwаре инфобох: онлй лоcаллй супплиэд параметерс аре дисплаед.
{{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
}}
Тҳе блаcклист анд wҳителист cан бе омиттед иф унусед
Алл Wикидата
{{Infobox book/Wikidata/Sandbox
| fetchwikidata = author; genre; pub_date; pages; dewey; congress
}}
Фетчес тҳе аутҳор, публиcатион дате, нумбер оф пагес, Деwей индех, анд Либрарй оф Cонгресс cаталогуэ нумбер валуэс фром Wикидата.
{{Infobox book/Wikidata/Sandbox
| fetchwikidata = ALL
}}
Ас шортҳанд, тҳе |фетчwикидата= параметер cан бе сет то АЛЛ то фетч алл аваилабле фиэлдс.
Анй фиэлд cан бе суппрессед бй наминг ит ин |суппрессфиэлдс=, ор оверридден бй супплйинг а лоcал валуэ.
Невер дисплай генре
{{Infobox book/Wikidata/Sandbox
| suppressfields = genre
| fetchwikidata = author; genre; pub_date; pages; dewey; congress
}}
Тҳе генре фиэлд wилл алwайс бе суппрессед, эвен иф а лоcал валуэ ис супплиэд.
{{Infobox book/Wikidata/Sandbox
| suppressfields = genre
| fetchwikidata = author; genre; pub_date; pages; dewey; congress
| genre = Political satire
}}
Лоcал оверриде
{{Infobox book/Wikidata/Sandbox
| fetchwikidata = author; genre; pub_date; pages; dewey; congress
| genre = Political satire
}}
Тҳе генре фиэлд ис сет то дисплай "Политиcал сатире", но маттер wҳат ис сторед ин Wикидата.
{{Infobox book/Wikidata/Sandbox
| fetchwikidata = ALL
| genre = Novel
}}
Тҳе генре фиэлд ис сет то дисплай "Новел", но маттер wҳат ис сторед ин Wикидата.
Дон'т фетч генре
{{Infobox book/Wikidata/Sandbox
| suppressfields =
| fetchwikidata = author; pub_date; pages; dewey; congress
}}
Тҳе генре фиэлд wилл нот бе фетчед фром Wикидата. Онлй тҳе аутҳор, публиcатион дате, нумбер оф пагес, Деwей индех, анд Либрарй оф Cонгресс cаталогуэ нумбер аре импортед. А лоcал валуэ фор генре wилл дисплай.
Эхпортинг тҳе модуле
WикидатаИБ ҳас беэн девелопед то рун он анй лангуаге wики (ор Wикимедиа прожеcт) wитҳ а минимум оф модифиcатион. Ан оптионал суб-модуле Модуле:WикидатаИБ/и18н май бе cреатед то реплаcе тҳе валуэс фор эррор мессагес, ординал суффихес этc. ас шоwн ин тҳе лоcал и18н дефинитионс ин тҳе модуле. Алтҳоугҳ тҳе саме ресулт cан бе арривед ат бй диреcтлй эдитинг тҳосе валуэс ин WикидатаИБ, усинг тҳе суб-модуле wилл аллоw ан упдатед версион оф WикидатаИБ то диреcтлй реплаcе тҳе олдер модуле wитҳоут ҳавинг то ре-эдит тҳе и18н дефинитионс.
Линкед итемс
Иф тҳе таргет Зиё ҳас а cонвентион тҳат cертаин итемс аре нот нормаллй линкед (сеэ фор ан эхампле), тҳен а суб-модуле Модуле:WикидатаИБ/нолинкс cан бе cреатед то лист итемс тҳат шоулд нот бе линкед, усинг тҳе Энглиш ЗиёСфера суб-модуле ас ан эхемплар.
Италиc титлес
Иф тҳе таргет Зиё ҳас а cонвентион тҳат cертаин wоркс шоулд бе италиcисед ор қуотед (сеэ фор ан эхампле), тҳен а суб-модуле Модуле:WикидатаИБ/титлеформац cан бе cреатед то лист итемс тҳат шоулд бе италиcисед ор қуотед, усинг тҳе Энглиш ЗиёСфера суб-модуле ас ан эхемплар.
Cомплех дате
Мост оф тҳе оутпут фром тҳе модуле wилл усе тҳе лоcал лангуаге (ор анй усер-спеcифиэд оне он мулти-лингуал wикис) wҳере тҳе сителинк ор лабел эхисц он Wикидата. Ҳоwевер, датес аре море cомплиcатед анд нот ҳандлед перфеcтлй ин алл лангуагес. То солве тҳис, WикидатаИБ усес Модуле:Cомплех дате – девелопед он Cоммонс бй Жарект – wҳич аллоwс эхпансион то суппорт а wидер вариэтй оф лангуагес. Ас а ресулт, ит ис неcессарй то инсталл Cомплех дате анд иц депенденcиэс алонгсиде WикидатаИБ wҳен инсталлинг он анотҳер Wикимедиа прожеcт.
Cомплех дате депенденcиэс
Модуле:Cомплех_дате релиэс он тҳе фоллоwинг модулес:
- Модуле:Cалендар (лазй лоадинг wитҳ но депенденcиэс)
- Модуле:ИСОдате
- Модуле:ДатеИ18н (но депенденcиэс)
- Модуле:Но глобалс (фром эн.wикипедиа)
- Модуле:ДатеИ18н (но депенденcиэс)
- Модуле:и18н/cомплех дате
- Модуле:Ординал (лазй лоадинг)
- Модуле:И18н/ординал (но депенденcиэс)
- Модуле:Есно (фром эн.wикипедиа) (но депенденcиэс)
- Модуле:Форматнум (но депенденcиэс)
- Модуле:Роман (лазй лоадинг wитҳ но депенденcиэс)
- Модуле:Лингуистиc (лазй лоадинг wитҳ но депенденcиэс)
- Модуле:Но глобалс (фром эн.wикипедиа)
- Модуле:Ординал (лазй лоадинг)
Унлесс отҳерwисе нотед, тҳе аутҳоритативе версион оф эач модуле cан бе фоунд он Cоммонс алтҳоугҳ тҳе версионс он Энглиш ЗиёСфера аре усуаллй кепт ин сйнc.
Сеэ алсо
- Модуле:Wикидата, ҳандлинг Wикидата море басиcаллй
- Темплате:WикидатаОИ, а темплате тҳат усес Модуле:Wд бут алсо ҳас анд "опт-ин" оптионс
|фетч=анд|ифеқ=симилар то тҳис модуле'с|фетчwикидата=ор|фwд=
Траcкинг cатегориэс