User:SBEyes/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.

Developer card
If the card is not available for play because it has a special purpose, such as being for gamemasters only or is used in the game outside of gameplay, use the  parameter as follows:

The default is false.

Choose One effect
If the card is one of the possible effects of a Choose One card, use the  parameter and supply the page name for the appropriate Choose One card as follows:

Use the regular page name for the card, not its data page name.

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.

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.