r-labs » Wiki Lists

h1. Redmine Plugin: Wiki Lists {{count}}

{{>toc}}

日本語は [[Wiki Lists|こちら]].

This plugin adds wiki macros that display ticket lists.

h2. Links

redmine.org: http://www.redmine.org/plugins/redmine_wiki_lists

repository: https://bitbucket.org/tkusukawa/redmine_wiki_lists

downloads:  https://bitbucket.org/tkusukawa/redmine_wiki_lists/downloads

h2. Installation

# Download zip file from "bitbucket":https://bitbucket.org/tkusukawa/redmine_wiki_lists/downloads

# Unzip

# Move the unziped folder into the $REDMINE/plugins/

# Restart REDMINE

h1. Usage

h2. ref_issues

ref_issues macro displays list of issues.

h3. Syntax

{{@ref_issues([option].., [column]..)@}}

*options:* 

superseded {{collapse

|* -s[=WORD[｜WORD]..]

  select issues that contain WORDs in subject. 

* -d[=WORD[｜WORD]..]

  select issues that contain WORDs in description. 

* -w[=WORD[｜WORD]..]

  select issues that contain WORDs in subject or description.

* -p[=IDENTIFIRE]

  Specify the project by identifire.|

}}

* -i=CUSTOM_QUERY_ID

  Use custom query by id.

* -q=CUSTOM_QUERY_NAME

  Use custom query by query name.

* -f:ATTRIBUTE OPERATOR [VALUE[|VALUE...]]

  filter. Attributes are shown below.

  [ATTRIBUTE]

<pre>

tracker_id,project_id,subject,description, 

due_date,category_id,status_id,assigned_to_id,priority_id, 

fixed_version_id,author_id,lock_version,created_on,updated_on, 

start_date,done_ratio,estimated_hours,parent_id,root_id, 

lft,rgt,is_private,closed_on, cf_*

</pre>

  [OPERATOR]

<pre>

=:is, !:is not, o:open, c:closed, !*:none,

*:any, >=:>=, <=:<=, ><:between, >t+:in more than, 

>w:this week, lw:last week, l2w:last 2 weeks, m:this month, lm:last month,

y:this year, >t-:less than days ago, ~:contains, !~:doesn't contain, 

=p:any issues in project, =!p:any issues not in project, !p:no issues in project, 

</pre>

You can specify two or more select option, it affect AND condition.

If you use this macro in a Issue, you can use the field value of the issue as VALUE by writing to the following field(column) name in the [] (brackets).

* -l[=column]

  Put linked text.

* -t[=column]

  Put markup text.

* -c

  number of issues.

*columns:* 

You can choose columns that you want to display.

If you do not specify the columns, same columns with customquery are displayed.

* project

* tracker

* parent

* status

* priority

* subject

* author

* assigned_to

* updated_on

* category

* fixed_version

* start_date

* due_date

* estimated_hours

* done_ratio

* created_on

* closed_on

* relations

h3. example

|\2. *1. use custom query by ID*|

|notation|{{@ref_issues(-i=9)@}}|

|results|{{ref_issues(-i=9)}}|

|\2. *2. use custom query by name*|

|notation|{{@ref_issues(-q=MyCustomQuery1)@}}|

|results|{{ref_issues(-q=MyCustomQuery1)}}|

|\2. *3. list up issues that contain 'sorting' in subject*|

|notation|{{@ref_issues(-f:subject ~ sorting)@}}|

|results|{{ref_issues(-f:subject ~ sorting)}}|

|\2. *4. list up issues that contain 'sorting' in subject. and specify display column(subject,author,assigned_to,status)*|

|notation|{{@ref_issues(-f:subject ~ sorting, subject, author, assigned_to, status)@}}|

|results|{{ref_issues(-f:subject ~ sorting, subject, author, assigned_to, status)}}|

|\2. *5. list up tickets that contain 'sorting' in subject, and restrict by project=Wiki Lists*|

|notation|{{@ref_issues(-f:subject ~ sorting, -f:project = Wiki Lists)@}}|

|results|{{ref_issues(-f:subject ~ sorting, -f:project = Wiki Lists)}}|

|\2. *6. pickup issues that have subject=Sample, and put linked ID*|

|notation|{{@ref_issues(-f:subject = Sample, -l=id)@}}|

|results|{{ref_issues(-f:subject = Sample, -l=id)}}|

|\2. *7. pickup issues that have subject=Sample, and put markuped description*|

|notation|{{@ref_issues(-f:subject = Sample, -t=description)@}}|

|results|{{ref_issues(-f:subject = Sample, -t=description)}}|

|\2. *8. put number of issues that contain 'sorting' in subject*|

|notation|{{@ref_issues(-f:subject ~ sorting, -c)@}}|

|results|{{ref_issues(-f:subject ~ sorting, -c)}}|

h2. history

→ "Roadmap":/projects/wiki_lists/roadmap?completed=1