Module:InfoboxImage/doc

{{#if:{{#ifeq:doc|sandbox|1}}{{#ifeq:doc|doc|1}}||{{#switch:|sysop|templateeditor|interfaceadmin=|#default=}}}}

{{#ifeq:doc|doc|{{#if:|}}|{{#switch:

 {{#if:
 |     
 | {{#ifeq:Module|Module
   | module
   | other
   }}
 }}

| module =

{{#ifeq: InfoboxImage | Sandbox

    | 
    | {{#switch: doc
        | doc | sandbox =
        | {{#ifeq:  | true 
            |  
            | {{#switch: protected
                | pre-alpha | prealpha | pa =
                | alpha | a =
                | beta | b =
                | release | r | general | g =
                | protected | protect | p =
                | semiprotected | semiprotect | semi =
              }}
          }}
      }}
   }}

| other | #default = }}}}

Overview

This module is used within infoboxes to process the image parameters and tidy up the formatting of the result.

Parameters

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 |{{SAFESUBST:#if:upright|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

All parameters:

<syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|page={{{page}}}|{{{size}}}|center|alt={{{alt}}}|link={{{link}}}|border|upright={{{upright}}}|thumbtime={{{thumbtime}}}|class={{{class}}}|{{{title}}}]]</syntaxhighlight>

[[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):

<syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|250px]]</syntaxhighlight>

[[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):

<syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|250px]]</syntaxhighlight>

[[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):

<syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|250px]]</syntaxhighlight>

[[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:

<syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|frameless]]</syntaxhighlight>

[[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):

<syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|frameless|upright]]</syntaxhighlight>

[[File:{{{image}}}|frameless|upright]]

When "alt" is used without "title", the alt text is also used as the title:

<syntaxhighlight lang="wikitext" style="overflow:auto;">[[File:{{{image}}}|frameless|alt=Alt text]]</syntaxhighlight>

[[File:{{{image}}}|frameless|alt=Alt text]]

For more information, see Wikipedia:Extended image syntax.

Sample usage

<syntaxhighlight lang="wikitext" style="overflow:auto;"> |image = </syntaxhighlight>

Examples

{{#invoke:InfoboxImage|InfoboxImage}}
{{#invoke:InfoboxImage|InfoboxImage|image=}}
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg}} {{#invoke:InfoboxImage|InfoboxImage|image=File:Abbey Rd Studios.jpg}} {{#invoke:InfoboxImage|InfoboxImage|image=Image:Abbey Rd Studios.jpg}}
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|upright=yes}}
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|upright=1.2}}
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=100px}} {{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|size=100}}
{{#invoke:InfoboxImage|InfoboxImage|image=[[File:Abbey Rd Studios.jpg{{#if:200px	200px}}]]}}
{{#invoke:InfoboxImage|InfoboxImage|image=[[File:Abbey Rd Studios.jpg{{#if:200px	title=Abbey Road!}}
{{#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=[[File:Image is needed male.svg{{#if:200px	200px}}]]}}
{{#invoke:InfoboxImage|InfoboxImage|image=[[File:Image is needed male.svg{{#if:200px	suppressplaceholder=no}}
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|maxsize=100px}}
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|maxsize=100px}}
{{#invoke:InfoboxImage|InfoboxImage|image=[[File:Abbey Rd Studios.jpg{{#if:200px	maxsize=100px}}
{{#invoke:InfoboxImage|InfoboxImage|image=Abbey Rd Studios.jpg|maxsize=100px|center=yes}}
{{#invoke:InfoboxImage|InfoboxImage|image=no such image|maxsize=100px|center=yes}}	File:No such image
{{#invoke:InfoboxImage|InfoboxImage|image={{#if:Multiple image|{{[[Template:{{#if:1|Multiple image}}|{{#if:1|Multiple image}}]]|{{#switch:6|0=width: 60|1=: 60|#default=width=60}}|{{#switch:7|0=image1: Yellow card.svg|1=: Yellow card.svg|#default=image1=Yellow card.svg}}|{{#switch:7|0=image2: Red card.svg|1=: Red card.svg|#default=image2=Red card.svg}}}}|}}}}

Placeholder images which can be suppressed

File:Blue - replace this image female.svg File:Blue - replace this image male.svg File:Female no free image yet.png 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 (blue).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

Tracking categories

• {{#if:|{{{name}}}|Category:Pages using infoboxes with thumbnail images}} (0)