Template:Userbox: Difference between revisions

Revision as of 14:28, 10 January 2024

Template Documentation

This template can be used to quickly create a userbox for display on a user's user page without having to know HTML or Wikitable syntax.

Usage

This template is used to create a new userbox. If you want to add an existing userbox to your user page, please check templates in PZwiki:Userboxes.

Syntax

Most HTML-based tables use only a handful of these attributes. The following subset can be used to quickly convert an HTML userbox into the format used here:

{{Userbox
| logo = 
| logo-color = 
| info = 
| info-color = 
| cat = 
}}

Parameters

logo ^Required: logo image and/or text.
logo-color: logo background color.
info ^Required: info text.
info-color: info background color.
cat: user category, omit "Category:" prefix.

Examples

{{Userbox}}

{{{logo}}}

{{{info}}}

{{Userbox}}

Spiffo welcomes you to the wiki!

How to translate

This template doesn't need to/shouldn't be translated, but you can translate the documentation of this template with the following steps:

Create a subpage of this template with the language code of the language you want to translate to.
Copy the code wrapped in the <noinclude> tag in this template into the page you created.
{{Translation guide}} template should be removed from the translated documentation.
Translate the page according to the translation requirements of normal pages.

@@ Line 1: / Line 1: @@
 <noinclude>
 {{Documentation/sandbox|doc =
-This template can be used to quickly create a [[Wikipedia:Wikipedia:Userboxes|userbox]] for display on a user's [[Wikipedia:Wikipedia:User pages|user page]] without having to know HTML or Wikitable syntax.
+This template can be used to quickly create a [[wikipedia:Wikipedia:Userboxes|userbox]] for display on a user's [[wikipedia:Wikipedia:User pages|user page]] without having to know HTML or Wikitable syntax.
 ==Usage==
-This template is used to create a new userbox. If you want to add an existing userbox to your user page, please check templates in [[#See also|see also]].
+This template is used to create a new userbox. If you want to add an existing userbox to your user page, please check templates in {{ll|PZwiki:Userboxes}}.
+===Syntax===
 Most HTML-based tables use only a handful of these attributes. The following subset can be used to quickly convert an HTML userbox into the format used here:
 <pre>
 {{Userbox
-| border-color =
-| border-width =
 | logo =
-| logo-width =
-| logo-height =
 | logo-color =
-| logo-background =
-| logo-size =
-| logo-padding =
 | info =
 | info-color =
-| info-background =
-| info-size =
-| info-padding =
 | cat =
 }}
@@ Line 28: / Line 19: @@
 ===Parameters===
-;<code>border-color</code>
+;<code>logo</code> {{sup|required}}
-:border color, default to {{Abbr|#000000|black}}.
+:logo image and/or text.
-;<code>border-width</code>
-:border width, default to 1px.
-;<code>logo</code>
-:logo image and/or text, default to ''logo'' text.
-;<code>logo-width</code>
-:logo box width, default to 60px.
-;<code>logo-height</code>
-:logo box height, default to 60px.
-:Images should normally be scaled to 60px or less.
 ;<code>logo-color</code>
-:logo font color, default to {{Abbr|#000000|black}}.
+:logo background color.
-;<code>logo-background</code>
+;<code>info</code> {{sup|required}}
-:logo background color, default to {{Abbr|#ffffff|white}}.
+:info text.
-;<code>logo-size</code>
-:logo text size, default to 14pt.
-;<code>logo-padding</code>
-:logo cell padding, default to 1px.
-;<code>info</code>
-:info text and/or image, default to ''info'' text.
 ;<code>info-color</code>
-:info font color, default to {{Abbr|#000000|black}}.
+:info background color.
-;<code>info-background</code>
-:info background color, default to #f6f6f6.
-;<code>info-size</code>
-:info text size, default to 8pt.
-;<code>info-padding</code>
-:info padding, default to 4px.
 ;<code>cat</code>
-:user category, default to ''empty''.
+:user category, omit "Category:" prefix.
-===Example===
+==Examples==
+*{{tll|Userbox}}
 {{Userbox}}
-*<code><nowiki>{{Userbox}}</nowiki></code> will produce as shown right.
+*{{tll|Userbox|logo=[[File:SpiffoWave.png|link=]]|info=Spiffo welcomes you to the wiki!}}
+{{Userbox|logo=[[File:SpiffoWave.png|link=]]|info=Spiffo welcomes you to the wiki!}}
 {{Translation guide}}
 ==See also==
-{{Userbox/see also}}
 *{{ll|PZwiki:Userboxes}}
 }}
 {{ll|Category:Userbox}}
-</noinclude><includeonly>{| style="clear: right; float: right; border: {{{border-width|1px}}} solid {{{border-color|#000000}}}; margin-left: .5em; margin-bottom: 2px; width: 250px; background: {{{info-background|#f6f6f6}}}; vertical-align: middle;" cellspacing=0
+{{ll|Category:Metatemplates}}
-! style="width: {{{logo-width|60px}}}; height: {{{logo-height|60px}}}; background: {{{logo-background|#ffffff}}}; text-align: center; font-size: {{{logo-size|14pt}}}; color: {{{logo-color|black}}}; padding: {{{logo-padding|1px}}};" | {{{logo|logo}}}
+</noinclude><includeonly><div class="userbox">{{#if:{{{cat|}}}|[[Category:{{{cat}}}]]}}
-| style="font-size: {{{info-size|8pt}}}; padding: {{{info-padding|4px}}}; color: {{{info-color|black}}};" | {{{info|''info''}}}
+  <div {{#if:{{{logo-color|}}}|style="background-color: {{{logo-color}}};"}}>{{{logo}}}</div>
-|}{{#if:{{{cat|}}}|[[Category:{{{cat}}}]]}}</includeonly>
+  <div {{#if:{{{info-color|}}}|style="background-color: {{{info-color}}};"}}>
+{{{info}}}
+  </div>
+</div></includeonly>