cgenericdic.class.php

Go to the documentation of this file.

<?php
/* Copyright (C) 2007-2012  Laurent Destailleur     <eldy@users.sourceforge.net>
 * Copyright (C) 2014-2016  Juanjo Menent           <jmenent@2byte.es>
 * Copyright (C) 2016       Florian Henry           <florian.henry@atm-consulting.fr>
 * Copyright (C) 2015       Raphaël Doursenaud      <rdoursenaud@gpcsolutions.fr>
 * Copyright (C) 2024-2025  Frédéric France         <frederic.france@free.fr>
 * Copyright (C) 2024   MDW           <mdeweerd@users.noreply.github.com>
 *
 * 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 3 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, see <https://www.gnu.org/licenses/>.
 */
 
// Put here all includes required by your class file
require_once DOL_DOCUMENT_ROOT.'/core/class/commondict.class.php';
 
class CGenericDic extends CommonDict
{
  public $element = 'undefined';  // Will be defined into constructor
 
  public $table_element = 'undefined';  // Will be defined into constructor
 
  public $lines = array();
 
  public $code;
 
  public $label;
 
  public function __construct(DoliDB $db)
  {
    $this->db = $db;
 
    // Don't forget to set this->element and this->table_element after the construction
  }
 
  public function create(User $user, $notrigger = 0)
  {
    dol_syslog(__METHOD__, LOG_DEBUG);
 
    $fieldlabel = 'label';
    if ($this->table_element == 'c_stcomm') {
      $fieldlabel = 'libelle';
    } elseif ($this->table_element == 'c_type_fees') {
      $fieldrowid = 'id';
    }
 
    $error = 0;
 
    // Clean parameters
 
    if (isset($this->code)) {
      $this->code = trim($this->code);
    }
    if (isset($this->label)) {
      $this->label = trim($this->label);
    }
    if (isset($this->active)) {
      $this->active = (int) $this->active;
    }
 
    // Insert request
    $sql = 'INSERT INTO '.$this->db->prefix().$this->table_element.'(';
    $sql .= 'code,';
    $sql .= $fieldlabel;
    $sql .= 'active';
    $sql .= ') VALUES (';
    $sql .= ' '.(!isset($this->code) ? 'NULL' : "'".$this->db->escape($this->code)."'").',';
    $sql .= ' '.(!isset($this->label) ? 'NULL' : "'".$this->db->escape($this->label)."'").',';
    $sql .= ' '.(!isset($this->active) ? 'NULL' : $this->active);
    $sql .= ')';
 
    $this->db->begin();
 
    $resql = $this->db->query($sql);
    if (!$resql) {
      $error++;
      $this->errors[] = 'Error '.$this->db->lasterror();
      dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
    }
 
    if (!$error) {
      $this->id = $this->db->last_insert_id($this->db->prefix().$this->table_element);
 
      // Uncomment this and change CTYPERESOURCE to your own tag if you
      // want this action to call a trigger.
      //if (!$notrigger) {
 
      //  // Call triggers
      //  $result=$this->call_trigger('CTYPERESOURCE_CREATE',$user);
      //  if ($result < 0) $error++;
      //  // End call triggers
      //}
    }
 
    // Commit or rollback
    if ($error) {
      $this->db->rollback();
 
      return -1 * $error;
    } else {
      $this->db->commit();
 
      return $this->id;
    }
  }
 
