Template:Metabox

From The Sims Wiki, a collaborative database for The Sims series
Jump to navigation Jump to search
This page is fully protected.


This template is used on 25,000+ pages
To avoid large-scale disruption and unnecessary server load, consider testing your changes elsewhere, such as by copying the source code of this template and pasting it into your user space, or in the sandbox. Consider proposing your changes on the talk page before editing this template.



 
{{{text}}}
Template documentation (View · Edit · History · Purge)
Metabox is so named because it is intended to be the foundation for all message box templates on The Sims Wiki. This template is being designed as the direct successor template to {{Parthenon}}. The primary goal of this project is to create a versatile message box that keeps certain 'types' of message boxes (e.g. administrative notices, featured page headers, or information boxes) organized by color, while offering advanced customization to able users.
Main parameters

text - This is the main text of the template itself. This is the only absolutely mandatory parameter.

headline - This parameter adds text to the header bar. This parameter is optional, but the header bar will remain even if no parameter is specified.

image - This parameter adds an image to the left side of the template. The image is resized to 60px automatically for the standard template, and 45px for small-sized templates. The File: prefix and brackets should not be included

  • This automatic resize can be overridden by adding the desired size in the imagesize parameter (raw number only, no 'px' needed)
  • This image can be set to link to a page by filling the imagelink parameter

type - This parameter sets the color of the template's background and header. There are six general types that can be applied:

  • type=admin produces a green metabox. This type is intended to be used for "official" notices or administrative messages.
  • type=info produces a blue metabox. This type is meant to be used for general information or notification messages.
  • type=notice produces a red metabox. This type is reserved for "urgent" notices or warning header messages.
  • type=feature produces a yellow metabox. This type of box is for use by the various featured templates, such as {{Feat art}}.
  • type=delete produces a violet metabox. This color is reserved for templates dealing with page merges, deletes, moves, etc.
  • type=cleanup produces an orange metabox. This color is reserved for cleanup templates, templates dealing with style issues, etc.

If the type parameter isn't specified or isn't specified correctly, the template will display with generic colors. The template can still be used in this way, but it's recommended to choose a type to display the box as.

Custom colors can be chosen, by specifying a color in the backgroundcolor and headercolor parameters; colors need to be in "hex triplet" format (e.g., #FFFFFF for white), but should exclude the number sign/hashtag.

width - This parameter adjusts the width of the template. Specify a width percentage you want the template to be, excluding the percent (%) sign at the end.

size - If this parameter is set so that size=small, the template will display as a smaller, left-aligned box rather than the large, center-aligned standard template.

nocat - Use this parameter with any input for templates that are normally transcluded to other templates, such as {{Experimental}} or {{Under construction}}, so that the templates that are using it will not be categorized as Category:Templates using Metabox.

Note on parameters

If Metabox is used as the foundation for a template, individual editors can be allowed to control the way the template appears on individual pages, so long as the parameter is carried over to templates based off this template. For example, {{Cleanup}} has an optional parameter, size, which is carried over from Metabox, since the Cleanup template is set up to allow the specification of a size parameter.


Syntax
{{Metabox
|type     = 
|image    = 
|size     = 
|headline = 
|text     = 
|nocat    = 
}}

Color examples
Metabox: type=admin
This is a green admin/official messages metabox
Metabox: type=info
This is a blue informational metabox
Metabox: type=notice
This is a red urgent notice metabox
Metabox: type=feature
This is a yellow featured content metabox
Metabox: type=delete
This is a violet delete/merge/split metabox
Metabox: type=cleanup
This is a gold/orange cleanup metabox

Change log
Change log

Metabox version 1

  • 5 September 2013 - Template created. It is not ready to be used on mainspace articles yet.
  • 5 September 2013 (2) - Template now accepts bordercolor and backgroundcolor parameters, which override the colors set by the chosen type (or give colors if no type is selected). Another parameter, imagewidth, can be used to adjust the width of the space around the chosen image. The default setting on standard-sized templates is 60px, and 50px on small-sized templates. These new parameters are all optional.
  • 5 September 2013 (3) - Template can be used to automatically categorize a page that uses a template derived from Metabox. The Metabox-based template needs to have parameter cat set with the name of the category that pages will be sorted into. If a particular order for sorting is needed, catsort can be filled; otherwise, it will sort by {{PAGENAME}}. Templates using Metabox will need to be categorized the old fashioned way, at least for now.
  • 9 September 2013 - New 'type' and type colors has been added. Delete/Move/Merge is now violet, and Cleanup/style issues are orange.
  • 2 September 2014 - New nocat parameter was added.
Change log
Metabox version 2
  • 4 April 2015 - Metabox was redesigned, as discussed in this forum thread. A new template, Template:Metabox2, was developed and merged into the main Metabox template. The history for the Metabox2 template is visible here. The new Metabox was designed to be backward compatible with the old Metabox.
  • 10 April 2015 - Bugfix implemented - redesigned Metabox would often overlap infoboxes and other right-aligned/right-floating elements. This has been fixed.

Attribution and Credit

This template was developed with code from its predecessor, Template:Parthenon; Template:Parthenon's revision history is visible here. This template was developed and refined on The Sims Wiki; the template's revision history and list of contributors is available here. On April 4, 2015, a significant redesign was implemented, using code developed at Template:Metabox2; history for that template is visible here.

The text of this template is licensed under the Creative Commons Attribution-ShareAlike 3.0 (CC-by-SA) license. Please review the CC-by-SA license text for more information.


Visit Template:Metabox/doc to edit this text! (How does this work?) (Refresh this text - why?)