最近の更新マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

最近の更新マクロは Confluence 内で最近変更されたコンテンツの一覧を表示します。

最近の更新マクロの使用

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

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

オートコンプリートを活用して素早く入力: {」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。

パラメーター

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

パラメーター

既定

説明

ユーザー名ごとの作者
(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 – タイトルは表示されます。

注意

Wiki マークアップの例

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

マクロ名: recently-updated

マクロ本文: なし。

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

最終更新日: 2018 年 1 月 30 日

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

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