Bu Modul:Wikidata/Medals modulunun sənədləşmə səhifəsidir.
Bu moduldan Vikidatadan mükafatların (P166) idxalı və formatlaşdırılması məqsədilə istifadə olunur.
- Mükafat şəkli üçün ilk növbədə piktoqram (P2910), sonra isə lent (P2425) parametrləri yoxlanılır.
- Mükafatın verilmə tarixi (P585) varsa, həmin il tire ilə ayrılaraq başlığa əlavə edilir.
- Piktoqram və ya mükafat lenti müxtəlif dövrlərdə fərqli cür olubsa, başlama (P580) və bitmə (P582) tarixlərinə əsasən təsvir müəyyən edilir.
- Eyni təbiətə malik olan bəzi mükafatlar əvəzlənərək avtomatik digər mükafata yönəldilir (məsələn: "Qızıl ulduz" medalı → Sovet İttifaqı Qəhrəmanı).
- Mükafatın dərəcəsi verilibsə, ona daxili keçid kimi Azərbaycan dilində mövcud olan üst məqaləyə keçid verilir.
- Ölkə adları üçün ölkə (P17) parametrindən istifadə olunur və ölkə adının Azərbaycan dilində P1813 abreviaturu varsa, o göstərilir.
- Mükafat laureatlarının müvafiq kateqoriyası (P2517) əlavə edilir. Əgər mükafat dərəcəsinin kateqoriyası yoxdursa, onun üst elementinin (əsas mükafatın) kateqoriyası yerləşdirilir.
- Əgər mükafatın təsviri yoxdursa, başqa mükafatlar idxal edilən zaman həmin mükafat sadəcə kateqoriya şəklində əlavə edilir.
- Göstərilən mükafat təsviri tipinə əsasən (piktoqram və ya mükafat lenti) kontur (border) parametri təyin edilir.
- Mükafatların ardıcılığı müvafiq siyahıya uyğun olaraq yenilənir.
Qeyd: mükafatların sayı 50-dən artıq olarsa, idxal zamanı yuxarıdakı funksiyalardan ikinci dərəcəli hesab olunanlar məhdudlaşdırılır.
formatProperty(context, options)- Cari səhifənin (və ya göstərilən "entity"nin) P166 (mükafat) xüsusiyyətlərinə əsasən bütün mükafatları emal edir və şəkilli, sıralı şəkildə çıxış verir. Modulun əsas funksiyasıdır. Şablon və məlumat qutuları bu funksiyadan istifadə edir.
formatValue(context, options, statement)- Yalnız bir mükafat üçün verilmiş bəyanatı (statement) formatlaşdırır. Bu funksiya, əsasən, fərdi mükafatların göstərilməsi üçün nəzərdə tutulmuşdur.
buildAwardHTML(id, statement)- Mükafatın şəkilli və ya kateqoriya əsaslı HTML çıxışını qurur. Şəkil, il, ölkə və etiket daxil olmaqla bütün lazımi məlumatları birləşdirir.
getImage(entity, awardDate)- Mükafatın piktoqram (P2910) və ya lent (P2425) şəkillərini, tarix aralığına əsaslanaraq düzgün şəkildə seçir. Şəkil ölçüsü və kontur (border) təyinatını da burada müəyyən edir.
getCountryLabel(entity)- Mükafatın aid olduğu ölkənin Azərbaycan dilində qısa və ya tam adını qaytarır. Əgər mükafat başqa mükafatın tərkib hissəsidirsə (P361), o üst elementə baxılır.
shouldAppendCountry(label, country, fullCountry)- Ölkə adı artıq mükafat etiketində varsa, təkrar yazılmasının qarşısını alır.
getAwardYear(statements, id)- Verilmiş bəyanatda (P585) göstərilən tarixdən il çıxararaq başlığa əlavə edir.
getMainValue(claims, property)- Göstərilən xüsusiyyət (property) üçün əsas dəyəri (main snak) qaytarır.
getCategoryWikitext(entity)- Mükafat üçün kateqoriya əlaqəsi (P2517) varsa, onu nəticəyə əlavə edir. Əgər birbaşa tapılmırsa, üst elementdə (P361) axtarır.
wrapWithClaimDiv(html, propertyId, itemId)- HTML çıxışını Vikidataya uyğun "div" strukturuna yerləşdirir.