Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
Layout Editor (legacy editor)Layout Editor (legacy editor)Activity Stream module
Activity Stream module
nameLE warningOnly on charlie conf
nopaneltrue

News module

The News module shows the most recent Confluence blog posts from one or more spaces. You can use this module on a help site to show a product’s latest features, as we have done on the Refined Sites for Cloud landing page on this our site.

...

Add this module to a page

Info

This module is only available if you have Refined for Confluence Cloud.

  1. Open the Page Builder on the page you want to edit. This can be:

  2. Go to a landing page on your site.

  3. Click the Edit page button.

  4. Hover your mouse over the desired location on the page and click the + Add module button that appears.

  5. Click News in the left-hand menu.

  6. Select the News module.

Edit the title

Simply click the module’s title to start writing and formatting. You can (heading), to edit it. There are various formatting options, including paragraph/heading styles. Tip: use text variables to make the text dynamic, for example to display the user’s first name.

Edit the settings

  1. Select Click the module to see open its settings menu, which appears on its right-hand side.Click the Cogwheel.

  2. Edit the settings, which are divided over multiple tabs:

Module tab

Setting

Description

Background

Add an Image, Color, or Gradient as background – or turn off the background by selecting None.

There are multiple ways to pick a color:

  • Select the shade and hue at the top of the popup.

  • Enter an RGB, RGBA, or hex code.

  • Click the eyedropper icon to select a color from anywhere on the page (available in the browsers Firefox and Edge).

  • Click one of the recently used colors.

Use the vertical slider in the middle of the popup to control the color’s opacity.

Fixed height

By default, all modules adjust their size to their content. To set a fixed height instead, fill in the desired height in pixels.

News tab

Setting

Description

Display style

  • Image feed shows the blog posts' image, title and publishing date.

  • Content feed Cards shows the blog posts' image, title, description and publishing date.

  • List shows the blog posts' publishing date and title.

  • Slideshow shows the blog posts one by one. It includes the blog posts' image, title and publishing date.

Avatars

Show or hide the blog authors' avatars (profile pictures). Users set up their avatars in their Atlassian account.

Number of items

Enter the amount of blog posts you want to show by default. Users can always click a button to load more, except when the Display style is set to Slideshow.

Filter

Filters let you narrow down which blog posts from your site's Confluence spaces to show.

  • Simple lets you filter by label, space and author.

  • Select Advanced to filter with CQL.

Filter by label
Available when Filter is set to Basic.

Enter a label to include only the blog posts that have that label in Confluence. Add a dash ( - ) in front of a label to exclude its blog posts. Separate multiple labels with commas.

Filter by space
Available when Filter is set to Basic.

To show blog posts from all Confluence spaces on your site, leave this field empty.

To show blog posts from one or more other spaces, add space keys separated with commas. Exclude a space key by adding a dash ( - ) in front of it.

To show dynamic content, enter a text variable:

Insert excerpt
Text variables (Page Builder)
Text variables (Page Builder)
nameNews
nopaneltrue

Filter by author
Available when Filter is set to Basic.

Enter a creator’s Account ID to include their blog posts. A user’s Account ID can be found in the URL of their Atlassian profile. For example, in a URL ending with wiki/people/62f636d425abc07e51c8b330, the bold string of letters and numbers is the user’s Account ID.

Add a dash ( - ) in front of a Account ID to exclude that user’s activity. Separate multiple IDs with commas.

To show only blog posts created by the user viewing the page, enter $userid.

Filter with CQL
Available when Filter is set to Advanced.

Use CQL to show specific blog posts. Use "type = blogpost". Make the filter dynamic with text variables.

For example, show blog posts that the user added:

Code Block
type = blogpost AND creator = $username ORDER BY created DESC

Images

By default, the module shows an image from the blog post . To (if available) You can also set a custom image, add it to the blog post’s metadata. preview image instead. Images are shown in a 4:3 portrait (vertical) format. We recommend using images that are at least 800x600 pixels.

Description

By default, the module shows the blog post’s first 250 characters. To set a custom description, add metadataa preview text to the blog post.