---++ %TOPIC%

Instead of writing =[<nop>[yourBugZillaURL/path/shob_bug.cgi?id=123][Bug #123]]= for every bug this plugin provides a convenient way to to this. Now, you only have to write =%<nop>BUG{123}%= to get the same result. This plugin does nothing else than giving your a shorthand for the above plus it places a nice bug-icon next to the bug. Have fun! ;-)

Since version 1.1 there is another shorthand to display buglists depending on your milestones. Just specify a milestone in the list tag like this =%<nop>BUGLIST{1.8}%= and you will get all bugs that have a target milestone of 1.8 or 1.8b. The beta thing is hard coded, so if you dont neet this you have to change this in the code, but as far as I know you can also ignore it.

In version 1.2 a shorthand for the 'mybugs' feature was added.

In version 1.3 there is a possibility to set a target for the bugzilla link (like targets in html href commands). So e.g. =%<nop>BUG{"BUGID" target="_blank"}%= or =%<nop>BUG{"BUGID" target="_top"}%= is possible.

---+++ Syntax Rules
 <blockquote style="background-color: #f5f5f5">
   * =%<nop>BUG{yourBugzillaBugNumberGoesHere}%= 
   * =%<nop>BUGLIST{yourBugzillaMilestoneNumberGoesHere}%= 
   * =%<nop>MYBUGS{user@some.domain}%= 
   * =%<nop>BUG{"yourBugzillaBugNumberGoesHere" target="_blank"}%= 
</blockquote>

---+++ Example
   * %BUG{12}% 
   * %BUGLIST{1.8}% 
   * %MYBUGS{joe@loos.er}% 
   * %BUG{"12" target="_blank"}% 

---+++ <nop>%TOPIC% Settings
<blockquote style="background-color:#f5f5f5">
      * Set BUGURL = http://bugzilla.mozilla.org/show_bug.cgi?id=
      * Set MILESTONEBUGLISTURL = http://bugzilla.mozilla.com/buglist.cgi?
      * Set BUGIMGURL = %ICON{bug_small}%
      * Set BUGTEXT = Bug#
      * Set MILESTONEBUGLISTEXT = Buglist for Release
      * Set SHORTDESCRIPTION = This plugin is useful to display links to bugzilla bugs.
      * Set DEBUG = 0
</blockquote>

---+++ Plugin Installation Instructions
   * You can install manually from the command-line:
      1 Download one of the =.zip= or =.tgz= archives
      1 Unpack the archive in the root directory of your TWiki installation.
      1 Run =configure= and enable the module, if it is a plugin.

---+++ Files
   * ==lib/TWiki/Plugins/BugzillaLinkPlugin.pm== 
   * ==data/TWiki/BugzillaLinkPlugin.txt== 
   * ==pub/TWiki/BugzillaLinkPlugin/bug.gif== 
   * ==pub/TWiki/BugzillaLinkPlugin/bug_small.gif== 
   * ==pub/TWiki/TWikiDocGraphics/bug_small.gif==
   * ==pub/TWiki/BugzillaLinkPlugin/bug_small.png== 
   * ==pub/TWiki/BugzillaLinkPlugin/bug_small_white.png== 

---+++ Plugin Info
|  Plugin Author: | %MAINWEB%.FlorianGnaegi |
|  TestedOnTWiki  | 4.2 |
|  Plugin Version: | 1.3 |
|  Change History: | 15 August 2002: Initial version<br /> 19. August Version 1.1 <br /> 8. July 2003 Version 1.2 <br /> 26. Aug 2008 Version 1.3|
|  CPAN Dependencies: | none |
|  Other Dependencies: | none |
|  Perl Version: | 5.0 |
|  Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
|  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |

---+++ History
   * 1.0: BUG function 
   * 1.1: Added BUGLIST function, renamed to BugzillaLinkPlugin 
   * 1.2: Added MYBUGS function (Thanks to Steve Kostecke), dealing with whitespace (Thanks to Alan Shields) 
   * 1.3: Added target function and changed to latest plugin syntax (by Sascha Vetter)

---+++ Contributors
   * Steve Kostecke (MYBUGS function) 
   * AnthonPang (Repackaging) 
   * AlanShields (White space elimination in queries) 
   * SaschaVetter (Added target function, updated code for twiki 4.2) 

__Related Topics:__ %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins

-- %MAINWEB%.SaschaVetter - 26 Aug 2008


%META:FILEATTACHMENT{name="bug_small_whilte.png" attr="" comment="PNG Bug, white background" date="1029409171" path="/home/gnaegi/bug.gif" size="166" user="FlorianGnaegi" version="1.0"}%
%META:FILEATTACHMENT{name="bug.gif" attr="" comment="GIF Bug large" date="1029409171" path="/home/gnaegi/bug.gif" size="166" user="FlorianGnaegi" version="1.1"}%
%META:FILEATTACHMENT{name="bug_small.gif" attr="" comment="GIF Bug small" date="1029416770" path="/home/gnaegi/bug_small.gif" size="885" user="FlorianGnaegi" version="1.1"}%
%META:FILEATTACHMENT{name="bug_small.png" attr="" comment="PNG Bug transparent" date="1029409171" path="/home/gnaegi/bug.gif" size="166" user="FlorianGnaegi" version="1.0"}%
