投稿者マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

robotsnoindex
robotsnoindex

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

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

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

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

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

投稿者マクロを使用する

投稿者マクロを追加するには、次の手順に従います。

  1. Confluence エディタで、 > [詳細を表示] の順に選択します
  2. 挿入するアイテムを探して選択します
  3. [挿入] を選択します。

このページに「/」と入力してツールバーからを選択し、同じリストを表示することも可能です。

投稿者マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
  2. [編集] を選択します。右側のパネルが開きます。
  3. パラメーターを修正します。変更内容は、移動するごとに保存されます。
  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。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 サイトのすべてのスペース。

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

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

コンテンツ タイプ
(contentType

pages と blog posts の両方

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

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

ブログ投稿日
(publishDate

なし

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

ページ階層を含む
(scope

指定されたページのみ

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

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

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

false

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

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

既定のメッセージ

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

Wiki マークアップの例

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


robotsnoindex
robotsnoindex
robotsnoindex

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 年 6 月 19 日

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

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