Edytujesz Moduł:Wikidane/opis

{{wysokie ryzyko|częste użycie|liczba=ponad 400 000}}
Moduł do odczytywania i prezentowania wartości cech z wikidanych powiązanych z bieżącym artykułem.

== <code>P</code> ==
Funkcja do odczytu i prezentacji wartości cechy.

=== parametry ===
{| class="wikitable" width = "100%"
! style="width: 8em;" | Pole
! Do czego służy?
! Jak wypełnić?
|-
| 1
| Numer cechy
| Np. <code>94</code> (herb) lub <code>395</code> (tablice rejestracyjne).
|-
| id
| Opcjonalny identyfikator danych z Wikidanych. Domyślnie odczytywane są cechy z danych powiązanych z bieżącą stroną.
| Np. <code>Q42</code>.
|-
| separator
| Separator wartości, gdy dostępna jest więcej niż jedna (zbiór):
; <code>i</code> : przecinek oraz spójnik ''i'' przed ostatnią wartością
; <code>lub</code> : przecinek oraz spójnik ''lub'' przed ostatnią wartością
; <code>''inny''</code> : jawnie podany ''inny'' separator
; ''brak'' : przecinek (wartość domyślna)
| Np. <code>lub</code> aby wyświetlić więcej niż jedną datę urodzin.
|-
| {{kotwica|P linkuj}}linkuj
| Wartość logiczna do sterowania generowaniem linków:
; <code>tak</code> : generuj link zawsze (jeśli możliwy)
; <code>nie</code> : generuj tylko opis
; ''brak'' : generuj w zależności od typu, tj. ''tak'' dla artykułów i koordynat, ''nie'' dla dat
| Np. <code>tak</code> dla daty urodzin lub śmierci
|-
| procesor
| Wtyczka do formatowania wartości
| Pełna nazwa modułu, który w jest odpowiedzialny za formatowanie zawartości cechy.
|-
| bez wartości
| Treść wartości specjalnej oznaczająca brak danej cechy.
| Zaleca się podawanie odpowiedniej treści, gdyż zależy ona silnie od kontekstu cechy. Domyślna treść ''bez wartości'' raczej nie oddaje jasno informacji i dlatego artykuły, które korzystają z domyślnego tekstu umieszczane są w kategorii technicznej [[:Kategoria:Cecha bez wartości]]. 
|-
| ile
| Maksymalna liczba wartości do odczytania.
| Cecha może zawierać więcej niż jedną wartość oraz domyślnie zwracane są wszystkie najlepsze wyniki. Tym polem można ten zbiór dodatkowo ograniczyć. Pole musi mieć wartość nie mniejszą niż 1.
|-
| ranga
| Filtr cech względem rangi
| Dopuszczalne wartości:
; najlepsza : domyślna wartość wczytująca cechę oznaczoną jako „preferowana” albo zbiór cech oznaczonych jako „zwykła”
; preferowana lub zwykła : zbiór cech oznaczonych zgodnie z opisem
; dowolna : cecha oznaczona jako „preferowana”, albo zbiór cech oznaczonych jako „zwykła”, albo zbiór cech oznaczonych inaczej
; preferowana : cecha oznaczona zgodnie z opisem
; zwykła : zbiór cech oznaczonych zgodnie z opisem
; przestarzała : zbiór cech oznaczonych zgodnie z opisem
; wszystkie : zbiór wszystkich dostępnych cech
|-
| P518
| Filtr kwalifikatora „[[:d:Property:P518|{{#invoke:Wikidane|label|P518}}]]”
| Lista akceptowanych wartości w formacie ''QNNN''. Dopuszczalne są też wartości specjalne ''novalue'', ''somevalue'' i ''missing''. Elementy należy oddzielać spacją.
|-
| P548
| Filtr kwalifikatora „[[:d:Property:P548|{{#invoke:Wikidane|label|P548}}]]”
| Lista akceptowanych wartości w formacie ''QNNN''. Filtr jest używany przez szablon {{s|wersja oprogramowania}}. Przykład: <code>P548=Q2122918 Q3295609</code>.
|-
| P580
| Filtr kwalifikatora „[[:d:Property:P580|{{#invoke:Wikidane|label|P580}}]]”
| Zbiór z wartości ''missing'', ''after'' lub ''before''.
|-
| P582
| Filtr kwalifikatora „[[:d:Property:P582|{{#invoke:Wikidane|label|P582}}]]”
| Zbiór z wartości ''missing'', ''after'' lub ''before''.
|-
| P625
| Filtr kwalifikatora „[[:d:Property:P625|{{#invoke:Wikidane|label|P625}}]]”
| Wartość <code>globe</code> oznacza, że wymagana jest obecność kwalifikatora z jakimikolwiek współrzędnymi.
|-
| TYP
| Filtr typu wartości cechy
| Zbiór z wartości ''value'', ''novalue'' lub ''somevalue''. Pozwala na filtrowanie względem rzeczywistej wartości, braku wartości lub nieznanej wartości.
|-
| format
| sposób formatowania wyniku inny niż domyślny
| zobacz [[Moduł:Wikidane/format]]
|-
|}

== <code>T</code> ==
Funkcja do sprawdzenia obecności cechy.

=== parametry ===
{| class="wikitable" width = "100%"
! style="width: 8em;" | Pole
! Do czego służy?
! Jak wypełnić?
|-
| 1
| Numer cechy
| Np. <code>94</code> (herb) lub <code>395</code> (tablice rejestracyjne).
|-
| id
| Opcjonalny identyfikator danych z Wikidanych. Domyślnie odczytywane są cechy z danych powiązanych z bieżącą stroną.
| Np. <code>Q42</code>.
|-
| ranga
| Filtr cech względem rangi
| Dopuszczalne wartości:
; najlepsza : domyślna wartość wczytująca cechę oznaczoną jako „preferowana” albo zbiór cech oznaczonych jako „zwykła”
; preferowana lub zwykła : zbiór cech oznaczonych zgodnie z opisem
; dowolna : cecha oznaczona jako „preferowana”, albo zbiór cech oznaczonych jako „zwykła”, albo zbiór cech oznaczonych inaczej
; preferowana : cecha oznaczona zgodnie z opisem
; zwykła : zbiór cech oznaczonych zgodnie z opisem
; przestarzała : zbiór cech oznaczonych zgodnie z opisem
; wszystkie : zbiór wszystkich dostępnych cech
|-
| P518
| Filtr kwalifikatora „[[:d:Property:P518|{{#invoke:Wikidane|label|P518}}]]”
| Lista akceptowanych wartości ''Qnnn''. Dopuszczalne są też wartości specjalne ''novalue'', ''somevalue'' i ''missing''. Elementy należy oddzielać znakiem odstępu.
|-
| P548
| Filtr kwalifikatora „[[:d:Property:P548|{{#invoke:Wikidane|label|P548}}]]”
| Lista akceptowanych wartości ''Qnnn''. Filtr jest używany przez szablon {{s|wersja oprogramowania}}.
|-
| P580
| Filtr kwalifikatora „[[:d:Property:P580|{{#invoke:Wikidane|label|P580}}]]”
| Zbiór z wartości ''missing'', ''after'' lub ''before''.
|-
| P582
| Filtr kwalifikatora „[[:d:Property:P582|{{#invoke:Wikidane|label|P582}}]]”
| Zbiór z wartości ''missing'', ''after'' lub ''before''.
|-
| P625
| Filtr kwalifikatora „[[:d:Property:P625|{{#invoke:Wikidane|label|P625}}]]”
| Wartość <code>globe</code> oznacza, że wymagana jest obecność kwalifikatora z jakimikolwiek współrzędnymi.
|-
| TYP
| Filtr typu wartości cechy
| Zbiór z wartości ''value'', ''novalue'' lub ''somevalue''. Pozwala na filtrowanie względem rzeczywistej wartości, braku wartości lub nieznanej wartości.
|}

== <code>etykieta</code> ==
Funkcja do nazwy elementu (domyślnie z bieżącej strony). Jeśli nazwa nie istnieje to zwracana jest nazwa strony bez prefiksów.

=== parametry ===
{| class="wikitable" width = "100%"
! Pole
! Do czego służy?
|-
| 1..''N''
| Kod języka, w którym nazwę chcemy uzyskać. Jeśli podane jest więcej kodów niż jeden (w kolejnych parametrach) to zwracana jest pierwsza znaleziona nazwa. Brak parametrów oznacza domyślnie wybór nazwy w języku polskim.
|-
| id
| Opcjonalny identyfikator danych z Wikidanych. Domyślnie odczytywane są cechy z danych powiązanych z bieżącą stroną.
|}

== <code>id</code> ==
Funkcja do odczytu identyfikatora strony na wikidanych.

=== parametry ===
{| class="wikitable" width = "100%"
! Pole
! Do czego służy?
|-
| 1
| Opcjonalny tytuł strony. Domyślnie brana jest strona bieżąca.
|-
| idwiki
| Globalny identyfikator danej wiki. Domyślnie ta wartość jest ustawiona na lokalną <code>wiki</code>.
|}

== <code>label</code> ==
Funkcja do odczytu nazwy elementu w Wikidanych.

=== parametry ===
{| class="wikitable" width = "100%"
! Pole
! Do czego służy?
|-
| 1
| Identyfikator elementu w Wikidanych. Identyfikator musi się zaczynać na ''P'' lub ''Q'', po których następuje ciąg cyfr dziesiętnych.
|}

== <code>page</code> ==
Funkcja do odczytu nazwy strony na Wikipedii.

=== parametry ===
{| class="wikitable" width = "100%"
! Pole
! Do czego służy?
|-
| 1
| Identyfikator elementu w Wikidanych. Identyfikator musi się zaczynać na ''P'' lub ''Q'', po których następuje ciąg cyfr dziesiętnych.
|-
| site
| Opcjonalny identyfikator wiki, z której nazwę strony chcemy czytać.
|}

== <code>V</code> i <code>Dump</code> ==
Funkcje techniczne do odczytu dowolnej gałęzi lub liścia z drzewa danych. <code>V</code> zwraca wartość liścia, jeśli istnieje. <code>Dump</code> robi zrzut diagnostyczny wybranej gałęzi.

=== parametry ===
{| class="wikitable" width = "100%"
! Pole
! Do czego służy?
|-
| 1..''N''
| Nazwa lub indeks coraz bardziej zagnieżdżonej gałęzi danych. Interesujące identyfikatory dla pierwszego poziomu to:
* <code>id</code> z identyfikatorem Qid
* <code>claims</code> ze zbiorem cech
* <code>labels</code> ze zbiorem etykiet w różnych językach
* <code>sitelinks</code> z interwiki i „medalami”
* <code>bestclaims</code> ze zbiorem odfiltrowanych cech, który można zawęzić parametrami opisanymi w funkcji <code>P</code>
|-
| id
| Opcjonalny identyfikator danych z Wikidanych. Domyślnie odczytywane są cechy z danych powiązanych z bieżącą stroną.
|}

=== przykłady ===
* {{m|Wikidane|V|sitelinks|plwikivoyage|title}} – tytuł strony w [[voy:Strona główna|Wikipodróżach]]
* {{m|Wikidane|V|sitelinks|commonswiki|title}} – tytuł strony w [[commons:Strona główna|repozytorium multimediów]]
* {{m|Wikidane|V|bestclaims|P18|1|mainsnak|datavalue|value}} – nazwa pierwszego pliku z ilustracją w [[commons:Strona główna|repozytorium multimediów]]
* {{m|Wikidane|V|bestclaims|P625|1|mainsnak|datavalue|value|latitude}} – szerokość geograficzna z pierwszych dostępnych współrzędnych
* {{m|Wikidane|V|bestclaims|P159|P625{{=}}globe|1|qualifiers|P625|1|datavalue|value|latitude}} – szerokość geograficzna z pierwszych dostępnych współrzędnych podanych jako kwalifikator dla siedziby przedsiębiorstwa

=== uwagi ===
* Wywołanie <code>Dump</code> jest sygnalizowane w kategorii [[:Kategoria:Wywołanie funkcji diagnostycznej 'Dump' z modułu Wikidanych]], która normalnie powinna być pusta.

== Błędy ==
Błędy należy zgłaszać na stronie [[Wikipedia:Kawiarenka/Kwestie techniczne]].