Annual Documentation Survey

Do you have 4 minutes to help us improve our documentation? Please take our annual survey!

Skip to end of metadata
Go to start of metadata

Description

Forums can be added to a Confluence Page using either the Community Forums Blueprints feature (recommended), or by manually adding the macros to a page.

The blueprint feature creates a forum under the current space and page.

Usage

Initial steps

  1. Click Create (three dots) from the Confluence Toolbar.
  2. Choose the Community Forum blueprint.



Default configuration

The default configuration adds the Status, Topic, Author, Number of Replies, Number of Views, and Last Activity Date columns. The Search, Sort and Filter features will be available as default including the new topic button. Sticky topics on top is set to true. Pagination is set to 20 topics per page. The Root page for the Forum is set to the page where the Forum Macro is located. The forum is still fully configurable after creation.

  1. Provide a forum title which will also be the name of the page.
  2. If choosing Default configuration, simply click Next, and then Done, and you'll see the newly created forum.


Custom configuration

  1. Provide a forum title which will also be the name of the page. See illustration above.
  2. Select "Custom Configuration" and click next.
  3. Select which columns you wish to appear in the forum and click next.




  4. Select "Display activity score" if you would like to see the activity score per topic in a separate column. This does not influence whether or not the 'hot' indicator () is shown. Only add this if you want the forum users to see the activity score per topic.
  5. Input the activity score threshold. This determines how much activity in a topic is required to make it hot. The higher the threshold, the more activity is required.
  6. Click next.




  7. Specify the root page if required. By setting an alternative root page, the forum will index all pages under a certain root and treat that as the root of the forum. You will be able to search, sort and filter all topics under this root. All topics added to the forum using the add topic button will appear under the root page. The default page will be the page where the Forum Macro resides (default: @self).
  8. Enter the number of topics to be displayed per forum. This splits the forum table across several pages navigable from the bottom of the forum.
  9. Select "Ass sub-forum table" if one is required. This adds a forum-summary macro under the forum macro configured to show child pages that contain forum macros. Create sub-forums easily by creating a forum under the current forum using the blueprint template again.
  10. Click next.




    The "Restrict new topic to creator" macro parameter has been disabled from v.2.3.1.

  11. Click Create and you're done! Your new forum is setup and ready to go.


  • No labels