Versions Compared

Key

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

...

The News module displays blog posts from a Confluence space as thumbnails in chronological order. For example, 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 Refined for Cloud landing page.

...

Add this module to a page

...

All Refined Pages, Jira Projects, and Confluence Spaces that you add in the Site Builder get their own landing page on your Refined site. Modules are the building blocks of these pages.

  1. Go to a page’s Layout Editorthe Page Builder.

  2. Hover your mouse over a spot in the layout the desired location on the page and click the + Add module button that appears.

  3. Click News in the left-hand menu.

Edit the title

Simply click the module’s title to start writing and formatting. You can use text variables to make the text dynamic, for example to display the user’s first name.

Edit the settings

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

  2. Click the Cogwheel.

Module tab

Setting

Description

Fixed height

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

News tab

Enter the module’s title. Use text variables such as $userfirstname to make this title dynamic.

Setting

Description

Title

Turn the module’s title on or off.

Title text
Available when Title is turned on.

Display style[ tbd ]

LINK TO IMAGES AND DESCRIPTIONS INFO BELOW

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

  • Content feed shows the blogposts' image, title, description and publishing date.

  • List shows the blogposts' publishing date and title.

  • Slideshow shows the blogposts one by one in a slideshow style. It includes the blogposts' image, title and publishing date.

Avatars[ tbd ]

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

[ tbd ]

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.

  • [ tbd ]

from legacy page: Show only blogposts that have a specific label in Confluence, or exclude specific blogposts by adding Enter a label to include only the blog posts that have that label in Confluence. Add a dash ( - ) in front of the labela label to exclude its blog posts. Separate multiple labels with commas.

Filter by space
Available when Filter is set to Basic.

  • [ tbd ]

from legacy page: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

on your Refined site Space the News module shows pages from
  • use the text variable $spacekey to show blog posts from only that space.

If you’d like to show content from another space instead, set up dynamic content with Text Variables. You can include several spaces by separating space keys with commas. To exclude results from a space, prepend the space key with
  • 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.

  • [ tbd ]

from legacy page:

Only show content from one or more authors, by adding their Account ID(s). A user’s 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 ID.

Separate multiple IDs with commas. TIP: Make this content dynamic by using Text VariablesEnter a creator's Account ID to include their blog posts. Add a dash ( - ) in front of an ID to exclude their blog posts. 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.

  • [ tbd ]

from legacy page:

The advanced filter lets you use Use CQL to show specific blogposts. 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

...