EVOLUTION-MANAGER

Edit File: cartridge.class.php

<?php
/**
 * ---------------------------------------------------------------------
 * GLPI - Gestionnaire Libre de Parc Informatique
 * Copyright (C) 2015-2018 Teclib' and contributors.
 *
 * http://glpi-project.org
 *
 * based on GLPI - Gestionnaire Libre de Parc Informatique
 * Copyright (C) 2003-2014 by the INDEPNET Development Team.
 *
 * ---------------------------------------------------------------------
 *
 * 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/>.
 * ---------------------------------------------------------------------
 */

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

//!  Cartridge Class
/**
 * This class is used to manage the cartridges.
 * @see CartridgeItem
 * @author Julien Dombre
 **/
class Cartridge extends CommonDBChild {

// From CommonDBTM
   static protected $forward_entity_to = ['Infocom'];
   public $dohistory                   = true;
   public $no_form_page                = true;

// From CommonDBChild
   static public $itemtype             = 'CartridgeItem';
   static public $items_id             = 'cartridgeitems_id';

/**
    * @since 0.84
   **/
   function getForbiddenStandardMassiveAction() {

$forbidden   = parent::getForbiddenStandardMassiveAction();
      $forbidden[] = 'update';
      return $forbidden;
   }

/**
    * @since 0.85
    *
    * @see CommonDBTM::showMassiveActionsSubForm()
   **/
   static function showMassiveActionsSubForm(MassiveAction $ma) {

switch ($ma->getAction()) {
         case 'updatepages' :
            $input = $ma->getInput();
            if (!isset($input['maxpages'])) {
               $input['maxpages'] = '';
            }
            echo "<input type='text' name='pages' value=\"".$input['maxpages']."\" size='6'>";
            echo "<br><br>".Html::submit(_x('button', 'Update'), ['name' => 'massiveaction']);
            return true;
      }
      return parent::showMassiveActionsSubForm($ma);
   }

/**
    * @since 0.84
    *
    * @see CommonDBTM::getNameField()
   **/
   static function getNameField() {
      return 'id';
   }

static function getTypeName($nb = 0) {
      return _n('Cartridge', 'Cartridges', $nb);
   }

function prepareInputForAdd($input) {

$item = static::getItemFromArray(static::$itemtype, static::$items_id, $input);
      if ($item === false) {
         return false;
      }

return ["cartridgeitems_id" => $item->fields["id"],
                   "entities_id"       => $item->getEntityID(),
                   "date_in"           => date("Y-m-d")];
   }

function post_addItem() {

Infocom::cloneItem('CartridgeItem', $this->fields["cartridgeitems_id"], $this->fields['id'],
                         $this->getType());
      parent::post_addItem();
   }

function post_updateItem($history = 1) {

if (in_array('pages', $this->updates)) {
         $printer = new Printer();
         if ($printer->getFromDB($this->fields['printers_id'])
             && (($this->fields['pages'] > $printer->getField('last_pages_counter'))
                 || ($this->oldvalues['pages'] == $printer->getField('last_pages_counter')))) {

$printer->update(['id'                 => $printer->getID(),
                                   'last_pages_counter' => $this->fields['pages'] ]);
         }
      }
      parent::post_updateItem($history);
   }

/**
    * @since 0.84
    *
    * @see CommonDBTM::getPreAdditionalInfosForName
   **/
   function getPreAdditionalInfosForName() {

$ci = new CartridgeItem();
      if ($ci->getFromDB($this->fields['cartridgeitems_id'])) {
         return $ci->getName();
      }
      return '';
   }

/**
    * @since 0.85
    *
    * @see CommonDBTM::processMassiveActionsForOneItemtype()
   **/
   static function processMassiveActionsForOneItemtype(MassiveAction $ma, CommonDBTM $item,
                                                       array $ids) {

switch ($ma->getAction()) {
         case 'uninstall' :
            foreach ($ids as $key) {
               if ($item->can($key, UPDATE)) {
                  if ($item->uninstall($key)) {
                     $ma->itemDone($item->getType(), $key, MassiveAction::ACTION_OK);
                  } else {
                     $ma->itemDone($item->getType(), $key, MassiveAction::ACTION_KO);
                     $ma->addMessage($item->getErrorMessage(ERROR_ON_ACTION));
                  }
               } else {
                  $ma->itemDone($item->getType(), $key, MassiveAction::ACTION_NORIGHT);
                  $ma->addMessage($item->getErrorMessage(ERROR_RIGHT));
               }
            }
            return;

case 'backtostock' :
            foreach ($ids as $id) {
               if ($item->can($id, UPDATE)) {
                  if ($item->backToStock(["id" => $id])) {
                     $ma->itemDone($item->getType(), $id, MassiveAction::ACTION_OK);
                  } else {
                     $ma->itemDone($item->getType(), $id, MassiveAction::ACTION_KO);
                     $ma->addMessage($item->getErrorMessage(ERROR_ON_ACTION));
                  }
               } else {
                  $ma->itemDone($item->getType(), $id, MassiveAction::ACTION_NORIGHT);
                  $ma->addMessage($item->getErrorMessage(ERROR_RIGHT));
               }
            }
            return;

case 'updatepages' :
            $input = $ma->getInput();
            if (isset($input['pages'])) {
               foreach ($ids as $key) {
                  if ($item->can($key, UPDATE)) {
                     if ($item->update(['id' => $key,
                                             'pages' => $input['pages']])) {
                        $ma->itemDone($item->getType(), $key, MassiveAction::ACTION_OK);
                     } else {
                        $ma->itemDone($item->getType(), $key, MassiveAction::ACTION_KO);
                        $ma->addMessage($item->getErrorMessage(ERROR_ON_ACTION));
                     }
                  } else {
                     $ma->itemDone($item->getType(), $key, MassiveAction::ACTION_NORIGHT);
                     $ma->addMessage($item->getErrorMessage(ERROR_RIGHT));
                  }
               }
            } else {
               $ma->itemDone($item->getType(), $ids, MassiveAction::ACTION_KO);
            }
            return;
      }
      parent::processMassiveActionsForOneItemtype($ma, $item, $ids);
   }

/**
    * send back to stock
    *
    * @since 0.85 (before name was restore)
    */
   function backToStock(array $input, $history = 1) {
      global $DB;

$result = $DB->update(
         $this->getTable(), [
            'date_out'     => 'NULL',
            'date_use'     => 'NULL',
            'printers_id'  => 0
         ], [
            'id' => $input['id']
         ]
      );
      if ($result && ($DB->affected_rows() > 0)) {
         return true;
      }
      return false;
   }

// SPECIFIC FUNCTIONS

/**
    * Link a cartridge to a printer.
    *
    * Link the first unused cartridge of type $Tid to the printer $pID
    *
    * @param $tID : cartridge type identifier
    * @param $pID : printer identifier
    *
    * @return boolean : true for success
   **/
   function install($pID, $tID) {
      global $DB;

// Get first unused cartridge
      $iterator = $DB->request([
         'SELECT' => ['id'],
         'FROM'   => $this->getTable(),
         'WHERE'  => [
            'cartridgeitems_id'  => $tID,
            'date_use'           => null
         ],
         'LIMIT'  => 1
      ]);

if (count($iterator)) {
         $result = $iterator->next();
         $cID = $result['id'];
         // Mise a jour cartouche en prenant garde aux insertion multiples
         $result = $DB->update(
            $this->getTable(), [
               'date_use'     => date('Y-m-d'),
               'printers_id'  => $pID
            ], [
               'id'        => $cID,
               'date_use'  => null
            ]
         );
         if ($result && ($DB->affected_rows() > 0)) {
            $changes = [
               '0',
               '',
               __('Installing a cartridge'),
            ];
            Log::history($pID, 'Printer', $changes, 0, Log::HISTORY_LOG_SIMPLE_MESSAGE);
            return true;
         }

} else {
         Session::addMessageAfterRedirect(__('No free cartridge'), false, ERROR);
      }
      return false;
   }

/**
    * UnLink a cartridge linked to a printer
    *
    * UnLink the cartridge identified by $ID
    *
    * @param $ID : cartridge identifier
    *
    * @return boolean
   **/
   function uninstall($ID) {
      global $DB;

if ($this->getFromDB($ID)) {
         $printer = new Printer();
         $toadd   = [];
         if ($printer->getFromDB($this->getField("printers_id"))) {
            $toadd['pages'] = $printer->fields['last_pages_counter'];
         }

$result = $DB->update(
            $this->getTable(), [
               'date_out'  => date('Y-m-d')
            ] + $toadd, [
               'id'  => $ID
            ]
         );

if ($result
             && ($DB->affected_rows() > 0)) {
            $changes = [
               '0',
               '',
               __('Uninstalling a cartridge'),
            ];
            Log::history($this->getField("printers_id"), 'Printer', $changes,
                         0, Log::HISTORY_LOG_SIMPLE_MESSAGE);

return true;
         }
         return false;
      }
   }

/**
    * Print the cartridge count HTML array for the cartridge item $tID
    *
    * @param $tID              integer: cartridge item identifier.
     *@param $alarm_threshold  integer: threshold alarm value.
    * @param $nohtml           integer: Return value without HTML tags (default 0)
    *
    * @return string to display
   **/
   static function getCount($tID, $alarm_threshold, $nohtml = 0) {

// Get total
      $total = self::getTotalNumber($tID);
      $out   = "";
      if ($total != 0) {
         $unused     = self::getUnusedNumber($tID);
         $used       = self::getUsedNumber($tID);
         $old        = self::getOldNumber($tID);
         $highlight  = "";
         if ($unused <= $alarm_threshold) {
            $highlight = "tab_bg_1_2";
         }

if (!$nohtml) {
            $out .= "<table  class='tab_format $highlight' width='100%'><tr><td>";
            $out .= __('Total')."</td><td>$total";
            $out .= "</td><td class='b'>";
            $out .= _nx('cartridge', 'New', 'New', $unused);
            $out .= "</td><td class='b'>$unused</td></tr>";
            $out .= "<tr><td>";
            $out .= _nx('cartridge', 'Used', 'Used', $used);
            $out .= "</td><td>$used</td><td>";
            $out .= _nx('cartridge', 'Worn', 'Worn', $old);
            $out .= "</td><td>$old</td></tr></table>";

} else {
            //TRANS : for display cartridges count : %1$d is the total number,
            //        %2$d the new one, %3$d the used one, %4$d worn one
            $out .= sprintf(__('Total: %1$d (%2$d new, %3$d used, %4$d worn)'),
                            $total, $unused, $used, $old);
         }

} else {
         if (!$nohtml) {
            $out .= "<div class='tab_bg_1_2'><i>".__('No cartridge')."</i></div>";
         } else {
            $out .= __('No cartridge');
         }
      }
      return $out;
   }

/**
    * Print the cartridge count HTML array for the printer $pID
    *
    * @since 0.85
    *
    * @param $pID              integer: printer identifier.
    * @param $nohtml           integer: Return value without HTML tags (default 0)
    *
    * @return string to display
   **/
   static function getCountForPrinter($pID, $nohtml = 0) {

// Get total
      $total = self::getTotalNumberForPrinter($pID);
      $out   = "";
      if ($total != 0) {
         $used       = self::getUsedNumberForPrinter($pID);
         $old        = self::getOldNumberForPrinter($pID);
         $highlight  = "";
         if ($used == 0) {
            $highlight = "tab_bg_1_2";
         }

if (!$nohtml) {
            $out .= "<table  class='tab_format $highlight' width='100%'><tr><td>";
            $out .= __('Total')."</td><td>$total";
            $out .= "</td><td colspan='2'></td><tr>";
            $out .= "<tr><td>";
            $out .= _nx('cartridge', 'Used', 'Used', $used);
            $out .= "</td><td>$used</span></td><td>";
            $out .= _nx('cartridge', 'Worn', 'Worn', $old);
            $out .= "</td><td>$old</span></td></tr></table>";

} else {
            //TRANS : for display cartridges count : %1$d is the total number,
            //        %2$d the used one, %3$d the worn one
            $out .= sprintf(__('Total: %1$d (%2$d used, %3$d worn)'), $total, $used, $old);
         }

/**
    * count how many cartbridge for the cartridge item $tID
    *
    * @param $tID integer: cartridge item identifier.
    *
    * @return integer : number of cartridge counted.
   **/
   static function getTotalNumber($tID) {
      global $DB;

$row = $DB->request([
         'FROM'   => self::getTable(),
         'COUNT'  => 'cpt',
         'WHERE'  => ['cartridgeitems_id' => $tID]
      ])->next();
      return $row['cpt'];
   }

/**
    * count how many cartbridge for the printer $pID
    *
    * @since 0.85
    *
    * @param $pID integer: printer identifier.
    *
    * @return integer : number of cartridge counted.
   **/
   static function getTotalNumberForPrinter($pID) {
      global $DB;

$row = $DB->request([
         'FROM'   => self::getTable(),
         'COUNT'  => 'cpt',
         'WHERE'  => ['printers_id' => $pID]
      ])->next();
      return (int)$row['cpt'];
   }

/**
    * count how many cartridge used for the cartridge item $tID
    *
    * @param $tID integer: cartridge item identifier.
    *
    * @return integer : number of cartridge used counted.
   **/
   static function getUsedNumber($tID) {
      global $DB;

$row = $DB->request([
         'SELECT' => ['id'],
         'COUNT'  => 'cpt',
         'FROM'   => 'glpi_cartridges',
         'WHERE'  => [
            'cartridgeitems_id'  => $tID,
            'date_out'           => null,
            'NOT'                => [
               'date_use'  => null
            ]
         ]
      ])->next();
      return (int)$row['cpt'];
   }

/**
    * count how many cartridge used for the printer $pID
    *
    * @since 0.85
    *
    * @param $pID integer: printer identifier.
    *
    * @return integer : number of cartridge used counted.
   **/
   static function getUsedNumberForPrinter($pID) {
      global $DB;

$result = $DB->request([
         'COUNT'  => 'cpt',
         'FROM'   => self::getTable(),
         'WHERE'  => [
            'printers_id'  => $pID,
            'date_out'     => null,
            'NOT'          => ['date_use' => null]
         ]
      ])->next();
      return $result['cpt'];
   }

/**
    * count how many old cartbridge for the cartridge item $tID
    *
    * @param $tID integer: cartridge item identifier.
    *
    * @return integer : number of old cartridge counted.
   **/
   static function getOldNumber($tID) {
      global $DB;

$result = $DB->request([
         'COUNT'  => 'cpt',
         'FROM'   => self::getTable(),
         'WHERE'  => [
            'cartridgeitems_id'  => $tID,
            'NOT'                => ['date_out' => null]
         ]
      ])->next();
      return $result['cpt'];
   }

/**
    * count how many old cartbridge for theprinter $pID
    *
    * @since 0.85
    *
    * @param $pID integer: printer identifier.
    *
    * @return integer : number of old cartridge counted.
   **/
   static function getOldNumberForPrinter($pID) {
      global $DB;

$result = $DB->request([
         'COUNT'  => 'cpt',
         'FROM'   => self::getTable(),
         'WHERE'  => [
            'printers_id'  => $pID,
            'NOT'          => ['date_out' => null]
         ]
      ])->next();
      return $result['cpt'];
   }

/**
    * count how many cartbridge unused for the cartridge item $tID
    *
    * @param $tID integer: cartridge item identifier.
    *
    * @return integer : number of cartridge unused counted.
   **/
   static function getUnusedNumber($tID) {
      global $DB;

$result = $DB->request([
         'COUNT'  => 'cpt',
         'FROM'   => self::getTable(),
         'WHERE'  => [
            'cartridgeitems_id'  => $tID,
            'date_use'           => null
         ]
      ])->next();
      return $result['cpt'];
   }

/**
    * Get the dict value for the status of a cartridge
    *
    * @param string $date_use  date : date of use
    * @param string $date_out  date : date of delete
    *
    * @return string : dict value for the cartridge status.
   **/
   static function getStatus($date_use, $date_out) {

if (is_null($date_use) || empty($date_use)) {
         return _x('cartridge', 'New');
      }
      if (is_null($date_out) || empty($date_out)) {
         return _x('cartridge', 'Used');
      }
      return _x('cartridge', 'Worn');
   }

/**
    * Print out the cartridges of a defined type
    *
    * @param $cartitem  object   of CartridgeItem class
    * @param $show_old  boolean  show old cartridges or not (default 0)
    *
    * @return boolean|void
   **/
   static function showForCartridgeItem(CartridgeItem $cartitem, $show_old = 0) {
      global $DB;

$tID = $cartitem->getField('id');
      if (!$cartitem->can($tID, READ)) {
         return false;
      }
      $canedit = $cartitem->can($tID, UPDATE);

$where = ['glpi_cartridges.cartridgeitems_id' => $tID];
      $order = [
         'glpi_cartridges.date_use ASC',
         'glpi_cartridges.date_out DESC',
         'glpi_cartridges.date_in'
      ];

if (!$show_old) { // NEW
         $where['glpi_cartridges.date_out'] = null;
         $order = [
            'glpi_cartridges.date_out ASC',
            'glpi_cartridges.date_use ASC',
            'glpi_cartridges.date_in'
         ];
      } else { //OLD
         $where['NOT'] = ['glpi_cartridges.date_out' => null];
      }

$stock_time       = 0;
      $use_time         = 0;
      $pages_printed    = 0;
      $nb_pages_printed = 0;

$iterator = $DB->request([
         'SELECT' => [
            'glpi_cartridges.*',
            'glpi_printers.id AS printID',
            'glpi_printers.name AS printname',
            'glpi_printers.init_pages_counter'
         ],
         'FROM'   => self::gettable(),
         'LEFT JOIN' => [
            'glpi_printers'   => [
               'FKEY'   => [
                  self::getTable()  => 'printers_id',
                  'glpi_printers'   => 'id'
               ]
            ]
         ],
         'WHERE'     => $where,
         'ORDER'     => $order
      ]);

$number = count($iterator);

echo "<div class='spaced'>";
      if ($canedit && $number) {
         $rand = mt_rand();
         Html::openMassiveActionsForm('mass'.__CLASS__.$rand);
         $actions = ['delete' => _x('button', 'Delete permanently'),
                     'Infocom'.MassiveAction::CLASS_ACTION_SEPARATOR.'activate'
                              => __('Enable the financial and administrative information')
                          ];
         if (!$show_old) {
            $actions['Cartridge'.MassiveAction::CLASS_ACTION_SEPARATOR.'backtostock']
                  = __('Back to stock');
         }
         $massiveactionparams = ['num_displayed'    => min($_SESSION['glpilist_limit'], $number),
                                      'specific_actions' => $actions,
                                      'container'        => 'mass'.__CLASS__.$rand,
                                      'rand'             => $rand];
         Html::showMassiveActions($massiveactionparams);
      }
      echo "<table class='tab_cadre_fixehov'>";
      if (!$show_old) {
         echo "<tr class='noHover'><th colspan='".($canedit?'7':'6')."'>".
               self::getCount($tID, -1)."</th>";
         echo "</tr>";
      } else { // Old
         echo "<tr class='noHover'><th colspan='".($canedit?'9':'8')."'>".__('Worn cartridges');
         echo "</th></tr>";
      }

$header_begin  = "<tr>";
      $header_top    = '';
      $header_bottom = '';
      $header_end    = '';

if ($canedit && $number) {
         $header_begin  .= "<th width='10'>";
         $header_top     = Html::getCheckAllAsCheckbox('mass'.__CLASS__.$rand);
         $header_bottom  = Html::getCheckAllAsCheckbox('mass'.__CLASS__.$rand);
         $header_end    .= "</th>";
      }
      $header_end .= "<th>".__('ID')."</th>";
      $header_end .= "<th>"._x('item', 'State')."</th>";
      $header_end .= "<th>".__('Add date')."</th><th>".__('Use date')."</th>";
      $header_end .= "<th>".__('Used on')."</th>";

if ($show_old) {
         $header_end .= "<th>".__('End date')."</th>";
         $header_end .= "<th>".__('Printer counter')."</th>";
      }

$header_end .= "<th width='18%'>".__('Financial and administrative information')."</th>";
      $header_end .= "</tr>";
      echo $header_begin.$header_top.$header_end;

$pages = [];

if ($number) {
         while ($data = $iterator->next()) {
            $date_in  = Html::convDate($data["date_in"]);
            $date_use = Html::convDate($data["date_use"]);
            $date_out = Html::convDate($data["date_out"]);
            $printer  = $data["printers_id"];

echo "<tr class='tab_bg_1'>";
            if ($canedit) {
               echo "<td width='10'>";
               Html::showMassiveActionCheckBox(__CLASS__, $data["id"]);
               echo "</td>";
            }
            echo "<td>".$data['id'].'</td>';
            echo "<td class='center'>".self::getStatus($data["date_use"], $data["date_out"]);
            echo "</td><td class='center'>".$date_in."</td>";
            echo "<td class='center'>".$date_use."</td>";
            echo "<td class='center'>";
            if (!is_null($date_use)) {
               if ($data["printID"] > 0) {
                  $printname = $data["printname"];
                  if ($_SESSION['glpiis_ids_visible'] || empty($printname)) {
                     $printname = sprintf(__('%1$s (%2$s)'), $printname, $data["printID"]);
                  }
                  echo "<a href='".Printer::getFormURLWithID($data["printID"])."'><span class='b'>".$printname."</span></a>";
               } else {
                  echo NOT_AVAILABLE;
               }
               $tmp_dbeg       = explode("-", $data["date_in"]);
               $tmp_dend       = explode("-", $data["date_use"]);
               $stock_time_tmp = mktime(0, 0, 0, $tmp_dend[1], $tmp_dend[2], $tmp_dend[0])
                                 - mktime(0, 0, 0, $tmp_dbeg[1], $tmp_dbeg[2], $tmp_dbeg[0]);
               $stock_time    += $stock_time_tmp;
            }
            if ($show_old) {
               echo "</td><td class='center'>";
               echo $date_out;
               $tmp_dbeg      = explode("-", $data["date_use"]);
               $tmp_dend      = explode("-", $data["date_out"]);
               $use_time_tmp  = mktime(0, 0, 0, $tmp_dend[1], $tmp_dend[2], $tmp_dend[0])
                                 - mktime(0, 0, 0, $tmp_dbeg[1], $tmp_dbeg[2], $tmp_dbeg[0]);
               $use_time     += $use_time_tmp;
            }

echo "</td>";
            if ($show_old) {
               // Get initial counter page
               if (!isset($pages[$printer])) {
                  $pages[$printer] = $data['init_pages_counter'];
               }
               echo "<td class='center'>";
               if ($pages[$printer] < $data['pages']) {
                  $pages_printed   += $data['pages']-$pages[$printer];
                  $nb_pages_printed++;
                  $pp               = $data['pages']-$pages[$printer];
                  printf(_n('%d printed page', '%d printed pages', $pp), $pp);
                  $pages[$printer]  = $data['pages'];
               } else if ($data['pages'] != 0) {
                  echo "<span class='tab_bg_1_2'>".__('Counter error')."</span>";
               }
               echo "</td>";
            }
            echo "<td class='center'>";
            Infocom::showDisplayLink('Cartridge', $data["id"]);
            echo "</td>";
            echo "</tr>";
         }
         if ($show_old
             && ($number > 0)) {
            if ($nb_pages_printed == 0) {
                $nb_pages_printed = 1;
            }
            echo "<tr class='tab_bg_2'><td colspan='".($canedit?'4':'3')."'>&nbsp;</td>";
            echo "<td class='center b'>".__('Average time in stock')."<br>";
            echo round($stock_time/$number/60/60/24/30.5, 1)." ".__('month')."</td>";
            echo "<td>&nbsp;</td>";
            echo "<td class='center b'>".__('Average time in use')."<br>";
            echo round($use_time/$number/60/60/24/30.5, 1)." ".__('month')."</td>";
            echo "<td class='center b'>".__('Average number of printed pages')."<br>";
            echo round($pages_printed/$nb_pages_printed)."</td>";
            echo "<td colspan='".($canedit?'3':'1')."'>&nbsp;</td></tr>";
         } else {
            echo $header_begin.$header_bottom.$header_end;
         }
      }

echo "</table>";
      if ($canedit && $number) {
         $massiveactionparams['ontop'] = false;
         Html::showMassiveActions($massiveactionparams);
         Html::closeForm();
      }
      echo "</div>\n\n";
   }

/**
    * Print out a link to add directly a new cartridge from a cartridge item.
    *
    * @param $cartitem  CartridgeItem object
    *
    * @return boolean|void
   **/
   static function showAddForm(CartridgeItem $cartitem) {

$ID = $cartitem->getField('id');
      if (!$cartitem->can($ID, UPDATE)) {
         return false;
      }
      if ($ID > 0) {
         echo "<div class='firstbloc'>";
         echo "<form method='post' action=\"".static::getFormURL()."\">";
         echo "<table class='tab_cadre_fixe'>";
         echo "<tr><td class='center tab_bg_2' width='20%'>";
         echo "<input type='hidden' name='cartridgeitems_id' value='$ID'>\n";
         Dropdown::showNumber('to_add', ['value' => 1,
                                              'min'   => 1,
                                              'max'   => 100]);
         echo "</td><td>";
         echo " <input type='submit' name='add' value=\"".__s('Add cartridges')."\"
                class='submit'>";
         echo "</td></tr>";
         echo "</table>";
         Html::closeForm();
         echo "</div>";
      }
   }

/**
    * Show installed cartridges
    *
    * @since 0.84 (before showInstalled)
    *
    * @param $printer            Printer object
    * @param $old       boolean  old cartridges or not ? (default 0)
    *
    * @return boolean|void
   **/
   static function showForPrinter(Printer $printer, $old = 0) {
      global $DB, $CFG_GLPI;

$instID = $printer->getField('id');
      if (!self::canView()) {
         return false;
      }
      $canedit = Session::haveRight("cartridge", UPDATE);
      $rand    = mt_rand();

$where = ['glpi_cartridges.printers_id' => $instID];
      if ($old) {
         $where['NOT'] = ['glpi_cartridges.date_out' => null];
      } else {
         $where['glpi_cartridges.date_out'] = null;
      }
      $iterator = $DB->request([
         'SELECT'    => [
            'glpi_cartridgeitems.id AS tID',
            'glpi_cartridgeitems.is_deleted',
            'glpi_cartridgeitems.ref AS ref',
            'glpi_cartridgeitems.name AS type',
            'glpi_cartridges.id',
            'glpi_cartridges.pages AS pages',
            'glpi_cartridges.date_use AS date_use',
            'glpi_cartridges.date_out AS date_out',
            'glpi_cartridges.date_in AS date_in',
            'glpi_cartridgeitemtypes.name AS typename'
         ],
         'FROM'      => self::getTable(),
         'LEFT JOIN' => [
            'glpi_cartridgeitems'      => [
               'FKEY'   => [
                  self::getTable()        => 'cartridgeitems_id',
                  'glpi_cartridgeitems'   => 'id'
               ]
            ],
            'glpi_cartridgeitemtypes'  => [
               'FKEY'   => [
                  'glpi_cartridgeitems'      => 'cartridgeitemtypes_id',
                  'glpi_cartridgeitemtypes'  => 'id'
               ]
            ]
         ],
         'WHERE'     => $where,
         'ORDER'     => [
            'glpi_cartridges.date_out ASC',
            'glpi_cartridges.date_use DESC',
            'glpi_cartridges.date_in',
         ]
      ]);

$number = count($iterator);

if ($canedit && !$old) {
         echo "<div class='firstbloc'>";
         echo "<form method='post' action=\"".static::getFormURL()."\">";
         echo "<table class='tab_cadre_fixe'>";
         echo "<tr><td class='center tab_bg_2' width='50%'>";
         echo "<input type='hidden' name='printers_id' value='$instID'>\n";
         if (CartridgeItem::dropdownForPrinter($printer)) {
            //TRANS : multiplier
            echo "</td><td>".__('x')."&nbsp;";
            Dropdown::showNumber("nbcart", ['value' => 1,
                                                 'min'   => 1,
                                                 'max'   => 5]);
            echo "</td><td><input type='submit' name='install' value=\""._sx('button', 'Install')."\"
                                  class='submit'>";

} else {
            echo __('No cartridge available');
         }

echo "</td></tr>";
         echo "</table>";
         Html::closeForm();
         echo "</div>";
      }

echo "<div id='viewcartridge$rand'></div>";

$pages = $printer->fields['init_pages_counter'];
      echo "<div class='spaced'>";
      if ($canedit && $number) {
         Html::openMassiveActionsForm('mass'.__CLASS__.$rand);
         if (!$old) {
            $actions = [__CLASS__.MassiveAction::CLASS_ACTION_SEPARATOR.'uninstall'
                                       => __('End of life'),
                             __CLASS__.MassiveAction::CLASS_ACTION_SEPARATOR.'backtostock'
                                       => __('Back to stock')
                            ];
         } else {
            $actions = [__CLASS__.MassiveAction::CLASS_ACTION_SEPARATOR.'updatepages'
                                      => __('Update printer counter'),
                             'purge' => _x('button', 'Delete permanently')];
         }
         $massiveactionparams = ['num_displayed'    => min($_SESSION['glpilist_limit'], $number),
                           'specific_actions' => $actions,
                           'container'        => 'mass'.__CLASS__.$rand,
                           'rand'             => $rand,
                           'extraparams'      => ['maxpages'
                                                       => $printer->fields['last_pages_counter']]];
         Html::showMassiveActions($massiveactionparams);
      }
      echo "<table class='tab_cadre_fixehov'>";
      echo "<tr class='noHover'>";
      if ($old == 0) {
         echo "<th colspan='".($canedit?'6':'5')."'>".__('Used cartridges')."</th>";
      } else {
         echo "<th colspan='".($canedit?'9':'8')."'>".__('Worn cartridges')."</th>";
      }
      echo "</tr>";

$header_begin  = "<tr>";
      $header_top    = '';
      $header_end    = '';

if ($canedit) {
         $header_begin  .= "<th width='10'>";
         $header_top    .= Html::getCheckAllAsCheckbox('mass'.__CLASS__.$rand);
         $header_end    .= "</th>";
      }
      $header_end .= "<th>".__('ID')."</th><th>"._n('Cartridge model', 'Cartridge models', 1)."</th>";
      $header_end .= "<th>"._n('Cartridge type', 'Cartridge types', 1)."</th>";
      $header_end .= "<th>".__('Add date')."</th>";
      $header_end .= "<th>".__('Use date')."</th>";
      if ($old != 0) {
         $header_end .= "<th>".__('End date')."</th>";
         $header_end .= "<th>".__('Printer counter')."</th>";
         $header_end .= "<th>".__('Printed pages')."</th>";
      }
      $header_end .= "</tr>";
      echo $header_begin.$header_top.$header_end;

$stock_time       = 0;
      $use_time         = 0;
      $pages_printed    = 0;
      $nb_pages_printed = 0;

while ($data = $iterator->next()) {
         $cart_id    = $data["id"];
         $typename   = $data["typename"];
         $date_in    = Html::convDate($data["date_in"]);
         $date_use   = Html::convDate($data["date_use"]);
         $date_out   = Html::convDate($data["date_out"]);
         $viewitemjs = ($canedit ? "style='cursor:pointer' onClick=\"viewEditCartridge".$cart_id.
                        "$rand();\"" : '');
         echo "<tr class='tab_bg_1".($data["is_deleted"]?"_2":"")."'>";
         if ($canedit) {
            echo "<td width='10'>";
            Html::showMassiveActionCheckBox(__CLASS__, $cart_id);
            echo "</td>";
         }
         echo "<td class='center' $viewitemjs>";
         if ($canedit) {
            echo "\n<script type='text/javascript' >\n";
            echo "function viewEditCartridge". $cart_id."$rand() {\n";
            $params = ['type'        => __CLASS__,
                            'parenttype'  => 'Printer',
                            'printers_id' => $printer->fields["id"],
                            'id'          => $cart_id];
            Ajax::updateItemJsCode("viewcartridge$rand",
                                   $CFG_GLPI["root_doc"]."/ajax/viewsubitem.php", $params);
            echo "};";
            echo "</script>\n";
         }
         echo $data["id"]."</td>";
         echo "<td class='center' $viewitemjs>";
         echo "<a href=\"".CartridgeItem::getFormURLWithID($data["tID"])."\">";
         printf(__('%1$s - %2$s'), $data["type"], $data["ref"]);
         echo "</a></td>";
         echo "<td class='center' $viewitemjs>".$typename."</td>";
         echo "<td class='center' $viewitemjs>".$date_in."</td>";
         echo "<td class='center' $viewitemjs>".$date_use."</td>";

$tmp_dbeg       = explode("-", $data["date_in"]);
         $tmp_dend       = explode("-", $data["date_use"]);

$stock_time_tmp = mktime(0, 0, 0, $tmp_dend[1], $tmp_dend[2], $tmp_dend[0])
                           - mktime(0, 0, 0, $tmp_dbeg[1], $tmp_dbeg[2], $tmp_dbeg[0]);
         $stock_time    += $stock_time_tmp;
         if ($old != 0) {
            echo "<td class='center' $viewitemjs>".$date_out;

$tmp_dbeg      = explode("-", $data["date_use"]);
            $tmp_dend      = explode("-", $data["date_out"]);

$use_time_tmp  = mktime(0, 0, 0, $tmp_dend[1], $tmp_dend[2], $tmp_dend[0])
                              - mktime(0, 0, 0, $tmp_dbeg[1], $tmp_dbeg[2], $tmp_dbeg[0]);
            $use_time     += $use_time_tmp;

echo "</td><td class='numeric' $viewitemjs>".$data['pages']."</td>";
            echo "<td class='numeric' $viewitemjs>";

if ($pages < $data['pages']) {
               $pages_printed   += $data['pages']-$pages;
               $nb_pages_printed++;
               $pp               = $data['pages']-$pages;
               echo $pp;
               $pages            = $data['pages'];
            } else {
               echo "&nbsp;";
            }
            echo "</td>";
         }
         echo "</tr>";
      }

if ($old) { // Print average
         if ($number > 0) {
            if ($nb_pages_printed == 0) {
               $nb_pages_printed = 1;
            }
            echo "<tr class='tab_bg_2'><td colspan='".($canedit?"4":'3')."'>&nbsp;</td>";
            echo "<td class='center b'>".__('Average time in stock')."<br>";
            $time_stock = round($stock_time/$number/60/60/24/30.5, 1);
            echo sprintf(_n('%d month', '%d months', $time_stock), $time_stock)."</td>";
            echo "<td class='center b'>".__('Average time in use')."<br>";
            $time_use = round($use_time/$number/60/60/24/30.5, 1);
            echo sprintf(_n('%d month', '%d months', $time_use), $time_use)."</td>";
            echo "<td class='center b' colspan='2'>".__('Average number of printed pages')."<br>";
            echo round($pages_printed/$nb_pages_printed)."</td>";
            echo "</tr>";
         }
      }

/** form for Cartridge
    *
    * @since 0.84
    *
    * @param $ID      integer  Id of the cartridge
    * @param $options array    of possible options:
    *     - parent Object : the printers where the cartridge is used
   **/
   function showForm($ID, $options = []) {

if (isset($options['parent']) && !empty($options['parent'])) {
         $printer = $options['parent'];
      }
      if (!$this->getFromDB($ID)) {
         return false;
      }
      $printer = new Printer;
      $printer->check($this->getField('printers_id'), UPDATE);

$cartitem = new CartridgeItem;
      $cartitem->getFromDB($this->getField('cartridgeitems_id'));

$is_old  = !empty($this->fields['date_out']);
      $is_used = !empty($this->fields['date_use']);

$options['colspan'] = 2;
      $options['candel']  = false; // Do not permit delete here
      $options['canedit'] = $is_used; // Do not permit edit if cart is not used
      $this->showFormHeader($options);

echo "<tr class='tab_bg_1'>";
      echo "<td>"._n('Printer', 'Printers', 1)."</td><td>";
      echo $printer->getLink();
      echo "<input type='hidden' name='printers_id' value='".$this->getField('printers_id')."'>\n";
      echo "<input type='hidden' name='cartridgeitems_id' value='".
             $this->getField('cartridgeitems_id')."'>\n";
      echo "</td>\n";
      echo "<td>"._n('Cartridge model', 'Cartridge models', 1)."</td>";
      echo "<td>".$cartitem->getLink()."</td></tr>\n";

echo "<tr class='tab_bg_1'>";
      echo "<td>".__('Add date')."</td>";
      echo "<td>".Html::convDate($this->fields["date_in"])."</td>";

echo "<td>".__('Use date')."</td><td>";
      if ($is_used && !$is_old) {
         Html::showDateField("date_use", ['value'      => $this->fields["date_use"],
                                               'maybeempty' => false,
                                               'canedit'    => true,
                                               'min'        => $this->fields["date_in"]]);
      } else {
         echo Html::convDate($this->fields["date_use"]);
      }
      echo "</td></tr>\n";

if ($is_old) {
         echo "<tr class='tab_bg_1'>";
         echo "<td>".__('End date')."</td><td>";
         Html::showDateField("date_out", ['value'      => $this->fields["date_out"],
                                               'maybeempty' => false,
                                               'canedit'    => true,
                                               'min'        => $this->fields["date_use"]]);
         echo "</td>";
         echo "<td>".__('Printer counter')."</td><td>";
         echo "<input type='text' name='pages' value=\"".$this->fields['pages']."\">";
         echo "</td></tr>\n";
      }
      $this->showFormButtons($options);

return true;
   }

/**
    * Get notification parameters by entity
    *
    * @param entity the entity (default 0)
    */
   static function getNotificationParameters($entity = 0) {
      global $DB, $CFG_GLPI;

//Look for parameters for this entity
      $iterator = $DB->request([
         'SELECT' => ['cartridges_alert_repeat'],
         'FROM'   => 'glpi_entities',
         'WHERE'  => ['id' => $entity]
      ]);

if (!count($iterator)) {
         //No specific parameters defined, taking global configuration params
         return $CFG_GLPI['cartridges_alert_repeat'];

} else {
         $data = $iterator->next();
         //This entity uses global parameters -> return global config
         if ($data['cartridges_alert_repeat'] == -1) {
            return $CFG_GLPI['cartridges_alert_repeat'];
         }
         // ELSE Special configuration for this entity
         return $data['cartridges_alert_repeat'];
      }
   }

function getTabNameForItem(CommonGLPI $item, $withtemplate = 0) {

if (!$withtemplate && self::canView()) {
         $nb = 0;
         switch ($item->getType()) {
            case 'Printer' :
               if ($_SESSION['glpishow_count_on_tabs']) {
                  $nb = self::countForPrinter($item);
               }
               return self::createTabEntry(self::getTypeName(Session::getPluralNumber()), $nb);

case 'CartridgeItem' :
               if ($_SESSION['glpishow_count_on_tabs']) {
                  $nb = self::countForCartridgeItem($item);
               }
               return self::createTabEntry(self::getTypeName(Session::getPluralNumber()), $nb);
         }
      }
      return '';
   }

static function countForCartridgeItem(CartridgeItem $item) {

return countElementsInTable(['glpi_cartridges'], ['glpi_cartridges.cartridgeitems_id' => $item->getField('id')]);
   }

/**
    * @param $item Printer object
   **/
   static function countForPrinter(Printer $item) {

return countElementsInTable(['glpi_cartridges'], ['glpi_cartridges.printers_id' => $item->getField('id')]);
   }

static function displayTabContentForItem(CommonGLPI $item, $tabnum = 1, $withtemplate = 0) {

switch ($item->getType()) {
         case 'Printer' :
            self::showForPrinter($item);
            self::showForPrinter($item, 1);
            return true;

case 'CartridgeItem' :
            self::showAddForm($item);
            self::showForCartridgeItem($item);
            self::showForCartridgeItem($item, 1);
            return true;
      }
   }

function getRights($interface = 'central') {
      $ci = new CartridgeItem();
      return $ci->getRights($interface);
   }

}