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

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

  • ページの作成または編集
  • ページへのコメントまたはラベルの追加
  • ページのウォッチ

スクリーンショット: 投稿者の一覧の例

In this example, the Display Format parameter has been set to list.

投稿者マクロを使用する

ページに投稿者マクロを追加する方法

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

To edit an existing macro: Click the macro placeholder and choose Edit. This will display the parameters of the macro in the Macro Browser.

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。

パラメーター

既定

説明

Contribution Type

authors

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

  • authors - ページを作成または編集したユーザーを含む
  • comments - ページにコメントしたユーザーを含む
  • labels - ページにラベルを追加したユーザーを含む
  • watches - ページをウォッチしてるユーザーを含む。

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

Sort By

count

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

  • count - ページへの投稿数でユーザーを並べ替え
  • name - ユーザーをアルファベット順に並べ替え
  • update - ページへの最終投稿日でユーザーを並べ替え

Reverse Sort

false

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

最大投稿者数

制限なし

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

Display Format

inline

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

  • inline — カンマ区切りの一覧
  • list — 箇条書きの一覧

Show Anonymous Contributions?

false

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

Show Count?

false

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

Show Last Contribution Time?

false

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

ページ名

current

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

ラベル

なし

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

スペース

current

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

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

  • @global — All global spaces.
  • @personal — All personal spaces.
  • @all — Confluence サイト内のすべてのスペース
    @all" />
    カンマ区切りで複数のスペース キーや特別な値を指定できます。

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

Content Type

pages と blog posts の両方

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

  • pages — ページ
  • blogposts — ブログ投稿

Blog Post Date

なし

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

Include Page Hierarchy

指定されたページのみ

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

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

Show Selected Pages

false

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

Custom "None Found" Message

既定のメッセージ

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

  • ラベルなし