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

= TableSorterPlugin

== Description

!TableSorterPlugin adds the [http://tablesorter.com/ tablesorter jQuery plugin] for turning HTML tables with THEAD and TBODY tags into a sortable table without page refreshes.
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 
[http://trac-hacks.org/newticket?component=TableSorterPlugin&owner=psuter new ticket].

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

== Download

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

== Source

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

== Example

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

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

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:'''