====== YouTrack Plugin ======

---- plugin ----
description: List YouTrack issues filtered by YouTrack Query Language
author     : Zopa 
email      : dev@zopa.com
type       : syntax, helper
lastupdate : 2015-02-24
compatible : Hrun
depends    : 
conflicts  : 
similar    : 
tags       : youtrack, issue, bugtracker, listing

downloadurl: https://github.com/dokuwiki-translate/dokuwiki-plugin-youtrack/zipball/master
bugtracker : 
sourcerepo : https://github.com/dokuwiki-translate/dokuwiki-plugin-youtrack
donationurl: 

screenshot_img : 
----

List [[https://www.jetbrains.com/youtrack/|YouTrack]] issues filtered by [[https://confluence.jetbrains.com/display/YTD6/Search+and+Command+Attributes|YouTrack Query Language]].

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

Please make sure you have [[http://php.net/manual/en/book.curl.php|cURL]] installed and enabled.

===== Syntax =====

Syntax:

  {{youtrack-list> QUERY | LIST_OF_FIELDS }}

Whereas ''QUERY'' is any query in the YouTrack Query Language, i.e. anything which appears in YouTracks search box. And ''LIST_OF_FIELDS'' is a comma-separated list of fields you'd like to display in the resulting table, i.e. all columns. Those fields need to have the same name as in YouTrack (although you can give aliases to custom fields to manipulate the names through that).

A special exception to that is the **''ID''** field. That will always result in the ID of the issue linked to its issue page.

Example:

  {{youtrack-list> #bug created: {This week} sort by: created | ID, summary, created }}

==== Caching ====

If you'd like the table to always be up-to-date, you need to add the ''%%~~NOCACHE~~%%'' macro. This makes less sense with lists that don't change very often.

===== Configuration and Settings =====

  * **''url''**: Base URL of the YouTrack installation
  * **''user''**: Login user (only needed if a login is necessary)
  * **''password''**: Login password (only needed if a login is necessary)
  * **''date_format''**: [[http://php.net/manual/en/function.date.php|Date format]] used in the table output

===== Credits =====

The helper component is based on the [[plugin:youtracklinks]] plugin by Dominic Pöllath.

===== Development =====

==== Change Log ====



==== Known Bugs and Issues ====

  * The maximum number of issues in the output table is currently limited to 100.

===== Discussion =====

I installed this plugin, but dont use it. But getting weird erros from the plugin //YouTrack issues not found// ... WTF? Why?