ユーザー リスト マクロ
ユーザー リスト マクロは、グループのメンバーシップに基づいて Confluence ユーザーの一覧を表示します。マクロは、ユーザーがオンラインかオフラインかも示します。
多数のユーザーがいるサイトでは、ユーザー一覧マクロが大量のメモリを消費する場合があります。サイトでメモリ不足エラーが発生するのを防ぐため、指定したグループに 10,000 以上のユーザーがいる場合、このマクロは表示されません。管理者は confluence.extra.userlister.limit
システム プロパティの設定により、この制限を変更できます。
ユーザー リスト マクロの使用
ユーザー リスト マクロをページに追加するには:
- エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
パラメーター | 既定 | 説明 |
---|---|---|
グループ | なし | グループ名を指定します。複数のグループをコンマで区切って指定するか、*を使用して Confluence のすべてのユーザーを表示します。 他のユーザーの詳細を見ることができるユーザーを制御する方法の詳細については、このナレッジベース ページを参照してください。 |
オンライン / オフラインのユーザーを表示 | 登録されている全ユーザー | オンラインまたはオフライン ユーザーをリストします。ステータスに関係なく、すべてのユーザーを表示するには、空白のままにします。 許可される値:
オンライン/オフラインのユーザーを表示するようこのマクロを設定する方法の詳細については、以下を参照してください。 |
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: userlister
マクロ本文: なし。
{userlister:groups=confluence-users|online=false}
ユーザー リスト マクロの設定
Display Online / Offline Users パラメーターを使用して、ユーザーが現在 Confluence にログイン中かどうかを示すには、システム アプリで、このマクロを提供する User Log In Listener コンポーネントを有効化する必要があります。これを実行するには、Confluence 管理者権限が必要です。
ユーザー リスト マクロで [オンライン/オフラインのユーザーを表示] フィルターを有効化するには:
> [アプリの管理] に移動します。
- ドロップダウンから [システム] を選択し、[User Lister] を検索します。
- 一覧を展開し、User Log In Listener モジュールを有効化します。
- 変更内容を反映するには、 Confluence を再起動します。