Looking for the best way to announce or share news and urgent announcements with your Confluence users? The News Teaser add-on for Confluence provides multiple, flexible macros to easily display news from blog posts, pages, or ad-hoc content in a beautiful way.

>>> Macro Demo Page <<<

Macros Included

  • 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.

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.

Parameter

Default

Description

Content Types

Blog Posts

Choose whether you want to display news from pages or blog posts or from both. Valid values are:

  • Pages - Display news from pages.

  • Blog Posts - Display news from blogposts.

  • Pages And Blog Posts - Display news from pages and blogposts.

Labels


Comma separated list of labels to search news by.

Spaces


Select one or more spaces to restrict searching of news. Leave blank for all spaces.

CQL Query


CQL Search query to further refine your search for news. Click here to open full CQL Documentation

Examples:

  • creator = "admin" returns news created by admin

  • created = "2019/01/01" returns news created at 2019/01/01

Time Frame


None - no time limit for news. Specify 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

  • M - Months

  • y - Years

Sort Order

Last Modified

Choose the order the news should be sorted by. Valid values are:

  • Title/Title Desc- Sort by title of page or blogpost

  • First Created/ Last Created- Sort by creation date of page or blogpost.

  • First Modified/ Last Modified- Sort by last modification date of page or blogpost.

Max Results

5

Maximum number of news to be displayed in the slider.

Show Error If No News Found

Enabled

Enable to show error message when no news were found.

Width

100%

Width of the slider in pixels or percents.

Height


Height of the slider in pixels. Leave blank to automatically use the height of the tallest slide.

Auto Slide Display Time

3 seconds

How long each news entry will be displayed in seconds, 0 turns auto slide off.

Buttons Color

#0049B0

Color of prev/next navigation. Use hexadecimal notation or HTML color name.

Background Color

white

Background color of news entries. Use hexadecimal notation or HTML color name.

Show Navigation

Enabled

Enable to show prev/next navigation.

Show Bullets

Enabled

Enable to show navigation bullets.

News Image Label


The file 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.

When no image label is entered, image is selected by name in alphabetic order (not by the date it was added).

NB. To add an image label: Go to the page where images are attached > in the top right corner of the page click on the three dots > select Attachments > a list of images appears where you can add and edit labels!

News Text

Text Summary

Choose which part of the page or blogpost content you want to display as news text:

  • Text Summary - first 255 characters of text from page or blogpost content

  • Full Text - entire text from page or blogpost content

  • Excerpt Summary - first 255 characters of text from inside excerpt macro

  • Full Excerpt - entire rendered content from inside excerpt macro

  • Full Content - entire rendered page or blogpost content

Display Space

Enabled

Enable to display the name of the space in news entries.

Display Author

Enabled

Enable to display the author's name in news entries.

Display Publication Date

Enabled

Enable to display the publication date in news entries.

Display Social Stats

Enabled

Enable to display the number of comments and likes in news entries.

Enable Links

Enabled

Enable to link news entries to their corresponding page or blogpost.

Open in Same Tab

Disabled

Enable to open the link in the current tab.


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.

Parameter

Default

Description

Content Types

Blog Posts

Choose whether you want to display news from pages or blog posts or from both. Valid values are:

  • Pages - Display news from pages.

  • Blog Posts - Display news from blogposts.

  • Pages And Blog Posts - Display news from pages and blogposts.

Labels


Comma separated list of labels to search news by.

Spaces


Select one or more spaces to restrict searching of news. Leave blank for all spaces.

CQL Query


CQL Search query to further refine your search for news. Click here to open full CQL Documentation

Examples:

  • creator = "admin" returns news created by admin

  • created = "2019/01/01" returns news created at 2019/01/01

Time Frame


None - no time limit for news. Specify 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

  • M - Months

  • y - Years

Sort Order

Last Modified

