Module:Message box/configuration

Module documentation[view] [edit] [history] [purge]

This module contains configuration data for Module:Message box.

Configuration options

Option	Explanation
types	A table containing data used by the type parameter of the message box. The table keys are the values that can be passed to the type parameter, and the table values are tables containing the class and the image used by that type.
default	The type to use if no value was passed to the type parameter, or if an invalid value was specified.
showInvalidTypeError	Whether to show an error if the value passed to the type parameter was invalid.
allowBlankParams	Usually blank values are stripped from parameters passed to the module. However, whitespace is preserved for the parameters included in the allowBlankParams table.
allowSmall	Whether a small version of the message box can be produced with |small=1.
smallParam	A custom value for the |small= parameter. For example, if set to "left" you can produce a small message box using |small=left.
smallClass	The class to use for small message boxes.
substCheck	Whether to perform a subst check or not.
classes	An array of classes to use with the message box.
imageEmptyCell	Whether to use an empty ‎<td>...‎</td> cell if there is no image set. This is used to preserve spacing for message boxes with a width of less than 100% of the screen.
imageEmptyCellStyle	Whether empty image cells should be styled.
imageCheckBlank	Whether |image=blank results in no image being displayed.
imageSmallSize	Usually, images used in small message boxes are set to 30x30px. This sets a custom size.
imageCellDiv	Whether to enclose the image in a ‎<div> enforcing a maximum image size.
useCollapsibleTextFields	Whether to use text fields that can be collapsed, i.e. "issue", "fix", "talk", etc. Currently only used in {{ambox}}.
imageRightNone	Whether |imageright=none results in no image being displayed on the right-hand side of the message box.
sectionDefault	The default name for the |section= parameter. Depends on useCollapsibleTextFields.
allowMainspaceCategories	Allow categorisation in the main namespace.
templateCategory	The name of a category to be placed on the template page.
templateCategoryRequireName	Whether the |name= parameter is required to display the template category.
templateErrorCategory	The name of the error category to be used on the template page.
templateErrorParamsToCheck	An array of parameter names to check. If any are absent, the templateErrorCategory is applied to the template page.

The above documentation is transcluded from Module:Message box/configuration/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (create) pages.
Subpages of this module.

--------------------------------------------------------------------------------
--                          Message box configuration                         --
--                                                                            --
-- This module contains configuration data for [[Module:Message box]].        --
--------------------------------------------------------------------------------

