Macro name: contentbylabel
Macro body: None.
| Parameter name | Required | Default | Parameter description and accepted values |
|---|---|---|---|
spaces | No | @all | Filters the results by space. The macro will display only the pages and other content types which belong to the space(s) you specify here. Special values: |
author | No | (None) | Filters the results by author. The macro will display only the pages and other content types which are written or updated by the author(s) you specify here. |
title | No | (None) | Adds a heading to the list. |
showLabels | No | true | Determines whether to display the matching labels in the list of results. |
reverse | No | false | Use this parameter in conjunction with the sort parameter. Set reverse=true to change the sort from ascending to descending. This parameter is ignored if the sort parameter is not specified. |
sort | No | modified | Determines how the results are sorted. To change the sort order from ascending to descending, use the reverse parameter described above. If this parameter is not specified, the sort order defaults to descending order based on the last modification date. Values: |
max | No | 15 | Determines the maximum number of results to be displayed. Note that the results are sorted first, and then the maximum parameter is applied. |
excerpt | No | false | If this parameter is set to true, the macro displays an excerpt from each page listed in the results. Note that you must define the excerpts on each of those pages, by adding the Excerpt macro to each page. If a particular page does not have an excerpt defined, then the Content by Label macro will not attempt to show an excerpt for that page. The Content by Label macro will show only the first few lines of the excerpt for each page. |
labels | Yes | (None) | Use this parameter to filter the results by label. The macro will display only the pages and other content types which are tagged with the label(s) you specify here. See also the operator parameter.You can specify one or more label values, separated by a comma or a space. |
showSpace | No | true | Determines whether to display the spaces in the list of results. |
type | No | All | Filters the restults by content type. The macro will display only the content of the type you specify here. You can specify one or more types, separated by a comma or a space. Available values:
|
operator | No | OR | The operator to apply to the supplied lists of labels. By default, a page with any of the non-prefixed labels (that is, labels without a plus (+) or minus (-) sign immediately preceding it) will be listed. If you specify a value of AND, only pages with all of the supplied non-prefixed labels will be listed. Note that this parameter only modifies the behaviour of the 'Label(s)' parameter and only affects label values without a plus (+) or minus (-) sign prefix. To avoid confusion or unexpected results, we recommend that you do not use the operator parameter in conjunction with any label values prefixed with '+' or '-' signs. |