News Slider Macro - Cloud

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

Parameters

Parameter		Default	Description

Parameter		Default	Description
News selectors	Content Types `contentTypes`	Blog Posts	Choose whether you want to display news from pages, blog posts, or both. Valid values are: Pages - Display news from pages. Blog Posts - Display news from blogposts. Pages And Blog Posts - Display news from pages and blog posts.
	Labels `labels`		Comma-separated list of labels to search news by.
	Spaces `spacesSelected`		Select one or more spaces to restrict searching for news. Leave blank for all spaces.
	CQL Query `cql`		CQL Search query to further refine your search for news. Click here to open the full CQL Documentation Examples: creator = "admin" returns news created by admin created = "2019/01/01" returns news created at 2019/01/01
	Time Frame `timeFrame`		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 `sortOrder`	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 `maxResults`	5	Maximum number of news to be displayed in the slider.
	Show Error If No News Found `showError`	Enabled	Enable to show error message when no news were found.
Slider Configuration	Width `width`	100%	Width of the slider in pixels or percents.
	Height `height`		Height of the slider in pixels. Leave blank to automatically use the height of the tallest slide.
	Auto Slide Display Time `displayTime`	3 seconds	How long each news entry will be displayed in seconds, 0 turns auto slide off.
	Buttons Color `buttonsColor`	#0049B0	Color of prev/next navigation. Use hexadecimal notation or HTML color name.
	Background Color `color`	white	Background color of news entries. Use hexadecimal notation or HTML color name.
	Show Navigation `navigation`	Enabled	Enable to show prev/next navigation.
	Show Bullets `bullets`	Enabled	Enable to show navigation bullets.
News cards configuration	News Image Label `imageLabels`		The file label of the image you want to display as a news image in the slider. The image needs to be attached to the corresponding page or blog post. Leave blank to use the first image the slider can find attached to the page or blog post. If no image attachment with the given file name or label exists or the page or blog post has no image attachments at all, no news image will be displayed. 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 `newsText`	Text Summary	Choose which part of the page or blog post content you want to display as news text: Text Summary - first 255 characters of text from the page or blog post content Full Text - entire text from page or blog post 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 blog post content
	Display Space `showSpace`	Enabled	Enable to display the name of the space in news entries.
	Display Author `showAuthor`	Enabled	Enable to display the author's name in news entries.
	Display Publication Date `showDate`	Enabled	Enable to display the publication date in news entries.
	Display Social Stats `showStats`	Enabled	Enable to display the number of comments and likes in news entries.
	Enable Links `link`	Enabled	Enable to link news entries to their corresponding page or blog post.
	Open in Same Tab `sameTab`	Disabled	Enable to open the link in the current tab.

Creating News Slider macro

To create a News Slider macro, perform the following steps:

Create a new page or go to Edit the page where you want to create the news or blog post.
Type / or click the + icon and search for News Slider macro.
Select News Slider macro. The Insert ‘News Slider’ Macro window is displayed.
Choose the Content Type from the drop-down.
Type the name of the space from where you to pull the news from. You can specify multiple space names.
You can customize parameters according to your requirements. For more information, see Parameters.
Click Insert.