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

= Download query output, reports and tickets as an Excel file

== Description

This plugin allows you to download Trac query output, reports and ticket pages as an Excel file.
 * In query and ticket, you are able to download including change history of tickets.
 * In report, [wiki:ExcelReportPatch] is no longer needed to export.

== Bugs/Feature Requests

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

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

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

== Download

Download the zipped source from [download:exceldownloadplugin here].

== Source

You can check out ExcelDownloadPlugin from [http://trac-hacks.org/svn/exceldownloadplugin here] using Subversion, or [source:exceldownloadplugin browse the source] with Trac.

== Installation

 1. Install pypi:xlwt library:
{{{#!sh
easy_install xlwt
}}}
    Or:
{{{#!sh
pip install xlwt
}}}
 2. Install the plugin:
{{{#!sh
easy_install http://trac-hacks.org/svn/exceldownloadplugin/0.12
}}}
 3. Enable the plugin in your `trac.ini` file:
{{{#!ini
[components]
tracexceldownload.* = enabled
}}}
 4. Restart your tracd (or web server) if needed.

== Example

Visit query, report or ticket page in your Trac. Click the `Excel` or `Excel including history` links at the bottom of the pages.

[[Image(format-excel.png,border=1)]]

'''Note:''' The latter link is unavailable in the report page.

== Tickets

[[TicketQuery(component=ExcelDownloadPlugin&status!=closed,group=status)]]

== Recent Changes

[[ChangeLog(exceldownloadplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:jun66j5] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [http://www.opengroove.com/ OpenGroove,Inc.] and [http://ciklone.com/ ciklone]