投稿者マクロ
投稿者マクロはページに何らかの投稿を行ったことがある Confluence ユーザーを一覧として表示します。ページのウォッチャーを一覧表示する際にも使用できます。
マクロの適用範囲は、指定したページの子や子孫ページまで拡張可能です。投稿者の一覧は次の作業を行ったユーザーから作成されます。
- ページの作成または編集
- ページへのコメントまたはラベルの追加
- ページのウォッチ
スクリーンショット: 投稿者の一覧の例
この例では、Display Format パラメータを list に設定しています。
投稿者マクロを使用する
ページに投稿者マクロを追加する方法
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化： タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
パラメーター
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).
パラメーター | 既定 | 説明 |
|---|---|---|
投稿タイプ | authors | ページ (およびオプションでその子孫ページ) で行われた投稿のタイプ、またはページのウォッチによる絞り込み。投稿者タイプは次のものになります。
|
並び替え順序 | count | 投稿者の並べ替えに使用される基準を指定します。並べ替え基準には次のものがあります。
|
逆順ソート | false | 一覧での投稿者の並べ替え順序を逆にします。Sort By パラメータと併用する必要があります。 |
最大投稿者数
| 制限なし | 投稿者一覧での人数を制限します。数字を指定しない場合、すべての投稿者が表示されます。 |
表示形式 | inline | 投稿者一覧での名前の表示形式を設定します。
|
匿名投稿者の表示 | false | ページに匿名で投稿した人を含めるかどうかを設定します。 |
件数の表示 | false | 指定した投稿タイプでの投稿回数を投稿者ごとに表示するかどうかを設定します。 |
最新投稿日時の表示 | false | 指定した投稿タイプでの投稿の最新日時を投稿者ごとに表示するかどうかを設定します。 |
ページ名 | current | 投稿者リストを作成する際に使用するページを指定します。ページ名とスペースが空白の場合、現在のページと見なされます。 |
ラベル | なし | 投稿者の一覧を、ページで指定したラベルを作成したユーザーで絞り込みます。カンマ区切りで複数のラベルを指定できます。 |
スペース | current | ページ名に設定されたページを含む Confluence スペースのスペース キーを指定するか、検索対象のスペースを指定します。スペース キーでは大文字 / 小文字が区別されます。 |
コンテンツ タイプ | pages と blog posts の両方 | 投稿者一覧を作成する際に使用するコンテンツ タイプを制限します。
|
ブログ投稿日 | なし | ブログ投稿の公開日を指定します。日付は YYYY/MM/DD 形式で入力します。 |
ページ階層を含む | 指定されたページのみ | 投稿者一覧を生成する際に追加で含めるページを指定します。
|
選択したページの表示 | false | 投稿者一覧の生成に使用したページの一覧を表示するかどうかを設定します。 |
カスタム "None Found" メッセージ | 既定のメッセージ | 投稿者が見つからなかった際に表示する既定のメッセージを上書きする内容を指定します。 |
コードの例
次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。
マクロ名: contributors
マクロ本文: なし。
保存形式の例
この例では、ブログ投稿のコンテンツ タイプを指定しています。
<ac:macro ac:name="contributors">
<ac:parameter ac:name="limit">10</ac:parameter>
<ac:parameter ac:name="spaces">ds,@personal</ac:parameter>
<ac:parameter ac:name="reverse">true</ac:parameter>
<ac:parameter ac:name="labels">chocolate,cake</ac:parameter>
<ac:parameter ac:name="showPages">true</ac:parameter>
<ac:parameter ac:name="noneFoundMessage">Oh dear, no contributors found</ac:parameter>
<ac:parameter ac:name="showCount">true</ac:parameter>
<ac:parameter ac:name="contentType">blogposts</ac:parameter>
<ac:parameter ac:name="include">authors,comments,labels,watches</ac:parameter>
<ac:parameter ac:name="mode">list</ac:parameter>
<ac:parameter ac:name="showAnonymous">true</ac:parameter>
<ac:parameter ac:name="order">update</ac:parameter>
<ac:parameter ac:name="showLastTime">true</ac:parameter>
<ac:parameter ac:name="publishDate">2012/06/30</ac:parameter>
</ac:macro>Wiki マークアップ例
この例では、ブログ投稿のコンテンツ タイプを指定しています。
{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}