Template:Ribbon

From Geohashing
Revision as of 19:38, 28 March 2015 by imported>ChromeCrusaders

This template displays a generic ribbon, which can be customized using the following parameters. It can be used to simplify existing ribbon pages, and to create new ribbons more easily. It also helps us to maintain a common layout for all ribbons.

  • icon = The icon image to display in the ribbon.
  • color = The border colour of the ribbon.
  • achievement = Achievement or consolation prize name.
  • action = A free form description of the achieved feature. "reaching the x,y hash..."

Optional parameters:

  • user = The user name to be displayed in the ribbon. (Defaults to "This user". use {{{name|}}} as value to pass through the possibly blank name parameter as user name)
  • category = The category name where users having gained this achievement will be put.
  • image = The usual photographic proof (Note: you may want to use the value {{{image|}}} to pass through the possibly blank image parameter from your own ribbon template.)
  • expedition = the expedition link, as used by the mini templates (e.g. "2008-05-22 33 -44")

Rarely used Parameters:

  • customtitle = replaces the words 'earned the' in the title of the ribbon.
  • bgcolor = replaces the background color of the ribbon.
  • fontcolor = replaces the font color of the ribbon.
  • iconcode = replaces the whole display code for the icon image.

Themes

  • Use the code
{{#vardefine:ribbontheme|themename}}

on any page to make all subsequent ribbons appear in the selected theme.

Example

{{Ribbon
|icon = Landgeohash.png
|color = darkgreen
|user = Mr. Stickman
|achievement = [[Lost in Thought Achievement]]
|action = hurting himself while concentrating on the display of his GPS
|category = Lost in Thought Achievement
|expedition = [[2008-05-22 33 -44]]
}}

will display, depending on the theme you have selected, as:

#default

Landgeohash.png
Mr. Stickman earned the Lost in Thought Achievement
by hurting himself while concentrating on the display of his GPS.

mini

Landgeohash.pngLost in Thought Achievement by hurting himself while concentrating on the display of his GPS.

micro

Landgeohash.pngLost in Thought Achievement: 2008-05-22 33 -44

Width

  • By default, the ribbon box will be sized to fit its contents. Use the code
{{#vardefine:ribbonwidth|width}}

on any page to make all subsequent ribbons appear with the selected width, to make them line up prettily. Use either a pixel width e.g. "50px" or a percentage such as "100%", as per the CSS width attribute.

Example The above ribbon, in the default theme, will display differently depending on the ribbonwidth variable:


default width

Landgeohash.png
Mr. Stickman earned the Lost in Thought Achievement
by hurting himself while concentrating on the display of his GPS.

600px

Landgeohash.png
Mr. Stickman earned the Lost in Thought Achievement
by hurting himself while concentrating on the display of his GPS.

100%

Landgeohash.png
Mr. Stickman earned the Lost in Thought Achievement
by hurting himself while concentrating on the display of his GPS.