投稿者マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

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

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

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

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

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

投稿者マクロを使用する

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

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

オートコンプリートを活用して素早く入力: {」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。

パラメータ

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (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 サイト内のすべてのスペース
    @all" />
    カンマ区切りで複数のスペース キーや特別な値を指定できます。

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

コンテンツ タイプ
(contentType

pages と blog posts の両方

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

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

ブログ投稿日
(publishDate

なし

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

ページ階層を含む
(scope

指定されたページのみ

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

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

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

false

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

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

既定のメッセージ

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

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}
最終更新日 2018 年 8 月 13 日

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

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