Choose the order the news should be sorted by. Valid values are:

  • Title/Title Desc- Sort by title of page or blogpost

  • First Created/ Last Created- Sort by creation date of page or blogpost.

  • First Modified/ Last Modified- Sort by last modification date of page or blogpost.

Max Results

10

Maximum number of news to be displayed in the slider.

Show Error If No News Found

Enabled

Enable to show error message when no news were found.

Layout

Cards

Choose 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

Responsive

Choose 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.

Promoted Label


Label which indicates whether a news should be displayed as promoted news with a ribbon containing the label name. Leave blank for no promoted news.

Promoted Label Color

#3873ae

Color of the ribbon of promoted news. Use hexadecimal notation or HTML color name. Field only appears when "Promoted Label" fields is entered.

Display Promoted News First

Enabled

Enable to display promoted news before regular news. Field only appears when "Promoted Label" fields is entered.

News Image Label


The file 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.

When no image label is entered, image is selected by name in alphabetic order (not by the date it was added).

NB. To add an image label: Go to the page where images are attached > in the top right corner of the page click on the three dots > select Attachments > a list of images appears where you can add and edit labels!

Background Color

white

Background color of news entries. Use hexadecimal notation or HTML color name.

News Text

Text Summary

Choose which part of the page or blogpost content you want to display as news text:

  • Text Summary - first 255 characters of text from page or blogpost content

  • Full Text - entire text from page or blogpost content

  • Excerpt Summary - first 255 characters of text from inside excerpt macro

  • Full Excerpt - entire rendered content from inside excerpt macro

  • Full Content - entire rendered page or blogpost content

Display Space

Enabled

Enable to display the name of the space in news entries.

Display Author

Enabled

Enable to display the author's name in news entries.

Display Publication Date

Enabled

Enable to display the publication date in news entries.

Display Social Stats

Enabled

Enable to display the number of comments and likes in news entries.

Enable Links

Enabled

Enable to link news entries to their corresponding page or blogpost.

Open in Same Tab

Disabled

Enable to open the link in the current tab.


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.

Parameter

Default

Description

Content Types

Blog Posts

Choose whether you want to display news from pages or blog posts or from both. Valid values are:

  • Pages - Display news from pages.

  • Blog Posts - Display news from blogposts.

  • Pages And Blog Posts - Display news from pages and blogposts.

Labels


Comma separated list of labels to search news by.

Spaces


Select one or more spaces to restrict searching of news. Leave blank for all spaces.

CQL Query


CQL Search query to further refine your search for news. Click here to open full CQL Documentation

Examples:

  • creator = "admin" returns news created by admin

  • created = "2019/01/01" returns news created at 2019/01/01

Time Frame


None - no time limit for news. Specify 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

  • M - Months

  • y - Years

Sort Order

Last Modified

Choose the order the news should be sorted by. Valid values are:

  • Title/Title Desc- Sort by title of page or blogpost

  • First Created/ Last Created- Sort by creation date of page or blogpost.

  • First Modified/ Last Modified- Sort by last modification date of page or blogpost.

Max Results

5

Maximum number of news to be displayed in the slider.

Show Error If No News Found

Enabled

Enable to show error message when no news were found.

Title

News

The title of the ticker to display.

Width

100%

Width of the ticker in pixels or percents.

Color

#3873ae

Color of the ticker. Use hexadecimal notation or HTML color name.

Display Time

4 seconds

How long each news entry will be displayed in seconds, 0 turns auto slide off.

News Text

Title

Choose 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


Optionally 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.

  • Creation Date - Creation date of page or blogpost.

  • Modified Date - Last modification date of page or blogpost.

Enable Links

Enabled

Enable to link news entries to their corresponding page or blogpost.

Open in Same Tab

Disabled

Enable to open the link in the current tab.


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.

Parameter

Default

Description

Title

News

The title of the ticker to display.

Width

100%

Width of the ticker in pixels or percents.

Display Time

4 seconds

How long each news entry will be displayed in seconds

Color

#3873ae

Color of the ticker. Use hexadecimal notation or HTML color name.