This macro includes the excerpt of a random child page to a specified parent.

HTML Code: random-excerpt

See the Confluence Excerpt macro for how to set an excerpt on pages you want included in the Random Excerpt macro’s output.

Usage

Storage Format

<ac:macro ac:name="random-excerpt">
<ac:parameter ac:name="parameter">value</ac:parameter>
</ac:macro>

Wiki Markup

{random-excerpt:parameter=value}

Parameter

Name

Description

Type

Default

Required

parent

Parent Page

The page whose children an excerpt should be randomly chosen from

confluence-content


title

Show Page Title

Show the page title (default - true)


true

link

Link

Add a more link to the page whose excerpt is being displayed (default - true)

boolean

true

more

More Label

The label to use for the link to the page (default - More …​)

string

more

label

Labels

Comma separated list of labels which the content must have at least one for it to be shown

string


class

CSS class

The CSS classname to add to the outer div

string


count

Count

The number of excerpts to be shown (default 1)

string

1

hide

Hide

Whether to hide the extra excerpts or not (default false)

boolean

false

flag

Flag

A list of flags, one of which must be defined for the content to be displayed

string


notflag

Not Flag

A list of flags which must not be defined for the content to be displayed

string


Example

Show a random excerpt from the child pages of the page.

<ac:macro ac:name="random-excerpt"><ac:parameter ac:name="parameter">value</ac:parameter>
</ac:macro>
{random-excerpt:parameter=value}

Result

Shows a random page excerpt with a link through to the page.