View source for TabbyGarf/Guides:Userbox Etiquette

== Disclaimer ==
This userbox etiquette is part of a project of UBX (Userbox) uniformization applied in part by some administrators on their own userboxes.
This etiquette tries to obtain overall sameness of style by being visually attached to the default wiki theme. This sameness is achieved by attributing the page background color to the userbox's "id-c" and "info-c" values. Another way of reaching that sameness is setting a userbox height (id-h) of 45 pixels, this value is also set to the picture (id value). You are not obligated to follow the etiquette as you wont get banned for breaking it. It's your UBX. your style. However in the case of let's say less niche/more general Userboxes (like an admin status UBX, User info UBX like [[User:TabbyGarf/MemberFor]], [[User:TabbyGarf/UserHelper]] or {{tl|User:TabbyGarf/Translator}}. This guide supposes you know how userboxes work. [[Category:Help]] [[Category:Guides]]
== Template ==
Such a userbox can be made thanks to multiple ways.
{{userbox
| border-c      = #e87057
| border-s      = 2
| id            = UBX <!-- or [[File:filename.extension|45px|link=]] -->
| id-c          = #333
| id-h          = 45
| id-s          = 12
| id-w          = 45
| info          = This is a simple UBX template following the etiquette. This is the output from the code below.
| info-c        = #333
| info-fc       = #fff
| info-s        = 8
}}
<br>
<br>
<pre>
{{userbox
| border-c      = #e87057
| border-s      = 2
| id            = UBX <!-- or [[File:filename.extension|45px|link=]] -->
| id-c          = #333
| id-h          = 45
| id-s          = 12
| id-w          = 45
| info          = sample text
| info-c        = #333
| info-fc       = #fff
| info-s        = 8
}}
<noinclude>
{{documentation}}
</noinclude>
</pre>

To follow more the wiki's theme you can see i've set the border-c value to "#e87057" to fit the Hyperlink color.

If you dont want to bother touching any code you can use this [http://yerich.net/userbox/ UBX generator] as long as you follow the template values for "id-h", "id-w" and "id" in case you use an image.

== Documentation ==
Adding documentation is necessary for userbox usage. To make a documentation you need to put {{tl|documentation}} inside the <noinclude> tags and make a "/doc" sub-page for example, [[User:TabbyGarf/UserHelper]]'s documentation page is [[User:TabbyGarf/UserHelper/doc]].
You can use a table to show different outputs of your UBX. ''(Remove quotation marks.)''
<pre>
{|
!Template Output
!Plain Code
|-
|{{User:K-Fee/UBX}}
|<"pre">{{User:K-Fee/UBX}}<"/pre">
|-
|{{User:K-Fee/UBX|Auto}}
|<pre>{{User:K-Fee/UBX|Auto}}<"/pre">
|-
|{{User:K-Fee/UBX}}
|<"pre">{{User:K-Fee/UBX|Strand}}<"/pre">
|-
</pre>
or, in the case of a single output: 
<pre>
{|
!Template Output
!Plain Code
|-
|{{User:K-Fee/UBX}}
|<"pre">{{User:K-Fee/UBX}}<"/pre">
|-
</pre>
== Remarks made over time ==
Please do not use <font> to put a color for your UBX text, as info-fc and id-fc both exist. Also try to avoid using <font> effect because it can be ugly.

== Notable UBX Examples ==
{|
!Template 
!Template Code
!Why Is It Good?
|-
|{{User:TabbyGarf/Garfield}}
|<pre>{{User:TabbyGarf/Garfield}}</pre>
| Giving the image's color to the border.
|-
|{{FANDOMDespise}}
|<pre>{{FANDOMDespise}}</pre>
|Users a color theme similar to FANDOM's logo, text could be fixed by setting "info-s" to "8" for homogeneity
|-
|{{UserHacker}}
|<pre>{{UserHacker}}</pre>
|Follow a theme to the typical "terminal-like" color palette.
|-
|{{BLM|both}}
|<pre>{{BLM|both}}</pre>
|Uses the icon's BG color on the UBC's BG color.
|-
|{{MemberFor|year=1987|month=06|day=19}}
|<pre>{{MemberFor|year=1987|month=06|day=19}</pre>
|Example on how to use info
|-