最近の更新マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

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

最近の更新マクロの使用

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

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

オートコンプリートでマクロエントリを高速化: タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

パラメーター

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

パラメーター

既定

説明

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

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

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

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

スペース
(spaces

@self

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

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

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

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

特別な値:

  • @self — 現在のスペース。
  • @personal — すべてのパーソナル スペース。
  • @global — すべてのサイト スペース。
  • @favorite — The spaces you have marked as favourite.
  • @favourite — 上記の @favorite と同様。
  • @all — Confluence サイトのすべてのスペース。
  • * — 上記の @all と同様。

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

ラベル
(labels

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

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

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

  • 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'.
  • 特定のラベル値を持つ結果のみを指定するには、ラベル値のすぐ前にプラス記号 (+) を追加します。例: ラベル値を +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 ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。 

マクロ名: recently-updated

マクロ本文: なし。

保存形式の例

<ac:structured-macro ac:name="recently-updated">
  <ac:parameter ac:name="spaces">
    <ri:space ri:space-key="ss"/>
  </ac:parameter>
  <ac:parameter ac:name="author">
    <ri:user ri:userkey="12345678912345678912345"/>
  </ac:parameter>
  <ac:parameter ac:name="users"/>
  <ac:parameter ac:name="max">10</ac:parameter>
  <ac:parameter ac:name="width">50%</ac:parameter>
  <ac:parameter ac:name="theme">sidebar</ac:parameter>
  <ac:parameter ac:name="labels">choc</ac:parameter>
  <ac:parameter ac:name="types">page</ac:parameter>
</ac:structured-macro>

Wiki マークアップ例

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

 

 

最終更新日: 2015 年 12 月 2 日

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

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