最近の更新マクロ
最近の更新マクロは Confluence 内で最近変更されたコンテンツの一覧を表示します。
最近の更新マクロの使用
最近の更新マクロをページに追加する方法:
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化: タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
パラメーター | 既定 | 説明 |
---|---|---|
ユーザー名ごとの作者 | 指定なし。つまり、すべてのコンテンツを表示します。 | 結果を作成者で絞り込みます。ここで指定した作者 (複数可) が最後に変更したページ等のみがマクロで表示されます。 |
スペース |
マクロが使用されているページを含むスペース | このパラメータを使用すれば、スペースでコンテンツを絞り込むことができます。ここで指定したスペース (複数可) に属するページ等のみがマクロで表示されます。
特別な値:
個人用スペースを指定する場合、 |
ラベル | 指定なし (すべてのコンテンツを表示) | 結果をラベルで絞り込みます。ここで指定したラベル (複数可) でタグ付けされているページ等のみがマクロで表示されます。
ラベル パラメータは、 |
表の幅 | 100% | マウロの表示幅を、ウィンドウ幅に対するパーセント値で指定します。 |
これらのコンテンツ タイプのみを表示 | すべてのタイプ | このパラメータを使用すれば、コンテンツ タイプでコンテンツを絞り込むことができます。ここで指定したコンテンツ タイプのみがマクロで表示されます。
特定のコンテンツ タイプのコンテンツを除外するには、そのコンテンツ タイプのすぐ前にマイナス記号 (-) を追加します。例: コンテンツ タイプを 利用可能な値: |
結果の最大数 | 15 | 表示される結果の最大数を指定します。このパラメータが省略されている場合、最大 15 件の結果が表示されます。このパラメータが許可できる論理的な最大値は 2 の 31 乗 - 1 (または 2147483647) ですが、パフォーマンス上の理由により、コード上で 200 に制限されています。詳細はこちら。 |
テーマ |
| このマクロの外観を選択します。
|
ユーザー プロファイルの画像を表示 |
| コンテンツを更新したユーザーのプロファイル画像を表示するには |
タイトルを隠す | False | コンテンツ一覧でのタイトルとして、"Recently Updated" テキストをマクロで非表示にするか表示するかを決定します。wiki マークアップとストレージ形式でのみ利用できます。 許可される値:
|
注意
- 最近更新されたダッシュボード マクロはこのマクロと似ていますが、Confluence ダッシュボードでの表示を意図して作成されています。
最近の更新 マクロで表示される言葉を変更したい場合は、「Confluence インターフェイス テキストの変更」のドキュメントを参照してください。
コードの例
次の例は、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}