News Teaser

Looking for the best way to announce or share your news to your Confluence users? The News Teaser add-on for Confluence provides multiple macros to easily display news from blogposts and pages in a beautiful way.

Includes:

  • News Slider macro
    Use the News Slider macro to display news from blogposts and pages with thumbnail and excerpt in a simple and beautiful slider.
  • News Teaser macro
    Use the News Teaser macro to display news entries with thumbnail and excerpt in a Pinterest like cards layout or as simple list.
  • News Ticker macro
    Use the News Ticker macro to show off your latest breaking news from blogposts and pages in a simple news ticker.
  • News Ticker From List macro
    Use the News Ticker From List macro to grab news from a bullet list specified in the macro body and display them in a simple ticker.

Feature Highlights:

  • Easily collect news entries from Confluence blogposts or pages and optionally filter them by spaces or labels.
  • Choose whether you want to display a summary, a short excerpt or the complete content as news text.
  • Specify which image attached to the corresponding page or blogpost you want to display as thumbnail.
  • Easily display social stats like the number of comments and likes to see which news are the most engaging.
  • Link news entries to corresponding pages or blogposts to allow users to read the entire news.
  • Fully customizable macros to adapt the output to your needs.
  • All macros are fully responsive and mobile compatible.
  • Works best in combination with the Custom Dashboards plugin to display newly published posts in a stunning way on your custom dashboard, such that it draws the attention of all your users.

Screenshots

News Slider Macro

Use the News Slider macro to display news from blogposts and pages with thumbnail and excerpt in a simple and beautiful slider.

Parameters

ParameterDefaultDescription
Width
width
None - responsive width will be usedWidth of the slider in pixels. Leave blank for responsive width.
Height
height
None - height of the tallest slide will be usedHeight of the slider in pixels. Leave blank to automatically use the height of the tallest slide.
Content Types
contentTypes
blogpostsChoose whether you want to display news from pages or blogposts or from both. Valid values are:
  • pages - Display news from pages.
  • blogposts - Display news from blogposts.
  • pagesAndBlogposts - Display news from pages and blogposts.
Labels
labels
NoneComma separated list of labels to search news by. Prefix labels with a + sign to indicate must-have labels or use a - sign to exclude news having a certain label. Examples:
  • confluence,jira - Returns all news labeled with confluence OR jira.
  • +confluence,+jira,-bitbucket - Returns all news having labels confluence AND jira, excluding news labeled with bitbucket.
Spaces
spaces
None - news from all spaces will be displayedComma separated list of space keys to restrict searching of news. Use @self for current space. Leave blank for all spaces.
Search Query
searchQuery
NoneSearch query to further refine your search for news. See Confluence Search Syntax for more information. Examples:
  • confluence OR jira returns all news containing either 'confluence' or 'jira'
  • "atlassian jira" returns all news containing the phrase 'atlassian jira'
Time Frame
time
None - no time limit for newsSpecify how far back in time Confluence should look for news to be displayed. Example: Use 12h to display all news created or updated in the last 12 hours. Leave blank for no time limit. Available units are:
  • m - Minutes
  • h - Hours
  • d - Days
  • w - Weeks
Sort Order
sort
creationDateChoose the order the news should be sorted by. Valid values are:
  • title - Sort by title of page or blogpost.
  • creationDate - Sort by creation date of page or blogpost.
  • modifiedDate - Sort by last modification date of page or blogpost.
Reverse Order
reverseSort
falseEnable for reverse sort order.
Max Results
maxResults
5Maximum number of news to be displayed in the slider.
Show Error If No News
showErrorIfNone
trueEnable to show error message when no news were found.
News Image
imageFilenameOrLabel
None - use the first image the slider can find attached to the page or blogpostThe file name or label of the image you want to display as news image in the slider. The image needs to be attached to the corresponding page or blogpost. Leave blank to use the first image the slider can find attached to the page or blogpost. If no image attachment with the given file name or label exists or the page or blogpost has no image attachments at all, no news image will be displayed. Example: thumbnail.png
News Text
excerptType
summaryChoose which part of the page or blogpost content you want to display as news text:
  • summary - First 255 characters of text from page or blogpost content.
  • shortExcerpt - First 255 characters of text from inside excerpt macro.
  • longExcerpt - First 500 characters of text from inside excerpt macro.
  • entireExcerpt - Entire text from inside excerpt macro.
  • entireText - Entire text from page or blogpost content.
  • entireContent - Entire rendered page or blogpost content.
