Template:Taxonbar/doc

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 [[Wikipedia:Categories| and stub template codes in the editor.

• |undefined

Usage
Add Taxonbar to an article:
 * 1) In Source editing mode, insert   below all other navigation templates except Authority control &mdash; it is preferable to add the   parameter even if just a single Wikidata item points to the article.
 * 2) Click "Show preview" to check placement, and to see which taxon identifiers are automatically pulled from Wikidata.
 * 3) 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:

Taxon example


when placed in the Scarlet macaw article:

Basic use samples
Blue jay

European robin

Agaricus bisporus

American chestnut

Nelumbo lutea

Escherichia coli

Plasmodium falciparum

Bombus terrestris

Canis

Monarch butterfly

Taxon identifiers
The template can automatically get its information from the following properties on Wikidata. This is configured in Module:Taxonbar/conf.

Hide specific identifier (optional)
Individual identifiers listed in the table above can be removed/hidden from the bar by setting the corresponding parameter to. 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  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:

On Coffea arabica, the result is:

Excluded databases
These databases are available at Wikidata, but are excluded by default here (en.wiki) for being non-English.

Additional parameters
Some taxon identifiers not currently in Wikidata can be added via additional parameters; however, adding the data to Wikidata is preferable, so that all versions of Wikipedia automatically benefit.

Example:

On Lilium, the result is:

where the taxon identifier in the eMonocot has been added to those picked up from Wikidata.

Multiple Wikidata entries
Some taxa will exist under multiple names (synonyms) on Wikidata. To add these synonyms, use the from2, from3, etc., parameters to specify their Wikidata IDs. The parameter from / from1 will be implicitly determined by the Wikidata item linked to the article. While not required, it is preferable to explicitly store the linked Wikidata item in the from / from1 parameter, for maintenance purposes. Parameters from2, from3, etc., can also be added, for example, if the linked Wikidata item differs from the taxon name of the en:Wikipedia article.

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. You can add taxon identifiers not present in Wikidata by appending the appropriate number to the end of the parameter name — for example, to add emonocot to the second row, use emonocot2.

For example,, when placed on the page Dog produces:

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, produces:

Basionyms
Basionyms available on Wikidata (via ) are automatically appended. You may also manually specify the basionym via from# to customize its location.

For example, both
 * and

would produce identical taxonbars for Ponerorchis cucullata:

or for a customized location:

More taxon examples
Arabica coffee, Coffea arabica

Common milkweed, Asclepias syriaca

Monarch butterfly, Danaus plexippus

Jaguar, Panthera onca

Eastern bluebird, Sialia sialis

Firefly, Lampyridae

Fly agaric, Amanita muscaria

Saccharomyces cerevisiae

Lactobacillus acidophilus

Plasmodium falciparum

Module editing — to-do list

 * Continue to add support for new, useful parameters (search)

Module editing — to-don't list

 * Import synonym QIDs via from Wikidata (talk)

Other links

 * ThePlantList
 * Authority control
 * Taxobox
 * Automated taxobox system/intro
 * Other templates in Category:Biology external link templates
 * Other templates in Category:Botany external link templates

Maintenance desired

 * — find/add taxon IDs to the primary Wikidata item
 * — find/add taxon IDs to secondary Wikidata item(s)
 * — migrate IDs to Wikidata, if possible
 * — remove duplicate(s) on Wikipedia
 * — swap from1/from2 parameter values (maybe)
 * — swap from1/from2 parameter values (probably)
 * — add from parameter
 * — add Taxonbar, if appropriate

TemplateData
{	"params": { "from": { "label": "Wikidata item", "example": "Q1", "suggested": true }	},	"description": "Links to taxonomic databases via Wikidata", "paramOrder": [ "from" ],	"format": "inline" }