Module:InfoboxImage/doc
This is a documentation subpage for Module:InfoboxImage. It may contain usage information, categories and other content that is not part of the original module page. |
This Lua module is used in system messages, and on approximately 4,950,000 pages, or roughly 8% of all pages. Changes to it can cause immediate changes to the Wikipedia user interface. To avoid major disruption and server load, any changes should be tested in the module's /sandbox or /testcases subpages, or in your own module sandbox. The tested changes can be added to this page in a single edit. Please discuss changes on the talk page before implementing them. |
Overview
[edit]This module is used within infoboxes to process the image parameters and tidy up the formatting of the result.
Parameters
[edit]Parameter | Description |
---|---|
image | Required. The main parameter that should be passed over which contains the image info. |
size | Size to display image, in pixels. Use is discouraged per WP:THUMBSIZE; see |upright= below instead.
|
maxsize | Maximum size to display image. Note: If no size or sizedefault params specified then image will be shown at maxsize. |
sizedefault | The size to use for the image if no size param is specified. Defaults to frameless. |
alt | Alt text for the image. |
title | Title text for image (mouseover text). |
border | If yes, then a border is added. |
page | The page number to be displayed when using a multi-page image. |
upright | If upright=yes, adds "upright" which displays image at 75% of default image size (which is 220px if not changed at Special:Preferences). If a value, adds "upright=value" to image, where values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%). |
center | If yes, then the image is centered. |
thumbtime | thumbtime param, used for video clips. |
suppressplaceholder | If no, then will not suppress certain placeholder images. See § Placeholder images which can be suppressed. |
link | Page to go to when clicking on the image. |
class | HTML classes to add to the image. |
Note: If you specify the maxsize or sizedefault params, then you should include the px after the number.
Parameters displayed in image syntax
[edit]All parameters:
{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | size={{{size}}} | maxsize={{{maxsize}}} | sizedefault={{{sizedefault}}} | upright={{{upright}}} | alt={{{alt}}} | title={{{title}}} | thumbtime={{{thumbtime}}} | link={{{link}}} | border=yes | center=yes | page={{{page}}} | class={{{class}}} }}
[[File:{{{image}}}|page={{{page}}}|{{{size}}}|center|alt={{{alt}}}|link={{{link}}}|border|upright={{{upright}}}|thumbtime={{{thumbtime}}}|class={{{class}}}|{{{title}}}]]
When "size" and "maxsize" are defined, the smaller of the two is used (if "px" is omitted it will be added by the module):
{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | size=300px | maxsize=250px }}
[[File:{{{image}}}|250px]]
When "size" is not defined, "sizedefault" is used, even if larger than "maxsize" (in actual use "px" is required after the number; omitted here to show it is not added by the module):
{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | sizedefault=250px | maxsize=200px }}
[[File:{{{image}}}|250px]]
When "size" and "sizedefault" are not defined, "maxsize" is used (in actual use "px" is required after the number; omitted here to show it is not added by the module):
{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | maxsize=250px }}
[[File:{{{image}}}|250px]]
When "size", "sizedefault", and "maxsize" are not defined, "frameless" is added, which displays the image at the default thumbnail size (220px, but logged in users can change this at Special:Preferences) and is required if using "upright" to scale the default size:
{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} }}
[[File:{{{image}}}|frameless]]
Use of "upright" without a number value, which displays the image at approximately 75% of the user's default size (multiplied by 0.75 then rounded to nearest 10):
{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | upright = yes }}
[[File:{{{image}}}|frameless|upright]]
When "alt" is used without "title", the alt text is also used as the title:
{{#invoke:InfoboxImage | InfoboxImage | image={{{image}}} | alt = Alt text }}
[[File:{{{image}}}|frameless|alt=Alt text]]
For more information, see Wikipedia:Extended image syntax.
Sample usage
[edit]|image = {{#invoke:InfoboxImage|InfoboxImage|image={{{image|}}}|upright={{{image_upright|1}}}|alt={{{alt|}}}}}
Examples
[edit]{{#invoke:InfoboxImage|InfoboxImage}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=}}
|
|
|
|
|
|
|
|
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250px|alt=The front stairs and door of Abbey Road Studios}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250|alt=The front stairs and door of Abbey Road Studios}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|sizedefault=250px|alt=The front stairs and door of Abbey Road Studios}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|alt=The front stairs and door of Abbey Road Studios}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=100px|alt=The front stairs and door of Abbey Road Studios}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Bandera de Bilbao.svg|size=100|border=yes}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Image is needed male.svg}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|maxsize=100px}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|maxsize=100px}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|maxsize=100px|center=yes}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image=no such image|maxsize=100px|center=yes}}
|
|
{{#invoke:InfoboxImage|InfoboxImage|image={{Multiple image
|
Placeholder images which can be suppressed
[edit]- File:Blue - replace this image female.svg
- File:Blue - replace this image male.svg
- File:Male no free image yet.png
- File:Flag of None (square).svg
- File:Flag of None.svg
- File:Flag of.svg
- File:Green - replace this image female.svg
- File:Green - replace this image male.svg
- File:Image is needed female.svg
- File:Image is needed male.svg
- File:Location map of None.svg
- File:Male no free image yet.png
- File:Missing flag.png
- File:No flag.svg
- File:No free portrait.svg
- File:No portrait (female).svg
- File:No portrait (male).svg
- File:Red - replace this image female.svg
- File:Red - replace this image male.svg
- File:Replace this image female.svg
- File:Replace this image male (blue).svg
- File:Replace this image male.svg
- File:Silver - replace this image female.svg
- File:Silver - replace this image male.svg
- File:Replace this image.svg
- File:Cricket no pic.png
- File:CarersLogo.gif
- File:Diagram Needed.svg
- File:Example.jpg
- File:Image placeholder.png
- File:No male portrait.svg
- File:Nocover-upload.png
- File:NoDVDcover copy.png
- File:Noribbon.svg
- File:No portrait-BFD-test.svg
- File:Placeholder barnstar ribbon.png
- File:Project Trains no image.png
- File:Image-request.png
- File:Sin bandera.svg
- File:Sin escudo.svg
- File:Replace this image - temple.png
- File:Replace this image butterfly.png
- File:Replace this image.svg
- File:Replace this image1.svg
- File:Resolution angle.png
- File:Image-No portrait-text-BFD-test.svg
- File:Insert image here.svg
- File:No image available.png
- File:NO IMAGE YET square.png
- File:NO IMAGE YET.png
- File:No Photo Available.svg
- File:No Screenshot.svg
- File:No-image-available.jpg
- File:Null.png
- File:PictureNeeded.gif
- File:Place holder.jpg
- File:Unbenannt.JPG
- File:UploadACopyrightFreeImage.svg
- File:UploadAnImage.gif
- File:UploadAnImage.svg
- File:UploadAnImageShort.svg
- File:CarersLogo.gif
- File:Diagram Needed.svg
- File:No male portrait.svg
- File:NoDVDcover copy.png
- File:Placeholder barnstar ribbon.png
- File:Project Trains no image.png
- File:Image-request.png