Gracias a Berdir lo conseguí funcionando. Así es como funciona con más detalle.
Tablesort se activa "automáticamente" si las matrices (columna) en la matriz $ headers contienen las claves 'datos', 'campo' y opcionalmente 'ordenar'. Esto creará enlaces con 'ordenar' y 'ordenar' en los encabezados de las columnas y mostrará la pequeña flecha y tal.
Para hacer su propia clasificación, obtenga la configuración de clasificación actual con tablesort_get_order y tablesort_get_sort y use esos valores para su propia función de clasificación. La clave 'sql' en la matriz devuelta por tablesort_get_order contiene el nombre del campo que se utilizará para la ordenación.
Una pieza de código de ejemplo (no probado) con la matriz $ users que contiene algunos detalles para cada usuario:
// setup the table data that we want to show
$tableData = array();
foreach ($users as $userDetails) {
$tableData[] = array(
'name' => $userDetails['name'],
'visits' => $userDetails['visits'],
'views' => $userDetails['views'],
'comments' => $userDetails['comments']
);
}
// headers array, sorting by default on comments
$headers = array(
array('data' => t('Name'), 'field' => 'name'),
array('data' => t('Visits'), 'field' => 'visits'),
array('data' => t('Views'), 'field' => 'views'),
array('data' => t('Comments'), 'field' => 'comments', 'sort' => 'desc')
);
// getting the current sort and order parameters from the url
$order = tablesort_get_order($headers);
$sort = tablesort_get_sort($headers);
// sort the table data accordingly (write your own sort function)
$tableData = my_array_sort($tableData, $order['sql'], $sort);
// create the array with rows for theme table
$rows = array();
foreach ($tableData as $entry) {
$rows[] = array(
array('data' => $entry['name']),
array('data' => $entry['visits']),
array('data' => $entry['views']),
array('data' => $entry['comments']),
);
}
// add any attributes and sent everything to theme table
$attributes = array('class' => array('my_class'));
$table = array('header' => $headers, 'attributes' => $attributes, 'rows' => $rows);
$html = theme('table', $table);