Chamilo is a learning management system focused on ease of use and accessibility
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
chamilo-lms/main/inc/lib/sortabletable.class.php

914 lines
32 KiB

<?php
/* For licensing terms, see /license.txt */
require_once 'pear/HTML/Table.php';
require_once 'pear/Pager/Pager.php';
require_once 'tablesort.lib.php';
/**
* This class allows you to display a sortable data-table. It is possible to
* split the data in several pages.
* Using this class you can:
* - automatically create checkboxes of the first table column
* - a "select all" and "deselect all" link is added
* - only if you provide a list of actions for the selected items
* - click on the table header to sort the data
* - choose how many items you see per page
* - navigate through all data-pages
*/
class SortableTable extends HTML_Table {
/**
* A name for this table
*/
public $table_name;
/**
* The page to display
*/
public $page_nr;
/**
* The column to sort the data
*/
public $column;
/**
* The sorting direction (ASC or DESC)
*/
public $direction;
/**
* Number of items to display per page
*/
public $per_page;
/**
* The default number of items to display per page
*/
public $default_items_per_page;
/**
* A prefix for the URL-parameters, can be used on pages with multiple
* SortableTables
*/
public $param_prefix;
/**
* The pager object to split the data in several pages
*/
public $pager;
/**
* The total number of items in the table
*/
public $total_number_of_items;
/**
* The function to get the total number of items
*/
public $get_total_number_function;
/**
* The function to the the data to display
*/
public $get_data_function;
/**
* An array with defined column-filters
*/
public $column_filters;
/**
* A list of actions which will be available through a select list
*/
public $form_actions;
/**
* Additional parameters to pass in the URL
*/
public $additional_parameters;
/**
* Additional attributes for the th-tags
*/
public $th_attributes;
/**
* Additional attributes for the td-tags
*/
public $td_attributes;
/**
* Array with names of the other tables defined on the same page of this
* table
*/
public $other_tables;
/**
* Create a new SortableTable
* @param string $table_name A name for the table (default = 'table')
* @param string $get_total_number_function A user defined function to get
* the total number of items in the table
* @param string $get_data_function A function to get the data to display on
* the current page
* @param int $default_column The default column on which the data should be
* sorted
* @param int $default_items_per_page The default number of items to show
* on one page
* @param string $default_order_direction The default order direction;
* either the constant 'ASC' or 'DESC'
*/
public function __construct ($table_name = 'table', $get_total_number_function = null, $get_data_function = null, $default_column = 1, $default_items_per_page = 20, $default_order_direction = 'ASC') {
parent :: __construct (array ('class' => 'data_table'));
$this->table_name = $table_name;
$this->additional_parameters = array ();
$this->param_prefix = $table_name.'_';
$this->page_nr = isset ($_SESSION[$this->param_prefix.'page_nr']) ? intval($_SESSION[$this->param_prefix.'page_nr']) : 1;
$this->page_nr = isset ($_GET[$this->param_prefix.'page_nr']) ? intval($_GET[$this->param_prefix.'page_nr']) : $this->page_nr;
$this->column = isset ($_SESSION[$this->param_prefix.'column']) ? intval($_SESSION[$this->param_prefix.'column']) : $default_column;
$this->column = isset ($_GET[$this->param_prefix.'column']) ? intval($_GET[$this->param_prefix.'column']) : $this->column;
//$this->direction = isset ($_SESSION[$this->param_prefix.'direction']) ? $_SESSION[$this->param_prefix.'direction'] : $default_order_direction;
if (isset($_SESSION[$this->param_prefix.'direction'])) {
$my_session_direction = $_SESSION[$this->param_prefix.'direction'];
if (!in_array($my_session_direction, array('ASC', 'DESC'))) {
$this->direction = 'ASC';
} else {
if ($my_session_direction == 'ASC') {
$this->direction = 'ASC';
} elseif ($my_session_direction == 'DESC') {
$this->direction = 'DESC';
}
}
}
if (isset($_GET[$this->param_prefix.'direction'])) {
$my_get_direction = $_GET[$this->param_prefix.'direction'];
if (!in_array($my_get_direction, array('ASC', 'DESC'))){
$this->direction = 'ASC';
} else {
if ($my_get_direction == 'ASC') {
$this->direction = 'ASC';
} elseif ($my_get_direction == 'DESC') {
$this->direction = 'DESC';
}
}
}
// Allow to change paginate in multiples tabs
unset($_SESSION[$this->param_prefix.'per_page']);
$this->per_page = isset ($_SESSION[$this->param_prefix.'per_page']) ? intval($_SESSION[$this->param_prefix.'per_page']) : $default_items_per_page;
$this->per_page = isset ($_GET[$this->param_prefix.'per_page']) ? intval($_GET[$this->param_prefix.'per_page']) : $this->per_page;
$_SESSION[$this->param_prefix.'per_page'] = $this->per_page;
$_SESSION[$this->param_prefix.'direction'] = $this->direction ;
$_SESSION[$this->param_prefix.'page_nr'] = $this->page_nr;
$_SESSION[$this->param_prefix.'column'] = $this->column;
$this->pager = null;
$this->default_items_per_page = $default_items_per_page;
$this->total_number_of_items = -1;
$this->get_total_number_function = $get_total_number_function;
$this->get_data_function = $get_data_function;
$this->column_filters = array ();
$this->form_actions = array ();
$this->checkbox_name = null;
$this->td_attributes = array ();
$this->th_attributes = array ();
$this->other_tables = array();
}
/**
* Get the Pager object to split the showed data in several pages
*/
public function get_pager () {
if (is_null($this->pager)) {
$total_number_of_items = $this->get_total_number_of_items();
$params['mode'] = 'Sliding';
$params['perPage'] = $this->per_page;
$params['totalItems'] = $total_number_of_items;
$params['urlVar'] = $this->param_prefix.'page_nr';
$params['currentPage'] = $this->page_nr;
$icon_attributes = array('style' => 'vertical-align: middle;');
$params['prevImg'] = Display :: return_icon('action_prev.png', get_lang('PreviousPage'), $icon_attributes);
$params['nextImg'] = Display :: return_icon('action_next.png', get_lang('NextPage'), $icon_attributes);
$params['firstPageText'] = Display :: return_icon('action_first.png', get_lang('FirstPage'), $icon_attributes);
$params['lastPageText'] = Display :: return_icon('action_last.png', get_lang('LastPage'), $icon_attributes);
$params['firstPagePre'] = '';
$params['lastPagePre'] = '';
$params['firstPagePost'] = '';
$params['lastPagePost'] = '';
$params['spacesBeforeSeparator'] = '';
$params['spacesAfterSeparator'] = '';
$query_vars = array_keys($_GET);
$query_vars_needed = array ($this->param_prefix.'column', $this->param_prefix.'direction', $this->param_prefix.'per_page');
if (count($this->additional_parameters) > 0) {
$query_vars_needed = array_merge($query_vars_needed, array_keys($this->additional_parameters));
}
$query_vars_exclude = array_diff($query_vars, $query_vars_needed);
$params['excludeVars'] = $query_vars_exclude;
$this->pager = & Pager :: factory($params);
}
return $this->pager;
}
/**
* Displays the table, complete with navigation buttons to browse through
* the data-pages.
*/
public function display () {
$empty_table = false;
if ($this->get_total_number_of_items() == 0) {
$cols = $this->getColCount();
$this->setCellAttributes(1, 0, 'style="font-style: italic;text-align:center;" colspan='.$cols);
$message_empty = api_xml_http_response_encode(get_lang('TheListIsEmpty'));
$this->setCellContents(1, 0, $message_empty);
$empty_table = true;
}
$html = '';
if (!$empty_table) {
$form = $this->get_page_select_form();
$nav = $this->get_navigation_html();
$html = '<table style="width:100%;">';
$html .= '<tr>';
$html .= '<td style="width:25%;">';
$html .= $form;
$html .= '</td>';
$html .= '<td style="text-align:center;">';
$html .= $this->get_table_title();
$html .= '</td>';
$html .= '<td style="text-align:right;width:25%;">';
$html .= $nav;
$html .= '</td>';
$html .= '</tr>';
$html .= '</table>';
if (count($this->form_actions) > 0) {
$html .= '<script language="JavaScript" type="text/javascript">
/*<![CDATA[*/
function setCheckbox(value) {
d = document.form_'.$this->table_name.';
for (i = 0; i < d.elements.length; i++) {
if (d.elements[i].type == "checkbox") {
d.elements[i].checked = value;
}
}
}
/*]]>*/
</script>';
$params = $this->get_sortable_table_param_string().'&amp;'.$this->get_additional_url_paramstring();
$html .= '<form method="post" action="'.api_get_self().'?'.$params.'" name="form_'.$this->table_name.'">';
}
}
$html .= $this->get_table_html();
if (!$empty_table) {
$html .= '<table style="width:100%;">';
$html .= '<tr>';
$html .= '<td colspan="2">';
if (count($this->form_actions) > 0) {
$html .= '<br />';
$html .= '<a href="?'.$params.'&amp;'.$this->param_prefix.'selectall=1" onclick="javascript: setCheckbox(true); return false;">'.get_lang('SelectAll').'</a> - ';
$html .= '<a href="?'.$params.'" onclick="javascript: setCheckbox(false); return false;">'.get_lang('UnSelectAll').'</a> ';
$html .= '<select name="action">';
foreach ($this->form_actions as $action => & $label) {
$html .= '<option value="'.$action.'">'.$label.'</option>';
}
$html .= '</select>';
$html .= '&nbsp;&nbsp;<button type="submit" class="save" onclick="javascript: if(!confirm('."'".addslashes(api_htmlentities(get_lang("ConfirmYourChoice"),ENT_QUOTES))."'".')) return false;">'.get_lang('Select').'</button>';
} else {
$html .= $form;
}
$html .= '</td>';
$html .= '<td style="text-align:right;">';
$html .= $nav;
$html .= '</td>';
$html .= '</tr>';
$html .= '</table>';
if (count($this->form_actions) > 0) {
$html .= '</form>';
}
}
echo $html;
}
/**
* This function shows the content of a table in a grid.
* Should not be use to edit information (edit/delete rows) only.
* */
public function display_grid () {
$empty_table = false;
if ($this->get_total_number_of_items() == 0) {
$cols = $this->getColCount();
//$this->setCellAttributes(1, 0, 'style="font-style: italic;text-align:center;" colspan='.$cols);
$message_empty = api_xml_http_response_encode(get_lang('TheListIsEmpty'));
$this->setCellContents(1, 0, $message_empty);
$empty_table = true;
}
$html = '';
if (!$empty_table) {
$form = $this->get_page_select_form();
$nav = $this->get_navigation_html();
// @todo This style css must be moved to default.css only for dev
echo '<style>
.main-grid { width:100%;}
.sub-header { width:100%; padding-top: 10px; padding-right: 10px; padding-left: 10px; height:30px;}
.grid_container { width:100%;}
.grid_item { height: 120px; width:98px; border:1px dotted #ccc; float:left; padding:5px; margin:8px;}
.grid_element_0 { width:100px; float:left; text-align:center; margin-bottom:5px;}
.grid_element_1 { width:100px; float:left; text-align:center;margin-bottom:5px;}
.grid_element_2 { width:150px; float:left;}
.grid_selectbox { width:30%; float:left;}
.grid_title { width:30%; float:left;}
.grid_nav { }
</style>';
// @todo This also must be moved
// Show only navigations if there are more than 1 page
$my_pager = $this->get_pager();
$html .= '<div class="main-grid">';
if ($my_pager->numPages() > 1) {
$html .= '<div class="sub-header">';
$html .= '<div class="grid_selectbox">'.$form.'</div>';
$html .= '<div class="grid_title">'.$this->get_table_title().'</div>';
$html .= '<div class="grid_nav">'.$nav.'</div>';
$html .= '</div>';
}
$html .= '<div class="clear"></div>';
if (count($this->form_actions) > 0) {
$script= '<script language="JavaScript" type="text/javascript">
/*<![CDATA[*/
function setCheckbox(value) {
d = document.form_'.$this->table_name.';
for (i = 0; i < d.elements.length; i++) {
if (d.elements[i].type == "checkbox") {
d.elements[i].checked = value;
}
}
}
/*]]>*/
</script>';
$params = $this->get_sortable_table_param_string().'&amp;'.$this->get_additional_url_paramstring();
$html .= '<form method="post" action="'.api_get_self().'?'.$params.'" name="form_'.$this->table_name.'">';
}
}
// Getting the items of the table
$items = $this->get_clean_html(false); //no sort
// Generation of style classes must be improved. Maybe we need a a table name to create style on the fly:
// i.e: .whoisonline_table_grid_container instead of .grid_container
// where whoisonline is the table's name like drupal's template engine
$html .= '<div class="grid_container">';
if (is_array($items) && count($items) > 0) {
foreach ($items as & $row) {
$html .= '<div class="grid_item">';
$i = 0;
foreach ($row as & $element) {
$html .= '<div class="grid_element_'.$i.'">'.$element.'</div>';
$i++;
}
$html .= '</div>';
}
}
$html .= '</div>'; //close grid_container
$html .= '</div>'; //close main grid
$html .= '<div class="clear"></div>';
/*
if (!$empty_table) {
$html .= '<table style="width:100%;">';
$html .= '<tr>';
$html .= '<td colspan="2">';
if (count($this->form_actions) > 0) {
$html .= '<br />';
$html .= '<a href="?'.$params.'&amp;'.$this->param_prefix.'selectall=1" onclick="javascript:setCheckbox(true);return false;">'.get_lang('SelectAll').'</a> - ';
$html .= '<a href="?'.$params.'" onclick="javascript:setCheckbox(false);return false;">'.get_lang('UnSelectAll').'</a> ';
$html .= '<select name="action">';
foreach ($this->form_actions as $action => $label) {
$html .= '<option value="'.$action.'">'.$label.'</option>';
}
$html .= '</select>';
$html .= '&nbsp;&nbsp;<button type="submit" class="save" onclick="javascript: if(!confirm('."'".addslashes(api_htmlentities(get_lang("ConfirmYourChoice"),ENT_QUOTES))."'".')) return false;">'.get_lang('Select').'</button>';
} else {
$html .= $form;
}
$html .= '</td>';
$html .= '<td style="text-align:right;">';
$html .= $nav;
$html .= '</td>';
$html .= '</tr>';
$html .= '</div>';
if (count($this->form_actions) > 0) {
$html .= '</form>';
}
}
*/
echo $html;
}
/**
* This function returns the content of a table in a grid
* Should not be use to edit information (edit/delete rows) only.
* @param array options of visibility
* @param bool hide navigation optionally
* @param int content per page when show navigation (optional)
* @param bool sort data optionally
* @return string grid html
*/
public function display_simple_grid($vibility_options, $hide_navigation = true, $per_page = 0, $sort_data = true) {
$empty_table = false;
if ($this->get_total_number_of_items() == 0) {
$cols = $this->getColCount();
//$this->setCellAttributes(1, 0, 'style="font-style: italic;text-align:center;" colspan='.$cols);
$message_empty = api_xml_http_response_encode(get_lang('TheListIsEmpty'));
$this->setCellContents(1, 0, $message_empty);
$empty_table = true;
}
$html = '';
if (!$empty_table) {
// If we show the pagination
if (!$hide_navigation) {
$form = '&nbsp;';
if ($per_page > 10) {
$form = $this->get_page_select_form();
}
$nav = $this->get_navigation_html();
// This also must be moved
$html = '<div class="sub-header" >';
$html .= '<div class="grid_selectbox">'.$form.'</div>';
$html .= '<div class="grid_title">'.$this->get_table_title().'</div>';
$html .= '<div class="grid_nav">'.$nav.'</div>';
$html .= '</div>';
}
$html .= '<div class="clear"></div>';
if (count($this->form_actions) > 0) {
$script= '<script language="javaScript" type="text/javascript">
/*<![CDATA[*/
function setCheckbox(value) {
d = document.form_'.$this->table_name.';
for (i = 0; i < d.elements.length; i++) {
if (d.elements[i].type == "checkbox") {
d.elements[i].checked = value;
}
}
}
/*]]>*/
</script>';
$params = $this->get_sortable_table_param_string().'&amp;'.$this->get_additional_url_paramstring();
$html .= '<form method="post" action="'.api_get_self().'?'.$params.'" name="form_'.$this->table_name.'">';
}
}
if ($hide_navigation) {
$items = $this->table_data; // This is a faster way to get what we want
} else {
// The normal way
$items = $this->get_clean_html($sort_data); // Getting the items of the table
}
// Generation of style classes must be improved. Maybe we need a a table name to create style on the fly:
// i.e: .whoisonline_table_grid_container instead of .grid_container
// where whoisonline is the table's name like drupal's template engine
if (is_array($vibility_options)) {
$filter = false; // The 2nd condition of the if will be loaded
} else {
$filter = $vibility_options !== false;
}
$html .= '<div class="'.$this->table_name.'_grid_container">';
if (is_array($items) && count($items) >0) {
foreach ($items as & $row) {
$html .= '<div class="'.$this->table_name.'_grid_item">';
$i = 0;
foreach ($row as & $element) {
if ($filter || $vibility_options[$i]) {
$html.='<div class="'.$this->table_name.'_grid_element_'.$i.'">'.$element.'</div>';
}
$i++;
}
$html .= '</div>';
}
}
$html .= '</div>';
$html .= '<div class="clear"></div>';
return $html;
}
/**
* Get the HTML-code with the navigational buttons to browse through the
* data-pages.
*/
public function get_navigation_html () {
$pager = $this->get_pager();
$pager_links = $pager->getLinks();
$showed_items = $pager->getOffsetByPageId();
$nav = $pager_links['first'].' '.$pager_links['back'];
$nav .= ' '.$pager->getCurrentPageId().' / '.$pager->numPages().' ';
$nav .= $pager_links['next'].' '.$pager_links['last'];
return $nav;
}
/**
* Get the HTML-code with the data-table.
*/
public function get_table_html () {
$pager = $this->get_pager();
$val = $pager->getOffsetByPageId();
$offset = $pager->getOffsetByPageId();
$from = $offset[0] - 1;
$table_data = $this->get_table_data($from);
if (is_array($table_data)) {
foreach ($table_data as $index => & $row) {
$row = $this->filter_data($row);
$this->addRow($row);
}
}
$this->altRowAttributes(0, array ('class' => 'row_odd'), array ('class' => 'row_even'), true);
foreach ($this->th_attributes as $column => $attributes) {
$this->setCellAttributes(0, $column, $attributes);
}
foreach ($this->td_attributes as $column => $attributes) {
$this->setColAttributes($column, $attributes);
}
return $this->toHTML();
}
/**
* This function return the items of the table
* @param bool true for sorting table data or false otherwise
* @return array table row items
*/
public function get_clean_html ($sort = true) {
$pager = $this->get_pager();
$val = $pager->getOffsetByPageId();
$offset = $pager->getOffsetByPageId();
$from = $offset[0] - 1;
$table_data = $this->get_table_data($from, $sort);
$new_table_data = array();
if (is_array($table_data)) {
foreach ($table_data as $index => & $row) {
$row = $this->filter_data($row);
$new_table_data[] = $row;
}
}
return $new_table_data;
}
/**
* Get the HTML-code wich represents a form to select how many items a page
* should contain.
*/
public function get_page_select_form () {
$total_number_of_items = $this->get_total_number_of_items();
if ($total_number_of_items <= $this->default_items_per_page) {
return '';
}
$result[] = '<form method="get" action="'.api_get_self().'" style="display:inline;">';
$param[$this->param_prefix.'direction'] = $this->direction;
$param[$this->param_prefix.'page_nr'] = $this->page_nr;
$param[$this->param_prefix.'column'] = $this->column;
if (is_array($this->additional_parameters)) {
$param = array_merge($param, $this->additional_parameters);
}
foreach ($param as $key => & $value) {
$result[] = '<input type="hidden" name="'.$key.'" value="'.$value.'"/>';
}
$result[] = '<select name="'.$this->param_prefix.'per_page" onchange="javascript: this.form.submit();">';
for ($nr = 10; $nr <= min(50, $total_number_of_items); $nr += 10) {
$result[] = '<option value="'.$nr.'" '. ($nr == $this->per_page ? 'selected="selected"' : '').'>'.$nr.'</option>';
}
// @todo no limits
//if ($total_number_of_items < 500) {
$result[] = '<option value="'.$total_number_of_items.'" '. ($total_number_of_items == $this->per_page ? 'selected="selected"' : '').'>'.api_ucfirst(get_lang('All')).'</option>';
//}
$result[] = '</select>';
$result[] = '<noscript>';
$result[] = '<button class="save" type="submit">'.get_lang('Save').'</button>';
$result[] = '</noscript>';
$result[] = '</form>';
$result = implode("\n", $result);
return $result;
}
/**
* Get the table title.
*/
public function get_table_title () {
$pager = $this->get_pager();
$showed_items = $pager->getOffsetByPageId();
return $showed_items[0].' - '.$showed_items[1].' / '.$this->get_total_number_of_items();
}
/**
* Set the header-label
* @param int $column The column number
* @param string $label The label
* @param boolean $sortable Is the table sortable by this column? (defatult
* = true)
* @param string $th_attributes Additional attributes for the th-tag of the
* table header
* @param string $td_attributes Additional attributes for the td-tags of the
* column
*/
public function set_header ($column, $label, $sortable = true, $th_attributes = null, $td_attributes = null) {
$param['direction'] = 'ASC';
if ($this->column == $column && $this->direction == 'ASC') {
$param['direction'] = 'DESC';
}
$param['page_nr'] = $this->page_nr;
$param['per_page'] = $this->per_page;
$param['column'] = $column;
if ($sortable) {
$link = '<a href="'.api_get_self().'?'.api_get_cidreq().'&amp;';
foreach ($param as $key => & $value) {
$link .= $this->param_prefix.$key.'='.urlencode($value).'&amp;';
}
$link .= $this->get_additional_url_paramstring();
$link .= '">'.$label.'</a>';
if ($this->column == $column) {
$link .= $this->direction == 'ASC' ? ' &#8595;' : ' &#8593;';
}
} else {
$link = $label;
}
$this->setHeaderContents(0, $column, $link);
if (!is_null($td_attributes)) {
$this->td_attributes[$column] = $td_attributes;
}
if (!is_null($th_attributes)) {
$this->th_attributes[$column] = $th_attributes;
}
}
/**
* Get the parameter-string with additional parameters to use in the URLs
* generated by this SortableTable
*/
public function get_additional_url_paramstring () {
$param_string_parts = array ();
if (is_array($this->additional_parameters) && count($this->additional_parameters) > 0) {
foreach ($this->additional_parameters as $key => & $value) {
$param_string_parts[] = urlencode($key).'='.urlencode($value);
}
}
$result = implode('&amp;', $param_string_parts);
foreach ($this->other_tables as $index => & $tablename) {
$param = array();
if (isset($_GET[$tablename.'_direction'])) {
//$param[$tablename.'_direction'] = $_GET[$tablename.'_direction'];
$my_get_direction = $_GET[$tablename.'_direction'];
if (!in_array($my_get_direction, array('ASC', 'DESC'))) {
$param[$tablename.'_direction'] = 'ASC';
} else {
$param[$tablename.'_direction'] = $my_get_direction;
}
}
if (isset($_GET[$tablename.'_page_nr'])) {
$param[$tablename.'_page_nr'] = intval($_GET[$tablename.'_page_nr']);
}
if (isset($_GET[$tablename.'_per_page'])) {
$param[$tablename.'_per_page'] = intval($_GET[$tablename.'_per_page']);
}
if (isset($_GET[$tablename.'_column'])) {
$param[$tablename.'_column'] = intval($_GET[$tablename.'_column']);
}
$param_string_parts = array ();
foreach ($param as $key => & $value) {
$param_string_parts[] = urlencode($key).'='.urlencode($value);
}
if (count($param_string_parts) > 0)
$result .= '&amp;'.implode('&amp;', $param_string_parts);
}
return $result;
}
/**
* Get the parameter-string with the SortableTable-related parameters to use
* in URLs
*/
public function get_sortable_table_param_string () {
$param[$this->param_prefix.'direction'] = $this->direction;
$param[$this->param_prefix.'page_nr'] = $this->page_nr;
$param[$this->param_prefix.'per_page'] = $this->per_page;
$param[$this->param_prefix.'column'] = $this->column;
$param_string_parts = array ();
foreach ($param as $key => & $value) {
$param_string_parts[] = urlencode($key).'='.urlencode($value);
}
$res = implode('&amp;', $param_string_parts);
return $res;
}
/**
* Add a filter to a column. If another filter was allready defined for the
* given column, it will be overwritten.
* @param int $column The number of the column
* @param string $function The name of the filter-function. This should be a
* function wich requires 1 parameter and returns the filtered value.
*/
public function set_column_filter ($column, $function) {
$this->column_filters[$column] = $function;
}
/**
* Define a list of actions which can be performed on the table-date.
* If you define a list of actions, the first column of the table will be
* converted into checkboxes.
* @param array $actions A list of actions. The key is the name of the
* action. The value is the label to show in the select-box
* @param string $checkbox_name The name of the generated checkboxes. The
* value of the checkbox will be the value of the first column.
*/
public function set_form_actions ($actions, $checkbox_name = 'id') {
$this->form_actions = $actions;
$this->checkbox_name = $checkbox_name;
}
/**
* Define a list of additional parameters to use in the generated URLs
* @example $parameters['action'] = 'test'; will be convert in <input type="hidden" name="action" value="test">
* @param array $parameters
*/
public function set_additional_parameters ($parameters) {
$this->additional_parameters = $parameters;
}
/**
* Set other tables on the same page.
* If you have other sortable tables on the page displaying this sortable
* tables, you can define those other tables with this function. If you
* don't define the other tables, there sorting and pagination will return
* to their default state when sorting this table.
* @param array $tablenames An array of table names.
*/
public function set_other_tables ($tablenames) {
$this->other_tables = $tablenames;
}
/**
* Transform all data in a table-row, using the filters defined by the
* function set_column_filter(...) defined elsewhere in this class.
* If you've defined actions, the first element of the given row will be
* converted into a checkbox
* @param array $row A row from the table.
*/
public function filter_data ($row) {
$url_params = $this->get_sortable_table_param_string().'&amp;'.$this->get_additional_url_paramstring();
foreach ($this->column_filters as $column => & $function) {
$row[$column] = call_user_func($function, $row[$column], $url_params, $row);
}
if (count($this->form_actions) > 0) {
if (strlen($row[0]) > 0) {
$row[0] = '<input type="checkbox" name="'.$this->checkbox_name.'[]" value="'.$row[0].'"';
if (isset($_GET[$this->param_prefix.'selectall'])) {
$row[0] .= ' checked="checked"';
}
$row[0] .= '/>';
}
}
foreach ($row as $index => & $value) {
if (empty($value)) {
$value = '-';
}
}
return $row;
}
/**
* Get the total number of items. This function calls the function given as
* 2nd argument in the constructor of a SortableTable. Make sure your
* function has the same parameters as defined here.
*/
public function get_total_number_of_items () {
if ($this->total_number_of_items == -1 && !is_null($this->get_total_number_function)) {
$this->total_number_of_items = call_user_func($this->get_total_number_function);
}
return $this->total_number_of_items;
}
/**
* Get the data to display. This function calls the function given as
* 2nd argument in the constructor of a SortableTable. Make sure your
* function has the same parameters as defined here.
* @param int $from Index of the first item to return.
* @param int $per_page The number of items to return
* @param int $column The number of the column on which the data should be
* sorted
* @param string $direction In which order should the data be sorted (ASC
* or DESC)
*/
public function get_table_data ($from = null, $per_page = null, $column = null, $direction = null) {
if (!is_null($this->get_data_function)) {
return call_user_func($this->get_data_function, $from, $this->per_page, $this->column, $this->direction);
}
return array ();
}
}
/**
* Sortable table which can be used for data available in an array
*/
class SortableTableFromArray extends SortableTable {
/**
* The array containing all data for this table
*/
public $table_data;
/**
* Constructor
* @param array $table_data
* @param int $default_column
* @param int $default_items_per_page
*/
public function __construct ($table_data, $default_column = 1, $default_items_per_page = 20, $tablename = 'tablename') {
parent :: __construct ($tablename, null, null, $default_column, $default_items_per_page);
$this->table_data = $table_data;
}
/**
* Get table data to show on current page
* @see SortableTable#get_table_data
*/
public function get_table_data ($from = 1, $sort = true) {
if ($sort) {
$content = TableSort :: sort_table($this->table_data, $this->column, $this->direction == 'ASC' ? SORT_ASC : SORT_DESC);
} else {
$content = $this->table_data;
}
return array_slice($content, $from, $this->per_page);
}
/**
* Get total number of items
* @see SortableTable#get_total_number_of_items
*/
public function get_total_number_of_items() {
return count($this->table_data);
}
}
/**
* Sortable table which can be used for data available in an array
*
* Is a variation of SortableTableFromArray because we add 2 new arrays $column_show and $column_order
* $column_show is an array that lets us decide which are going to be the columns to show
* $column_order is an array that lets us decide the ordering of the columns
* i.e: $column_header=array('a','b','c','d','e'); $column_order=array(1,2,5,4,5);
* These means that the 3th column (letter "c") will be sort like the order we use in the 5th column
*/
class SortableTableFromArrayConfig extends SortableTable {
/**
* The array containing the columns that will be show i.e $column_show=array('1','0','0'); we will show only the 1st column
*/
private $column_show;
/**
*The array containing the real sort column $column_order=array('1''4','3','4'); The 2nd column will be order like the 4th column
*/
private $column_order;
/**
* The array containing all data for this table
*/
private $table_data;
/**
* Constructor
* @param array $table_data All the information of the table
* @param int $default_column Default column that will be use in the sorts functions
* @param int $default_items_per_page quantity of pages that we are going to see
* @param int $tablename Name of the table
* @param array $column_show An array with binary values 1: we show the column 2: we don't show it
* @param array $column_order An array of integers that let us decide how the columns are going to be sort.
*/
public function __construct ($table_data, $default_column = 1, $default_items_per_page = 20, $tablename = 'tablename', $column_show = null, $column_order = null, $direction = 'ASC') {
$this->column_show = $column_show;
$this->column_order = $column_order;
parent :: __construct ($tablename, null, null, $default_column, $default_items_per_page, $direction);
$this->table_data = $table_data;
}
/**
* Get table data to show on current page
* @see SortableTable#get_table_data
*/
public function get_table_data($from = 1) {
$content = TableSort :: sort_table_config($this->table_data, $this->column, $this->direction == 'ASC' ? SORT_ASC : SORT_DESC, $this->column_show, $this->column_order);
return array_slice($content, $from, $this->per_page);
}
/**
* Get total number of items
* @see SortableTable#get_total_number_of_items
*/
public function get_total_number_of_items () {
return count($this->table_data);
}
}