  public function fetch($id, $code = '', $label = '')
  {
    dol_syslog(__METHOD__, LOG_DEBUG);
 
    $fieldrowid = 'rowid';
    $fieldlabel = 'label';
    if ($this->table_element == 'c_stcomm') {
      $fieldrowid = 'id';
      $fieldlabel = 'libelle';
    } elseif ($this->table_element == 'c_type_fees') {
      $fieldrowid = 'id';
    }
 
    $sql = "SELECT";
    $sql .= " ".$this->db->sanitize("t.".$fieldrowid).",";
    $sql .= " t.code,";
    $sql .= " ".$this->db->sanitize("t.".$fieldlabel)." as label,";
    $sql .= " t.active";
    $sql .= " FROM ".$this->db->prefix().$this->table_element." as t";
    if ($id) {
      $sql .= " WHERE ".$this->db->sanitize("t.".$fieldrowid)." = ".((int) $id);
    } elseif ($code) {
      $sql .= " WHERE t.code = '".$this->db->escape($code)."'";
    } elseif ($label) {
      $sql .= " WHERE t.label = '".$this->db->escape($label)."'";
    }
 
    $resql = $this->db->query($sql);
    if ($resql) {
      $numrows = $this->db->num_rows($resql);
      if ($numrows) {
        $obj = $this->db->fetch_object($resql);
 
        $this->id = $obj->$fieldrowid;
 
        $this->code = $obj->code;
        $this->label = $obj->label;
        $this->active = $obj->active;
      }
 
      // Retrieve all extrafields for invoice
      // fetch optionals attributes and labels
      // $this->fetch_optionals();
 
      // $this->fetch_lines();
 
      $this->db->free($resql);
 
      if ($numrows) {
        return 1;
      } else {
        return 0;
      }
    } else {
      $this->errors[] = 'Error '.$this->db->lasterror();
      dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
 
      return -1;
    }
  }
 
  public function fetchAll($sortorder = '', $sortfield = '', $limit = 0, $offset = 0, $filter = '', $filtermode = 'AND')
  {
    dol_syslog(__METHOD__, LOG_DEBUG);
 
    $fieldrowid = 'rowid';
    $fieldlabel = 'label';
    if ($this->table_element == 'c_stcomm') {
      $fieldrowid = 'id';
      $fieldlabel = 'libelle';
    } elseif ($this->table_element == 'c_type_fees') {
      $fieldrowid = 'id';
    }
 
    $sql = "SELECT";
    $sql .= " t.".$this->db->sanitize($fieldrowid).",";
    $sql .= " t.code,";
    $sql .= " t.".$this->db->sanitize($fieldlabel)." as label,";
    $sql .= " t.active";
    $sql .= " FROM ".$this->db->prefix().$this->table_element." as t";
 
    // Manage filter
    if (is_array($filter)) {
      $sqlwhere = array();
      if (count($filter) > 0) {
        foreach ($filter as $key => $value) {
          $sqlwhere[] = $this->db->sanitize($key)." LIKE '%".$this->db->escape($value)."%'";
        }
      }
      if (count($sqlwhere) > 0) {
        $sql .= " WHERE ".implode(' '.$this->db->escape($filtermode).' ', $sqlwhere);
      }
 
      $filter = '';
    }
 
    // Manage filter
    $errormessage = '';
    $sql .= forgeSQLFromUniversalSearchCriteria($filter, $errormessage);
    if ($errormessage) {
      $this->errors[] = $errormessage;
      dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
      return -1;
    }
 
    if (!empty($sortfield)) {
      $sql .= $this->db->order($sortfield, $sortorder);
    }
    if (!empty($limit)) {
      $sql .= $this->db->plimit($limit, $offset);
    }
 
    $resql = $this->db->query($sql);
    if ($resql) {
      $num = $this->db->num_rows($resql);
 
      while ($obj = $this->db->fetch_object($resql)) {
        $line = new self($this->db);
 
        $line->id = $obj->$fieldrowid;
 
        $line->code = $obj->code;
        $line->label = $obj->label;
        $line->active = $obj->active;
      }
      $this->db->free($resql);
 
      return $num;
    } else {
      $this->errors[] = 'Error '.$this->db->lasterror();
      dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
 
      return -1;
    }
  }
 
