投稿者マクロ
スクリーンショット: プリンターの使い方のページへの投稿者を表示するページ。
この例では、Display Format パラメータを list に設定しています。
このマクロをページに追加する
ページに投稿者マクロを追加する方法
- エディタのツールバーで、[挿入]
> [その他のマクロ] を選択します。 - [Confluence コンテンツ] カテゴリから [投稿者] を選択します。
- 表示したい投稿者の種類を入力し、任意のパラメーターを設定します。
- [挿入] をクリックします。
その後、ページを公開するとマクロの動作を確認できます。
スクリーンショット: 投稿者マクロのパラメーターの設定
マクロ パラメーターを変更する
マクロ パラメーターは、マクロの動作を変えるために使用します。
マクロ パラメーターを変更するには、次の手順を実行します。
- エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
- 必要に応じてパラメーターを更新し、[挿入] を選択します。
このマクロで使用できるパラメーターの一覧は、次のとおりです。
パラメーター | 既定 | 説明 |
|---|---|---|
投稿タイプ | authors | ページ (およびオプションでその子孫ページ) で行われた投稿のタイプ、またはページのウォッチによる絞り込み。投稿者タイプは次のものになります。
|
並び替え順序 | count | 投稿者の並べ替えに使用される基準を指定します。並べ替え基準には次のものがあります。
|
逆順ソート | false | 一覧での投稿者の並べ替え順序を逆にします。Sort By パラメータと併用する必要があります。 |
最大投稿者数
| 制限なし | 投稿者一覧での人数を制限します。数字を指定しない場合、すべての投稿者が表示されます。 |
表示形式 | inline | 投稿者一覧での名前の表示形式を設定します。
|
匿名投稿者の表示 | false | ページに匿名で投稿した人を含めるかどうかを設定します。 |
件数の表示 | false | 指定した投稿タイプでの投稿回数を投稿者ごとに表示するかどうかを設定します。 |
最新投稿日時の表示 | false | 指定した投稿タイプでの投稿の最新日時を投稿者ごとに表示するかどうかを設定します。 |
ページ名 | current | 投稿者リストを作成する際に使用するページを指定します。ページ名とスペースが空白の場合、現在のページと見なされます。 |
ラベル | なし | 投稿者の一覧を、ページで指定したラベルを作成したユーザーで絞り込みます。カンマ区切りで複数のラベルを指定できます。 |
スペース | current | ページ名に設定されたページを含む Confluence スペースのスペース キーを指定するか、検索対象のスペースを指定します。スペース キーでは大文字 / 小文字が区別されます。 |
コンテンツ タイプ | pages と blog posts の両方 | 投稿者一覧を作成する際に使用するコンテンツ タイプを制限します。
|
ブログ投稿日 | なし | ブログ投稿の公開日を指定します。日付は YYYY/MM/DD 形式で入力します。 |
ページ階層を含む | 指定されたページのみ | 投稿者一覧を生成する際に追加で含めるページを指定します。
|
選択したページの表示 | false | 投稿者一覧の生成に使用したページの一覧を表示するかどうかを設定します。 |
カスタム "None Found" メッセージ | 既定のメッセージ | 投稿者が見つからなかった際に表示する既定のメッセージを上書きする内容を指定します。 |
Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。
このマクロを追加するその他の方法
手入力でこのマクロを追加する
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}