Versions Compared

Key

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

...

News module

The News module displays shows the most recent Confluence blog posts from a Confluence space as thumbnails in chronological order. For example, you one or more spaces. You can use this module on a help desk site to show a product’s latest features, as we have done on help.refined.com’s the Refined for Cloud landing page.

...

Info

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

...

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

  2. Click the Cogwheel.

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

Module tab

Setting

Description

Fixed height

By default, all modules adjust their size to their content.

If you want

To set a fixed height instead, fill in the desired height in pixels.

News tab

Setting

Description

Display style

  • Image feed shows the

blogposts
  • blog posts' image, title and publishing date.

  • Content feed shows the

blogposts
blogposts
  • blog posts' publishing date and title.

  • Slideshow shows the

blogposts
  • blog posts one by one. It includes the

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

blogposts

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.

Decide which spaces to include:

  • Leave this field empty to show blog posts from all Confluence spaces on your site.

  • When placed on a page that is created from a Confluence space, use the text variable $spacekey to show blog posts from only that space.

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

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 from the user viewing the page, use CQL (Advanced filter) with the function currentUser().

Filter with CQL
Available when Filter is set to Advanced.

Use CQL to show specific

blogposts

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

If the display mode includes images, they are displayed in By default, the module shows an image from the blog post. To set a custom image, add it to the blog post’s metadata.

Images are shown in a 4:3 portrait (vertical) format.The module automatically shows the first image located in each blogpost. If that image has a different ratio than 4:3, the module will crop it. We recommend using images that are at least 800x600 pixels.If you want to use a different image, add metadata to the blogpost.

Description

If the display mode includes a descriptionBy default, the module automatically shows the blogpost’s blog post’s first 250 characters. If you want to To set a custom description, add metadata to the blogpostblog post.