View source for Help:Saintapedia badges

{{Notice|For a list of all USApedia badges see [[Help:Finding USApedia badges]].}}
{{Help Box}}
A ''' badge''' or '''userbox''' (commonly abbreviated as '''UBX''') are small colored box (see examples to the right) designed to appear only on a USApedian's [[Special:MyPage | User Page]]  as a communicative notice about the user, in order to directly (or even indirectly) help USApedians collaborate more effectively on articles.

They generally include one or two small graphics and a few short lines of text. Often they also include wiki markup that places the user in a [[Categories|category]].
*Badges are generally intended to be used only on userpages.
*Badges are tools intended for communication purposes, such as helping editors collaborate more effectively on articles.
*Badges on this wiki should be created as [[Templates|templates]] and [[help:transclusion|transcluded]] onto user pages.  See 

== List of Badges==
{| class="wikitable" align="right"
|-
! Badge gallery
|-
| [[Image:Badge gallery.png|thumb|alt=Screenshot of the [[Badge gallery]] showing a number of rectangle boxes each with an image on the left|Screenshot of [[Help:Finding USApedia badges/Badge gallery | badge gallery]]|link=Help:Finding USApedia badges/Badge gallery|400px|right]]
|-
| See the full listing at [[Help:Finding USApedia badges]]
|}

See [[Help:Finding USApedia Badges]] for a list of badges and instructions on easily adding them to your userpage.

==Why add badges to your user page==

Badges help you:
* connect with other USApedia editors
* tell more about yourself
* make your [[User page]] more visually appealing
* Promote your efforts, organizations, or communities which you are a member

