News Board: Using News Board
The News page
Accessing the News page via the global navigation
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.
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.
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.
- Insert a 'Profile Picture' on your featured blogpost, and the lozenge colour will be set for 'People'. Any images will be ignored, and it will use the profile image instead. Use this to introduce team members or provide recognition.
- Insert a 'Warning Panel' on your featured blogpost, and the lozenge colour will be set for 'Important'. Any images will be ignored. Use this to highlight must-read content.
- Everything else will use the 'News' lozenge colour.
The Configure menu
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.
Adding a Banner
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:
- Make sure the image is saved in a space that all users can access.
- Find the image and right-click to copy the link to it. If the link you copy looks strange and starts with "blob", don't worry - News Board will fix the link. But you can not use links that start with a sub-domain of "api.media.atlassian.com".
News Board roles
The following News Board roles are available:
- Admin - configure all settings, except General Settings (see below).
- Editor - Feature content, manage Categories, configure Look and Feel.
- Feature - Feature content. Only applies if all users aren't permitted to feature content.
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.