Template:Card infobox/doc

This template can be used in two ways:


 * 1) Most commonly, it will be used to pull imported data from a data page onto a card's regular content page.
 * 2) It can also be used to directly enter data for a card.
 * 3) *Since this has the side effects of adding the card information to lists, it should only be done for actual cards in the game.
 * 4) *Note that automated imports of card data will usually add data pages for new cards; they typically will not need to be added manually.

This template can also be used to add additional information to cards beyond that supplied by the automated imports. Note that the actual visual function of the infobox is handled by Card infobox/layout, which has no side effects beyond simply displaying the infobox.

Adding additional information
There is some information of interest about various cards that the importer cannot automatically acquire. These parameters allow you to add this useful information whether or not data is being pulled from a data page.

Not currently in play
If the card is not currently in play, use the  parameter as follows:

The default is true.

NB: This parameter is currently used for removed cards. For upcoming cards, use  (see below).

Not a collectible card
If the card is uncollectible, such as resulting from the effect of another card, use the  parameter as follows:

The default is true, unless the  parameter is also used, in which case this is automatically set to   even if   is specified here.

Developer card
If the card is only available to the game's developers, such as cards intended for testing and system purposes, use the  parameter as follows:

The default is false.

Choice card
If the card is a choice card produced by a multiple choice effect such as Choose One, a link to the parent card can be displayed in the infobox by using  parameter and supplying the page name for the parent card as follows:

Use the regular page name for the card, not its data page name. For example, Wrath (234) uses

Using alternate categories
Card categories are used to keep certain special types of cards separate from regular cards. To place the card in one or more special categories instead of the regular categories, use the  parameter as follows:

For example, if  is given, it will be added to Category:Boss cards, Category:Boss card data, Category:Special cards and Category:Special card data. Note that even if this parameter is used, the card will still be added to Category:All cards and Category:All card data. However, cards that use this parameter will not be added to the main card categories Category:Cards and Category:Card data.

While this parameter accepts multiple arguments, special card divisions should almost always be combined to form a single category name, for example Removed boss, rather than Removed, Boss. This is because using multiple categories will include the card in each category, while combining categories will include the card only in the combined category. For sorting purposes, the latter is almost always correct, since card categories are generally used to keep sets of cards separate. If uncertain of the correct category name, check the pages of similar cards.

'''This parameter should not generally be used on cards that are used in normal gameplay, as putting them in alternate categories will prevent them from appearing in standard lists. Tags or hidden tags below should be used instead for normal cards.'''

Additional abilities
If the card has additional abilities that the automated importer did not include, the  parameter can be used to add these abilities to the card data.

Tags
Tags can also be added that can determine whether a card appears in certain lists. These appear in the infobox and link to a given page. See Card tag page for more details.

Hidden tags
Like the tags above, these can be used to determine whether a card appears in certain lists, but these do not actually appear in the infobox and are not associated with any given wiki page.

Acceptable tags
NB: This table may not be complete. Please update it with missing tags.

Specifying other versions of the card
By adding these, the infobox will include links to the pages of the other two versions, and if those pages identify images, it includes them in the image selector as well. It determines its own version by looking at  and ignores the corresponding parameter. (Note that for Battlegrounds versions, it will only retrieve the image identified in .)   is only looked at for non-Battlegrounds cards.

Pulling card data from a data page
Data pages are set up by an automated importer which is run on the wiki from time to time. This information uses card information extracted from the game client. There are four ways to identify what data page the infobox should pull card data for.

Automatic, default method
The infobox automatically looks for a data page for a card with the same name as the page name the infobox is used on. This can acquire the wrong data if there are more than one card with that name. In these cases, a different method will need to be used.

By card name
Another name can also be specified using the  parameter.

This can be useful if the page name and card name need to be different for some reason, but this has the same drawback as the automatic method; if there is more than one card with that name, it may not acquire the correct data.

By data subpage name
The third option is to explicitly specify which data page the card data should be acquired from by the subpage name of the data page. This works as follows:

Note that you should only include the subpage name. For example, do use, not.

This guarantees no more than one infobox showing up, but if the data page doesn't exist, if it isn't using Card data, or there are certain problems with the data, nothing will show up.

By full data page name
All proper data pages should have names starting with, but this isn't desirable for data pages used for testing. In this case, you can use the  parameter with a full page name to exactly specify which page to use.

Manual data entry
This can be used like a normal infobox as well, but be aware that it automatically adds card data to properties as well as performing automatic categorization. It is not intended for user-created cards or any cards not actually in the game. For anything like this, use Card infobox/layout directly, as it does not perform any of these functions.

Usage:

Important note: If this template finds a matching data page, any values supplied by the data page take priority over these manually entered values. In most cases when this happens, the manual values here should be removed to reduce potential confusion.

But if the data page values are incorrect:
 * The first step is simply to edit the data page itself and correct the inaccurate information there. It is probably just outdated and would be fixed by the next import anyway.
 * If imports are consistently setting up an incorrect value for a card, you can use the  parameters to override the data page value. For example,   would make the mana cost 3 in all of the card data's regardless of the what the data page says. This is only appropriate as a last resort, however.

Hiding the infobox
The infobox itself can be 'hidden' by using the  parameter as follows:

Technically the infobox is not hidden, rather the Card infobox/layout template is simply not called. This is useful for pages such as playable hero articles which do not wish to feature an infobox, but still need to be included in the wiki's card data system.