return {
	ambox = {
		types = {
			speedy = {
				class = 'ambox-speedy',
				image = 'OOjs UI icon clock-destructive.svg'
			},
			delete = {
				class = 'ambox-delete',
				image = 'OOjs UI icon alert-destructive.svg'
			},
			warning = { -- alias for content
				class = 'ambox-content',
				image = 'OOjs UI icon notice-warning.svg'
			},
			content = {
				class = 'ambox-content',
				image = 'OOjs UI icon notice-warning.svg'
			},
			style = {
				class = 'ambox-style',
				image = 'Edit-clear.svg'
			},
			move = {
				class = 'ambox-move',
				image = 'Merge-split-transwiki default.svg'
			},
			protection = {
				class = 'ambox-protection',
				image = 'Semi-protection-shackle-keyhole.svg'
			},
			notice = {
				class = 'ambox-notice',
				image = 'OOjs UI icon information-progressive.svg'
			}
		},
		default                     = 'notice',
		allowBlankParams            = {'talk', 'sect', 'date', 'issue', 'fix', 'subst', 'hidden'},
		allowSmall                  = true,
		smallParam                  = 'left',
		smallClass                  = 'mbox-small-left',
		substCheck                  = true,
		classes                     = {'metadata', 'plainlinks', 'ambox'},
		imageEmptyCell              = true,
		imageCheckBlank             = true,
		imageSmallSize              = '20x20px',
		imageCellDiv                = true,
		useCollapsibleTextFields    = true,
		imageRightNone              = true,
		sectionDefault              = 'article',
		allowMainspaceCategories    = true,
		templateCategory            = 'Article message templates',
	        templateCategoryRequireName = true,
		templateErrorCategory       = nil,
		templateErrorParamsToCheck  = {'issue', 'fix', 'subst'}
	},
	
	cmbox = {
		types = {
			speedy = {
				class = 'cmbox-speedy',
				image = 'OOjs UI icon clock-destructive.svg'
			},
			delete = {
				class = 'cmbox-delete',
				image = 'OOjs UI icon alert-destructive.svg'
			},
			content = {
				class = 'cmbox-content',
				image = 'OOjs UI icon notice-warning.svg'
			},
			style = {
				class = 'cmbox-style',
				image = 'Edit-clear.svg'
			},
			move = {
				class = 'cmbox-move',
				image = 'Merge-split-transwiki default.svg'
			},
			protection = {
				class = 'cmbox-protection',
				image = 'Semi-protection-shackle-keyhole.svg'
			},
			notice = {
				class = 'cmbox-notice',
				image = 'OOjs UI icon information-progressive.svg'
			},
			caution = {
				class = 'cmbox-style',
				image = 'Ambox warning yellow.svg'
			}
		},
		default              = 'notice',
		showInvalidTypeError = true,
		classes              = {'plainlinks', 'cmbox'},
		imageEmptyCell       = true
	},
	
	fmbox = {
		types = {
			warning = {
				class = 'fmbox-warning',
				image = 'OOjs UI icon clock-destructive.svg'
			},
			editnotice = {
				class = 'fmbox-editnotice',
				image = 'OOjs UI icon information-progressive.svg'
			},
			system = {
				class = 'fmbox-system',
				image = 'OOjs UI icon information-progressive.svg'
			}
		},
		default              = 'system',
		showInvalidTypeError = true,
		classes              = {'plainlinks', 'fmbox'},
		imageEmptyCell       = false,
		imageRightNone       = false
	},
	
	imbox = {
		types = {
			speedy = {
				class = 'imbox-speedy',
				image = 'OOjs UI icon clock-destructive.svg'
			},
			delete = {
				class = 'imbox-delete',
				image = 'OOjs UI icon alert-destructive.svg'
			},
			content = {
				class = 'imbox-content',
				image = 'OOjs UI icon notice-warning.svg'
			},
			style = {
				class = 'imbox-style',
				image = 'Edit-clear.svg'
			},
			move = {
				class = 'imbox-move',
				image = 'Merge-split-transwiki default.svg'
			},
			protection = {
				class = 'imbox-protection',
				image = 'Semi-protection-shackle-keyhole.svg'
			},
			license = {
				class = 'imbox-license licensetpl',
				image = 'Imbox license.png' -- @todo We need an SVG version of this
			},
			featured = {
				class = 'imbox-featured',
				image = 'Cscr-featured.svg'
			},
			notice = {
				class = 'imbox-notice',
				image = 'OOjs UI icon information-progressive.svg'
			}
		},
		default              = 'notice',
		showInvalidTypeError = true,
		classes              = {'imbox'},
		usePlainlinksParam   = true,
		imageEmptyCell       = true,
		below                = true,
		templateCategory     = 'File message boxes'
	},
	
	ombox = {
		types = {
			speedy = {
				class = 'ombox-speedy',
				image = 'OOjs UI icon clock-destructive.svg'
			},
			delete = {
				class = 'ombox-delete',
				image = 'OOjs UI icon alert-destructive.svg'
			},
			warning = { -- alias for content
				class = 'ombox-content',
				image = 'OOjs UI icon notice-warning.svg'
			},
			content = {
				class = 'ombox-content',
				image = 'OOjs UI icon notice-warning.svg'
			},
			style = {
				class = 'ombox-style',
				image = 'Edit-clear.svg'
			},
			move = {
				class = 'ombox-move',
				image = 'Merge-split-transwiki default.svg'
			},
			protection = {
				class = 'ombox-protection',
				image = 'Semi-protection-shackle-keyhole.svg'
			},
			notice = {
				class = 'ombox-notice',
				image = 'OOjs UI icon information-progressive.svg'
			},
			critical = {
				class = 'mbox-critical',
				image = 'OOjs UI icon clock-destructive.svg'
			}
		},
		default              = 'notice',
		showInvalidTypeError = true,
		classes              = {'plainlinks', 'ombox'},
		allowSmall           = true,
		imageEmptyCell       = true,
		imageRightNone       = true
	},
	
	tmbox = {
		types = {
			speedy = {
				class = 'tmbox-speedy',
				image = 'OOjs UI icon clock-destructive.svg'
			},
			delete = {
				class = 'tmbox-delete',
				image = 'OOjs UI icon alert-destructive.svg'
			},
			content = {
				class = 'tmbox-content',
				image = 'OOjs UI icon notice-warning.svg'
			},
			style = {
				class = 'tmbox-style',
				image = 'Edit-clear.svg'
			},
			move = {
				class = 'tmbox-move',
				image = 'Merge-split-transwiki default.svg'
			},
			protection = {
				class = 'tmbox-protection',
				image = 'Semi-protection-shackle-keyhole.svg'
			},
			notice = {
				class = 'tmbox-notice',
				image = 'OOjs UI icon information-progressive.svg'
			}
		},
		default              = 'notice',
		showInvalidTypeError = true,
		classes              = {'plainlinks', 'tmbox'},
		allowSmall           = true,
		imageRightNone       = true,
		imageEmptyCell       = true,
		imageEmptyCellStyle  = true,
		templateCategory     = 'Talk message boxes'
	}
}