Template:Taxonbar/sandbox
 | __EXPECTUNUSEDTEMPLATE__This is the template sandbox page for Template:Taxonbar (diff). See also the companion subpage for test cases. |
 | This template is used on approximately 467,000 pages, or roughly 3% of all pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
 | This template uses Lua: |
| Related pages |
|---|
Description
This metadata template links Wikipedia articles to various biological and taxonomic databases. Taxonbar displays these links as short strings, indicating the unique identifier each database has assigned the taxon for catalogue purposes.
Taxonomic identifiers of each taxon are stored and retrieved from each taxon's corresponding Wikidata entry, but can be overridden in individual articles with locally entered data. Adding the data to Wikidata is preferable.
This project is based on the work of {{Authority Control}} and Wikidata:WikiProject Taxonomy. If you are a template editor or Wikipedia administrator, you may contribute at Module:Taxonbar. Please discuss ideas/thoughts for improvement or use on Template:Taxonbar/talk.
Position
Please place Taxonbar correctly. As a metadata template, Taxonbar should be placed:
- Below all references, footnotes, and external links.
- Below all navigation templates—except Authority control
- Above the Authority control template.
- Above all [[Category:]] and stub template codes in the editor.
Usage
Add Taxonbar to an article:
- In Source editing mode, insert
{{Taxonbar|from=}}below all other navigation templates except Authority control — it is preferable to add thefrom = QIDparameter even if just a single Wikidata item points to the article. - Click "Show preview" to check placement, and to see which taxon identifiers are automatically pulled from Wikidata.
- If you have more identifiers to add, consider adding them to the article's Wikidata item, so that all versions of Wikipedia automatically benefit. Be careful not to edit the structure or names of Wikidata taxa until you have become familiar with Wikidata:WikiProject Taxonomy and Wikidata:WikiProject Taxonomy/Tutorial.
Basic code:
<syntaxhighlight lang="wikitext"></syntaxhighlight>Taxon example
{{Taxonbar|from=Q930712}} when placed in the Pileated woodpecker article:
Error: "Q930712" is not a valid Wikidata entity ID.
Basic use samples
Examples of articles demonstrating its use include:
Taxon identifiers
The template can automatically get its information from the following properties on Wikidata. This is configured in Module:Taxonbar/conf.
List of taxon identifiers
| Parameter | Wikidata ID | Authority | Description |
|---|---|---|---|
| aba | P4526 | ||
| adw | P4024 | ||
| afd | P6039 | ||
| afromoths | P6093 | ||
| algaebase | P1348 | ||
| amphibiaweb | P5036 | ||
| antweb | P5299 | ||
| aoi | P5003 | ||
| aofp | P6159 | ||
| apa | P6137 | ||
| apdb | P2036 | ||
| aphid species file | P12767 | ||
| apni | P5984 | ||
| apsa | P2809 | ||
| araneae | P3594 | ||
| arkive | P2833 | ||
| asw | P5354 | ||
| atrf | P6904 | ||
| ausfungi | P9076 | ||
| auslichen | P9093 | ||
| avibase | P2026 | ||
| bacdive | P2946 | ||
| bamona | P3398 | ||
| bhl | P687 | ||
| biolib | P838 | ||
| birdlife | P5257 | ||
| birdlife-australia | P6040 | ||
| bold | P3606 | ||
| bow | P3444 | ||
| bto | P4798 | ||
| bugguide | P2464 | ||
| butmoth | P3060 | ||
| calflora | P3420 | ||
| cal-ipc | P6176 | ||
| col | P10585 | ||
| center | P6003 | ||
| cms | P6033 | ||
| cnps | P4194 | ||
| cockroach species file | P6052 | ||
| cockroach species file new | P12817 | ||
| coleorrhyncha species file | P12771 | ||
| conifers | P1940 | ||
| cool | P6408 | ||
| coreoidea species file | P6053 | ||
| dermaptera species file | P12750 | ||
| ebird | P3444 | ||
| ecocrop | P4753 | ||
| ecos | P6030 | ||
| eflorasa | P6933 | ||
| embioptera species file | P12751 | ||
| eol | P830 | ||
| eppo | P3031 | ||
| eunis | P6177 | ||
| euring | P3459 | ||
| euro+med plantbase | P12380 | ||
| faunaeuropaea | P1895 | ||
| faunaeuropaeanew | P4807 | ||
| feis | P6044 | ||
| featherbase | P12589 | ||
| fishbase | P938 | ||
| florabase | P3101 | ||
| flow | P6096 | ||
| fna | P1727 | ||
| foao | P3100 | ||
| foao2 | P6756 | ||
| foc | P1747 | ||
| foio | P3795 | ||
| fungorum | P1391 | ||
| gbif | P846 | ||
| gisd | P5626 | ||
| gnab | P4715 | ||
| goniat | P5216 | ||
| grassbase | P1832 | ||
| grin | P1421 | ||
| grylloblattodea species file | P12768 | ||
| ibc | P3099 | ||
| ifpni | P6341 | ||
| inaturalist | P3151 | ||
| ipa | P6161 | ||
| ipni | P961 | ||
| irmng | P5055 | ||
| isc | P5698 | ||
| isoptera species file | P12752 | ||
| itis | P815 | ||
| iucn | P627 | ||
| lepindex | P3064 | ||
| lob | P5862 | ||
| lpsn | P1991 | ||
| lygaeoidea species file | P11311 | ||
| lygaeoidea species file new | P12818 | ||
| mantophasmatodea species file | P12769 | ||
| mantodea species file | P6055 | ||
| mdd | P12560 | ||
| michiganflora | P6103 | ||
| mobotpf | P6034 | ||
| mol | P6092 | ||
| mnhn | P6046 | ||
| millibase | P12271 | ||
| mona | P4758 | ||
| mabena | P9608 | ||
| msw | P959 | ||
| mycobank | P962 | ||
| nas | P6163 | ||
| natureserve | P10243 | ||
| nbn | P3240 | ||
| ncbi | P685 | ||
| neotropical | P6047 | ||
| noaa | P6049 | ||
| nswflora | P3130 | ||
| ntflora | P5953 | ||
| nzbo | P6048 | ||
| nzor | P2752 | ||
| nzpcn | P7496 | ||
| observation.org | P6105 | ||
| obis | P6754 | ||
| odnr | P6289 | ||
| ottol | P9157 | ||
| orthoptera species file | P6050 | ||
| orthoptera species file new | P12785 | ||
| paldat | P4122 | ||
| paleobiodb | P10907 | ||
| fossilworks | P842 | ||
| panartic | P2434 | ||
| pfaf | P4301 | ||
| pfi | P6114 | ||
| phasmida species file | P4855 | ||
| phasmida species file new | P12819 | ||
| plecoptera species file | P12770 | ||
| ppe | P6061 | ||
| plantlist | P1070 | ||
| plants | P1772 | ||
| plantzafrica | P12645 | ||
| plazi | P1992 | ||
| powo | P5037 | ||
| psocodea species file | P8145 | ||
| psocodea species file new | P12820 | ||
| psyl'list | P6376 | ||
| rd | P5473 | ||
| rhs | P8765 | ||
| sanbi | P6056 | ||
| scalenet | P6516 | ||
| scc | P6057 | ||
| sealifebase | P6018 | ||
| seinet | P6209 | ||
| species+ | P2040 | ||
| sprat | P2455 | ||
| steere | P6035 | ||
| tree of life | P5221 | ||
| tropicos | P960 | ||
| tsa | P5397 | ||
| ubio | P4728 | ||
| vascan | P1745 | ||
| vicflora | P5945 | ||
| watson | P1761 | ||
| white-files | P6347 | ||
| world arachnid catalog | P11803 | ||
| wio | P6285 | ||
| wisflora | P6227 | ||
| woi | P3746 | ||
| wfo | P7715 | ||
| world auchenorrhyncha db | P12057 | ||
| worms | P850 | ||
| wsc | P3288 | ||
| xeno-canto | P2426 | ||
| zoobank | P1746 | ||
| zoraptera species file | P12753 |
Manual identifiers
Some taxon identifiers not currently in Wikidata can be added via additional parameters listed above; however, adding the data to Wikidata is preferable, so that all versions of Wikipedia automatically benefit.
Example: <syntaxhighlight lang="wikitext">Lua error in mw.wikibase.lua at line 97: too many expensive function calls.</syntaxhighlight>
On Lilium, the result is the following, where the taxon identifier in the Plants of the World Online has been added to those picked up from Wikidata:
Lua error in mw.wikibase.lua at line 97: too many expensive function calls.
If there are multiple Wikidata entries resulting in multiple rows, the row to which an identifier is added can be specified by appending a number matching the relevant |from#= parameter.
A Wikispecies page can be also added manually. However, it is preferable to link it to the Wikidata item; this can be done at the Wikidata page within the "Multilingual sites" section, entering "species" as the "wiki".
| Parameter | Database | Property URL/Interwiki link |
|---|---|---|
| Wikispecies | Wikispecies | Wikispecies:$1 |
Hide specific identifier (optional)
Individual identifiers listed in the table above can be removed/hidden from the bar by setting the corresponding parameter to <syntaxhighlight lang="text" class="" style="" inline="1">no</syntaxhighlight>. This is useful when trying to reduce the number of unhelpful links within Taxonbar. Spaces are optional. There is no sense in removing too many identifiers, for example: removing plant or fungi identifiers from an animal taxon would have no effect, as these parameters will not show up on an animal taxon in the first place. It is best to preview {{Taxonbar}} on the page and decide what entries provide little relevant data. Plant species will have the most entries and are most likely in need of hiding some entries.
Example: To remove FOC, IPNI, and AFPD, the code would look like: <syntaxhighlight lang="wikitext"></syntaxhighlight>
On Coffea arabica, the result is:
Error: "Q47685" is not a valid Wikidata entity ID.
Displaying excluded databases (optional)
These databases are available at Wikidata but are excluded by default on the English-language Wikipedia as they are not in the English language. They can be included in the {{taxonbar}} by setting the corresponding parameter to <syntaxhighlight lang="text" class="" style="" inline="1">yes</syntaxhighlight> (e.g. |CoL-Taiwan=yes), which will then retrieve the value from Wikidata, or by setting the value of the parameter manually (e.g. |CoL-Taiwan=395235).
| Wikidata property name | ID | Authority | Description | Language |
|---|---|---|---|---|
| P3088 | Taiwanese | |||
| P4902 | Spanish | |||
| P5263 | Czech | |||
| P6115 | French | |||
| P4630 | French | |||
| P1939 | Swedish | |||
| P6043 | French | |||
| P5179 | Catalan | |||
| P6094 | German | |||
| P4311 | Dutch | |||
| P6054 | French | |||
| P2794 | French | |||
| P6025 | French | |||
| P3102 | Russian | |||
| P3186 | French | |||
| P3105 | French | |||
| P4125 | French | |||
| P6142 | Dutch | |||
| P3322 | Dutch | |||
| P4664 | Portuguese |
Multiple Wikidata entries
The parameter |from= / |from1= will be implicitly determined by the Wikidata item linked to the article. For maintenance purposes it is preferable to explicitly provide the linked Wikidata item in the |from= / |from1= parameter, although it is not strictly required. If it is not provided the article will be listed at Category:Taxonbars without from parameter.
Parameters |from2=, |from3=, etc., can also be added, for example, if the linked Wikidata item differs from the taxon name of the English-language Wikipedia article. Some taxa exist under multiple names (synonyms) on Wikidata. To add these synonyms, use the |from2=, |from3=, etc., parameters to specify their Wikidata IDs. If there is more than one row, the taxon name from Wikidata will be shown in the leftmost column — to overwrite this, use the |title= / |title1=, |title2=, |title3=, etc. parameters.
For example, <syntaxhighlight lang="wikitext" inline>Error: "Q26972265" is not a valid Wikidata entity ID.
Error: "Q20717272" is not a valid Wikidata entity ID.
</syntaxhighlight>, when placed on the page Dog produces:
Error: "Q26972265" is not a valid Wikidata entity ID.
Error: "Q20717272" is not a valid Wikidata entity ID.
The same approach can be used when monotypic taxa have a single article, but there are multiple entries in Wikidata.
For example, at Haptanthus, which covers the genus and its sole species, <syntaxhighlight lang="wikitext" inline>Error: "Q15715555" is not a valid Wikidata entity ID.
Error: "Q133951" is not a valid Wikidata entity ID.
</syntaxhighlight> produces:
Error: "Q15715555" is not a valid Wikidata entity ID.
Error: "Q133951" is not a valid Wikidata entity ID.
You can manually add taxon identifiers not present in Wikidata to a specific row by appending the appropriate number to the end of the parameter name — for example, to add an inaturalist identifier to the second row, use |inaturalist2=.
Basionyms
Basionyms available on Wikidata (via (P566)) are automatically appended. You may also manually specify the basionym via |from#= to manually specify its position.
For example, both
- <syntaxhighlight lang="wikitext" inline>Error: "Q43372357" is not a valid Wikidata entity ID.
Error: "Q164254" is not a valid Wikidata entity ID.
</syntaxhighlight> and - <syntaxhighlight lang="wikitext" inline>Error: "Q43372357" is not a valid Wikidata entity ID.
Error: "Q164254" is not a valid Wikidata entity ID.
Error: "Q21977691" is not a valid Wikidata entity ID.
</syntaxhighlight>
would produce identical taxonbars for Ponerorchis cucullata:
Error: "Q43372357" is not a valid Wikidata entity ID.
Error: "Q164254" is not a valid Wikidata entity ID.
Error: "Q21977691" is not a valid Wikidata entity ID.
However, changing the order of the IDs will alter their position in the taxonbar so
- <syntaxhighlight lang="wikitext" inline>Error: "Q43372357" is not a valid Wikidata entity ID.
Error: "Q21977691" is not a valid Wikidata entity ID.
Error: "Q164254" is not a valid Wikidata entity ID.
</syntaxhighlight>
produces a taxonbar with the basionym in a different position:
Error: "Q43372357" is not a valid Wikidata entity ID.
Error: "Q21977691" is not a valid Wikidata entity ID.
Error: "Q164254" is not a valid Wikidata entity ID.
More taxon examples
Purge server cache
Arabica coffee, Coffea arabica
Error: "Q47685" is not a valid Wikidata entity ID.
Jaguar, Panthera onca
Error: "Q35694" is not a valid Wikidata entity ID.
Fly agaric, Amanita muscaria
Error: "Q131227" is not a valid Wikidata entity ID.
Lactobacillus acidophilus
Error: "Q132644" is not a valid Wikidata entity ID.
Plasmodium falciparum
Error: "Q311383" is not a valid Wikidata entity ID.
Module editing — to-do list
- Continue to add support for new, useful parameters (search)
Module editing — to-don't list
See also
Other links
- {{ThePlantList}}
- {{Authority control}}
- {{Taxobox}}
- Wikipedia:Automated taxobox system/intro
- Other templates in Category:Biology external link templates
- Other templates in Category:Botany external link templates
Tracking categories
Maintenance required
- Category:Taxonbar pages requiring a Wikidata item (0)
- Category:Taxonbars desynced from Wikidata (0)
- Category:Taxonbars on possible non-taxon pages (0)
- Category:Taxonbars with duplicate from parameters (0)
- Category:Taxonbars with invalid from parameters (0)
- Category:Taxonbars with manual taxon IDs differing from Wikidata (0)
- Category:Taxonbars with unknown parameters (0)
- Category:Taxonbars with unnamed parameters (0)
Maintenance desired
- Category:Taxobox articles missing a taxonbar (0) — add {{Taxonbar}}, if appropriate
- Category:Taxonbars without primary Wikidata taxon IDs (0) — find/add taxon IDs to the primary Wikidata item
- Category:Taxonbars without secondary Wikidata taxon IDs (0) — find/add taxon IDs to secondary Wikidata item(s)
- Category:Taxonbars with manual taxon IDs (0) — migrate IDs to Wikidata, if possible
- Category:Taxonbars with manual taxon IDs identical to Wikidata (0) — remove duplicate(s) on Wikipedia
- Category:Taxonbars without from parameter (0) — add
|from=parameter - Category:Taxonbars with from2 matching article title (0) — swap
|from1=/|from2=parameter values (maybe) - Category:Taxonbars with from2 matching article title & QID (0) — swap
|from1=/|from2=parameter values (probably) - Category:Taxonbars with automatically added monotypic genera (0) — add QIDs of related monotypic ranks to
|from2=, etc. - Category:Taxonbars with automatically added monotypic species (0) — add QIDs of related monotypic ranks to
|from2=, etc. - Category:Taxonbars of monotypic species missing genera (0) — verify monotypic status of both genus and species on Wikidata
- Category:Taxonbars of monotypic genera missing species (0) — verify monotypic status of both genus and species on Wikidata
Tracking only (no error)
- Category:Taxobox articles possibly missing a taxonbar (0)
- Category:Taxonbars with multiple manual Wikidata items (0)
- Category:Taxonbars with 20–24 taxon IDs (0)
- Category:Taxonbars with 25–29 taxon IDs (0)
- Category:Taxonbars with 30–34 taxon IDs (0)
- Category:Taxonbars with 35–39 taxon IDs (0)
- Category:Taxonbars with 40–44 taxon IDs (0)
- Category:Taxonbars with 45+ taxon IDs (0)
- Category:Taxonbars with automatically added basionyms (0)
- Category:Taxonbars with automatically added original combinations (0)
TemplateData
TemplateData for Taxonbar
Links to taxonomic databases via Wikidata
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Wikidata item | from | no description
| Unknown | suggested |