Skip to main content
Skip table of contents

The Lucene query parameter of the news macros

The macros Blog Posts & PagesTop Stories Slider and News Boxes have a parameter called Lucene Query. This  parameter is a very flexible Parameter and can be used to:

All these different usage types can be combined to build a very detailed and dynamic content selection.

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



JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.