News Board: Using News Board

The News page

By default, when News Board is installed, a link to the News page is added to the Confluence global navigation.

Note: This link may appear differently if your News page has been renamed (see the 'Changing the name and colour scheme of the News page' section below) or if the link has been disabled by the Confluence Administrator in 'General Settings'.

Alternatively, News Board can be installed as a space theme. It can then also replace the default Confluence dashboard (see below).

Using the News page

The News page header provides a search box to search all featured content. For Users with the Editor or Admin role or Confluence Administrators, a drop-down menu provides access to configuration dialogs (except 'General Settings', accessed by Confluence Administrators via Apps > Manage Apps menu).

Installing as a space theme

News Board can be used as a theme within a space and replaces the standard space homepage. See Apply a Theme to a Space.

Once applied as a theme, if you are a Confluence Administrator you can also then set this space as your 'Site Homepage' to replace the default dashboard with the News page. See Configuring the Site Homepage.

Using the macro

You can display featured pages and blogposts using the News Board macro. The macro can be used directly on the page or added to a layout. To use the macro, type /News Board.

Options are:

Note: The macro is responsive and adaptive to the width of the page and the options selected, so the published macro may look different on some screens. Sometimes the live preview will not immediately reflect your configuration changes. When this happens, try previewing page, then return to editing. If the published macro still doesn't appear as expected, please let us know.

For the best results, use the 'wide' width and pick a maximum of either 3, 6, or 9 pages and blogposts for a 3 column display. When using the 'centre' width, use either 2, 4, or 8 for a 2 column display. In layouts, the News Board macro will display either as a 2 column or single column only.

Featuring pages and blogposts

How to feature content

Find the page or blogpost you would like to feature. Click on the button and select the 'Feature' option from the drop-down menu.

The feature dialog provides a toggle control to mark the content as featured and a drop-down menu to select a category.

If a user cannot feature content, they can still view the Feature dialog but not make any changes.

Once you feature content, it may take a few moments to appear on the News page while Confluence updates its search index.

You can quickly check if a page or blogpost has been featured by looking for the black tick on a yellow background icon. This icon is only visible to logged-in users.

Note: News Board respects access permissions, so users can only see content they are entitled to see and edit (Add) permissions are required to feature content.

How to include an image in your featured content

Simply attach or link to image in your page or blogpost - News Board will use the first image in the content. To learn about how to attach or link to images from the Web, see Display Files and Images.

In the default News page layout (see 'Styling your News page' below), if the first featured page or blogpost includes a big enough image, it will be shown as a hero in the first row (followed by a 2 x 3 grid). However, if the most recent image doesn't have a suitable image, a 3 x 3 grid will be shown instead.

Control the category lozenge colours

The colour of the category lozenges represents three types of content: news, news about people, and important content. However, the colour indicator is separate from the Category applied and is controlled by including specific macros in your content.

Users with News Board Admin or Editor roles (see 'News Board roles' below), and Confluence Administrators, can access all the News Board configuration options from the 'Configure' button on the News Board page. Editors can view some settings, but not change them.

Managing content Categories

Users with the Editor or Admin role or Confluence Administrator can manage the content categories using the Categories dialog.

Note: While you can edit existing categories, categories can't be deleted, only marked inactive.

Styling your News page

Users with the Editor or Admin role or Confluence Administrator can change the appearance of News Board.

Changing the name and colour scheme of the News page

Use the Look and Feel option to change the colour scheme of the News page. Enter colour values using hex colour values. You will be shown a preview of the colour scheme as you enter new values. The 'Reset' button replaces the values with the default colour scheme used at installation, however, the changes will not be applied until you save the new configuration.

Changes to the name of the News page will apply immediately, however, try refreshing the page and clearing the cache if changes to the colour scheme do not update immediately.

Changing the Layout template

Use the Layout option to select a different layout template. The default News page layout is a 3x3 grid template. In the default News page layout, the first row is replaced with a hero image, if the latest featured content contains a suitable image. Check the description for each layout template for more information about how they work.

As well as changing colours and layout, you can add an image Banner to your News page. Currently, the banner image file needs to be hosted in an accessible URL. Images 980px x 150px in size fit best, as News Board will format the image to fit the space.

You can also change the text colour of News page name and settings menu, otherwise, the text colour set in Look and Feel is used.

You will be shown a preview of the banner as you enter new values. The 'Reset' button clears the banner settings. Changes to the banner image will apply immediately, however, try refreshing the page and clearing the cache if the image does not update immediately.

To use an image stored in Confluence:

News Board roles

The following News Board roles are available:

Roles are set using the Users dialog. To remove a user from the list, set their role to 'Remove' and save.

Note: Only your Confluence Administrator can manage General Settings. These determine if the link to the News page should appear on the global navigation and if any user can feature content. Refer to the Administrator Help page for more information.