classes/class.ilTableGUI.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2005 ILIAS open source, University of Cologne            |
        |                                                                             |
        | This program is free software; you can redistribute it and/or               |
        | modify it under the terms of the GNU General Public License                 |
        | as published by the Free Software Foundation; either version 2              |
        | of the License, or (at your option) any later version.                      |
        |                                                                             |
        | This program is distributed in the hope that it will be useful,             |
        | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
        | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
        | GNU General Public License for more details.                                |
        |                                                                             |
        | You should have received a copy of the GNU General Public License           |
        | along with this program; if not, write to the Free Software                 |
        | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
        +-----------------------------------------------------------------------------+
*/

class ilTableGUI
{
        var $title;                                     // table title name
        var $icon;                                      // table title icon
        var $icon_alt;                          // table title icon alt text

        var $help_page;                         // table help name
        var $help_icon;                         // table help icon
        var $help_icon_alt;                     // table help icon alt text

        var $header_names;                      // titles of header columns
        var $header_vars;                       // var names of header columns (i.e. for database order column)
        var $linkbar_vars;                      // additional variables for linkbar

        var $data;                                      // table content
        
        var $column_count;                      // no. of columns (based on element count of $this->header array)
        var $column_width;                      // column width of each column (used in order until max. column from column count is reached)
                                                                // any exceeding values are ignored
        var $max_count;                         // max. count of database query
        var $limit;                                     // max. count of dataset per page
        var $max_limit = false;
        var $offset;                            // dataset offset
        var $order_column;                      // order column
        var $order_direction;           // order direction
        
        var $footer_style;                      // css format for links
        var     $footer_previous;               // value of previous link
        var     $footer_next;                   // value of next link
        
        var $lang_support = true;       // if a lang object is included
        var $global_tpl;                        // uses global tpl (true) or a local one (false)
        
        // default settings for enabled/disabled table modules 
        var $enabled = array(
                                                        "title"                 =>      true,
                                                        "icon"                  =>      true,
                                                        "help"                  =>      false,
                                                        "content"               =>      true,
                                                        "action"                =>      false,
                                                        "header"        =>  true,
                                                        "footer"                =>      true,
                                                        "linkbar"               =>      true,
                                                        "numinfo"               =>      true,
                                                        "sort"                  =>  true,
                                                        "hits"          =>  false,
                                                        "auto_sort"     =>  true
                                                );

        // tpl styles (only one so far)
        var $styles = array(
                                                        "table"         => "fullwidth"
                                                );
        
        function ilTableGUI($a_data = 0,$a_global_tpl = true)
        {
                global $ilias, $tpl, $lng;

                $this->global_tpl = $a_global_tpl;
                $this->ilias =& $ilias;
                $this->header_vars = array();
                $this->header_params = array();
                $this->enabled["form"] = true;
                if ($this->global_tpl)
                {
                        $this->tpl =& $tpl;
                }
                else
                {
                        $this->tpl = new ilTemplate("tpl.table.html",true,true);
                }

                //$this->tpl->setVariable("IMG_ARROW", ilUtil::getImagePath("arrow_downright.gif"));

                $this->lng =& $lng;

                if (!$this->lng)
                {
                        $this->lang_support = false;
                }

                $this->setData($a_data);
        }


        function setTemplate(&$a_tpl)
        {
                $this->tpl =& $a_tpl;
        }

        function &getTemplateObject()
        {
                return $this->tpl;
        }

        function setData($a_data)
        {
                if (is_array($a_data))
                {
                        $this->data = $a_data;
                }
        }

        function getData()
        {
                return $this->data;
        }

        function setTitle($a_title,$a_icon = 0,$a_icon_alt = 0)
        {
                $this->title = $a_title;
                $this->icon = $a_icon;
                $this->icon_alt = $a_icon_alt;

                if (!$this->icon)
                {
                        $this->enabled["icon"] = false;

                        return;
                }

                if (!$this->icon_alt)
                {
                        $this->icon_alt = $this->icon;
                }
        }
        
