Template:Transclude files as random slideshow

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

This template transcludes images from specified pages, and 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 does not show anything in article space.

Usage

 Note: Though there is no fixed limit to the number of pages that can be specified, or images per page, be aware that technical limitations may be encountered for very large numbers of pages or images.

Specify pages displaying images:

{{Transclude files as random slideshow
| First page
| second page
| third page
}}

If images should only be retrieved from a certain section of each page:

{{Transclude files as random slideshow
| First page  | section1= section name
| second page | section2= section name
| third page  | section3= section name
}}

To also include some specific files:

{{Transclude files as random slideshow
| File:SpecificFileOne.jpg | caption1= Caption for first file
| File:SpecificFileTwo.png | caption2= Caption for second file | credit2= Credits for second file (optional)
| First page
| Second page
| Third page
}}

Alternate syntax for specific files' captions and credits:

{{Transclude files as random slideshow
| File:SpecificFileOne.jpg ## Caption for first file
| File:SpecificFileTwo.png ## Caption for second file ## Credits for second file (optional)
| First page
| Second page
| Third page
}}

Parameters

|1=, |2=, |3=, ... (or equivalent positional parameters)

Full page name – including namespace – of the page containing images, or of a specific image.

|section1=, |section2=, |section3=, ...

Limit to files in these section of the corresponding page. Optional.

|caption1=, |caption2=, |caption3=, ...

Caption for the corresponding file (or omit these parameters and use the alternate syntax shown above)

|credit1=, |credit2=, |credit3=, ...

Optional: Credits for the file (or omit these parameters and use the alternate syntax shown above)

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

Display in the mobile view

On mobile devices, a standard gallery is displayed instead of the slideshow, and only the first four images (after randomisation) are visible.

Examples

{{Box-header|title=Selected pictures}}
{{Transclude files as random slideshow
| Template:Transclude files as random slideshow/testcases/1
| Template:Transclude files as random slideshow/testcases/2
| Template:Transclude files as random slideshow/testcases/3
}}
{{Box-footer}}

Selected pictures

• 
  Tired cat (from Template:Transclude files as random slideshow/testcases/2)
• 
  Example 3 (from Template:Transclude files as random slideshow/testcases/1)
• 
  Example 4 (from Template:Transclude files as random slideshow/testcases/1)
• 
  Cat playing with a lizard (from Template:Transclude files as random slideshow/testcases/2)
• 
  Cat lying on rice straw (from Template:Transclude files as random slideshow/testcases/2)
• 
  Cat on snow (from Template:Transclude files as random slideshow/testcases/2)
• 
  Cats in Mumbai (from Template:Transclude files as random slideshow/testcases/2)

{{Box-header|title=Selected pictures}}
{{Transclude files as random slideshow
| Template:Transclude files as random slideshow/testcases/2 |section1=Mice
}}
{{Box-footer}}

Selected pictures

• 
  Mice with food (from Template:Transclude files as random slideshow/testcases/2)
• 
  Brown mouse (from Template:Transclude files as random slideshow/testcases/2)
• 
  Two mice (from Template:Transclude files as random slideshow/testcases/2)
• 
  Mouse on a wheel (from Template:Transclude files as random slideshow/testcases/2)
• 
  A mouse in the hand is worth two in the bush (from Template:Transclude files as random slideshow/testcases/2)

{{Box-header|title=Selected pictures}}
{{Transclude files as random slideshow
| Sky
}}
{{Box-footer}}

Selected pictures

• 
  The night sky over Slovenia in July (from Sky)
• 
  Cirriform clouds and a quarter Moon in the blue daytime sky over Germany (from Sky)
• 
  Dawn is the beginning of morning twilight. (from Sky)
• 
  The crescent Moon remains visible just moments before sunrise. (from Sky)
• 
  Sky during day time (from Sky)
• 
  White cumulus clouds appeared over Dhaka, Bangladesh, when significant flooding was underway in many parts of the country. (from Sky)
• 
  The Milky Way can be seen as a large band across the night sky, and is distorted into an arch in this 360° panorama. (from Sky)
• 
  Jupiter, Ancient Roman sky deity (from Sky)
• 
  Earth's atmosphere scatters a greater proportion of blue light than of red light. (from Sky)
• 
  Civil, nautical, and astronomical twilight. Dusk is the end of evening twilight. (from Sky)
• 
  Picture of the sky in the eye of a tropical cyclone (from Sky)

{{Sidebar
| pretitle = Embedded in sidebar, scaled to 1.35 upright
| pretitlestyle = font-weight:bold;
| width =
| style = border:1px solid #c8ccd1;
| content1style = margin:-5px -5px -2.2em -5px; display: inline-block;
| content1 = {{Transclude files as random slideshow
| Template:Transclude files as random slideshow/testcases/2 |section1=Mice
}}
| content2style = height:0px; margin:0 -0.4em; padding:0; display:inline-block; visibility:hidden; 
| content2 = [[File:Cat playing with a lizard.jpg|frameless|border|upright=1.35]]
}}

See also

TemplateData

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

TemplateData for Transclude files as random slideshow

No description.

Template parameters[Edit template data]

Parameter		Description	Type	Status
Page 1	1	First page to use as a source of files/images	Page name	required
Page 2	2	Second page to use a source of files/images. (Add more pages using parameters "3", "4", "5", etc)	Page name	optional
Section of page 1	section1	Limit files to this section of page 1	String	optional
Section of page 2	section2	Limit files to this section of page 2	String	optional
Width	width	Maximum width for all images. Specify as a %, or in em, or in px Default 100%	String	optional

The above documentation is transcluded from Template:Transclude files as 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.