Confluence 3.0 のサポートは終了しています。
ドキュメントの最新バージョンを確認してください。
The Recently Updated macro displays a list of the most recently changed content within Confluence.
The Recently Updated Dashboard macro is similar to this macro, but is intended for display on the Confluence dashboard.
On this page:
Usage with the Macro Browser
To insert the recently updated macro into a page using the Macro Browser,
- Open your desired Confluence page, then click the 'Edit' button. The 'Edit Page' mode opens.
- Next, click the Macro Browser icon
on the editor toolbar. The Macro Browser will open in the middle of the screen. - In the Macro Browser, type the name of your desired macro into the search box at the top right of the window. Macros with a matching name will appear in the centre pane. Click on the desired macro to see its options screen. Here, you can set the macro parameters then click 'insert' to put the macro into the page.
Once you've found the recently updated macro and have added the required parameter values, click 'insert' to add it to your page.
Usage with the Wiki Markup Editor
{recently-updated}
Working Example of Usage
Below is a working example of the 'Recently Updated' macro which by default, lists 15 results.
必要な入力項目 |
表示結果 |
|---|---|
{recently-updated} |
最近更新された課題 |
パラメーター
Parameters are settings for Confluence macros that allow the user to control their content or presentation. The table below lists relevant parameters for this macro.
Parameter names are displayed differently in the macro browser interface and in wiki markup. Below, parameter names used in the macro browser are indicated in Bold text, while their equivalents in wiki markup are indicated in (bracketed) text. If the latter is not shown, then in wiki markup, the parameter's name should be omitted and only its value should be added immediately after the colon symbol (:).
パラメーター |
必須かどうか |
既定 |
説明 |
|---|---|---|---|
Author(s) by username |
いいえ |
指定なし (すべてのコンテンツを表示) |
Filter the results by author. The macro will display only the pages etc which were last modified by the author(s) you specify here. |
Label(s) |
いいえ |
指定なし (すべてのコンテンツを表示) |
結果をラベルで絞り込みます。ここで指定したラベル (複数可) でタグ付けされているページ等のみがマクロで表示されます。
|
Maximum Number of Results |
いいえ |
15 |
Specify the maximum number of results to be displayed. Note that the results are sorted first, and then the maximum parameter is applied. If this parameter is omitted, then a maximum of 15 results are displayed. The theoretical maximum value that this parameter can accept is 2 to the power of 31, minus 1 (or 2147483647), though this has been limited to 200 in the code, for performance reasons. More details are here. |
Reverse Sort |
いいえ |
false |
Use this parameter in conjunction with the |
Show User Profile Pictures |
いいえ |
false |
コンテンツを更新したユーザーのプロファイル画像を表示するには |
Sort By |
いいえ |
modified |
Specify how the results should be sorted. To change the sort order from ascending to descending, use the
|
Space(s) |
いいえ |
@self, i.e. the space which contains the page on which the macro is used |
このパラメータを使用すれば、スペースでコンテンツを絞り込むことができます。ここで指定したスペース (複数可) に属するページ等のみがマクロで表示されます。
特別な値:
|
Include these Content Types Only |
いいえ |
すべてのタイプ |
このパラメータを使用すれば、コンテンツ タイプでコンテンツを絞り込むことができます。ここで指定したコンテンツ タイプのみがマクロで表示されます。 特定のコンテンツ タイプのコンテンツを除外するには、そのコンテンツ タイプのすぐ前にマイナス記号 (-) を追加します。例: コンテンツ タイプを 利用可能な値:
|
Width of Table |
いいえ |
100% |
マウロの表示幅を、ウィンドウ幅に対するパーセント値で指定します。 |
theme |
いいえ |
'concise' with the heading 'Recently Updated' |
このマクロの外観を選択します。
|
例
1. Include content from all spaces
The code below will show all the pages from all the spaces that have been recently updated:
{recently-updated:space=@all}
2. Include content from specific spaces
Use the code below to specify the spaces for which you want to view recently updated content:
{recently-updated:space=SPACEKEY1,SPACEKEY2}
3. Specify the width of the display
Use the code below to limit the width of the display to 50% of the window:
{recently-updated:width=50%}
4. Filter content using labels
The code below will include recently updated content labelled with 'timesheets' or 'summaries', from the 'sales' and 'marketing' spaces, provided that the content is not labelled with 'obsolete':
{recently-updated:space=sales,marketing|label=timesheets,summaries,-obsolete}
5. Sort the results
Use the code below to sort the list of items by date last modified, with the most recent at the top:
{recently-updated:sort=modified|reverse=true}
6. Filter by content type
Use the code below to show pages only (not news items, comments or any other content type) and sort the list of items by date last modified, with the most recent at the top:
{recently-updated:sort=modified|reverse=true|type=page}
7. Change the number of results in the list
The code below changes the number of results listed (from the default value of 15) to 8:
{recently-updated:maxResults=8}
8. Display profile pictures
The code below will display the profile picture of the user who most recently updated the content.
{recently-updated-dashboard:showProfilePic=true}
9. Display recent comments, including profile pictures and text
The code below will display recent comments in the current space, showing the profile picture of the users who made the comments, plus the first line or two of the comment text.
This is the only way to ensure that the text of the comments is displayed, using this macro.
{recently-updated-dashboard:types=comment|showProfilePic=true}
Customising the wording
If you would like to change the wording displayed by the 'Recently Updated' macro, please refer to the document on modifying the Confluence interface text.
関連トピック
Recently Updated Dashboard Macro
Viewing Recently Updated Content
Working with Macros
Take me back to the Confluence User Guide.
概要
コンテンツ ツール
アプリ
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.