content-options

{content-options}

Plugin: Scaffolding Plugin

Generates a set of options linking to Confluence content (eg. pages, blog posts, etc).

Description

May be filtered in several ways. Must be contained inside a list-data macro.

Usage

{content-options:parent=[parent page]|ancestor=[ancestor page]|spaces=[space list]|branches=[all, parents, children]}

Parameters

Name Required Default Description
parent
Only immediate children of the specified page will be listed. You can specify both the page and space key here, using standard Confluence link syntax. Eg: "KEY:Page Name". Combining with 'spaces' will help efficiency.
ancestor
Any descendent of the specified page will be listed.
spaces
Only lists pages from the specified list of spaces.
branches
Specifies the type of pages that will be listed. May be one of:
  • all - (default) All page types are returned.
  • parents - Only pages with children are listed.
  • children - Only pages with no children are listed.
labels
Specify labels which the content may contain ('xxx'), must contain ('+yyy') or may not contain ('-zzz'). Eg:
  • "foo bar": must have either 'foo' or 'bar'.
  • "+foo -bar": must have 'foo', cannot have 'bar'.

Sorting and additional filtering (Since 3.2.0)

If you have the Reporting Plugin installed, it is possible to sort and filter the results of {content-options} with any of the 'sort' and 'filter' macros available with that plugin, such as text-sort or number-filter. Just add them inside your {content-options} macro as you would for a 'reporter' macro. Eg:

{list-data:Children}
  {content-options:parent=@self}
    {text-sort:page:title|order=descending}
    {date-filter:page:modification date|minValue=-30d}
  {content-options}
{list-data}

See Also

Labels

macro macro Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.