<?php
/*
 * @version $Id: htmltablemain.class.php 22657 2014-02-12 16:17:54Z moyo $
 -------------------------------------------------------------------------
 GLPI - Gestionnaire Libre de Parc Informatique
 Copyright (C) 2003-2014 by the INDEPNET Development Team.

 http://indepnet.net/   http://glpi-project.org
 -------------------------------------------------------------------------

 LICENSE

 This file is part of GLPI.

 GLPI 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.

 GLPI 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 GLPI. If not, see <http://www.gnu.org/licenses/>.
 --------------------------------------------------------------------------
 */

/** @file
* @brief
*/

if (!defined('GLPI_ROOT')) {
   die("Sorry. You can't access directly to this file");
}


/// HTMLTable class
/// Create a smart HTML table. The table allows cells to depend on other ones. As such, it is
/// possible to have rowspan for cells that are "father" of other ones. If a "father" has several
/// sons, then, it "rowspans" on all.
/// The table integrates the notion of group of rows (HTMLTableGroup). For instance, for
/// Computer_Device, each group represents a kind of device (network card, graphique card,
/// processor, memory, ...).
/// There is HTMLTableSuperHeader that defines global headers for all groups. Each group can cut
/// these HTMLTableSuperHeader as many HTMLTableSubHeader as necessary. There is an automatic
/// organisation of the headers between groups.
///
/// The (strict) order of definition of the table is:
///    * Define all HTMLTableSuperHeader that are used by each group: HTMLTableMain::addHeader()
///    * Define one HTMLTableGroup: HTMLTableMain::createGroup()
///      * Define all HTMLTableSubHeader depending of previously defined HTMLTableSuperHeader
///                                       for the given group: HTMLTableGroup::addHeader()
///      * Create all HTMLTableRow for the given group: HTMLTableGroup::createRow()
///          * Create all HTMLTableCell for the given row : HTMLTableRow::addCell()
/// and so on for each group.
/// When done, call HTMLTableMain::display() to render the table.
///
/// A column that don't have any content is collapse
///
/// For further explaination, refer to NetworkPort and all its dependencies (NetworkName, IPAddress,
/// IPNetwork, ...) or Computer_Device and each kind of device.
/// @since 0.84
class HTMLTableMain extends HTMLTableBase {


   private $groups    = array();
   private $itemtypes = array();


   function __construct() {
      parent::__construct(true);
   }


   /**
    * We can define a global name for the table : this will print as header that colspan all columns
    *
    * @param $name the name to print inside the header
    *
    * @return nothing
   **/
   function setTitle($name) {
      $this->title = $name;
   }


   function tryAddHeader() {

      if (count($this->groups) > 0) {
         throw new Exception('Implementation error: must define all headers before any subgroups');
      }
   }


   /**
    * @param $name      string   The name of the group, to be able to retrieve the group
    *                            later with HTMLTableMain::getHeaderByName()
    * @param $content            (@see HTMLTableEntity::content)
    *                             The title of the group : display before the group itself
    *
    * TODO : study to be sure that the order is the one we have defined ...
    *
    * @return nothing
   **/
   function createGroup($name, $content) {

      if (!empty($name)) {
         if (!isset($this->groups[$name])) {
            $this->groups[$name] = new HTMLTableGroup($this, $name, $content);
         }
      }
      return $this->getGroup($name);
   }


   /**
    * @param $itemtype
    * @param $title
   **/
   function addItemType($itemtype, $title) {
      $this->itemtypes[$itemtype] = $title;
   }


   /**
    * Retrieve a group by its name
    *
    * @param $group_name (string) the group name
    *
    * @return nothing
   **/
   function getGroup($group_name) {

      if (isset($this->groups[$group_name])) {
         return $this->groups[$group_name];
      }
      return false;
   }


   /**
    * Display the super headers, for the global table, or the groups
   **/
   function displaySuperHeader() {

      echo "\t\t<tr>\n";
      foreach ($this->getHeaderOrder() as $header_name) {
         $header = $this->getSuperHeaderByName($header_name);
         echo "\t\t\t";
         $header->displayTableHeader(true);
         echo "\n";
      }
      echo "\t\t</tr>\n";
   }


   /**
    * get the total number of rows (ie.: the sum of each group number of rows)
    *
    * Beware that a row is counted only if it is not empty (ie.: at least one addCell)
    *
    * @return the total number of rows
   **/
   function getNumberOfRows() {

      $numberOfRow = 0;
      foreach ($this->groups as $group) {
         $numberOfRow += $group->getNumberOfRows();
      }
      return $numberOfRow;
   }


   /**
    * Display the table itself
    *
    * @param $params    array of possible options:
    *    'html_id'                       the global HTML ID of the table
    *    'display_thead'                 display the header before the first group
    *    'display_tfoot'                 display the header at the end of the table
    *    'display_header_for_each_group' display the header of each group
    *    'display_super_for_each_group'  display the super header befor each group
    *    'display_title_for_each_group'  display the title of each group
    *
    * @return nothing (display only)
   **/
   function display(array $params) {

      $p['html_id']        = '';
      $p['display_thead']  = true;
      $p['display_tfoot']  = true;

      foreach ($params as $key => $val) {
         $p[$key] = $val;
      }

      foreach ($this->groups as $group) {
         $group->prepareDisplay();
      }

      $totalNumberOfRow = $this->getNumberOfRows();

      $totalNumberOfColumn = 0;
      foreach ($this->getHeaders() as $header) {
         $colspan              = $header['']->getColSpan();
         $totalNumberOfColumn += $colspan;
      }


      foreach ($this->itemtypes as $itemtype => $title) {
         Session::initNavigateListItems($itemtype, $title);
      }

      echo "\n<table class='tab_cadre_fixe'";
      if (!empty($p['html_id'])) {
         echo " id='".$p['html_id']."'";
      }
      echo ">\n";

      $open_thead = ((!empty($this->title)) || ($p['display_thead']));
      if ($open_thead) {
         echo "\t<thead>\n";
      }

      if (!empty($this->title)) {
         echo "\t\t<tr><th colspan='$totalNumberOfColumn'>".$this->title."</th></tr>\n";
      }

      if ($totalNumberOfRow == 0) {

         if ($open_thead) {
            echo "\t</thead>\n";
         }

         echo "\t\t<tr class='tab_bg_1'>".
              "<td class='center' colspan='$totalNumberOfColumn'>" . __('None') ."</td></tr>\n";

      } else {

         if ($p['display_thead']) {
            $this->displaySuperHeader();
         }

         if ($open_thead) {
            echo "\t</thead>\n";
         }

         if ($p['display_tfoot']) {
            echo "\t<tfoot>\n";
            $this->displaySuperHeader();
            echo "\t</tfoot>\n";
         }

         foreach ($this->groups as $group) {
            $group->displayGroup($totalNumberOfColumn, $p);
         }
     }

      echo "</table>\n";

   }


}
?>