  public function update(User $user, $notrigger = 0)
  {
    $error = 0;
 
    dol_syslog(__METHOD__, LOG_DEBUG);
 
    $fieldrowid = 'rowid';
    $fieldlabel = 'label';
    if ($this->table_element == 'c_stcomm') {
      $fieldrowid = 'id';
      $fieldlabel = 'libelle';
    } elseif ($this->table_element == 'c_type_fees') {
      $fieldrowid = 'id';
    }
 
    // Clean parameters
 
    if (isset($this->code)) {
      $this->code = trim($this->code);
    }
    if (isset($this->label)) {
      $this->label = trim($this->label);
    }
    if (isset($this->active)) {
      $this->active = (int) $this->active;
    }
 
    // Check parameters
    // Put here code to add a control on parameters values
 
    // Update request
    $sql = "UPDATE ".$this->db->prefix().$this->table_element.' SET';
    $sql .= " code = ".(isset($this->code) ? "'".$this->db->escape($this->code)."'" : "null").',';
    $sql .= " ".$this->db->sanitize($fieldlabel)." = ".(isset($this->label) ? "'".$this->db->escape($this->label)."'" : "null").',';
    $sql .= " active = ".(isset($this->active) ? $this->active : "null");
    $sql .= " WHERE ".$this->db->sanitize($fieldrowid)." = ".((int) $this->id);
 
    $this->db->begin();
 
    $resql = $this->db->query($sql);
    if (!$resql) {
      $error++;
      $this->errors[] = 'Error '.$this->db->lasterror();
      dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
    }
 
    // Uncomment this and change CTYPERESOURCE to your own tag if you
    // want this action calls a trigger.
    //if (!$error && !$notrigger) {
 
    //  // Call triggers
    //  $result=$this->call_trigger('CTYPERESOURCE_MODIFY',$user);
    //  if ($result < 0) { $error++; //Do also what you must do to rollback action if trigger fail}
    //  // End call triggers
    //}
 
    // Commit or rollback
    if ($error) {
      $this->db->rollback();
 
      return -1 * $error;
    } else {
      $this->db->commit();
 
      return 1;
    }
  }
 
  public function delete(User $user, $notrigger = 0)
  {
    dol_syslog(__METHOD__, LOG_DEBUG);
 
    $fieldrowid = 'rowid';
 
    $error = 0;
 
    $this->db->begin();
 
    // Uncomment this and change CTYPERESOURCE to your own tag if you
    // want this action calls a trigger.
    //if (!$error && !$notrigger) {
 
    //  // Call triggers
    //  $result=$this->call_trigger('CTYPERESOURCE_DELETE',$user);
    //  if ($result < 0) { $error++; //Do also what you must do to rollback action if trigger fail}
    //  // End call triggers
    //}
 
    // If you need to delete child tables to, you can insert them here
 
    if (!$error) {
      $sql = "DELETE FROM ".$this->db->prefix().$this->table_element;
      $sql .= " WHERE ".$this->db->sanitize($fieldrowid)." = ".((int) $this->id);
 
      $resql = $this->db->query($sql);
      if (!$resql) {
        $error++;
        $this->errors[] = 'Error '.$this->db->lasterror();
        dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
      }
    }
 
    // Commit or rollback
    if ($error) {
      $this->db->rollback();
 
      return -1 * $error;
    } else {
      $this->db->commit();
 
      return 1;
    }
  }
 
  public function createFromClone(User $user, $fromid)
  {
    dol_syslog(__METHOD__, LOG_DEBUG);
 
    $error = 0;
    $object = new CGenericDic($this->db);
 
    $this->db->begin();
 
    // Load source object
    $object->fetch($fromid);
    // Reset object
    $object->id = 0;
 
    // Clear fields
    // ...
 
    // Create clone
    $object->context['createfromclone'] = 'createfromclone';
    $result = $object->create($user);
 
    // Other options
    if ($result < 0) {
      $error++;
      $this->errors = $object->errors;
      dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
    }
 
    unset($object->context['createfromclone']);
 
    // End
    if (!$error) {
      $this->db->commit();
 
      return $object->id;
    } else {
      $this->db->rollback();
 
      return -1;
    }
  }
 
  public function initAsSpecimen()
  {
    $this->id = 0;
 
    $this->code = 'CODE';
    $this->label = 'Label';
    $this->active = 1;
 
    return 1;
  }
}