投稿者マクロを挿入する

投稿者マクロはページに何らかの投稿を行ったことがある Confluence ユーザーを一覧として表示します。ページのウォッチャーを一覧表示する際にも使用できます。

マクロの適用範囲は、指定したページの子や子孫ページまで拡張可能です。投稿者の一覧は次の作業を行ったユーザーから作成されます。

  • ページの作成または編集

  • ページへのコメントまたはラベルの追加

  • ページのウォッチ

投稿者マクロを使用する

投稿者マクロを追加するには:

  1. 編集時には、ツールバーから を選択します。

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

投稿者マクロを編集するには:

  1. マクロのプレースホルダーを選択します。

  2. [編集] アイコン を選択して、設定パネルを開きます。

  3. パラメーターを設定します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します (example)。

パラメーター

既定

説明

投稿タイプ
(include

authors

ページ (およびオプションでその子孫ページ) で行われた投稿のタイプ、またはページのウォッチによる絞り込み。投稿者タイプは次のものになります。

  • authors - ページを作成または編集したユーザーを含む

  • comments - ページにコメントしたユーザーを含む

  • labels - ページにラベルを追加したユーザーを含む

  • watches - ページをウォッチしてるユーザーを含む。

    コンマ区切りで複数の投稿タイプを指定できます。

並べ替え順序
(order

count

投稿者の並べ替えに使用される基準を指定します。並べ替え基準には次のものがあります。

  • count - ページへの投稿数でユーザーを並べ替え

  • name - ユーザーをアルファベット順に並べ替え

  • update - ページへの最終投稿日でユーザーを並べ替え

逆順ソート
(reverse

false

一覧での投稿者の並べ替え順序を逆にします。Sort By パラメータと併用する必要があります。

最大投稿者数

(limit)

制限なし

投稿者一覧での人数を制限します。数字を指定しない場合、すべての投稿者が表示されます。

表示形式
(mode

inline

投稿者一覧での名前の表示形式を設定します。

  • inline — カンマ区切りの一覧

  • list — 箇条書きの一覧

匿名投稿者の表示
(showAnonymous

false

ページに匿名で投稿した人を含めるかどうかを設定します。

件数の表示
(showCount

false

指定した投稿タイプでの投稿回数を投稿者ごとに表示するかどうかを設定します。

最新投稿日時の表示
(showLastTime

false

指定した投稿タイプでの投稿の最新日時を投稿者ごとに表示するかどうかを設定します。

ページ名
(page

current

投稿者リストを作成する際に使用するページを指定します。ページ名スペースが空白の場合、現在のページと見なされます。

ラベル
(labels

なし

投稿者の一覧を、ページで指定したラベルを作成したユーザーで絞り込みます。カンマ区切りで複数のラベルを指定できます。

スペース
(spaces

current

ページ名に設定されたページを含む Confluence スペースのスペース キーを指定するか、検索するスペースを指定します。スペース キーでは大文字と小文字が区別されます。

また、このパラメーターは次のような特殊な値を使用します。

  • @global — すべてのサイト スペース。

  • @personal — すべてのパーソナル スペース。

  • @all — Confluence サイトのすべてのスペース。

    コンマ区切りで複数のスペース キーや特別な値を指定できます。

    ページ名ラベルを指定しない場合は、指定した一連のスペースにあるすべてのページが含まれます。

コンテンツ タイプ
(contentType

pages と blog posts の両方

投稿者一覧を作成する際に使用するコンテンツ タイプを制限します。

  • pages — ページ

  • blogposts — ブログ投稿

ブログ投稿日
(publishDate

なし

ブログ投稿の公開日を指定します。日付は YYYY/MM/DD 形式で入力します。

ページ階層を含む
(scope

指定されたページのみ

投稿者一覧を生成する際に追加で含めるページを指定します。

  • children — 指定したページの子ページのみ

  • descendants — 指定したページのすべての子孫ページ

選択したページの表示
(showPages

false

投稿者一覧の生成に使用したページの一覧を表示するかどうかを設定します。

カスタム "None Found" メッセージ
(noneFoundMessage

既定のメッセージ

投稿者が見つからなかった際に表示する既定のメッセージを上書きする内容を指定します。

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

マクロ名: contributors

マクロ本文: なし。

この例では、ブログ投稿のコンテンツ タイプを指定しています。

1 2 3 4 {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}

この例では、ページ コンテンツ タイプを指定しています。

1 2 3 4 {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}

 

その他のヘルプ