Template:Transclude files as random slideshow/doc

From Wikipedia, the free encyclopedia
Jump to navigation Jump to search

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.

Usage[edit]

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

Parameters[edit]

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

Examples[edit]

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

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

Selected pictures

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

Selected pictures

See also[edit]

TemplateData
This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly error report for this template.

TemplateData for Transclude files as random slideshow

No description.

Template parameters

ParameterDescriptionTypeStatus
Page 11

First page to use as a source of files/images

Default
empty
Example
empty
Auto value
empty
Pagerequired
Page 22

Second page to use a source of files/images. (Add more pages using parameters "3", "4", "5", etc)

Default
empty
Example
empty
Auto value
empty
Pageoptional
Section of page 1section1

Limit files to this section of page 1

Default
empty
Example
empty
Auto value
empty
Stringoptional
Section of page 2section2

Limit files to this section of page 2

Default
empty
Example
empty
Auto value
empty
Stringoptional
Widthwidth

Maximum width for all images. Specify as a %, or in em, or in px

Default
100%
Example
empty
Auto value
empty
Stringoptional