User:Willscrlt/UBX/Userbox-2/doc



Purpose
&#123;&#123;&#125;&#125;&#32;&mdash; makes a userbox for users to provide information about themselves on their user page. This version has

This template was forked from the Userbox template on the English Wikipedia, which has different usage examples and has changed since. Additionally, this template has been enhanced to be more compatible and functional across multiple wikis. Most userboxes developed for one wiki should continue to work as-is (or with just a few tweaks) on other wikis if this template is used.

One big difference is that this template uses parser functions to combine three templates (Userbox, Userbox-r, and Userbox-2) into a single template. It does this by adding one additional attribute:. The possible values are 'l' (the default) for a userbox with the smaller ID box (usually for logos) on the left (standard Userbox layout), 'r' for the reverse (Userbox-r layout), and '2' for a userbox an ID box on both ends (Userbox-2 layout). If this doesn't make sense, don't worry about it. I've created my own versions of each of these templates, so you can just use them and ignore the  attribute if you prefer.

''This is version 2.1.0 (Userbox) of my custom template. The most current version is available from my English Wikipedia account.''

Compact form
For simple userboxes, the compact form is simple, fast, and easy to understand. The numerical labels shown below ('1=', '2=', etc.) are optional unless your data includes any equal signs ('='). If you do not use labels, you must enter the values in the proper order. All attributes are optional, but you may not skip any attributes prior to the one you want to specify. It is the order of the attributes that is important when omitting labels, and skipping attributes messes up the order and breaks the template. To avoid all those limitations, simply include the numerical labels or the extended labels from the Extended form below.

This form is convenient, but considered deprecated on many Wiki projects. The standard Userbox template here may not support this form in the future, and the order of the attributes may change.

Extended form
Using the extended form gives you much more control, but you must spell and capitalize the labels exactly as shown. All attributes are optional and may appear in any order. You may mix numerical and extended labels, but extended labels take precedence over numerical ones.

This form uses the labels found on many Wiki projects. The default values may be significantly different from project to project, and not all projects offer all of these attributes.

Related templates

 * My versions of the templates available here at
 * :Willscrlt/UBX/Userbox &mdash; One ID box on the left and a larger Info area on the right
 * :Willscrlt/UBX/Userbox-r &mdash; The reverse layout of previous template
 * :Willscrlt/UBX/Userbox-2 &mdash; Two ID boxes with a larger Info area centered between


 * Local versions (if any) of the templates available here at
 * :Userbox
 * :Userbox-r
 * :Userbox-2


 * Original versions available on the English Wikipedia which include more examples
 * Userbox
 * Userbox-r
 * Userbox-2