Using PageSlideshowPlugin

Last modified: 10/9/2026

Using PageSlideshowPlugin

The PageSlideshowPlugin shows a rotating set of pages on any page: each slide has the page's title, the start of its text and a Read more link to the page.

Description

Use it for a front-page banner of featured pages, a "did you know" panel, or a tour of a topic. Name the pages to show, or ask for a few at random. For a slideshow of pictures, see Using SlideshowPlugin. See Plugins for every plugin.

Who sees which slides

Each slide is a page, and a page only appears for people who may read it:

So you can safely name a private page: its owner sees it, and nobody else learns it exists.

Syntax

[{PageSlideshowPlugin pages='Using SlideshowPlugin,Markdown as we use it'}] renders as:

Parameters

ParameterDefaultDescription
pages(none)Comma-separated page names to show, in order. Use this or random.
random(none)How many pages to pick at random from those the reader may read.
interval5000Milliseconds between slides. 0 turns autoplay off.
excerpt300Most characters of each page's text to show.
showTitletrueShow the page title on each slide.
showLinktrueShow the Read more link.
controlstrueShow the previous and next arrows.
indicatorstrueShow the row of slide dots.
height300pxSmallest height of each slide (any CSS length).
cssclass(none)An extra CSS class on the slideshow, for your own styling.

Examples

Three random pages, slower

[{PageSlideshowPlugin random='3' interval='8000'}] renders as:

Short excerpts, no arrows, no autoplay

[{PageSlideshowPlugin pages='Using SlideshowPlugin,Markdown as we use it' excerpt='120' controls='false' interval='0'}] renders as:

Notes