Template:AllyBox

From FBSA Wiki
Jump to navigation Jump to search

Summary

Details

Getting Started

Setting up the AllyBox is incredibly simple. Start off by copying and pasting the code below into the section where you want the information to show up.

{{AllyBox



|}}

This will set up a table with Friends, Neutrals and Enemies categories as seen below:


Friends
Neutrals
Enemies

Adding Characters

Once the initial template in place, characters are easily added by entering in information for their name and description. This is done by setting pre-defined parameter values. The parameters follow the pattern of {REL}{LOC}{NUM)}, where {REL} is either "friend", "neutral" or "enemy", {LOC} is either "name" or "desc" and {NUM} is a numerical value from 1 to 20. For example, "friendname1", "neutraldesc5" and "enemyname20" are all valid parameters.

To add characters, enter values for the parameters in numerical order. Since the wording may be confusing, an example of the code is placed below:

{{AllyBox
| friendname1 = Friend #1
| frienddesc1 = The description for Friend #1
| friendname2 = Friend #2
| frienddesc2 = The description for Friend #2
| neutralname1 = Neutral #1
| neutraldesc1 = The description for Neutral #1
| enemyname1 = Enemy #1
| enemydesc1 = The description for Enemy #1
|}}

The blue and green code is what we added to the original template. Blue indicates the necesarry parts of the template and green indicates the editable sections. An updated view of how the template would look is shown below:


Friends
  • Friend #1: The description for Friend #1
  • Friend #2: The description for Friend #2
Neutrals
  • Neutral #1: The description for Neutral #1
Enemies
  • Enemy #1: The description for Enemy #1

Titles

Let's suppose for a minute that you want to change the title of one or more categories. This can be done by setting the parameters "friendtitle", "neutraltitle" and "enemytitle". The following is an updated example of our previous code:

{{AllyBox
| friendtitle = Good People
| neutraltitle = So-So People
| enemytitle = Bad People
| friendname1 = Friend #1
| frienddesc1 = The description for Friend #1
| friendname2 = Friend #2
| frienddesc2 = The description for Friend #2
| neutralname1 = Neutral #1
| neutraldesc1 = The description for Neutral #1
| enemyname1 = Enemy #1
| enemydesc1 = The description for Enemy #1
|}}

Just like before, the blue text indicates a part of the template, and the green is the editable regions. The code above would create the following example:


Good People
  • Friend #1: The description for Friend #1
  • Friend #2: The description for Friend #2
So-So People
  • Neutral #1: The description for Neutral #1
Bad People
  • Enemy #1: The description for Enemy #1

Coloring

Lastly, it is possible to change the color of the individual columns to fit the color scheme of your page. The colors you choose must either be standard html colors (i.e. "red", "blue" and so on) or in hexidecimal form ("#024334", "#FFFFFF", ect). To set the color of a column, set the paramters for friendcolor, neutralcolor and enemycolor. The following is an example:

{{AllyBox
| friendcolor = red
| neutralcolor = #666666
| enemycolor = blue
| friendtitle = Good People
| neutraltitle = So-So People
| enemytitle = Bad People
| friendname1 = Friend #1
| frienddesc1 = The description for Friend #1
| friendname2 = Friend #2
| frienddesc2 = The description for Friend #2
| neutralname1 = Neutral #1
| neutraldesc1 = The description for Neutral #1
| enemyname1 = Enemy #1
| enemydesc1 = The description for Enemy #1
|}}

As with the prior examples, blue code indicates a part of the template and green represents the editable region. These changes would make our example template look like this:


Good People
  • Friend #1: The description for Friend #1
  • Friend #2: The description for Friend #2
So-So People
  • Neutral #1: The description for Neutral #1
Bad People
  • Enemy #1: The description for Enemy #1

Tips

Including Links

Often times, people might want to include links to other people's pages. This can be done two ways and is entirely up to user preference.

Option 1

The simplest and easiest way to add links to VirtueVerse pages would be to encompass the character names in the standard "[[ ]]" brackets. Let's modify our basic code (before we added the title and color changes) to see how that code would look. The edits are hightlighted in blue below:

{{AllyBox
| friendname1 = [[Friend #1]]
| frienddesc1 = The description for Friend #1
| friendname2 = [[Friend #2]]
| frienddesc2 = The description for Friend #2
| neutralname1 = [[Neutral #1]]
| neutraldesc1 = The description for Neutral #1
| enemyname1 = [[Enemy #1]]
| enemydesc1 = The description for Enemy #1
|}}

These minor changes to the code would make the output look like this:


Friends
Neutrals
Enemies

Option 2

While option 1 isn't a bad solution, the blue and red links may be difficult to see on some backgrounds. They also make the columns less monotone, which for some might be less stylistically appealing. If this is an issue, there is a second option.

By editing the section titles, it is possible to add references to link to various other pages. The following is an example of this approach (new changes appearing in blue):

{{AllyBox
| friendtitle = Friends<ref>Friend links: [[Friend #1]] and [[Friend #2]]</ref>
| neutraltitle = Neutrals<ref>Neutral links: [[Neutral #1]]</ref>
| enemytitle = Enemies<ref>Enemy links: [[Enemy #1]]</ref>
| friendname1 = Friend #1
| frienddesc1 = The description for Friend #1
| friendname2 = Friend #2
| frienddesc2 = The description for Friend #2
| neutralname1 = Neutral #1
| neutraldesc1 = The description for Neutral #1
| enemyname1 = Enemy #1
| enemydesc1 = The description for Enemy #1
|}}

When using this method, be sure to place the code for references ("<references />") on the bottom of your page so that the links become visible. By linking to other pages this way, the links become non-obtrusive to the style of the page while still providing users with the ability to provide links for additional info. This can be seen in the example below:


Friends[1]
  • Friend #1: The description for Friend #1
  • Friend #2: The description for Friend #2
Neutrals[2]
  • Neutral #1: The description for Neutral #1
Enemies[3]
  • Enemy #1: The description for Enemy #1

Limitations

Currently, the AllyBox only has room for 20 friends, 20 neutrals and 20 enemies. This limit is completely arbitrary and can be expanded if requested.


  1. Friend links: Friend #1 and Friend #2
  2. Neutral links: Neutral #1
  3. Enemy links: Enemy #1