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.
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.
- Number of pages and blogposts: The maximum number of most recent featured pages and blogposts to display. News Board may trim the number of the pages and blogposts shown when the Hero option is selected.
- Show a hero: If the latest featured page or blogpost contains a suitable image, display as a hero. A hero does not display in narrow columns.
- Show a link to open the News Board page: If selected, a link is included at the bottom to open the full News Board page.
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.
- 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.