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.

CODE

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 .

CODE

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.

CODE

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