== How to add badges to your user page==
To add templates, see:
* [[Help:Visual editor#Templates|Templates]] for [[Help:Visual editor|VisualEditor]] or 
* [[Help:Templates]]
<big>'''We recommend you start by:'''</big> 
# adding a [[Help:Finding USApedia badges#Blank Badge box|Blank Badge box]] ([[template]]) to [[Special:Mypage|your user page]] and then
# adding badges after the equals sign (=), such as '''<nowiki>|Badge1 = {{Plain language badge}}</nowiki>'''<del><del>

== Badge ideas ==

=== Created ===
* Linux user
* Template Creator
* Gardener
* Nav Box creator
*
* '''Stub creator''' - especially focusing on create [[USApedia:Stub|Stub articles]] from red links on [[Acronyms | Acronyms]] page and adding other acronyms.
* Programming languages - {{W|Wikipedia:Userboxes/Programming}}

=== Ideas ===
* Experts - especially sciences - {{W|Wikipedia:Userboxes/Expertise}}
* {{W|Wikipedia:Userboxes/Profession}}
* Grammarian
* Article Rescue Squadron
* [[Category]] Creator
* Make more than 10 edits 
* Create more than 2 pages 
* Homepage improvement team 
* Current Events WikiProject
* Mac user

== How to Create Your Own Badge ==
=== Certification badges ===
There is an {{tlx|Certification badge}} that allows badges to be easily created for individuals who have earned a certification.

=== Group badge ===
{{tlx|Group badge}} allow you to easily and quickly create a badge for a group

=== General badge ===
{{tlx|General badge}} allow you to easily and quickly create a badge with full customization

=== Other badges ===
Badges can made for other efforts, organization,accomplishments.  to do so, an individual needs
# an idea
# a small graphic image (44 pixels x 44 pixels ideally)
# to [[Help:Files|upload]] the image to USApedia
# to copy the code into a new template
# make the three changes listed below

===Typical Content===
Typical userbox content examples:

*This user <verb phrase> <noun phrase>.
**This user is <noun phrase>.
**This user is a member of <noun phrase>.
**This user is a fan of <noun phrase>.
**This user supports <noun phrase>.
**This user contributes to <noun phrase>.
**This user is interested in <noun phrase>.
**This user is fascinated by <noun phrase>.

Other combinations are obviously possible.

=== Category inclusion ===
*Do not create categories which could potentially include all USApedians.  For example, userboxes such as: "This user is human."; "This user uses the internet"; etc., should not include category markup based on such criteria.
*Do not ''negatively'' categorize "not"-based userboxes. For example: "This user does not like <noun phrase>."

=== Caution about image use ===
*Make certain the image license conforms with our [[What Not To Post On USApedia|copyright policy]].

=== Example Wikitext for the template ===
{| class="wikitable"
|+ Example Code from Gardening Badge
! Garden Badge Code
! Changes You Need to Make
|- 
| <nowiki>{{userbox</nowiki><br>
<nowiki>| border-c = navy</nowiki><br>
<nowiki>| id       = [[File:Gardening Badge.jpg|44px]]</nowiki><br>
<nowiki>| id-c     = #ccccff</nowiki><br>
<nowiki>| info     = This USApedian is a '''[[USApedia:Gardening|Gardener]]'''.</nowiki><br>
<nowiki>| usercategory = USApedia Gardener</nowiki><br>
<nowiki>| nocat = {{{nocat|}}}</nowiki><br>
<nowiki><br style="clear:both" /></nowiki><br>
<nowiki>}}</nowiki><br>
<nowiki><noinclude></nowiki><br>
<nowiki>{{documentation}}</noinclude></nowiki><br>
| [[File:Badge Code Example.jpg]]
|}

'''Remember:'''
* <nowiki>'''</nowiki> will make text bold.
* In the example <nowiki>This USApedian is a '''[[USApedia:Gardening|Gardener]]'''.</nowiki> using the <nowiki> | </nowiki> changes how the link will appear on the page.  In this case, <nowiki> [[USApedia:Gardening]] </nowiki> normally appears as [[USApedia:Gardening]].  By changing it to <nowiki> [[USApedia:Gardening|Gardener]] </nowiki>, the link now shows up as [[USApedia:Gardening|Gardener]] instead of [[USApedia:Gardening]].

'''After you create your own badge, please''' 
# add it to the [[Help:USApedia Badges#List_of_Badges | list above]].
# create {{W|Wikipedia:Template documentation|documentation}} on how to add it to your page.  See the [[Template:Gardening Badge/doc|Gardening Badge documentation]] for an example.

=== How to construct the box ===
There are a number of box types to select from when deciding to make a badge. 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, badges are typically made using maker-templates that have a number of parameters.
{| class="wikitable"
!Template Parameters
!Meaning
!Value type
|-
|border-c
|<span style="border:1px solid #333;">The '''border color''' of the userbox.</span>
|[[Web colors|CSS color value]] ([[hexadecimal|#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 [[Point (typography)|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. [[Pixel|px]], [[Point (typography)|pt]]
|-
|id-lh
|The distance between text lines of id box.
|CSS relative line height/length value. [[Em (typography)|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 Wikipedia 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.

'''See more options''' on {{tl|Userbox}} template page itself.

=== Badge types ===

{| width="100%" cellspacing="1" cellpadding="2" style="background: #99f; color: #000;"
! colspan="2" style="background: #fff;" |Types of Userboxes
|-
! 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}}
|}

=== Badge sampling templates ===
To make it easier to quote the generation code for a userbox in a uniform format, a template {{tl|Userbox sample compact}} has been made available, which produces a picture of the userbox along with the code necessary to create it. To use it, just give it exactly the same parameters you would give the {{tl|Userbox}} template. You must use '''subst:''', or the template will not work properly. An example is shown below:
:<nowiki>{{subst:Userbox sample compact|id=UBX|id-c=red|info=This is a '''[[WP:UBX|Userbox]]'''.}}</nowiki>
Produces:

{| border="1" cellpadding="2" cellspacing="0"
|-
| style="width:350px; text-align: left; font-size: 8pt; color:black;  font-family: Arial; " |<nowiki> {{{{Visua|}=|itor tra=tion|{{Notice=r|list= al|ower=ia|dges = </nowiki><nowiki>[[He</nowiki><nowiki>|Findin=ower|ia bad=]|}</nowiki>
{{Bad=box
||ge= <nowiki>{{</nowiki>|r Po=pedi|n =|o=||year=2011|month=06|day=1=|
|Bad= = {{!}}}}

| <div style="float:{{{float|left}}}; border:{{{border-width|{{{border-s|1}}}}}}px solid {{{border-color|{{{1|{{{border-c|red}}}}}}}}}; margin:1px;">
{| cellspacing="0" style="width:238px; background:{{{info-background|{{{2|{{{info-c|#EEE}}}}}}}}};"
| style="width:45px; height:45px; background:{{{logo-background|{{{1|red}}}}}}; text-align:center; font-size:{{{logo-size|{{{5|{{{id-s|14}}}}}}}}}pt; color:{{{logo-color|{{{id-fc|black}}}}}};" | '''{{{logo|{{{3|UBX}}}}}}'''
| style="font-size:{{{info-size|{{{info-s|8}}}}}}pt; padding:4pt; line-height:1.25em; color:{{{info-color|{{{info-fc|black}}}}}};" | This is a '''[[WP:UBX|Userbox]]'''.
|}</div>

|}

There are not yet any similar templates available for userboxes created by the templates ''Userbox-r'', ''Userbox-2'' and ''Userbox-m''.

== List of badges ==
Below is the list of [[:Category:Badges]], displayed using a [[Dynamic Page List]].

{{Div col|300px}}
<DynamicPageList>
  category=Badges
  ordermethod=categoryadd
  order=descending
  namespace=Template
  shownamespace = false
  addfirstcategorydate = true
</DynamicPageList>
{{div col end}}

==See also==
For more details, as well as an extensive list of Userboxes in use on Wikipedia, see {{W|Wikipedia:Userboxes}}.

* [http://www.yerich.net/userbox/ Userbox Maker]

{{USApedia}}

[[Category:Help]]
[[Category:Badges]]