Enable Links
enableLinks
trueEnable to link news entries to their corresponding page or blogpost.
Open Links in new Window
openLinksInNewWindow
falseEnable to open links in a new browser window, if links are enabled.
Auto Slide
autoSlide
trueEnable to automatically slide through news.
Display Time
delay
4000How long each news entry will be displayed (ms), if auto slide is enabled.
Show Social Stats
showStats
falseEnable to display the number of comments and likes in news entries.
Show Navigation
showNavigation
trueEnable to show prev/next navigation.
Show Bullets
showBullets
trueEnable to show navigation bullets.
Color
color
None - topbar color of current space will be usedColor of prev/next navigation. Use hexadecimal notation or HTML color name. Leave blank to automatically use the topbar color of the current space.
Background Color
backgroundColor
#f5f5f5Background color of news entries. Use hexadecimal notation or HTML color name.

News Teaser Macro

Use the News Teaser macro to show off news entries with thumbnail and excerpt in a Pinterest like cards layout or as simple list.

Parameters

ParameterDefaultDescription
Content Types
contentTypes
blogpostsChoose whether you want to display news from pages or blogposts or from both. Valid values are:
  • pages - Display news from pages.
  • blogposts - Display news from blogposts.
  • pagesAndBlogposts - Display news from pages and blogposts.
Labels
labels
NoneComma separated list of labels to search news by. Prefix labels with a + sign to indicate must-have labels or use a - sign to exclude news having a certain label. Examples:
  • confluence,jira - Returns all news labeled with confluence OR jira.
  • +confluence,+jira,-bitbucket - Returns all news having labels confluence AND jira, excluding news labeled with bitbucket.
Spaces
spaces
None - news from all spaces will be displayedComma separated list of space keys to restrict searching of news. Use @self for current space. Leave blank for all spaces.
Search Query
searchQuery
NoneSearch query to further refine your search for news. See Confluence Search Syntax for more information. Examples:
  • confluence OR jira returns all news containing either 'confluence' or 'jira'
  • "atlassian jira" returns all news containing the phrase 'atlassian jira'
Time Frame
time
None - no time limit for newsSpecify how far back in time Confluence should look for news to be displayed. Example: Use 12h to display all news created or updated in the last 12 hours. Leave blank for no time limit. Available units are:
  • m - Minutes
  • h - Hours
  • d - Days
  • w - Weeks
Sort Order
sort
creationDateChoose the order the news should be sorted by. Valid values are:
  • title - Sort by title of page or blogpost.
  • creationDate - Sort by creation date of page or blogpost.
  • modifiedDate - Sort by last modification date of page or blogpost.
Reverse Order
reverseSort
falseEnable for reverse sort order.
Max Results
maxResults
5Maximum number of news to be displayed.
Load More
loadMore
trueEnable to show button at the bottom to load more news entries.
Show Error If No News
showErrorIfNone
trueEnable to show error message when no news were found.
Layout
layout
cardsChoose whether you want to display news in a Pinterest like cards layout or as list. Valid values are:
  • cards - Display news in a Pinterest like cards layout.
  • list - Display news as simple list.
Columns
columns
responsiveChoose the number of columns to be displayed when using the cards layout. Use responsive to let the macro dynamically choose the number of columns for the best fit. Valid values are:
  • responsive - The number of columns is dynamically detected for the best fit.
  • 1 - Display news in a single column.
  • 2 - Display news in two columns.
  • 3 - Display news in three columns.
  • 4 - Display news in four columns.
  • 5 - Display news in five columns.
News Image
imageFilenameOrLabel
None - use the first image the macro can find attached to the page or blogpostThe file name or label of the image you want to display as news image. The image needs to be attached to the corresponding page or blogpost. Leave blank to use the first image the macro can find attached to the page or blogpost. If no image attachment with the given file name or label exists or the page or blogpost has no image attachments at all, no news image will be displayed. Example: thumbnail.png
News Text
excerptType
summaryChoose which part of the page or blogpost content you want to display as news text:
  • summary - First 255 characters of text from page or blogpost content.
  • shortExcerpt - First 255 characters of text from inside excerpt macro.
  • longExcerpt - First 500 characters of text from inside excerpt macro.
  • entireExcerpt - Entire text from inside excerpt macro.
  • entireText - Entire text from page or blogpost content.
  • entireContent - Entire rendered page or blogpost content.
