Skip to end of metadata
Go to start of metadata

Description

Creates a link to add a topic to a forum. This macro creates a link to the add page action in Confluence to create a child page for the given forum root page.

Usage

{add-topic}Add Topic{add-topic}

Parameters

Parameter

Required

Default

Notes

Bubbles Version

default

(error)

current page

The page contaning the forum macro in SPACEKEY:pagename format

1.0

page

(error)

current page

Alternative parameter for specifying the page containing the forum macro.

1.0

space

(error)

current space

Alternative parameter for specifying the space key

1.0

restrict

(error)

true

Whether to restrict the created forum page to be editable only by the creator.

1.0

Hits and Tips

Adding a link manually:

Topics are just child pages of the root forum page, so if you want to build a link to add a child page manually without the macro this is what you need to do:

<confluence url>/pages/createpage.action?spaceKey=<space key>&fromPageId=<forum root>

Where:

  • <confluence url> is the base URL of your confluence installalation
  • <space key> is the space key for the space where the forum us located
  • <forum root> is the page ID (not title) of the forum page to which the topic pages are attached

Listing restricted pages

The add-topic macro can automatically restrict the edit permissions to the person who creates a topic, meaning that only that person and people with sufficient administration privileges can edit or delete the topic.

To see a list of all restricted pages, go in to Space Administration and under the "Security" section there is a "Restricted Pages" link that will list the pages and allow you to remove the restrictions from them if desired.

2 Comments

  1. Unknown User (jem@centrelink.gov.au)

    Hi. Can this macro use the template option. It might be nice to use a little bit of scaffolding the maintain some order etc.

    1. no, for templates you should use the newpage menulink instead, to retain the same functionality as add-topic include the add-page-restriction macro in your template.