<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
{{redirects|Phabricator|Phab}}
{{redirects|Phabricator|Phab}}
This template is intended to be used on feedback pages and talk pages for software deployments. It floats right-aligned next to whichever content it precedes. Imagine we see a comment like the following:
|1label =Task number<!-- A (very) brief name for the parameter. -->
|1d-en =Phabricator task number, in the form T1234. Bugzilla bug numbers are automatically converted to Phabricator tasks.
|1aliases =<!-- List of aliases, separated by / (a slash) -->
|1type =line
|1def =<!-- default value for the parameter -->
|1stat =required
<div style="margin-left:4em;">
|2 =2
{| class="wikitable" width="500px"
|2label =Status
|-
|2d-en =Current status of the task on Phabricator. One of resolved/invalid/duplicate/declined/open
|
|2aliases =
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --[[Special:Mypage|Dogmaster3000]] 01:17, 14 December 2011 (PST)
|2type =line
|}
|2def =
</div>
|2stat =optional
|2sv = resolved/invalid/duplicate/declined/open
Now let's say we want to note that there's a task on Phabricator for this. We'll add the following code: <code><nowiki>{{tracked|T123}}</nowiki></code> (where T123 is the identifier of the task).
|3 =float
<div style="margin-left:4em;">
|3label =float
'''Sample output:'''
|3d-en =Sets CSS float and clear properties
{| class="wikitable" style="width: 500px;"
|3aliases =
|-
|3type =line
|
|3def =right
{{Tracked|T123}}
|3stat =optional-
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --[[Special:Mypage|Dogmaster3000]] 01:17, 14 December 2011 (PST)
|3sv =right/left/none/both/inherit
|}
</div>
We can leave it at that. If we'd like to note the fact that the task's been resolved, we can note its status, via <code><nowiki>{{tracked|T123|resolved}}</nowiki></code>. In addition to <code>resolved</code>, we support <code>invalid</code>, <code>duplicate</code>, <code>declined</code>, <code>stalled</code> and <code>open</code>. Example with the <code>resolved</code> keyword:
<div style="margin-left:4em;">
'''Sample output:'''
{| class="wikitable" width="500px"
|-
|
{{tracked|T123|resolved}}
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --[[Special:Mypage|Dogmaster3000]] 01:17, 14 December 2011 (PST)
|}
</div>
Of course, feel free to avoid using this template if tracking a comment is not useful.
<div style="margin-left:4em;">
{| class="wikitable" width="500px"
|-
|
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --[[Special:Mypage|Dogmaster3000]] 01:17, 14 December 2011 (PST)
: You appear to be running the new IE toolbar. This is expected behavior. However, if you upgrade, it will show the angry dancing Ballmer instead. --[[Special:Mypage|GNUnicorn]] 01:38, 14 December 2011 (PST)
|4 =style
|}
|4label =style
</div>
|4d-en =Adds additional CSS to the box
|4aliases =
|4type =
|4def =
|4stat =optional-
==Bugzilla tickets==
|name =Tracked
For backwards compatibility, this template also accepts the number of a Bugzilla ticket as first parameter, and the following resolutions: <code>fixed</code>, <code>wontfix</code>, <code>later</code>, <code>invalid</code>. Last but not least, we can mark a bug as critical. We deliberately aren't using this keyword for bugs which are resolved one way or another -- the point of adding this to the template is to note to all readers of the page that the seriousness of a bug has been critical. '''This keyword should only be used if the bug has also been marked as critical in Bugzilla.''' Example usage: <code><nowiki>{{Tracked|300|critical}}</nowiki></code>
|desc =Link box to a bug report
|namespace =all
<div style="margin-left:4em;">
|usergroup =all
'''Sample output:'''
|placement =
{| class="wikitable" width="500px"
|mustbesubst =
|-
|relieson =
|
|useTemplateData = 1
{{Tracked|300|critical}}
|usage-notes =
|shorthand =
|setscats =
|seealso =
|type =
|i18n-desc =
|i18n-subpage =i18n
|i18n-mediawiki-msg =
|i18n-method =ext.translate
|example =T1234{{!}}resolved
|example-value ={{Tracked|T1234|resolved}}
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --[[Special:Mypage|Dogmaster3000]] 01:17, 14 December 2011 (PST)
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --[[Special:Mypage|Dogmaster3000]] 01:17, 14 December 2011 (PST)
|}
|example2 =T2001
</div>
|print =
}}
If you need the [[phabricator:|Phabricator]] task for a migrated Bugzilla ticket, add 2000 to the BZ bug number and prefix with '''T''', e.g., [[phabricator:T2300|T2300]] replaced [[bugzilla:300]].
<includeonly>{{Sandbox other||
----
<!-- Categories below this line; interwikis at Wikidata -->
<templatedata>
[[Category:Maintenance templates]]
{
}}</includeonly>
"description": "Link box to a bug report",
"params": {
"1": {
"label": "Bug id.",
"description": "Tasknumber T123 or old bugzilla number",
TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.
Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either useTemplateData=1 or useTemplateData=only on the /doc subpage and transcluding it with {{Documentation}} into the template. <nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.
Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw <templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.
Your software is broken. It doesn't even work on Windows ME. When I try to load it, Bill Gates appears on my screen and laughs manically. --Dogmaster3000 01:17, 14 December 2011 (PST)
