DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== 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, issues, bugtracker, listing

downloadurl: https://github.com/zopaUK/dokuwiki-plugin-youtrack/zipball/master
bugtracker : https://github.com/zopaUK/dokuwiki-plugin-youtrack/issues
sourcerepo : https://github.com/zopaUK/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 =====

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. 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:

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 ====

{{rss>https://github.com/zopaUK/dokuwiki-plugin-youtrack/commits/master.atom date}}

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

* The maximum number of issues in the output table is currently limited to 100.
  * i installed this plugin, but dont use it. but getting weird erros from the plugin //YouTrack issues not found// ... wtf? why?

===== Discussion =====

Please fill all the letters into the box to prove you're human. U᠎ R R Q Y Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International