API@RTK0.NET

tablesort_get_order

• Drupal 4.7
• Drupal 5

1. drupal
   1. 4.7
   2. 5
   3. 6 tablesort.inc
   4. 7 tablesort.inc

Determine the current sort criterion.

Parameters

$headers An array of column headers in the format described in theme_table().

Return value

An associative array describing the criterion, containing the keys:

• "name": The localized title of the table column.
• "sql": The name of the database field to sort on.

Code

includes/tablesort.inc, line 147

<?php
function tablesort_get_order($headers) {
  $order = isset($_GET['order']) ? $_GET['order'] : '';
  foreach ($headers as $header) {
    if (isset($header['data']) && $order == $header['data']) {
      return array('name' => $header['data'], 'sql' => $header['field']);
    }

    if (isset($header['sort']) && ($header['sort'] == 'asc' || $header['sort'] == 'desc')) {
      $default = array(
        'name' => $header['data'],
        'sql' => $header['field'],
      );
    }
  }

  if (isset($default)) {
    return $default;
  }
  else {
    // The first column specified is initial 'order by' field unless otherwise specified
    if (is_array($headers[0])) {
      return array('name' => $headers[0]['data'], 'sql' => $headers[0]['field']);
    }
    else {
      return array('name' => $headers[0]);
    }
  }
}
?>