投稿者マクロ
投稿者マクロはページに何らかの投稿を行ったことがある Confluence ユーザーを一覧として表示します。ページのウォッチャーを一覧表示する際にも使用できます。
マクロの適用範囲は、指定したページの子や子孫ページまで拡張可能です。投稿者の一覧は次の作業を行ったユーザーから作成されます。
- ページの作成または編集
- ページへのコメントまたはラベルの追加
- ページのウォッチ
スクリーンショット: 投稿者の一覧の例
この例では、Display Format パラメータを list に設定しています。
投稿者マクロを使用する
投稿者マクロを追加するには、次の手順に従います。
- Confluence エディタで、
> [詳細を表示] の順に選択します - 挿入するアイテムを探して選択します
- [挿入] を選択します。
このページに「/」と入力してツールバーからを選択し、同じリストを表示することも可能です。
投稿者マクロを編集するには、次の手順に従います。
- マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
- [編集] を選択します。右側のパネルが開きます。
- パラメーターを修正します。変更内容は、移動するごとに保存されます。
- ページの編集を再開すると、パネルが閉じます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメーター名がブラウザで使用されるラベルと異なる場合は、以下に括弧付きで一覧表示されます (example)。
パラメーター | 既定 | 説明 |
|---|---|---|
投稿タイプ | authors | ページ (およびオプションでその子孫ページ) で行われた投稿のタイプ、またはページのウォッチによる絞り込み。投稿者タイプは次のものになります。
|
並び替え順序 | count | 投稿者の並べ替えに使用される基準を指定します。並べ替え基準には次のものがあります。
|
逆順ソート | false | 一覧での投稿者の並べ替え順序を逆にします。Sort By パラメータと併用する必要があります。 |
最大投稿者数
| 制限なし | 投稿者一覧での人数を制限します。数字を指定しない場合、すべての投稿者が表示されます。 |
表示形式 | inline | 投稿者一覧での名前の表示形式を設定します。
|
匿名投稿者の表示 | false | ページに匿名で投稿した人を含めるかどうかを設定します。 |
件数の表示 | false | 指定した投稿タイプでの投稿回数を投稿者ごとに表示するかどうかを設定します。 |
最新投稿日時の表示 | false | 指定した投稿タイプでの投稿の最新日時を投稿者ごとに表示するかどうかを設定します。 |
ページ名 | current | 投稿者リストを作成する際に使用するページを指定します。ページ名とスペースが空白の場合、現在のページと見なされます。 |
ラベル | なし | 投稿者の一覧を、ページで指定したラベルを作成したユーザーで絞り込みます。カンマ区切りで複数のラベルを指定できます。 |
スペース | current | ページ名に設定されたページを含む Confluence スペースのスペース キーを指定するか、検索対象のスペースを指定します。スペース キーでは大文字 / 小文字が区別されます。 |
コンテンツ タイプ | pages と blog posts の両方 | 投稿者一覧を作成する際に使用するコンテンツ タイプを制限します。
|
ブログ投稿日 | なし | ブログ投稿の公開日を指定します。日付は YYYY/MM/DD 形式で入力します。 |
ページ階層を含む | 指定されたページのみ | 投稿者一覧を生成する際に追加で含めるページを指定します。
|
選択したページの表示 | false | 投稿者一覧の生成に使用したページの一覧を表示するかどうかを設定します。 |
カスタム "None Found" メッセージ | 既定のメッセージ | 投稿者が見つからなかった際に表示する既定のメッセージを上書きする内容を指定します。 |
Wiki マークアップの例
Wiki マークアップは従来のエディタでのみサポートされます。
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。
マクロ名: contributors
マクロ本文: なし。
この例では、ブログ投稿のコンテンツ タイプを指定しています。
{contributors:limit=10|spaces=ds,@personal|reverse=true|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=blogposts|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|showLastTime=true|publishDate=2012/06/30}この例では、ページ コンテンツ タイプを指定しています。
{contributors:limit=10|spaces=ds,@personal|reverse=true|scope=descendants|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=pages|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|page=ds:Advanced Topics|showLastTime=true}