最近の更新マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

最近の更新マクロをページに追加すると、最近作成または編集されたページ、ブログ、ファイル、およびコメントの一覧が表示されます。 

これは以下の場合に適しています。

  • プロジェクトのランディング ページや情報ページ
  • チーム スペースのホーム ページ

これは非常に柔軟性が高く、特定のユーザー、スペース、コンテンツ タイプなどに制限した一覧を作成できます。 

On this page:

スクリーンショット: 最近作成されたページや更新されたページを表示する、プロジェクトのランディング ページ。

このマクロをページに追加する

最近の更新マクロをページに追加する方法:

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] カテゴリから [最近の更新] を選択します。
  3. 任意のパラメーターを入力します。
  4. [挿入] をクリックします。 

その後、ページを公開するとマクロの動作を確認できます。 

スクリーンショット: 特定のスペースの特定のユーザーによる更新を表示するための、最近の更新マクロの設定。

マクロ パラメーターを変更する

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

このマクロで使用できるパラメーターの一覧は、次のとおりです。 

パラメーター

既定

説明

ユーザー名ごとの作者
(author

指定なし。つまり、すべてのコンテンツを表示します。

結果を作成者で絞り込みます。ここで指定した作者 (複数可) が最後に変更したページ等のみがマクロで表示されます。

複数のユーザーを指定できます。

スペース
(spaces

@self

マクロが使用されているページを含むスペース

このパラメータを使用すれば、スペースでコンテンツを絞り込むことができます。ここで指定したスペース (複数可) に属するページ等のみがマクロで表示されます。

カンマまたはスペースで区切ることで、1 つ以上のスペース キーを指定できます。

  • 特定のスペースのコンテンツを除外するには、スペース キーのすぐ前にマイナス記号 (-) を追加します。例: スペース キーを -BADSPACE と指定すると、BADSPACE に含まれないコンテンツのみを取得できます。
  • 特定のスペースのコンテンツのみを指定するには、スペース キーのすぐ前にプラス記号 (+) を追加します。例: スペース キーを +GOODSPACE と指定すると、GOODSPACE のコンテンツのみを取得できます (各コンテンツ項目は 1 つのスペースにのみ所属するため、このオプションが有効な麺は少ないことにご注意ください。1 つのスペース キーの前にプラス記号を設定してほかのスペース キーを一覧に追加した場合、追加したスペース キーは無視されます)。

特別な値:

  • @self — 現在のスペース。
  • @personal — すべてのパーソナル スペース。
  • @global — すべてのサイト スペース。
  • @favorite — ユーザーがお気に入りとして設定したすべてのスペース。
  • @favourite — 上記の @favorite と同様。
  • @all — Confluence サイトのすべてのスペース。
  • * — 上記の @all と同様。

個人用スペースを指定する場合、~jbloggs~jbloggs@example.com のように、ユーザー名の前にチルダ (~) 記号をつける必要があることにご注意ください。

ラベル
(labels

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

結果をラベルで絞り込みます。ここで指定したラベル (複数可) でタグ付けされているページ等のみがマクロで表示されます。

カンマまたはスペースで区切ることで、1 つ以上のラベル値を指定できます。

  • 特定のラベルに一致するコンテンツを除外するには、ラベルの値のすぐ前にマイナス記号 (-) を追加します。例: ラベル値を -badpage と指定すると、"badpage" のラベルを持たないコンテンツのみを取得できます。
  • 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を +superpage,+goodpage と指定すると、少なくとも "superpage" と "goodpage" の 2 つのラベルを持つコンテンツのみを取得できます。

ラベル パラメータは、page および blog コンテンツ タイプにのみ適用されます。

表の幅
(width

100%

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

これらのコンテンツ タイプのみを表示
(types

すべてのタイプ

このパラメータを使用すれば、コンテンツ タイプでコンテンツを絞り込むことができます。ここで指定したコンテンツ タイプのみがマクロで表示されます。

カンマまたはスペース区切りで複数のタイプを指定できます。

特定のコンテンツ タイプのコンテンツを除外するには、そのコンテンツ タイプのすぐ前にマイナス記号 (-) を追加します。例: コンテンツ タイプを -blogpost と指定すると、ページと、ブログ投稿を除くその他すべてのコンテンツを取得できます。

利用可能な値:

結果の最大数
(max

15

表示される結果の最大数を指定します。このパラメータが省略されている場合、最大 15 件の結果が表示されます。このパラメータが許可できる論理的な最大値は 2 の 31 乗 - 1 (または 2147483647) ですが、パフォーマンス上の理由により、コード上で 200 に制限されています。詳細はこちら

テーマ
(theme

concise

このマクロの外観を選択します。

  • concise — 更新またはコメントされたページ名、ページ通知をトリガーしたユーザー、変更日時を表示する既定のリスト。
  • social — 最近の変更を新しい順に一覧表示しますが、ユーザーごとに短期間のセグメントでグループ化します。各ユーザーの時間セグメントには "サブ" リストが表示され、更新またはコメントされたページの名前と、これらの変更が行われた日時を示します。
  • sidebar — 最近の更新を新しい順にリストし、更新またはコメントされたページの名前と、ページの変更日時を示します。このテーマでは作者を表示しません。

ユーザー プロファイルの画像を表示
(showProfilePic

false

コンテンツを更新したユーザーのプロファイル画像を表示するには showProfilePic=true を指定します。

タイトルを隠す
(hideHeading)

False

コンテンツ一覧でのタイトルとして、"Recently Updated" テキストをマクロで非表示にするか表示するかを決定します。wiki マークアップとストレージ形式でのみ利用できます。

許可される値:

  • true – タイトルは非表示になります。
  • false – タイトルは表示されます。

Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

このマクロを追加するその他の方法

手入力でこのマクロを追加する

{」と入力してからマクロ名の入力を開始すると、マクロの一覧が表示されます。

Wiki マークアップを使用してこのマクロを追加する

これは、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。

マクロ名: recently-updated

マクロ本文: なし。

{recently-updated:spaces=ds|author=admin|max=10|hideHeading=true|width=50%|theme=sidebar|showProfilePic=true|labels=choc|types=page}

Last modified on Mar 22, 2022

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.