The Lucene query parameter of the news macros
The macros Blog Posts & Pages, Top Stories Slider and News Boxes have a parameter called Lucene Query
. This parameter is a very flexible Parameter and can be used to:
Write an own more specific Lucene Query to select the desired content by using the Confluence Search Syntax.
To connect our Macros with the Metadata Add-on by Communardo
To connect our Macros with the User Profile Add-on by Communardo
All these different usage types can be combined to build a very detailed and dynamic content selection.
Enterprise Theme version 5.2.0 or greater is needed
Related articles:
Examples
Usage of the Confluence Search Syntax
In this example we select all blogs with the word Confluence in the title. The whole syntax is documented in the article Confluence Search Syntax.
title:Confluence*
Filter by metadata
If you use the Metadata Add-on by Communardo, you can filter the results by the metadata in the following way to show only content with the metadata City:Berlin .
title:Confluence* AND metadatafield.city:Berlin
How to determine the name of the metadata field and some more examples can be found in Use the Communardo Metadata Add-on with the Enterprise Theme News Macros.
Filter by the User Profile
If you use the Metadata Add-on and the User Profile Add-on by Communardo you can combine these to use the profile information of the current user. This allows you to provide a very user specific listing.
metadatafield.city:upc.currentUser.Location
The part upc.currentUser.Location
will be replaced by the Location of the user (if such a field exists). More information about this feature can be found in Use the Communardo User Profiles Add-on with the Enterprise Theme News Macros
Available variables in the context of the parameter
There are some variables you can use within the Lucene parameter:
Variable | Description | Example |
---|---|---|
$user | The current user | $user.name |
$spaceKey | The spaceKey of the current space | |
$content, $page | The current viewed content object com.atlassian.confluence.core.ContentEntityObject | |
$contentId | The id of the current content object | |
$helper | An instance of the class com.atlassian.confluence.themes.ThemeHelper | |
$req | The current request |