Show Space
showSpace
trueEnable to display the name of the space in news entries.
Show Author
showAuthor
trueEnable to display the author's name in news entries.
Show Publication Date
showDate
trueEnable to display the publication date in news entries.
Show Social Stats
showStats
trueEnable to display the number of comments and likes in news entries.
Show Engagement Buttons
showButtons
trueEnable to display engagement buttons (like, favorite, comment and share) when hovering over news entries.
Enable Links
enableLinks
trueEnable to link news entries to their corresponding page or blogpost.
Open Links in new Window
openLinksInNewWindow
falseEnable to open links in a new browser window, if links are enabled.

News Ticker Macro

Use the News Ticker macro to grab your latest breaking news from blogposts and pages and display them in a simple ticker.

Parameters

ParameterDefaultDescription
Title
title
falseThe title of the ticker to display.
Width
width
None - responsive width will be usedWidth of the ticker in pixels. Leave blank for responsive width.
Content Types
contentTypes
blogpostsChoose whether you want to display news from pages or blogposts or from both. Valid values are:
  • pages - Display news from pages.
  • blogposts - Display news from blogposts.
  • pagesAndBlogposts - Display news from pages and blogposts.
Labels
labels
NoneComma separated list of labels to search news by. Prefix labels with a + sign to indicate must-have labels or use a - sign to exclude news having a certain label. Examples:
  • confluence,jira - Returns all news labeled with confluence OR jira.
  • +confluence,+jira,-bitbucket - Returns all news having labels confluence AND jira, excluding news labeled with bitbucket.
Spaces
spaces
None - news from all spaces will be displayedComma separated list of space keys to restrict searching of news. Use @self for current space. Leave blank for all spaces.
Search Query
searchQuery
NoneSearch query to further refine your search for news. See Confluence Search Syntax for more information. Examples:
  • confluence OR jira returns all news containing either 'confluence' or 'jira'
  • "atlassian jira" returns all news containing the phrase 'atlassian jira'
Time Frame
time
None - no time limit for newsSpecify how far back in time Confluence should look for news to be displayed. Example: Use 12h to display all news created or updated in the last 12 hours. Leave blank for no time limit. Available units are:
  • m - Minutes
  • h - Hours
  • d - Days
  • w - Weeks
Sort Order
sort
creationDateChoose the order the news should be sorted by. Valid values are:
  • title - Sort by title of page or blogpost.
  • creationDate - Sort by creation date of page or blogpost.
  • modifiedDate - Sort by last modification date of page or blogpost.
Reverse Order
reverseSort
falseEnable for reverse sort order.
Max Results
maxResults
5Maximum number of news to be displayed.
Show Error If No News
showErrorIfNone
trueEnable to show error message when no news were found.
News Text
excerptType
titleChoose which part of the page or blogpost you want to display as news text:
  • title - Title of page or blogpost.
  • excerpt - Content from inside excerpt macro.
Prefix Text
prefix
NoneOptionally choose whether you want to display the space, author, creation date or last modification date before the news text. Valid values are:
  • space - Space of page or blogpost.
  • author - Author of page or blogpost.
  • creationDate - Creation date of page or blogpost.
  • modifiedDate - Last modification date of page or blogpost.
Enable Links
enableLinks
trueEnable to link news entries to their corresponding page or blogpost.
Open Links in new Window
openLinksInNewWindow
falseEnable to open links in a new browser window, if links are enabled.
Display Time
delay
4000How long each news entry will be displayed (ms).
Color
color
None - topbar color of current space will be usedColor of the ticker. Use hexadecimal notation or HTML color name. Leave blank to automatically use the topbar color of the current space.

News Ticker From List Macro

Use the News Ticker From List macro to grab news from a bullet list specified in the macro body and display them in a simple ticker.

News Ticker From List

Parameters

ParameterDefaultDescription
Title
title
falseThe title of the ticker to display.
Width
width
None - responsive width will be usedWidth of the ticker in pixels. Leave blank for responsive width.
Display Time
delay
4000How long each news entry will be displayed (ms).
Color
color
None - topbar color of current space will be usedColor of the ticker. Use hexadecimal notation or HTML color name. Leave blank to automatically use the topbar color of the current space.