Template:Random slideshow/doc

Template page

This template creates a slideshow gallery with a randomised order – i.e. it changes when the page is purged. It is intended for use in portals and will not display in article space.

Usage

As many images and captions as desired may be specified, in the following format:

{{Random slideshow 
| First image  | first caption
| second image | second caption
| third image  | third caption
}}

Credits (e.g. "Photograph: Example") may be specified, using the following format

{{Random slideshow 
| First image  | first caption | credit1=
| second image | second caption | credit2=
| third image  | third caption | credit3=
}}

Parameters

|1=, |3=, |5=, ... (or equivalent positional parameters)
File name. The "File:" prefix is optional.
|2=, |4=, |6=, ... (or equivalent positional parameters)
Caption for the file.
|credit1=, |credit2=, |credit3=, ...
Credits for the file. Optional.
|width=
Maximum width for all images; default is 100% (intended for use inside portal components)
Can be specified as a % (e.g. 75%), or in ems (e.g. 30em), or in px (e.g. 200px)
If a unit is not specified, px is assumed (i.e. 350 is equivalent to 350px)
|random=
Set to no or false to turn off the randomisation.

Display in the mobile view

On mobile devices, a standard gallery is displayed instead of the slideshow. If the screen width is less than 720px, only the first four images after randomisation are visible (example screenshot). For mobile devices with larger resolutions, all images are displayed (example screenshot). For some tables, it displays all images stacked (example screenshot).

Examples

Purge this page to see these galleries in a different order

Cats

{{Box-header|title=Selected pictures}}
{{Random slideshow 
| File:Cat playing with a lizard.jpg | Cat playing with a lizard
| Felis silvestris catus lying on rice straw.jpg | Cat lying on rice straw
| Mumbai 03-2016 63 Dhobi Talao Chowk.jpg | Cats in Mumbai
| File:Felis catus-cat on snow.jpg | Cat on snow
| Tired 20-year-old cat.jpg | Tired cat
}}
{{Box-footer}}

Selected pictures

Mice

{{Random slideshow | width=275
| File:Agouti Mice.jpg | Two mice | credit1= Photograph: Pogrebnoj-Alexandroff
| Brown mouse.jpg | Brown mouse | credit2= Photograph: [[User:Kulmalukko|Tiia Monto]]
| File:Farbmaeuse.jpg | Mice with food | credit3= Photograph: [[c:User:Whitesky~commonswiki|Whitesky]]
| File:Farbmaus.JPG | Mouse on a wheel | credit2= Photograph: [[de:User:R2Dine|R2Dine]]
| White lab mouse in hand B.jpg | A mouse in the hand is worth two in the bush | credit4= Photograph: Pogrebnoj-Alexandroff
}}

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template in articles based on this TemplateData.

TemplateData for Random slideshow

Creates a slideshow gallery with randomized order. Add as many images as desired.

Template parameters

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
Image 11 (unnamed positional parameter)

Name of the first image, without prefix

Default
(empty)
Example
Portal puzzle.svg, 1=Portal puzzle.svg
Filerequired
Caption 12 (unnamed positional parameter)

Caption of the first image

Default
(empty)
Example
2=This is the default portal icon
Stringrequired
Credit 1credit1

Credit for the first image

Example
Photograph: [[User:Example|Example]]
Unknownoptional
Widthwidth

Maximum width of all images

Default
(none)
Example
width=80px, width=30em, width=50%
Numbersuggested
Image 23 (unnamed positional parameter

Name of the second image, without prefix

Default
(empty)
Example
Brown mouse.jpg, 3=Brown mouse.jpg
Filesuggested
Caption 24 (unnamed positional parameter)

Caption of the second image

Default
(empty)
Example
4=This is a brown mouse
Stringsuggested
Credit 2credit2

Credits for the second image

Example
Photographer: [[User:Example|Example]]
Unknownoptional