        function setHelp($a_help_page,$a_help_icon,$a_help_icon_alt = 0)
        {
                $this->help_page = $a_help_page;
                $this->help_icon = $a_help_icon;
                $this->help_icon_alt = $a_help_icon_alt;

                if (!$this->help_icon_alt)
                {
                        $this->help_icon_alt = $this->help_icon;
                }
        }
        
        function setHeaderNames($a_header_names)
        {
                $this->header_names = $a_header_names;
                $this->column_count = count($this->header_names);
        }

        function setHeaderVars($a_header_vars,$a_header_params = 0)
        {
                $this->header_vars = $a_header_vars;
                
                if ($a_header_params == 0 or !is_array($a_header_params))
                {
                        $this->link_params = "";
                }
                else
                {
                        $this->header_params = $a_header_params;        // temp. solution for linkbar

                        foreach ($a_header_params as $key => $val)
                        {
                                $this->link_params .= $key."=".$val."&";
                        }
                }
        }
        
        function setColumnWidth($a_column_width)
        {
                $this->column_width = $a_column_width;
        }
        
        function setOneColumnWidth($a_column_width,$a_column_number)
        {
                $this->column_width[$a_column_number] = $a_column_width;
        }

        function setMaxCount($a_max_count)
        {
                $this->max_count = $a_max_count;

                if ($this->max_limit)
                {
                        $this->limit = $this->max_count;
                }
        }
        
        function setLimit($a_limit = 0, $a_default_limit = 0)
        {
                $this->limit = ($a_limit) ? $a_limit : $a_default_limit;

                if ($this->limit == 0)
                {
                        $this->max_limit = true;
                }
        }

        function setOffset($a_offset)
        {
                $this->offset = ($a_offset) ? $a_offset : 0;
        }
        
        function setOrderColumn($a_order_column = 0,$a_default_column = 0)
        {
                // set default sort column to first column
                if (empty($a_order_column))
                {
                        if (!empty($a_default_column))
                        {
                                $this->order_column = array_search($a_default_column,$this->header_vars);       
                        }
                        else
                        {
                                $this->order_column = 0;
                                return;
                        }
                }
                else
                {
                        $this->order_column = array_search($a_order_column,$this->header_vars);
                }

                if ($this->order_column === false)
                {
                        // if not found, set default sort column to first column
                        $this->order_column = 0;
                }
        }

        function setOrderDirection($a_order_direction)
        {
                if ($a_order_direction == "desc")
                {
                        $this->order_direction = "desc";
                        $this->sort_order = "asc";
                }
                else
                {
                        $this->order_direction = "asc"; // set default sort order to "ASC"
                        $this->sort_order = "desc";
                }
        }

        function setFooter($a_style,$a_previous = 0,$a_next = 0)
        {
                $this->footer_style = $a_style;

                $this->footer_previous = ($a_previous) ? $a_previous : "<<<";
                $this->footer_next = ($a_next) ? $a_next : ">>>";
        }

        function enable($a_module_name)
        {
                if (!in_array($a_module_name,array_keys($this->enabled)))
                {
                        return false;
                }

                $this->enabled[$a_module_name] = true;
        } 

        function disable($a_module_name)
        {
                if (!in_array($a_module_name,array_keys($this->enabled)))
                {
                        return false;
                }

                $this->enabled[$a_module_name] = false;
        }
        

        function sortData()
        {
                if($this->enabled["sort"])
                {
                        $this->data = ilUtil::sortArray($this->data,$this->order_column,$this->order_direction);
                }
                $this->data = array_slice($this->data,$this->offset,$this->limit);
        }

