Template:Random slideshow

Template documentation[view] [edit] [history] [purge]

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

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

• Image 1Cat playing with a lizard
  Cat playing with a lizard
• Image 2Cat on snow
  Cat on snow
• Image 3Tired cat
  Tired cat
• Image 4Cats in Mumbai
  Cats in Mumbai
• Image 5Cat lying on rice straw
  Cat lying on rice straw

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
}}

• Image 1Brown mouse Photograph: Tiia Monto
  Brown mouse

  Photograph: Tiia Monto

• Image 2A mouse in the hand is worth two in the bush Photograph: Pogrebnoj-Alexandroff
  A mouse in the hand is worth two in the bush

  Photograph: Pogrebnoj-Alexandroff

• Image 3Mice with food Photograph: Whitesky
  Mice with food

  Photograph: Whitesky

• Image 4Mouse on a wheel Photograph: R2Dine
  Mouse on a wheel

  Photograph: R2Dine

• Image 5Two mice Photograph: Pogrebnoj-Alexandroff
  Two mice

  Photograph: Pogrebnoj-Alexandroff

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Random slideshow in articles based on its TemplateData.

TemplateData for Random slideshow

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

Template parameters[Edit template data]

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
Image 1	1 (unnamed positional parameter)	Name of the first image, without prefix Default (empty) Example Portal puzzle.svg, 1=Portal puzzle.svg	File	required
Caption 1	2 (unnamed positional parameter)	Caption of the first image Default (empty) Example 2=This is the default portal icon	String	required
Credit 1	credit1	Credit for the first image Example Photograph: [[User:Example|Example]]	Unknown	optional
Width	width	Maximum width of all images Default (none) Example width=80px, width=30em, width=50%	Number	suggested
Image 2	3 (unnamed positional parameter	Name of the second image, without prefix Default (empty) Example Brown mouse.jpg, 3=Brown mouse.jpg	File	suggested
Caption 2	4 (unnamed positional parameter)	Caption of the second image Default (empty) Example 4=This is a brown mouse	String	suggested
Credit 2	credit2	Credits for the second image Example Photographer: [[User:Example|Example]]	Unknown	optional

The above documentation is transcluded from Template:Random slideshow/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template.