The Recently Updated macro displays a list of the most recently changed content within Confluence.

(info) The Recently Updated Dashboard macro is similar to this one, but is intended for display on the Confluence dashboard.

On this page:

Basic Usage

{recently-updated}

Working Example of Usage

Below is a working example of the 'Recently Updated' macro which by default, lists 15 results.

必要な入力項目

表示結果

{recently-updated}

最近更新された課題

Optional Parameters

パラメーター

既定

説明

author

指定なし (すべてのコンテンツを表示)

Filter the results by author. The macro will display only the pages etc which were last modified by the author(s) you specify here.

You can specify one or more authors, separated by a comma or a space.

  • To exclude content which was created or updated by a specific user, put a minus sign (-) immediately in front of the username. For example: If you specify a username of -hpotter you will get only content which the user 'hpotter' has neither created nor edited.
  • To indicate that the results must have been created or updated by least one of the specified users, simply list the usernames separated by commas. For example: If you specify usernames of -hpotter,hgranger,adumbledore you will get content which has been created/updated by either 'hgranger' or 'adumbledore' (or both) but 'hpotter' has not touched.
  • To indicate that the results must have been created or updated by a specific user, put a plus sign (+) immediately in front of the username. For example: If you specify the usernames as +hgranger,+adumbledore you will get content which has been updated by at least two people, being 'hgranger' and 'adumbledore'.

ラベル

指定なし (すべてのコンテンツを表示)

Filter the results by label. The macro will display only the pages etc which are tagged with the label(s) you specify here.

You can specify one or more label values, separated by a comma or a space.

  • To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of -badpage you will get only content which is not labelled with 'badpage'.
  • To indicate that the results must match at least one of the specified label values, simply list the labels separated by commas. For example: If you specify a label value of -badpage,goodpage,superpage you will get content which has a label of either 'goodpage' or 'superpage' (or both) but does not have the label 'badpage'.
  • 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を +superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。

(info) If there are no pages matching any of the specified labels, then Confluence will ignore the labels and will list all recently updated pages, as well as showing a message, "These labels don't exist and were ignored: xxx ". This unexpected behaviour is noted in issue CONF-10167.

labels

指定なし (すべてのコンテンツを表示)

Exactly the same as label above.

max

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).

maxResults

15

Exactly the same as max above.

リバース

false

Use this parameter in conjunction with the sort parameter described below. Set reverse=true to change the sort from ascending to descending order.

Note: this parameter is ignored if the sort parameter is not specified.

showProfilePic

false

Specify showProfilePic=true to display the profile pictures of the users who updated the content.

並べ替え

modified

Specify how the results should be sorted. To change the sort order from ascending to descending, use the reverse parameter described above.

Note: If this parameter is not specified, the sort order defaults to descending order based on the last modification date.

Values:

  • creation — Sort by the date on which the content was added.
  • title — Sort alphabetically by title.
  • modified — Sort by the date on which the content was last updated.

スペース

@self、すなわちマクロが書かれたページを含むスペース

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.

You can specify one or more space keys, separated by a comma or a space.

  • 特定のスペースのコンテンツを除外するには、スペース キーのすぐ前にマイナス記号 (-) を追加します。例: スペース キーを -BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。
  • To indicate that the results must come from least one of the specified spaces, simply list the space keys separated by commas. For example: If you specify the space keys of YOURSPACE,GOODSPACE you will get content from both YOURSPACE and GOODSPACE.
  • 特定のスペースのコンテンツのみを指定するには、スペース キーのすぐ前にプラス記号 (+) を追加します。例: スペース キーを +GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。


特別な値:
  • @self — 現在のスペース。
  • @personal — All personal spaces.
  • @global — All global spaces.
  • @favorite — The spaces you have marked as favourite.
  • @favourite — 上記の @favorite と同様。
  • @all — Confluence サイトのすべてのスペース。
  • * — 上記の @all と同様。

(info) When specifying a personal space, remember to use the tilde (~) sign in front of the username, such as ~jbloggs or ~jbloggs@example.com.

スペース

The space which contains the page on which the macro is coded

Exactly the same as space above.

type

すべて

This parameter allows you to filter content 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.

  • To exclude content of a given content type, put a minus sign (-) immediately in front of that content type. For example: If you specify a content type of -comment you will get pages, news items and all other content except comments.
  • To indicate that the results must be of a given content type, put a plus sign (+) immediately in front of that content type. For example: If you specify a label value of +comment you will get only comments. You will get the same results if you specify a single value of comment. (Note that this is not particularly useful, because each content item belongs to one content type only. If you put a plus sign next to one content type and list other content types too, the other content types will be ignored.)
  • To indicate that the results must match at least one of the specified content types, simply list the content types separated by commas. For example: If you specify a content type of comment,page you will get comments and pages.


利用可能な値:
  • pagePages.
  • blogpostNews items, also known as blog posts.
  • news — 上記の blogpost と同様。
  • commentComments on pages and news items.
  • mailEmail messages.
  • attachmentAttachments.

types

すべてのタイプ

Exactly the same as type above.

width

100%

マウロの表示幅を、ウィンドウ幅に対するパーセント値で指定します。

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.
(info) 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 Confluence User Guide

  • ラベルなし