In a first step you'll insert the Cover Stories macro into a page where you want to display them. In many cases this will be a dashboard or the main page of a single space, but you can place it wherever you like. It is recommendable to use the whole available width of the page and not put the Cover Stories into a column - although technically that is possible. If the Cover Stories don't have enough room, there might be issues with nicely displaying the contents.
A new window will offer you several layout options for displaying your Cover Stories. Select the layout fitting your needs from the following options:
- four big tiles (2x2)
- two big tiles above and four smaller tiles below (2+4)
- eight small tiles (2x4)
In the example to the left we chose a two by two tiles layout. The page can display four different news from different sources and for different users, according to the specifications made in the admin menu.
Click on a tile to configure its news sources. If you don't configure anything but simply insert the macro on your page, it will show all kinds of news from all spaces. This is also the default configuration.
Defining news sources: Space and label combinations
If you don't plan to personalize the news according to a user's profile attributes, you can simply define a space/label combination. In order for the Cover Stories macro to work properly you have to choose spaces containing blog posts, or else the tile will be left blank.
Optionally you can enter one or more label names, so only blog posts tagged with that label will be shown. A simple use case would be labelling all blog posts you want to be displayed as Cover Story with a label called "cover".
You can use almost any combination of spaces and labels:
If you leave the field empty, the tile will draw news from all spaces in your Confluence instance.
|one space||If you enter a single space, all the news for this tile will come from this specific space.|
|several spaces||If you enter several spaces, the news will com from one of those spaces (as if you said "from space 1 OR space 2")|
If you leave the field empty, the tile will draw all news from the specified space(s), no matter what labels are applied to them
|one label||If you enter a single label, all the news for this tile will come from the specified space(s) AND they have to be tagged with the specified label|
|several labels||If you enter several labels, all the news for this channel will come from the specified space(s) AND they have to be tagged with ALL OF the specified labels|
Linking labels with OR
If your news concept calls for a linking of labels with OR, you can do so by defining a news section in the admin interface and select "Personalized news section" within the tile. Please refer to the admin documentation for further information.
Defining news sources: News categories
If you want to display news belonging to a certain category, they first have to be set up by an admin. Please refer to the admin documentation for that part.
In your Cover Stories tile configuration you select the option "News categories". Start typing the name of a category to narrow down the offered options, if there are lots of categories available.
You can select one, several or no category, which will have the following effects:
If you leave the field empty, the tile will draw all news that have a category assigned to them, no matter what category that is. News without category won't show up in the tile.
|one category||If you enter a single category, only news for this category will be shown.|
|several categories||If you enter several categories, the tile will draw only those news that have ALL of the categories assigned to them.|
Linking labels with OR
If your news concept calls for a linking of categories with OR, you can do so by defining a news section in the admin interface and select "Personalized news section" within the tile. Please refer to the admin documentation for further information.
Defining news sources: Personalized news sections
In order to display personalized news in a tile you'll choose the option personalized news section. A dropdown menu will offer all existing news sections. Just select the one you want to be displayed and confirm your choice by clicking "Apply".
If you want to define more news sections for personalization, please refer to the page ENB - Define News Sections for personalization.
Defining news sources: Specific, single contents
With the other options you define a stream of news that is displayed: Whenever a new post is published, it replaces the previous one in the tile.
But sometimes you might want to have a specific item in a specific place and you want it to stay there as long as you see fit. In this case you choose option #3: "Single page / blog post". Start typing the title of the page or blog post you want to display, and you will be offered matching choices.
Usually you don't need the news teaser macro on pages, only on blog posts. For this use case however, you'll have to embed the macro in the page you want to display on the Cover Stories tile. This works exactly the same as embedding the macro on a blog post. This is described in detail on the page ENB - Define visually attractive teasers for your news 1.2
At this point, Cover Stories come in four different formats or styles. Each item is linked to its respective blog post. You are free to define, which style will be used for the Cover Stories' presentation, independent of the actual content of the blog post.
The image uses the complete available space of the tile. For best results choose image files with an aspect ratio of 16:9 and large enough to fill the available space. If your image file is too wide or too high, the Cover Stories macro will make sure it won't be shown larger than the tile is supposed to be. Please note: In order to select the image inside the News Teaser macro the file has to be already appended to the blog post. It doesn't have to be visible within the post, though.
- The title of the blog post and an excerpt of the content appear below the video. Users can directly play the video if it is shown in one of the larger tiles. If the video is shown in smaller tiles a click will lead to the respective blog post. In both cases you should make sure to embed the video in the blog post as well, not only in the News Teaser macro.
Title on Color
- The title of the blog post appears on a colored background. By editing your theme or custom css you can change the color to match your corporate design. This design works best with short titles.
- The quote appears on a white space. By editing your theme or custom css you can adapt the look of it and match it to your corporate design.
- No labels