The Content by Label macro lists content which has been tagged with specific labels.
On this page:
To insert the content by label macro into a page using the Macro Browser,
|
Once you've found the content by label macro, click 'insert' to add it to your page. |
To display all pages with the label needs-fixing, use:
{contentbylabel:label=needs-fixing|showLabels=false|showSpace=false|maxResults=99|space=@self}
|
Below is a working example of the 'Content by Label' macro. In the example, we have restricted the display to 5 results. By default, Confluence lists all the labels for each result displayed. See the optional parameters below for more information.
必要な入力項目 |
表示結果 |
|---|---|
{contentbylabel:label=documentation|maxResults=5} |
|
パラメーター |
既定 |
説明 |
|---|---|---|
( |
なし |
Filter the results by author. The macro will display only the pages etc which are written or updated by the author(s) you specify here. |
Label(s) |
なし |
This parameter is required. |
Maximum Number of Pages |
15 |
表示される結果の最大数を指定します。結果は最初にソートされ、その後、最大のパラメータが適用されることにご注意ください。 |
( |
または |
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. By using |
Show Labels for Each Page |
true |
Show or hide labels for results. |
Show Space Name for Each Page |
true |
Show or hide spaces for results. |
Reverse Sort |
false |
Use this parameter in conjunction with the |
Sort By |
modified |
Specify how the results should be sorted. To change the sort order from ascending to descending, use the |
Restrict to these Spaces |
@all, i.e. all spaces in your Confluence site. |
This parameter allows you to filter content by space. The macro will display only the pages etc. which belong to the space(s) you specify here. 特別な値: |
List Title |
なし |
Adds a title or heading to the list. |
Include these Content Types Only |
すべて |
このパラメータを使用すれば、コンテンツ タイプでコンテンツを絞り込むことができます。ここで指定したコンテンツ タイプのみがマクロで表示されます。 利用可能な値:
|
Display Excerpts |
false |
Displays excerpts for each page listed in the Content by Label macro. 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. |
{contentbylabel:label=dogs,cats|space=PETS}
|
{contentbylabel:label=dogs,cats|space=@self}
|
{contentbylabel:label=dogs,cats|space=@all}
|
The code below will show only pages (but not blog posts or other content types) with the labels 'dogs' or 'cats':
{contentbylabel:label=dogs,cats|type=page}
|
{contentbylabel:label=dogs,cats|showLabels=false}
|
{contentbylabel:label=dogs,cats|showSpace=false}
|
{contentbylabel:label=dogs,cats|excerpt=true}
|
{contentbylabel:label=dogs,cats|max=99}
|
{contentbylabel:label=dogs,cats|sort=modified}
|
{contentbylabel:label=dogs,cats|sort=modified|reverse=true}
|
Related Labels Macro
Navmap Macro
Recently Used Labels Macro
Working with Labels
Working with Macros
Take me back to the Confluence User's Guide.