Community Central
Register
Community Central
150px-1330470.png Other blogs by Thisismyrofl
Infoboxes
Suggestions


Template:Infobox Wolf3D levelHey! This is Thisismyrofl, an admin here on Community Central. I wanted to see if I could explain how to use the new style of Template:Infobox (new as in September 2012). On your right, you see a basic infobox made in the new infobox format. We'll learn how to make an infobox of our own to meet our specific needs!

I'm referring here to the default styles, that is, those that were on the Starter Pages Wiki's Template:Infobox page. Since every newly created wiki, at the time of its creation, is given a copy of every page and template on Starter Pages Wiki, that means that there are thousands of wikis that came with the old style, and thousands founded after October 2015 that came with the new style.

For more information on old and new styles of infoboxes, see my other blog.

Plan the infobox[]

Let's make a plan! Think about what you want your infobox to look like, and decide about visibility. It might help to write down your plan on a piece of paper, or type it somewhere.

If I wanted to make a template "Template:Infobox Wolf3D level" for the game Wolfenstein 3D, it might follow this format:

Template:Infobox Wolf3D level
* Title
* Image
* Image caption
*  Heading: "Treasure"
** Crosses				(default: "0")
** Chalices				(default: "0")
** Chests				(default: "0")
* Heading: "Other stats"
** Par time				(default: hidden)
** Song					(default: hidden)
** Secrets				(default: hidden)
* Heading: "Level order"
** Previous level and Next Level	(side by side)

