Help:Userboxes

From the Portal Wiki
Revision as of 07:06, 28 September 2021 by Tark (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Instructions

User info boxes, or user boxes, are small tags that can be placed on your user page to denote affiliations, hobbies, achievements, etc. They can be either public (in the Template namespace), or private (in the User namespace).

See also: Portal Wiki:Userboxes

It's not polite to use unlisted user boxes without permission!

Note: When possible, please use user info boxes that have already been created.

Using a User Info Box

Using a user box is as simple as adding the template to your user page. For example, the Aperture Science Employee userbox can be found at Template:User Aperture Science Employee.

To add a public user box to your page, you include the template like so:

{{User Aperture Science Employee}}

The above example produces the following userbox:

User Aperture AI icon.png This user is an employee of Aperture Science.


Displaying several User Info Boxes

Userboxes cannot be simply piled onto a user page, as this causes them to stack diagonally. The simplest way to display them is to use a table, which will arrange them into a grid.

{| align="center"
| {{User Wiki Staff}}
| {{User Wiki Translator}}
| {{User Animal|rooster}}
| {{User Portal 2 release}}
|}

The above example produces the following:

Achievement Aperture Science.png This user is a Portal Wiki staff member.

Portal logo.png This user is a Portal Unnoficial Wiki translator!

Ping rooster.png This user's favorite animal is a Rooster!

Portal 2 logo.png This user was online at Portal 2's release.

This code can be used to display between 1 and 4 columns of userboxes. More rows can be added by inserting |- into the table:

{| align="center"
| {{User Wiki Staff}}
| {{User Wiki Translator}}
| {{User Animal|rooster}}
|-
| {{User Portal 2 release}}
| {{User Portal}}
| {{User Wiki age|day=12|month=02|year=2011}}
|}

The above example produces the following:

Achievement Aperture Science.png This user is a Portal Wiki staff member.

Portal logo.png This user is a Portal Unnoficial Wiki translator!

Ping rooster.png This user's favorite animal is a Rooster!

Portal 2 logo.png This user was online at Portal 2's release.

Portal logo.png This user enjoys Portal.

Achievement Overclocker.jpg As of May 30, 2024,
I have been a Portal Wikipedian for 13 years, 3 months, and 18 days. (since February 12, 2011)


Parameters

Some userboxes require additional parameters to work properly. A parameter is added to the template with a | symbol separating it from the template title:

{{User Element|cu}}

will generate:

Cu This user's favorite element is Copper.


To add a private user box, you must use the full path to the template, as follows:

{{User:CountDOODOO/Template:User_Bright}}

will generate: User:CountDOODOO/Template:User Bright

Note: Note that when including a user box from the User namespace, you MUST include the Template prefix.

Creating a User Info Box

Very widely used user boxes (such as Template:User Aperture Science Employee) should be created in the Template namespace. All other user boxes should be in the User namespace (such as User:CountDOODOO/Template:User Example).

1. Navigate to the page you wish to use for your userbox.
The naming convention for user boxes is:
Template:User Name of user box
ALL user boxes should be prefixed with "User" to avoid any conflicts with articles.
2. Copy the code below. Do NOT edit the global user box template.
{{Userbox
  |border-c = Border Color (Hex)
  |border-s = Border Size (Pixels, Use 1 to match others)
  |id-c     = ID field bgcolor (Hex)
  |id-s     = ID field Font size (Pixels, Use 14 to match others)
  |id-fc    = ID field Color (Hex)
  |info-c   = Info text bgcolor (Hex)
  |info-s   = Info Font size (Pixels, use 7 to match others)
  |info-fc  = Info text color (foreground)
  |id       = ID field text (Small Section.  40px image OR Two 14pt Characters ONLY)
  |info     = Info field Text (Large Section, Text ONLY)
}}
3. Edit everything to the right of the = sign as desired.
Note: The maximum text size for the id is 24! Do not exceed this value, or the box will stretch.
4. (Optional) If you want your user box to be listed as public, go to Portal Wiki:Userboxes and add the following (Replace USERBOX NAME with the name of your user box):
{{Userbox_preview|UIB=USERBOX NAME}}