ユーザーリストマクロ

ユーザーリストマクロは、グループのメンバーシップに基づいて Confluence ユーザーの一覧を表示します。マクロは、ユーザーがオンラインかオフラインかも示します。

多数のユーザーがいるサイトでは、ユーザー一覧マクロが大量のメモリを消費する場合があります。サイトでメモリ不足エラーが発生するのを防ぐため、指定したグループに 10,000 以上のユーザーがいる場合、このマクロは表示されません。管理者は confluence.extra.userlister.limit システムプロパティの設定により、この制限を変更できます。

ユーザーリストマクロの使用

ユーザーリストマクロをページに追加するには:

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

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

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

パラメーター

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

パラメーター

既定

説明

グループ
(groups)

なし

グループ名を指定します。複数のグループをコンマで区切って指定するか、*を使用して Confluence のすべてのユーザーを表示します。

他のユーザーの詳細を見ることができるユーザーを制御する方法の詳細については、このナレッジベースページを参照してください。

オンライン / オフラインのユーザーを表示
(online)

登録されている全ユーザー

オンラインまたはオフラインユーザーをリストします。ステータスに関係なく、すべてのユーザーを表示するには、空白のままにします。

許可される値:

指定なし – マクロはすべての登録ユーザーを表示します。
true –マクロはオンラインのユーザーのみを表示します。
false – マクロはオフラインのユーザーのみを表示します。

オンライン/オフラインのユーザーを表示するようこのマクロを設定する方法の詳細については、以下を参照してください。

Wiki マークアップの例

以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタムコンテンツなど) でマクロを追加する場合に便利です。

マクロ名: userlister

マクロ本文: なし。

{userlister:groups=confluence-users|online=false}