Help:Userbox

From FamilySearch Wiki

(Difference between revisions)
(made suitable to add as documentation for userbox templates)
m (Added section - Adding User Boxes)
Line 29: Line 29:
  
 
[[Category:Help|{{PAGENAME}}]]
 
[[Category:Help|{{PAGENAME}}]]
 +
 +
 +
=== Adding User Boxes  ===
 +
 +
How to you build a list of userboxes on your User Page? {{User box top|align=right}} {{User United Kingdom}} {{User Wiki Volunteer}} {{User BillionGraves}} {{User WikiProject United States Civil War}} {{User FGS2012}} {{User English}} {{User Danish}} {{User Wiki Maintenance}} {{User Norwegian}} {{User Italian}} {{userboxbreak|toptext=[[FamilySearch Communities|Communities]]}} {{Collapsible list
 +
|1={{User Denmark GRC}}
 +
|2={{User England GRC}}
 +
|3={{User France GRC}}
 +
|4={{User Scotland GRC}}
 +
|5={{User California GRC}}
 +
|6={{User Kansas GRC}}
 +
|7={{User Ohio GRC}}
 +
|8={{User Utah GRC}}
 +
|9={{User Virginia GRC}}
 +
}}{{User box bottom}}
 +
 +
Start by adding this code to your userpage where you want to add your userboxes:
 +
 +
<span style="color:blue"> <nowiki> {{User box top|align=right}} </nowiki>&nbsp; (</span>Note: align right, left or center.)
 +
 +
Next add the template code for the user box(es) that relate to your activities, skills and affiliations.
 +
 +
Some examples are: <span style="color:blue"> <nowiki> {{User United States}} {{User Sweden GRC}} {{User Wiki Volunteer}} {{User BillionGraves}} {{User English}} {{User Danish}} {{User Wiki Maintenance}} </nowiki></span> etc. (Note the separation of each by a space).
 +
 +
End the userbox array with this code: <span style="color:blue"> <nowiki>  {{User box bottom}}  </nowiki> </span>
 +
 +
The userboxes will now show on your user page and look like those to the right.
 +
 +
If your list of user boxes is long, you may want to include collapsible sections.
 +
 +
The code to add a collapsible section is easy to add with some simple code. The collapsible section for a Communities section looks like this: (See it in action to the right.)
 +
 +
(Note: The section description "Communities" and the link to the wiki article named "FamilySearch_Communities")
 +
 +
<span style="color:blue"><nowiki>
 +
{{userboxbreak|toptext=[[FamilySearch Communities|Communities]]}} </nowiki></span>
 +
 +
The next item to add is the collapsible box template which starts with:
 +
 +
<span style="color:blue"><nowiki>
 +
{{Collapsible list </nowiki></span> and will eventually end with double curly brackets <span style="color:blue"><nowiki> }}</nowiki></span>
 +
 +
An example of code for a collapsible FamilySearch Communities userbox section looks like this:
 +
 +
<span style="color:blue"><nowiki>
 +
{{userboxbreak|toptext=[[FamilySearch Communities|Communities]]}} {{Collapsible list
 +
|1={{User Denmark GRC}}
 +
|2={{User England GRC}}
 +
}}
 +
 +
</nowiki> </span>
 +
 +
You can add as many or few to the list as you want. Just copy the code above and modify it to fit your desire.
 +
 +
Each new item has to start with a pipe | .... then a number in consecutive order followed by the equals sign and then the userbox code.
 +
 +
<span style="color:blue"><nowiki>|1={{User Denmark GRC}}</nowiki></span>
 +
 +
Be sure to close the section with two curly brackets. <span style="color:blue"> }} </span>
 +
 +
You can have many different sections in your userbox frame. Just choose the title for each section, add the appropriate opening statement and link and then add the code for the userbox templates that you want in that section. &nbsp;Close the userbox with the code shown in the above examples.
 +
 +
Here are two userpages that demonstrate collapsible userboxes:
 +
 +
