در حال ویرایش الگو:WikidataOI/توضیحات

{{Documentation subpage}}
{{Wikidata/توضیحات|template={{ROOTPAGENAME}}|intro=This version of {{t|Wikidata}} includes an [[#Opt-in toggle|'''O'''pt-'''I'''n toggle]] (i.e. {{para|fetch|true}}, hence the name Wikidata'''OI'''). The template doesn't fetch any data by default unless the said parameter is set.
|seealso=*{{t|Wikidata}}, the same template but without the opt-in toggle.|extraparams=fetch{{=}}true|section=
== Opt-in toggle ==
The opt-in toggle is a convenience feature to allow data from Wikidata only to be fetched when explicitly requested. It consists of two named flags, which are name-value pairs (i.e. <code>{{!}}flag=value</code>), that can be given anywhere inside the call. The default behaviour (i.e. if the flags are not given or left empty) is not to fetch data from Wikidata. Note that a value consisting merely out of whitespace is also considered empty. The following table describes their usage.
<table class="wikitable">
<tr>
<th>Named flag</th>
<th>Default</th>
<th>Description</th>
</tr>
<tr>
<th style="text-align:right;"><code>fetch=</code></th>
<td>{{dfn|<code>{{0|&ensp;}}</code>|title=empty}}</td>
<td>Used to request data to be fetched from Wikidata.
<p>Any non-empty value assigned to this flag (e.g. <code>{{!}}fetch=true</code>, <code>{{!}}fetch=false</code>, <code>{{!}}fetch=arbitrary</code>) will trigger the template to fetch data from Wikidata, but only if the <code>ifeq</code> flag is not given or empty.</p>
<p>If the <code>ifeq</code> flag is given and not empty, then the value assigned to this flag must be equal to the value of the <code>ifeq</code> flag to trigger the template to fetch data from Wikidata.</p>
<p>The default behaviour is not to fetch data from Wikidata.</p>
</td>
</tr>
<tr>
<th style="text-align:right;"><code>ifeq=</code></th>
<td>{{dfn|<code>{{0|&ensp;}}</code>|title=empty}}</td>
<td>Adds a constraint to the value that the <code>fetch</code> flag must have before it triggers the template to fetch data from Wikidata.
<p>If the value assigned to this flag is non-empty, then data from Wikidata is only fetched if the <code>fetch</code> flag has the same value (e.g. <code>{{!}}fetch=true{{!}}ifeq=true</code> will trigger the template to fetch data, whereas <code>{{!}}fetch=false{{!}}ifeq=true</code> will not).</p>
</td>
</tr>
</table>}}