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

= Sort tables

== Description

This plugin allows you to sort tables on your Trac wiki or ticket pages. It uses the [http://tablesorter.com/ tablesorter jQuery plugin] for turning HTML tables into a sortable table without requiring a page refresh. The HTML-code of the table must be specified with the THEAD and TBODY tags for this to work.

This plugin is a wrapper around the third-party Javascript library `jquery.tablesorter`, that is dual licensed under the MIT and GPL licenses.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Example

A screenshot with a table with sortable headings would look as follows:

[[Image(tableSorterPlugin-screenshot.2.png,border=2)]]

The tablesorter plugin requires a `THEAD` tag, which is not added to [trac:wiki:WikiFormatting#Tables normal wiki tables], so use [trac:wiki:WikiHtml WikiHtml] instead. The class `tablesorter` is also required:

{{{
{{{#!html
<table id="myTable" class="tablesorter"> 
<thead> 
<tr> 
    <th>Last Name</th> 
    <th>First Name</th> 
    <th>Email</th> 
    <th>Due</th> 
</tr> 
</thead> 
<tbody> 
<tr> 
    <td>Smith</td> 
    <td>John</td> 
    <td>jsmith@gmail.com</td> 
    <td>$50.00</td> 
</tr> 
<tr> 
    <td>Bach</td> 
    <td>Frank</td> 
    <td>fbach@yahoo.com</td> 
    <td>$50.00</td> 
</tr> 
<tr> 
    <td>Doe</td> 
    <td>Jason</td> 
    <td>jdoe@hotmail.com</td> 
    <td>$100.00</td> 
</tr> 
<tr> 
    <td>Conway</td> 
    <td>Tim</td> 
    <td>tconway@earthlink.net</td> 
    <td>$50.00</td> 
</tr> 
</tbody> 
</table> 
}}}
}}}

== Recent Changes

[[ChangeLog(tablesorterplugin, 3)]]

== Author/Contributors

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