:*[[User:Cottrells|Cottrells]]
 +
:*[[User:Ldrew|Ldrew]]
 +
 +
'''The list of available userboxes is found at: '''
 +
 +
:*[[FamilySearch Wiki:Userboxes|Userboxes]]
 +
 +
<br> <br>

Revision as of 16:12, 29 August 2013

Help-content.png This help article will guide you as you edit in the Wiki. See Contributor Help for more help articles.



Comment icon crystal.png A userbox is a small rectangular box that looks like this. Below are more examples.
Formatting icon40.png Userboxes can come in many different styles and colors.
Information icon.png Userboxes can have one or two sideboxes. Broom icon.png

A userbox (commonly abbreviated as UBX) is a small colored box (see examples to the right) designed to appear only on a contributor's User page as a communicative notice about the user, in order to directly (or even indirectly) help users collaborate more effectively on articles.

Using existing userboxes

A gallery of existing userboxes can be found in the FamilySearch Wiki:Userboxes/Gallery.

The {{clear}} template can be placed after the plain userbox if text is added on a new line immediately after it.

If you have a number of userboxes, you can put {{userboxtop}} before and {{userboxbottom}} after the list to order them together on your user page.

You will generally not add a userbox to another's user page, except in the case of recognition userboxes.

Creating a new userbox

The basic template used in creating new userboxes is {{Userbox}}. Basic examples are included in the template documentation. Alternatively a request for a new userbox can be added to the FamilySearch Wiki:Userboxes talk page.


Adding User Boxes

How to you build a list of userboxes on your User Page?

Flag of the United Kingdom.png This user lives in the United Kingdom.

Volunteers wanted II.jpg

This user is a Wiki Volunteer participating in the Help Wanted Project.
Billiongraves twitter icon.png This user is a contributor to the BillionGraves database of cemetery records.
Flag of England.png This user is of English ancestry.
Flag of Denmark.png This user is of Danish ancestry.
Broom icon.png This user likes to cleanup the wiki.
Flag of Norway.png This user is of Norwegian ancestry.
Flag of Italy.png This user is of Italian ancestry.

Start by adding this code to your userpage where you want to add your userboxes:

{{User box top|align=right}}   (Note: align right, left or center.)

Next add the template code for the user box(es) that relate to your activities, skills and affiliations.

Some examples are: {{User United States}} {{User Sweden GRC}} {{User Wiki Volunteer}} {{User BillionGraves}} {{User English}} {{User Danish}} {{User Wiki Maintenance}} etc. (Note the separation of each by a space).

End the userbox array with this code: {{User box bottom}}

The userboxes will now show on your user page and look like those to the right.

If your list of user boxes is long, you may want to include collapsible sections.

The code to add a collapsible section is easy to add with some simple code. The collapsible section for a Communities section looks like this: (See it in action to the right.)

(Note: The section description "Communities" and the link to the wiki article named "FamilySearch_Communities")

{{userboxbreak|toptext=[[FamilySearch Communities|Communities]]}}

The next item to add is the collapsible box template which starts with:

{{Collapsible list and will eventually end with double curly brackets }}

An example of code for a collapsible FamilySearch Communities userbox section looks like this:

{{userboxbreak|toptext=[[FamilySearch Communities|Communities]]}} {{Collapsible list |1={{User Denmark GRC}} |2={{User England GRC}} }}

You can add as many or few to the list as you want. Just copy the code above and modify it to fit your desire.

Each new item has to start with a pipe | .... then a number in consecutive order followed by the equals sign and then the userbox code.

|1={{User Denmark GRC}}

Be sure to close the section with two curly brackets. }}

You can have many different sections in your userbox frame. Just choose the title for each section, add the appropriate opening statement and link and then add the code for the userbox templates that you want in that section.  Close the userbox with the code shown in the above examples.

Here are two userpages that demonstrate collapsible userboxes:

The list of available userboxes is found at: