[[PageOutline(2-5,Contents,pullout)]]

= Issue Tracking with Bugzilla

== Description

This plugin allows you to link to tickets in [https://www.bugzilla.org/ Bugzilla] from within Trac.
If you have Bugzilla deployed as your issue tracking system and are unable to move away from it, this plugin should enable you to use Trac and have the !#123 links automatically link back to your Bugzilla pages rather than Trac's pages.

== Bugs/Feature Requests

Existing bugs and feature requests for BugzillaIssueTrackingPlugin are 
[report:9?COMPONENT=BugzillaIssueTrackingPlugin here].

If you have any issues, create a 
[/newticket?component=BugzillaIssueTrackingPlugin new ticket].

[[TicketQuery(component=BugzillaIssueTrackingPlugin,group=type,format=progress)]]

== Download

Download the zipped source from [export:bugzillaissuetrackingplugin here].

== Source

You can check out BugzillaIssueTrackingPlugin from [/svn/bugzillaissuetrackingplugin here] using Subversion, or [source:bugzillaissuetrackingplugin browse the source] with Trac.

== Installation

Just copy the bugzilla.py file into the 'plugins' sub-folder of your Trac environment. 

== Configuration

Make sure you disable Trac's native tickets before the ticket numbers will link to your Bugzilla installation correctly. To do this just add 'trac.ticket.*= disabled' to the components section of your `trac.ini` file. If there isn't a [components] section, then create one.

Out-of-the-box bugzilla.py will try to link to a Bugzilla installation running on http://bugzilla. This probably isn't what you want and to have it point at your installation, add a new section to the `trac.ini file` named [bugzilla]. The Bugzilla plugin understands only one parameter, which is 'bugzilla_url'.  Have this point to where your Bugzilla installation really resides (trailing slash is optional).

The end of your `trac.ini` file may now look like:

{{{#!ini
[components]
trac.ticket.*= disabled

[bugzilla]
bugzilla_url= http://bugzilla
}}}

== Recent Changes

[[ChangeLog(bugzillaissuetrackingplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:javajunky] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''