        function render()
        {
                $this->tpl->setVariable("CSS_TABLE",$this->getStyle("table"));

                // table title icon
                if ($this->enabled["icon"] && $this->enabled["title"])
                {
                        $this->tpl->setCurrentBlock("tbl_header_title_icon");
                        $this->tpl->setVariable("TBL_TITLE_IMG",ilUtil::getImagePath($this->icon));
                        $this->tpl->setVariable("TBL_TITLE_IMG_ALT",$this->icon_alt);
                        $this->tpl->parseCurrentBlock();
                }
                // table title help
                if ($this->enabled["help"] && $this->enabled["title"])
                {
                        $this->tpl->setCurrentBlock("tbl_header_title_help");
                        $this->tpl->setVariable("TBL_HELP_IMG",ilUtil::getImagePath($this->help_icon));
                        $this->tpl->setVariable("TBL_HELP_LINK",$this->help_page);
                        $this->tpl->setVariable("TBL_HELP_IMG_ALT",$this->help_icon_alt);
                        $this->tpl->parseCurrentBlock();
                }

                // hits per page selector
                if ($this->enabled["hits"] && $this->enabled["title"])
                {
                        $this->tpl->setCurrentBlock("tbl_header_hits_page");
                        $this->tpl->setVariable("LIMIT",$_SESSION["tbl_limit"]);
                        $this->tpl->setVariable("HITS_PER_PAGE",$this->lng->txt("hits_per_page"));
                        $this->tpl->parseCurrentBlock();
                }
                
                // table title
                if ($this->enabled["title"])
                {
                        $this->tpl->setCurrentBlock("tbl_header_title");
                        $this->tpl->setVariable("COLUMN_COUNT",$this->column_count);
                        $this->tpl->setVariable("TBL_TITLE",$this->title);
                        $this->tpl->parseCurrentBlock();
                }
                
                // table header
                if ($this->enabled["header"])
                {
                        foreach ($this->header_names as $key => $tbl_header_cell)
                        {
                                if (!$this->enabled["sort"])
                                {
                                        $this->tpl->setCurrentBlock("tbl_header_no_link");
                                        $this->tpl->setVariable("TBL_COLUMN_WIDTH_NO_LINK"," width=\"".$this->column_width[$key]."\"");
                                        $this->tpl->setVariable("TBL_HEADER_CELL_NO_LINK",$tbl_header_cell);
                                        $this->tpl->parseCurrentBlock();
                                        continue;
                                }
                                if (($key == $this->order_column) && ($this->order_direction != ""))
                                {
                                        if (strcmp($this->header_vars[$key], "") != 0)
                                        {
                                                $this->tpl->setCurrentBlock("tbl_order_image");
                                                $this->tpl->setVariable("IMG_ORDER_DIR",ilUtil::getImagePath($this->order_direction."_order.png"));
                                                $this->tpl->parseCurrentBlock();
                                        }
                                }
        
                                $this->tpl->setCurrentBlock("tbl_header_cell");
                                $this->tpl->setVariable("TBL_HEADER_CELL",$tbl_header_cell);
                                
                                // only set width if a value is given for that column
                                if ($this->column_width[$key])
                                {
                                        $this->tpl->setVariable("TBL_COLUMN_WIDTH"," width=\"".$this->column_width[$key]."\"");
                                }
        
                                $lng_sort_column = ($this->lang_support) ? $this->lng->txt("sort_by_this_column") : "Sort by this column";
                                $this->tpl->setVariable("TBL_ORDER_ALT",$lng_sort_column);
                        
                                $order_dir = "asc";
                        
                                if ($key == $this->order_column)
                                { 
                                        $order_dir = $this->sort_order;
        
                                        $lng_change_sort = ($this->lang_support) ? $this->lng->txt("change_sort_direction") : "Change sort direction";
                                        $this->tpl->setVariable("TBL_ORDER_ALT",$lng_change_sort);
                                }
                        
                                $this->tpl->setVariable("TBL_ORDER_LINK",basename($_SERVER["PHP_SELF"])."?".$this->link_params."sort_by=".$this->header_vars[$key]."&sort_order=".$order_dir."&offset=".$this->offset);
                                $this->tpl->parseCurrentBlock();
                        }
                        
                        $this->tpl->setCurrentBlock("tbl_header");
                        $this->tpl->parseCurrentBlock();
                }

                // table data
                // the table content may be skipped to use an individual template blockfile
                // To do so don't set $this->data and parse your table content by yourself
                // The template block name for the blockfile MUST be 'TBL_CONTENT'

                if ($this->enabled["content"] && is_array($this->data))
                {
                        if($this->enabled['auto_sort'])
                        {
                                $this->setMaxCount(count($this->data));
                                $this->sortData();
                        }
                        $count = 0;
                        
                        foreach ($this->data as $tbl_content_row)
                        {
                                foreach ($tbl_content_row as $key => $tbl_content_cell)
                                {
                    if (is_array($tbl_content_cell))
                    {
                        $this->tpl->setCurrentBlock("tbl_cell_subtitle");
                                            $this->tpl->setVariable("TBL_CELL_SUBTITLE",$tbl_content_cell[1]);
                                            $this->tpl->parseCurrentBlock();
                                            $tbl_content_cell = "<b>".$tbl_content_cell[0]."</b>";
                    }
                    
                    $this->tpl->setCurrentBlock("tbl_content_cell");
                                        $this->tpl->setVariable("TBL_CONTENT_CELL",$tbl_content_cell);
                                        $this->tpl->parseCurrentBlock();
                                }

                                $this->tpl->setCurrentBlock("tbl_content_row");
                                $rowcolor = ilUtil::switchColor($count,"tblrow2","tblrow1");
                                $this->tpl->setVariable("ROWCOLOR", $rowcolor);
                                $this->tpl->parseCurrentBlock();
                        
                                $count++;
                        }
                }
                // table footer numinfo
                if ($this->enabled["numinfo"] && $this->enabled["footer"])
                {
                        $start = $this->offset + 1;                             // compute num info
                        $end = $this->offset + $this->limit;
                        
                        if ($end > $this->max_count or $this->limit == 0)
                        {
                                $end = $this->max_count;
                        }
                        
                        if ($this->lang_support)
                        {
                                $numinfo = "(".$this->lng->txt("dataset")." ".$start." - ".$end." ".strtolower($this->lng->txt("of"))." ".$this->max_count.")";
                        }
                        else
                        {
                                $numinfo = "(Dataset ".$start." - ".$end." of ".$this->max_count.")";
                        }
                        if ($this->max_count == 0)
                        {
                                $numinfo = $this->lng->txt("no_datasets");
                        }
        
                        $this->tpl->setCurrentBlock("tbl_footer_numinfo");
                        $this->tpl->setVariable("NUMINFO", $numinfo);
                        $this->tpl->parseCurrentBlock();
                }
                // table footer linkbar
                if ($this->enabled["linkbar"] && $this->enabled["footer"] && $this->limit != 0)
                {
                        $params = array(
                                                        "sort_by"               => $this->header_vars[$this->order_column],
                                                        "sort_order"    => $this->order_direction
                                                        );
                        $params = array_merge($this->header_params,$params);
                        
                        $layout = array(
                                                        "link"  => $this->footer_style,
                                                        "prev"  => $this->footer_previous,
                                                        "next"  => $this->footer_next,
                                                        );
                        $linkbar = ilUtil::Linkbar(basename($_SERVER["PHP_SELF"]),$this->max_count,$this->limit,$this->offset,$params,$layout);
                        $this->tpl->setCurrentBlock("tbl_footer_linkbar");
                        $this->tpl->setVariable("LINKBAR", $linkbar);
                        $this->tpl->parseCurrentBlock();
                }
                                                
                // table footer
                if ($this->enabled["footer"])
                {
                        $this->tpl->setCurrentBlock("tbl_footer");
                        $this->tpl->setVariable("COLUMN_COUNT",$this->column_count);
                        $this->tpl->parseCurrentBlock();
                }

                if ($this->enabled["form"])
                {
                        $this->tpl->touchBlock("tbl_form_footer");
                }

                if (!$this->global_tpl)
                {
                        return $this->tpl->get();
                }
        }
        
        /*
        * set a tpl stylesheet
        * @access       public
        * @param        string  table element
        * @param        string  CSS definition
        */
        function setStyle($a_element,$a_style)
        {
                $this->styles[$a_element] = $a_style;
        }

        /*
        * get a tpl stylesheet
        * @access       public
        * @param        string  table element
        */
        function getStyle($a_element)
        {
                return $this->styles[$a_element];
        }
}
?>