The Contributors Summary macro displays a table of contribution-based statistics for a set of pages. These statistics can be grouped according to individual pages or individual contributors.

The default scope of this macro covers an individual page, but this can be extended to include the immediate children or descendants of a specified page. The statistics cover the following types of contributions:

  • ページの編集を行う
  • ページにコメントを追加する
  • ページにラベルを追加する
  • ページをウォッチしている人

A simple example of the Contributors macro is shown in the block below, which lists statistics on the number of times each contributor has edited, added comments and added labels to this page.

スクリーンショット：投稿者マクロ統計表の例

In this example, all default parameter settings are used. For more information about this macro's parameters, refer to the Parameters section below.

On this page:

Usage with the Macro Browser

To insert the contributors summary macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

Once you've found the contributors summary macro, click 'insert' to add it to your page.

Usage with the Wiki Markup Editor

{contributors-summary:groupby=TYPE}

Where TYPE refers to the criterion used for grouping statistics associated with the current page (and optionally its descendants). This criteria can be either contributor- or page-based.

パラメーター

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

パラメーター

Required in Wiki Markup?

既定

説明

Group By
(groupby)

いいえ

contributors

Specify if the table should group contribution-based statistics by contributor or page.

Columns to Display
(columns)

いいえ

edits, comments and labels

The columns that should appear in the table. The statistics or type of information presented is based on the Group By parameter (above). The allowable types of contributions include:

  • edits — number of times the contributor has edited the page(s) or number of edits made to the page.
  • edited — list of pages edited by the contributor or list of contributors who have edited the page.
  • comments — number of times the contributor has added comments to the page(s) or number of comments on the page.
  • commented — list of pages to which the contributor has added comments or list of contributors who have commented on the page.
  • labels — number of times the contributor has added labels to the page(s) or number of labels on the page.
  • labeled — list of pages to which the contributor has added labels or list of contributors who have added a label to the page.
  • labellist — list of labels either added by the contributor or on the page.
  • watches — number of pages being watched by the contributor/person or number of contributors/people watching the page.
  • watching — list of pages being watched by the contributor/person or list of contributors/people watching the page.
  • lastupdate — the last time a contributor made an update or the page was last updated. Valid updates can include edit, comment or label modifications to a page.

    One or more columns can be used.

Sort By
(order)

いいえ

count

The criteria used for sorting items in the table. The items sorted are based on the Group By parameter (above). The allowable sort criteria include:

  • edits — sorts items in the table based on the total number of edits made either by a contributor or to a page.
  • name — 投稿者名またはページ名のアルファベット順に応じて表内の項目を並べ替え
  • editTime — 投稿者のページ (または指定した複数のページ) での最終更新日時、またはペーのが最終更新日時に応じて表内の項目を並べ替え
  • update — sorts items in the table based on when the contributor last made any contribution to a page (or a specified set of pages) or when the page last had a contribution made to it.

Reverse Sort
(reverse)

いいえ

false

Reverses the order of items in the table, sorted by the chosen Sort By criterion. (Used only in conjunction with the Sort By parameter.)

Maximum Number of Contributors
(limit)

いいえ

制限なし

Restricts the number of items in the table to the value specified. If no number is specified, no restriction is applied.

Show Anonymous Contributions?
(showAnonymous)

いいえ

false

Includes individuals who have made anonymous contributions to a page, in the tabulated statistics.

Page Name
(page)

いいえ

current

The page from which to calculate the contribution-based statistics. If no Page Name and Space(s) are specified, the current page is assumed.

Label(s)
(labels)

いいえ

なし

Restrict the contribution-based statistics to these labels only. Separate each label with a comma.

Space(s)
(spaces)

いいえ

current

Specify the space key of the Confluence space which contains the specified page name or alternatively, specify a scope of spaces to search. Space keys are case-sensitive.

This parameter also takes special values, including:

  • @global — All global spaces.
  • @personal — All personal spaces.
  • @all — All spaces in your Confluence site.

    You can specify one or more space keys or special values, each of which must be separated by a comma.

    If no Page Name and Label(s) are specified, all pages from the specified set of spaces are included.

Content Type
(contentType)

いいえ

pages と blog posts の両方

Used to restrict page types to either pages (pages) or blog posts (blogposts). If no value is specified in the Macro Browser, both pages and blog posts are included.

Blog Post Date
(publishDate)

いいえ

なし

Specify the publish date for a blog post. The date format required is: YYYY/MM/DD.

Include Page Hierarchy
(scope)

いいえ

指定されたページのみ

指定したページの直近の子ページまたはすべての子孫ページのどちらを含むか指定します。マクロブラウザに値が指定されていない場合、指定したページのみが含まれます。


関連トピック

Contributors Macro
Working with Macros

Take me back to the Confluence User's Guide.

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.