投稿者マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

投稿者マクロをページに追加すると、このページや別のページ、一連のページに投稿した Confluence ユーザーの一覧が表示されます。投稿者には、以下を実行したユーザーが含まれます。

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

このマクロは以下の場合に適しています。

  • ドキュメント管理とコンプライアンス
  • ページについて問い合わせたユーザーの一覧の提供

On this page:

スクリーンショット: プリンターの使い方のページへの投稿者を表示するページ。 

この例では、Display Format パラメータを list に設定しています。

このマクロをページに追加する

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

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] カテゴリから [投稿者] を選択します。
  3. 表示したい投稿者の種類を入力し、任意のパラメーターを設定します。
  4. [挿入] をクリックします。 

その後、ページを公開するとマクロの動作を確認できます。 

スクリーンショット: 投稿者マクロのパラメーターの設定

マクロ パラメーターを変更する

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

このマクロで使用できるパラメーターの一覧は、次のとおりです。 

パラメーター

既定

説明

投稿タイプ
(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 サイト内のすべてのスペース
    @all" />
    カンマ区切りで複数のスペース キーや特別な値を指定できます。

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

コンテンツ タイプ
(contentType

pages と blog posts の両方

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

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

ブログ投稿日
(publishDate

なし

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

ページ階層を含む
(scope

指定されたページのみ

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

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

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

false

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

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

既定のメッセージ

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

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}
最終更新日: 2023 年 10 月 13 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.