Template:Ribbon

From Geohashing
Revision as of 21:39, 9 November 2020 by Fippe (talk | contribs)

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. "2005-05-26 37 -122")

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 = Pilgrimage achievement
|action = reaching the coordinates of the original comic
|category = Pilgrimage achievement
|expedition = [[2005-05-26 37 -122]]
}}

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

#default

Landgeohash.png
Mr. Stickman earned the Pilgrimage achievement
by reaching the coordinates of the original comic.

mini

Landgeohash.pngPilgrimage achievement by reaching the coordinates of the original comic.

micro

Landgeohash.pngPilgrimage achievement: 2005-05-26 37 -122

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 Pilgrimage achievement
by reaching the coordinates of the original comic.

600px

Landgeohash.png
Mr. Stickman earned the Pilgrimage achievement
by reaching the coordinates of the original comic.

100%

Landgeohash.png
Mr. Stickman earned the Pilgrimage achievement
by reaching the coordinates of the original comic.