Template:Taxonbar/doc

This is a documentation subpage for Template:Taxonbar.
It contains usage information, categories and other content that is not part of the original template page.

This template is used on approximately 91,000 pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Taxonbar

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 catalog 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: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.

Taxonbar is placed below all navigation templates, except Authority control (not shown here).

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 the [[Category:]] 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 the from = QID parameter 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:

{{Taxonbar|from=}}

Taxon example

Scarlet macaw (Ara macao)

{{Taxonbar|from=Q243761}} when placed in the Scarlet macaw article:

Basic use samples

REDIRECT Template:See also

Taxon identifiers

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

Parameter	Wikidata ID	Authority
adw	P4024	from=P4024}}
apdb	P2036	from=P2036}}
algaebase	P1348	from=P1348}}
araneae	P3594	from=P3594}}
arkive	P2833	from=P2833}}
avibase	P2026	from=P2026}}
bacdive	P2946	from=P2946}}
bamona	P3398	from=P3398}}
biolib	P838	from=P838}}
bhl	P687	from=P687}}
bugguide	P2464	from=P2464}}
butmoth	P3060	from=P3060}}
conifers	P1940	from=P1940}}
ebird	P3444	from=P3444}}
eol	P830	from=P830}}
faunaeuropaea	P1895	from=P1895}}
fishbase	P938	from=P938}}
florabase	P3101	from=P3101}}
fna	P1727	from=P1727}}
foao	P3100	from=P3100}}
foc	P1747	from=P1747}}
fossilworks	P842	from=P842}}
gbif	P846	from=P846}}
grassbase	P1832	from=P1832}}
grin	P1421	from=P1421}}
ibc	P3099	from=P3099}}
ictv	P1076	from=P1076}}
inaturalist	P3151	from=P3151}}
indexfungorum	P1391	from=P1391}}
ipni	P961	from=P961}}
ipni	P586	from=P586}}
itis	P815	from=P815}}
iucn	P627	from=P627}}
lepindex	P3064	from=P3064}}
lpsn	P1991	from=P1991}}
msw	P959	from=P959}}
mycobank	P962	from=P962}}
ncbi	P685	from=P685}}
paldat	P4122	from=P4122}}
panartic	P2434	from=P2434}}
plantarium	P3102	from=P3102}}
plantlist	P1070	from=P1070}}
plants	P1772	from=P1772}}
plazi	P1992	from=P1992}}
species	P2040	from=P2040}}
sprat	P2455	from=P2455}}
tropicos	P960	from=P960}}
vascan	P1745	from=P1745}}
watson	P1761	from=P1761}}
wcsp	P3591	from=P3591}}
worms	P850	from=P850}}
wsc	P3288	from=P3288}}
xeno-canto	P2426	from=P2426}}
zoobank	P1746	from=P1746}}

Hide specific identifier (optional)

Individual identifiers listed in the table above can be removed(hidden) from the bar by setting the corresponding parameter to no. This is useful when trying to reduce the number of 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 if the goal is to keep the bar on one line.

Example: To remove FOC, IPNI, and AFPD, the code would look like:

{{taxonbar | foc = no | ipni = no| apdb = no }}

On Coffea arabica, the result is:

Taxon identifiers not in Wikidata

Some taxon identifiers not at present in Wikidata can be added via extra parameters, however adding the data to Wikidata is preferable.

Example:

{{taxonbar | emonocot = 280381}}

On Lilium, the result is:

where the taxon identifier in the World Checklist of Selected Plant Families has been added to those picked up from Wikidata.

Parameter	Database	Property URL/Interwiki link
eMonocot	eMonocot	http://e-monocot.org/taxon/urn:kew.org:wcs:taxon:$1
emonocotfamily	eMonocot	http://e-monocot.org/taxon/urn:kew.org:wcs:family:$1
uBio	uBio	http://www.ubio.org/browser/details.php?namebankID=$1
WSC species	World Spider Catalog	http://www.wsc.nmbe.ch/search?sFamily=&fMt=begin&sGenus=&gMt=begin&sSpecies=&sMt=begin&mMt=exact&multiPurpose=slsid&sMulti=$1
WSC genus	World Spider Catalog	http://www.wsc.nmbe.ch/search?sFamily=&fMt=begin&sGenus=&gMt=begin&sSpecies=&sMt=begin&mMt=exact&multiPurpose=glsid&sMulti=$1
WSC family	World Spider Catalog	http://www.wsc.nmbe.ch/search?sFamily=&fMt=begin&sGenus=&gMt=begin&sSpecies=&sMt=begin&mMt=exact&multiPurpose=flsid&sMulti=$1
Wikispecies	Wikispecies	Wikispecies:$1

Multiple Wikidata entries

Some taxons will exist under multiple names on Wikidata. To add these additional names, you can use the |from2=, |from3=, etc. parameters to add their Wikidata IDs (|from=/|from1= will be automatically determined by the article title should normally be omitted, but can be specified manually if needed).

If there is more that one row, the taxon name from Wikidata will be shown in the leftmost column — to overwrite this, use the |for=/|for1=, |for2=, |for3=, 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, {{Taxonbar|from2=Q138193}}, when placed on the page Aloiampelos ciliaris produces:

More taxon examples

Purge server cache

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

Template editing—to-do list

~~Switch to Module:Taxonbar when it's ready and meets our needs.~~ Done.
Continue to add support for new, useful parameters.
Program Module:Taxonbar to add tracking for entries not on Wikidata? Suggest differences be resolved.
Program Module:Taxonbar to create it's own documentation table of parameters.
Program Module:Taxonbar to support disabled(hidden) databases which can shown when called.