Modul:EditAtWikidata/doc

Aceasta este pagina de documentație pentru Modul:EditAtWikidata

Aceasta este pagina de documentație pentru Modul:EditAtWikidata.
Pagina descrie modul de folosire al formatului și conține categoriile de care acesta aparține, precum și orice altceva ce nu face parte din formatul propriu-zis.

Acest modul este folosit pentru a afișa o pictogramă (un creion albastru) sau un text cu o legătură către elementul Wikidata asociat paginii curente. Este folosit, de regulă, în formate (cum ar fi infocasetele) pentru a indica faptul că o anumită valoare este preluată de la Wikidata și poate fi modificată direct acolo.

Acesta reprezintă documentația pentru modulul al cărui cod sursă se regăsește în EditAtWikidata.lua.

Utilizare

Se poate apela prin intermediul formatului {{Editează la Wikidata}}.

Utilizarea de bază în cadrul unui format:

{{#invoke:EditAtWikidata|showMessage|{{{parametru_local|}}}}}

Utilizare cu toți parametrii opționali (în general pentru teste sau legături către o anumită proprietate):

{{#invoke:EditAtWikidata|showMessage|{{{parametru_local|}}} |qid= |pid= |label=}}

Parametri (pentru showMessage)

Modulul utilizează funcția principală showMessage, care acceptă următorii parametri:

1 (primul parametru nenominalizat): Parametrul local. Dacă acest parametru este furnizat și nu este gol, modulul nu va afișa mesajul/pictograma. Acest mecanism previne apariția legăturii către Wikidata atunci când în format se folosește deja o valoare introdusă manual.
qid (opțional): ID-ul elementului Wikidata (de exemplu, Q42). Dacă nu este specificat, modulul preia automat elementul Wikidata asociat paginii curente. Este folosit în special pentru testarea modulului în afara spațiului de articole.
pid (opțional): ID-ul proprietății Wikidata (de exemplu, P18). Dacă este furnizat, legătura generată va duce exact la secțiunea acelei proprietăți din pagina Wikidata a elementului.
label (opțional): Un text personalizat. Dacă este completat, modulul va genera o legătură text cu acest titlu în loc să afișeze pictograma implicită cu creionul albastru și textul de tip tooltip „Modificați la Wikidata”.

Funcții pentru alte module

Modulul expune funcții care pot fi apelate direct din alte module Lua, fără a trece prin formatarea parametrilor specifică apelurilor #invoke:

displayMessage

p.displayMessage(pid, qid)

Returnează wikitextul pentru pictograma creionului albastru, legat la elementul și (opțional) proprietatea Wikidata specificate.

pid (opțional): ID-ul proprietății Wikidata (ex. "P18").
qid (opțional): ID-ul elementului Wikidata (ex. "Q42"). Dacă este omis, folosește elementul paginii curente.

displayMessageWithCustomText

p.displayMessageWithCustomText(pid, qid, text)

Returnează o legătură text personalizată către elementul (și opțional proprietatea) Wikidata specificat.

pid (opțional): ID-ul proprietății Wikidata (ex. "P18"). Dacă este specificat, legătura va include o ancoră către acea proprietate (#pid).
qid (opțional): ID-ul elementului Wikidata (ex. "Q42"). Dacă este omis, folosește elementul paginii curente.
text (opțional): Textul afișat în legătură. Dacă parametrul text este omis sau nil, funcția apelează automat p.displayMessage(pid, qid) și returnează pictograma implicită cu creionul albastru.