View source

A userbadge is a small colored box (see examples to the right) designed to appear on a DareNET Wiki user's page as a communicative notice about the user.

== Using Existing Userbadges ==

Userbadges are for the use of users on their own user pages. It is considered uncivil to place any userbadges on any other user's page(s) without their permission. However, userboxes may be placed on non-mainspace talk/discussion pages by anyone.

== Syntax ==

The standard syntax for adding a userbadge to your user page (also known as transclusion) is: 

<code><nowiki>{{Userbadge/name_of_badge}}</nowiki></code>

=== Optional Substitution ===

You may decide to substitute the template code onto your user page using the syntax <nowiki>{{subst:Userbage/name_of_box}}</nowiki>. The use of "subst:" will ensure that the template is always displayed in its form when you add it to your user page, i.e. it will not reflect subsequent edits to the template. This method will lead to large amounts of code on your user page.

== Constructing a Userbadge ==

=== How to construct the box ===

There are a number of box types to select from when deciding to make a userbadge. The most commonly used design is the "'''Standard box'''". It has one square shaped area on the left ("''id''") and a rectangular area on the right ("''info''").

For ease of use, userbadges are made using maker-templates that have a number of parameters. Once the maker-template is saved, it is automatically transformed to HTML.
{| class="wikitable"
!Template Parameters
!Meaning
!Value type
|-
|border-c
|<span style="border:1px solid #333;">The '''border color''' of the userbox.</span>
|CSS color value (#hex or color name)
|-
|border-s
|<span style="border:4px solid #3f3;">The '''border size''' of the userbox.</span>
|Width in pixels
|-
|id-c
|<span style="background:#efe">The '''background color''' of the id box.</span>
|CSS color value
|-
|id-s
|The font <span style="font-size:150%">'''size'''</span> of the id box.
|Size in PostScript points
|-
|id-fc
|The font <span style="color:#090">'''color'''</span> of the id box text.
|CSS color value
|-
|id-p
|The distance between border and content of id box.
|CSS padding width value. px, pt
|-
|id-lh
|The distance between text lines of id box.
|CSS relative line height/length value. em
|-
|info-c
|<span style="background:#efe">The background color of info box.</span>
|CSS color value
|-
|info-s
|The font <span style="font-size:150%">'''size'''</span> of info box.
|Size in PostScript points
|-
|info-fc
|The font <span style="color:#090">'''color'''</span> of info box.
|CSS color value
|-
|info-p
|The distance between border and content of info box.
|CSS padding width value. px, pt
|-
|info-lh
|The distance between text lines of info box.
|CSS relative line height/length value. em
|-
|id
|This is the '''content''' of the id box.
|Free-form
|-
|info
|This is the '''content''' of info box.
|Free-form
|}

The '''id''' and '''info''' boxes can include text, links, and images using the usual wiki syntax.  Generally, the '''id''' box will contain a few letters or a 43px image, while the '''info''' box will contain a sentence with a link or two.

===== Userbadge types =====

{| cellspacing="1" cellpadding="2" style="background: #99f; color: #000;"
!style="background: #fff;"|Code
!style="background: #fff;"|Appearance
|-
!colspan="2" style="background: #fff; text-align: left; padding: 0 1em;"|Standard box
|-
|style="background: #fff;"|<tt><nowiki>{{Userbox |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |info-c=#039 |info-s=8 |info-fc=#fff |id=ID |info=Content}}</nowiki></tt>
''or'' <tt><nowiki>{{Userbox |side-box colour |main box colour |side-box content |main box content}}</nowiki></tt>
|style="width:243px; background: #fff;"|{{Userbox |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |info-c=#039 |info-s=8 |info-fc=#fff |id=ID |info=Content}}
|-
!colspan="2" style="background: #fff; text-align: left; padding: 0 1em;"|Reverse box
|-
|style="background: #fff;"|<tt><nowiki>{{Userbox-r |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |info-c=#039 |info-s=8 |info-fc=#fff |id=ID |info=Content}}</nowiki></tt>
''or'' <tt><nowiki>{{Userbox-r |side-box colour |main box colour |side-box content |main box content}}</nowiki></tt>
|style="width:243px; background: #fff;"|{{Userbox-r |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |info-c=#039 |info-s=8 |info-fc=#fff |id=ID |info=Content}}
|-
!colspan="2" style="background: #fff; text-align: left; padding: 0 1em;"|Double box
|-
|style="background: #fff;"|<tt><nowiki>{{Userbox-2 |border-c=#000 |border-s=1 |id1-c=#fff |id1-s=12 |id1-fc=#000 |id2-c=#000 |id2-s=12 |id2-fc=#fff |info-c=#039 |info-s=8 |info-fc=#fff |id1=ID 1 |id2=ID 2 |info=Content}}</nowiki></tt>
''or'' <tt><nowiki>{{Userbox-2 |side-box 1 colour |main box colour |side-box 1 content |message |side-box 2 content |border colour |side-box 2 colour |main box font-colour |box border thickness}}</nowiki></tt>
<br/>'''''Note''': If omitted, border colour and side-box 2 colour default to the same colour as side-box 1, and font colour is black.  Default border thickness is 1.''
|style="width:243px; background: #fff;"|{{Userbox-2 |border-c=#000 |border-s=1 |id1-c=#fff |id1-s=12 |id1-fc=#000 |id2-c=#000 |id2-s=12 |id2-fc=#fff |info-c=#039 |info-s=8 |info-fc=#fff |id1=ID 1 |id2=ID 2 |info=Content}}
|-
!colspan="2" style="background: #fff; text-align: left; padding: 0 1em;"|Mini box
|-
|style="background: #fff;"|<tt><nowiki>{{Userbox-m |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |id=ID}}</nowiki></tt>
''or'' <tt><nowiki>{{Userbox-m |box colour |box content}}</nowiki></tt>
|style="width:243px; background: #fff;"|{{Userbox-m |border-c=#000 |border-s=1 |id-c=#fff |id-s=12 |id-fc=#000 |id=ID}}
|}