If a row is left empty when the template is called, we must decide whether it should give a default value (such as "Unknown") or be hidden (that is, the row won't show up at all). Jump to the section #Visibility for more information. Mark on your plan how you want each row to be treated.

Default syntax[]

Let's also make the default syntax for the new template! This can be copied into the template's documentation. It should look something like this.

{{Infobox Wolf3D level
| title         = 
| image         = 
| imagecaption  = 
| crosses       = 
| chalices      = 
| chests        = 
| par           = 
| song          = 
| secrets       = 
| previouslevel = 
| nextlevel     = 
}}

This is what will be pasted into an article and then filled out to make a fully-fledged infobox appear on the article! But before it works, you need to customize the page "Infobox Wolf3D level" on your wiki. Try not to be excessive in naming the parameters: lowercase, typed as one word is sufficient, because it doesn't affect the appearance of the infobox anyway.

Now that we've planned it out, let's customize our infobox.

Understanding the code[]

Let's take a look at the standard code of Template:Infobox. Remember that this is the default code, and not necessarily the code that will be seen on your infobox. I've colored it myself for clarity - you're not likely to see this kind of coloring when you actually edit.

An explanation of the code of the infobox
Note that linebreaks have been added, sparingly, for readability on this page.
The code An explanation

<onlyinclude><infobox>
<title source="title"><default>''Unknown''</default></title>


<image source="image">
</image>


<group>
<header>Some attributes</header>



<label>First</label>
<default>''Unknown''</default>

<label>Second</label>
<default>''Unknown''</default>

<label>Third</label>
<default>''Unknown''</default>

</group>

<group>
<header>Other attributes</header>


<label>Fourth</label>
<label>Fifth</label>
<label>Sixth</label>
</group>

<group layout="horizontal">
<header>Order</header>


<label>Previous</label>
<label>Next</label>

</group>
</infobox></onlyinclude><noinclude><br style="clear:both;"/>


{{documentation}}</noinclude>


Opens the infobox. This title is
the top of the infobox: if unspecified it says "Unknown".

NOTE: whitespace (linebreaks) don't affect the code.

Here is the image and image's caption.
If {{{image}}} or {{{imagecaption}}} is undefined,
the image or caption is omitted.


The first two-column header. It says "Some attributes".
Feel free to change "Some attributes" to your needs!

 
Each of these is a field in the infobox.
They represent {{{first}}}, {{{second}}}, {{{third}}}.
By default, they say "First", "Second", "Third".
If undefined, they say "Unknown".






The second two-column header.

 
These are 3 infobox fields, but they're different
from the previous (red) fields. They'll be totally
hidden, if their parameters are undefined.
 


The third two-column header.

Because of the layout="horizontal", These two parameters
display side-by-side instead of one after the other.


Closes the infobox.
It's best not to mess with this.
 
Now the table and infobox is closed.
This last template displays documentation.


Visibility[]

There are two types of infobox rows: those with default values and those which are hidden if no value is given. By default, the first three have default values, and the fourth, fifth, and sixth are hidden.

Below, two infoboxes: on the right, I have filled in the template entirely, but on the left I have left all six fields blank. Because they're blank, the first three return the default value "Unknown". The fourth, fifth, and sixth, as well as "Previous" and "Next" are differently coded: when no value is specified, they do not appear at all. Keep this difference in mind.


Edit your infobox![]

DON'T CHANGE THE PAGE Template:Infobox! You're supposed to leave it unchanged and edit other infobox templates, which you can copy from Template:Infobox.

I'll assume that at this point, you already have an infobox or infobox template at the location "Infobox Wolf3D level" on your wiki[footnotes 1], or whatever you've decided to name it. If you haven't, take a look at my other blog: User blog:Thisismyrofl/Creating a portable new-style infobox.

Any part of this can be modified, but look at the {{{3}}}, {{{3}}}, and {{{3}}} parts. Those are the important parts we need to work with. Until your abilities with templates have improved, it's best to leave the {{{3}}} and {{{3}}} parts alone.

Editing headings[]

Click here to see how I did it!

By default, the infobox has three heading snippets, highlighted in green in my above code. Their default texts are "some attributes", "other attributes", and "Order".

<header>Some attributes</header>

...

<header>Other attributes</header>

...

<header>Order</header>

The default texts aren't really specific enough for a lot of wikis. Just change the text "Some attributes", "Other attributes", and "Order" (highlighted here in yellow) to your liking! You can leave the rest of the code intact.

As always, you can remove either or both of the headings if you want (just delete any code that looks like the above headings) or add headings (just paste in a copy of the above code).

Editing rows with defaults[]

Click here to see how I did it!

By default, the infobox has six rows, the first three of which have the property that when a parameter is undefined, the row is still visible - showing instead a default text.

<data source="first"><label>First</label><default>''Unknown''</default>
<data source="second"><label>Second</label><default>''Unknown''</default>
<data source="third"><label>Third</label><default>''Unknown''</default>

Each of these three obvious snippets is a row, but the default headings ("first", "second", "third") don't work for a lot of people. So we can feel free to change them! I've highlighted the bits of code you'd edit.

  1. Change the label text (here highlighted in cyan) to read whatever you want to appear on the left side of the infobox row.
  2. Change the parameter name (here highlighted in green) to display the parameter name you decided on in your default syntax earlier. For example, my first parameter was to be "crosses", so I'd replace "first" with "crosses".
  3. Change the default text (highlighted in yellow) if you want. The default action is that an unspecified parameter will display the code ''Unknown'' which returns an italicized: "Unknown". You can change the default text to whatever you want, and format it with italics, without italics, or otherwise. For example, my default number of crosses was to be "0". So, I would replace the ''Unknown'' with 0.
  4. I've highlighted and explained how to edit the "First" row, but you can follow the same steps for the second and third.

As always, remember that you can remove one, two, or all three of the above rows in order to use fewer rows with defaults (perhaps if you want all your rows to be hidden), or you can add your own.

Editing rows that hide[]

Click here to see how I did it!

By default, the infobox has six rows, the fourth, fifth, and sixth of which have the property that when a parameter is undefined, the row does not appear at all. Contrast with the above behavior, where the row remains visible.

<data source="fourth"><label>Fourth</label>
<data source="fifth"><label>Fifth</label>
<data source="sixth"><label>Sixth</label>

Each of these rows is a row of the infobox, but the default headings ("fourth", "fifth", "sixth") don't work for a lot of people. So we can feel free to change them! I've highlighted the bits of code you'd edit.

  1. Change the label text (here highlighted in cyan) to read whatever you want to appear on the left side of the infobox row.
  2. Change the parameter name (here highlighted in green) to display the parameter name you decided on in your default syntax earlier. For example, my first parameter which I wanted to be hidden was to be "par", so I'd type par in place of fourth.
  3. I've highlighted and explained how to edit the "Fourth" row, but you can follow the same steps for "Fifth" and "Sixth".

As always, remember that you can remove one, two, or all three of the above snippets of code in order to use fewer rows with default action to hide, or you can add your own.

Editing order rows[]

Click here to see how I did it!

The infobox also comes with two parameters meant to appear side-by-side. If omitted, they remain invisible (much like the fourth, fifth, and sixth parameters).

<data source="previous"><label>Previous</label>
<data source="next"><label>Next</label>

These parameters display side-by-side because of the layout="horizontal" in the <group> tag.

  1. Change the label text (here highlighted in cyan) to read whatever you want to appear on the left side of the infobox row.
  2. Change the parameter name (here highlighted in green) to display the parameter name you decided on in your default syntax earlier. For example, my first parameter which I wanted to be hidden was to be "par", so I'd type par in place of fourth.

As always, remember that you can remove the above snippets of code in order to use fewer rows with default action to hide, or you can add your own.

We're mostly done![]

Now you can save the page! Enjoy your new infobox! Paste your default syntax into an article and fill it in. The infobox I made looks like the one on the right. Super pretty!

Finishing touches[]

The above steps are the important part, which is why I had you save the page. There's a few other things that we can do, but your template will function fine without them.

Default title[]

Click here to see how I did it!

The |title= parameter controls what appears at the top of the infobox, in the fourth row of the code.

<title source="title"><default>''Unknown''</default></title>

By default, you have to fill it in, otherwise your infobox will have a nasty italicized "Unknown" at the top. A smarter behavior can be brought about by switching in a {{PAGENAME}<nowiki/>} magic word:

<title source="title"><default>{{PAGENAME}}</default></title>

Now, if the title is left blank, it'll default to the name of the page. You might still have to edit the |title= parameter on some pages.

Documentation[]

Templates are kinda complicated, so it's best to have a little snippet of information on how to use it at the bottom of the template. You'll notice that at the bottom of the default template code, there's a {{Documentation}} template call. This calls Template:Documentation, which varies from wiki to wiki, but in any case, it will transclude the page located at Template:Your template/doc.

Here's a wise layout for your new template's documentation:

== Default syntax==
Paste this into the page, then fill it in, to use the template.
<pre>
{{Infobox Wolf3D level
| title         = 
| image         = 
| imagecaption  = 
| crosses       = 
| chalices      = 
| chests        = 
| par           = 
| song          = 
| secrets       = 
| previouslevel = 
| nextlevel     = 
}}
</pre>

<noinclude>[[Category:Template documentation]]</noinclude>

Paste that to Template:Infobox Wolf3D level/doc (substituting in the name of your infobox) on your wiki[footnotes 1] Remember, though, that you need to substitute in your default syntax for what I've pasted here.

Be bold![]

I've only outlined the basics of editing infoboxes. Feel free to be bold and try editing them further! If you mess up, you can always undo the edits from the page's history.

And always feel free to ask someone for help if you need it!

And I would love it if you would send me a message if my blogs helped you!

Notes[]

  1. 1.0 1.1 A number of times, this page refers to pages on your wiki, such as "Template:Infobox on your wiki". I don't know what your wiki is, so I can't directly link to it, but if you're having trouble finding the correct page, just click the link to go to the equivalent page on Community Central, then edit the URL so that community.wikia.com is substituted with your wiki's URL: for example wolfenstein.wikia.com.

See also[]