Help:Userboxes: Difference between revisions

From the Portal Wiki
Jump to navigation Jump to search
m (Keep forgetting the navbar >.<)
mNo edit summary
 
Line 1: Line 1:
{{NS HELP navbar}}
==Instructions==
==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).
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).


'''Existing User Boxes''': [[User_info_boxes|User Info Boxes]]
{{See also|Portal Wiki:Userboxes}}


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


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


==Using a User Info Box==
==Using a User Info Box==
Using a user box is as simple as adding the template to your user page. For example, the TF2 Junky userbox can be found at [[Template:User TF2 junky]].
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:
To add a public user box to your page, you include the template like so:
:<pre>{{User TF2 junky}}</pre>
:<pre>{{User Aperture Science Employee}}</pre>


The above example produces the following on your user page:
The above example produces the following userbox:
{{User TF2 junky}}
{{User Aperture Science Employee}}
{{clr}}
==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.


<pre>
{| align="center"
| {{User Wiki Staff}}
| {{User Wiki Translator}}
| {{User Animal|rooster}}
| {{User Portal 2 release}}
|}
</pre>
The above example produces the following:
{| align="center"
| {{User Wiki Staff}}
| {{User Wiki Translator}}
| {{User Animal|rooster}}
| {{User Portal 2 release}}
|}
This code can be used to display between 1 and 4 columns of userboxes. More rows can be added by inserting <code>|-</code> into the table:
<pre>
{| 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}}
|}
</pre>
The above example produces the following:
{| 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}}
|}
==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:
<pre>{{User Element|cu}}</pre>
will generate:
{{User Element|cu}}
{{clr}}
To add a private user box, you must use the full path to the template, as follows:
To add a private user box, you must use the full path to the template, as follows:
:<pre>{{User:CountDOODOO/Template:Recent Changes Patroller}}</pre>
<pre>{{User:CountDOODOO/Template:User_Bright}}</pre>
 
will generate:
The above example produces the following user box:
{{User:CountDOODOO/Template:User_Bright}}
{{Template:User Recent Changes Patroller}}
{{clr}}


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


==Creating a User Info Box==
==Creating a User Info Box==
Very widely used user boxes (such as [[Template:User TF2 junky]]) should be created in the Template namespace. All other user boxes should be in the User namespace (such as [[User:Firestorm/Template:User Example]]).
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.
:1. Navigate to the page you wish to use for your userbox.
Line 54: Line 105:
:: '''Note:''' The maximum text size for the id is 24! Do not exceed this value, or the box will stretch.
:: '''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 [[User_info_boxes|User Info Boxes]] and add the following (Replace USERBOX NAME with the name of your user box):
: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):
:: <pre>{{Userbox_preview|UIB=USERBOX NAME}}</pre>
:: <pre>{{Userbox_preview|UIB=USERBOX NAME}}</pre>




{{NS HELP navbar}}
__NOEDITSECTION__
__NOEDITSECTION__
[[Category:Help]]
[[Category:Help]]

Latest revision as of 07:06, 28 September 2021

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 March 29, 2024,
I have been a Portal Wikipedian for 13 years, 1 month, and 17 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}}