entrepot.class.php

Go to the documentation of this file.

<?php
/* Copyright (C) 2003-2006 Rodolphe Quiedeville <rodolphe@quiedeville.org>
 * Copyright (C) 2004-2010 Laurent Destailleur  <eldy@users.sourceforge.net>
 * Copyright (C) 2005-2008 Regis Houssin        <regis.houssin@inodbox.com>
 * Copyright (C) 2011    Juanjo Menent        <jmenent@2byte.es>
 * Copyright (C) 2016    Francis Appels       <francis.appels@yahoo.com>
 * Copyright (C) 2019-2020  Frédéric France         <frederic.france@netlogic.fr>
 *
 * 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/>.
 */

require_once DOL_DOCUMENT_ROOT.'/core/class/commonobject.class.php';


class Entrepot extends CommonObject
{
  public $element = 'stock';

  public $table_element = 'entrepot';

  public $picto = 'stock';

  public $ismultientitymanaged = 1;

  public $libelle;

  public $label;

  public $description;

  public $statut;

  public $lieu;

  public $address;

  public $zip;

  public $town;

  public $phone;

  public $fax;

  public $fk_parent;

  public $statuts = array();

  public $fields = array(
    'rowid' =>array('type'=>'integer', 'label'=>'ID', 'enabled'=>1, 'visible'=>0, 'notnull'=>1, 'position'=>10),
    'entity' =>array('type'=>'integer', 'label'=>'Entity', 'enabled'=>1, 'visible'=>0, 'default'=>1, 'notnull'=>1, 'index'=>1, 'position'=>15),
    'ref' =>array('type'=>'varchar(255)', 'label'=>'Ref', 'enabled'=>1, 'visible'=>1, 'showoncombobox'=>1, 'position'=>25, 'searchall'=>1),
    'entity' =>array('type'=>'integer', 'label'=>'Entity', 'enabled'=>1, 'visible'=>0, 'notnull'=>1, 'position'=>30),
    'description' =>array('type'=>'text', 'label'=>'Description', 'enabled'=>1, 'visible'=>-2, 'position'=>35, 'searchall'=>1),
    'lieu' =>array('type'=>'varchar(64)', 'label'=>'LocationSummary', 'enabled'=>1, 'visible'=>1, 'position'=>40, 'showoncombobox'=>1, 'searchall'=>1),
    'fk_parent' =>array('type'=>'integer:Entrepot:product/stock/class/entrepot.class.php:1:statut=1 AND entity IN (__SHARED_ENTITIES__)', 'label'=>'ParentWarehouse', 'enabled'=>1, 'visible'=>-2, 'position'=>41),
    'address' =>array('type'=>'varchar(255)', 'label'=>'Address', 'enabled'=>1, 'visible'=>-2, 'position'=>45, 'searchall'=>1),
    'zip' =>array('type'=>'varchar(10)', 'label'=>'Zip', 'enabled'=>1, 'visible'=>-2, 'position'=>50, 'searchall'=>1),
    'town' =>array('type'=>'varchar(50)', 'label'=>'Town', 'enabled'=>1, 'visible'=>-2, 'position'=>55, 'searchall'=>1),
    'fk_departement' =>array('type'=>'sellist:c_departements:label:rowid::active=1', 'label'=>'State', 'enabled'=>1, 'visible'=>0, 'position'=>60),
    'fk_pays' =>array('type'=>'sellist:c_country:label:rowid::active=1', 'label'=>'Country', 'enabled'=>1, 'visible'=>-2, 'position'=>65),
    'phone' =>array('type'=>'varchar(20)', 'label'=>'Phone', 'enabled'=>1, 'visible'=>-2, 'position'=>70, 'searchall'=>1),
    'fax' =>array('type'=>'varchar(20)', 'label'=>'Fax', 'enabled'=>1, 'visible'=>-2, 'position'=>75, 'searchall'=>1),
    //'fk_user_author' =>array('type'=>'integer', 'label'=>'Fk user author', 'enabled'=>1, 'visible'=>-2, 'position'=>82),
    'datec' =>array('type'=>'datetime', 'label'=>'DateCreation', 'enabled'=>1, 'visible'=>-2, 'position'=>300),
    'tms' =>array('type'=>'timestamp', 'label'=>'DateModification', 'enabled'=>1, 'visible'=>-2, 'notnull'=>1, 'position'=>301),
    //'import_key' =>array('type'=>'varchar(14)', 'label'=>'ImportId', 'enabled'=>1, 'visible'=>-2, 'position'=>1000),
    //'model_pdf' =>array('type'=>'varchar(255)', 'label'=>'ModelPDF', 'enabled'=>1, 'visible'=>0, 'position'=>1010),
    'statut' =>array('type'=>'tinyint(4)', 'label'=>'Status', 'enabled'=>1, 'visible'=>1, 'position'=>500),
  );

  const STATUS_CLOSED = 0;

  const STATUS_OPEN_ALL = 1;

  const STATUS_OPEN_INTERNAL = 2;


  public function __construct($db)
  {
    global $conf;
    $this->db = $db;

    $this->statuts[self::STATUS_CLOSED] = 'Closed2';
    if (!empty($conf->global->ENTREPOT_EXTRA_STATUS)) {
      $this->statuts[self::STATUS_OPEN_ALL] = 'OpenAll';
      $this->statuts[self::STATUS_OPEN_INTERNAL] = 'OpenInternal';
    } else {
      $this->statuts[self::STATUS_OPEN_ALL] = 'Opened';
    }
  }

  public function create($user)
  {
    global $conf;

    $error = 0;

    $this->label = trim(!empty($this->label) ? $this->label : $this->libelle);

    // Error if label not defined
    if ($this->label == '') {
      $this->error = "ErrorFieldRequired";
      return 0;
    }

    $now = dol_now();

    $this->db->begin();

    $sql = "INSERT INTO ".MAIN_DB_PREFIX."entrepot (ref, entity, datec, fk_user_author, fk_parent)";
    $sql .= " VALUES ('".$this->db->escape($this->label)."', ".$conf->entity.", '".$this->db->idate($now)."', ".$user->id.", ".($this->fk_parent > 0 ? $this->fk_parent : "NULL").")";

    dol_syslog(get_class($this)."::create", LOG_DEBUG);
    $result = $this->db->query($sql);
    if ($result)
    {
      $id = $this->db->last_insert_id(MAIN_DB_PREFIX."entrepot");
      if ($id > 0)
      {
        $this->id = $id;

        if (!$error)
        {
          $result = $this->update($id, $user);
          if ($result <= 0)
          {
            $error++;
          }
        }

        // Actions on extra fields
        if (!$error)
        {
          if (!$error)
          {
            $result = $this->insertExtraFields();
            if ($result < 0)
            {
              $error++;
            }
          }
        }

        if (!$error)
        {
          $this->db->commit();
          return $id;
        } else {
          dol_syslog(get_class($this)."::create return -3");
          $this->db->rollback();
          return -3;
        }
      } else {
        $this->error = "Failed to get insert id";
        dol_syslog(get_class($this)."::create return -2");
        return -2;
      }
    } else {
      $this->error = $this->db->error();
      dol_syslog(get_class($this)."::create Error ".$this->db->error());
      $this->db->rollback();
      return -1;
    }
  }

  public function update($id, $user)
  {
    global $conf;

    $error = 0;

    if (empty($id)) $id = $this->id;
    if (empty($this->label)) $this->label = $this->libelle; // For backward compatibility

    // Check if new parent is already a child of current warehouse
    if (!empty($this->fk_parent))
    {
      $TChildWarehouses = array($id);
      $TChildWarehouses = $this->get_children_warehouses($this->id, $TChildWarehouses);
      if (in_array($this->fk_parent, $TChildWarehouses))
      {
        $this->error = 'ErrorCannotAddThisParentWarehouse';
        return -2;
      }
    }

    $this->label = trim(!empty($this->label) ? $this->label : $this->libelle);

    $this->description = trim($this->description);

    $this->lieu = trim($this->lieu);

    $this->address = trim($this->address);
    $this->zip = trim($this->zip);
    $this->town = trim($this->town);
    $this->country_id = ($this->country_id > 0 ? $this->country_id : 0);

    $sql = "UPDATE ".MAIN_DB_PREFIX."entrepot ";
    $sql .= " SET ref = '".$this->db->escape($this->label)."'";
    $sql .= ", fk_parent = ".(($this->fk_parent > 0) ? $this->fk_parent : "NULL");
    $sql .= ", description = '".$this->db->escape($this->description)."'";
    $sql .= ", statut = ".$this->statut;
    $sql .= ", lieu = '".$this->db->escape($this->lieu)."'";
    $sql .= ", address = '".$this->db->escape($this->address)."'";
    $sql .= ", zip = '".$this->db->escape($this->zip)."'";
    $sql .= ", town = '".$this->db->escape($this->town)."'";
    $sql .= ", fk_pays = ".$this->country_id;
    $sql .= ", phone = '".$this->db->escape($this->phone)."'";
    $sql .= ", fax = '".$this->db->escape($this->fax)."'";
    $sql .= " WHERE rowid = ".$id;

    $this->db->begin();

    dol_syslog(get_class($this)."::update", LOG_DEBUG);
    $resql = $this->db->query($sql);

    if (!$resql) {
      $error++;
      $this->errors[] = "Error ".$this->db->lasterror();
    }

    if (!$error) {
      $result = $this->insertExtraFields();
      if ($result < 0)
      {
        $error++;
      }
    }

    if (!$error) {
      $this->db->commit();
      return 1;
    } else {
      $this->db->rollback();
      $this->error = $this->db->lasterror();
      return -1;
    }
  }


  public function delete($user, $notrigger = 0)
  {
    global $conf;

    $error = 0;

    dol_syslog(get_class($this)."::delete id=".$this->id, LOG_DEBUG);

    $this->db->begin();

    if (!$error && empty($notrigger))
    {
      // Call trigger
      $result = $this->call_trigger('WAREHOUSE_DELETE', $user);
      if ($result < 0) { $error++; }
      // End call triggers
    }

    $elements = array('stock_mouvement', 'product_stock', 'product_warehouse_properties');
    foreach ($elements as $table)
    {
      if (!$error)
      {
        $sql = "DELETE FROM ".MAIN_DB_PREFIX.$table;
        $sql .= " WHERE fk_entrepot = ".$this->id;

        $result = $this->db->query($sql);
        if (!$result)
        {
          $error++;
          $this->errors[] = $this->db->lasterror();
        }
      }
    }

    // Removed extrafields
    if (!$error)
    {
      if (!$error)
      {
        $result = $this->deleteExtraFields();
        if ($result < 0)
        {
          $error++;
          dol_syslog(get_class($this)."::delete Error ".$this->error, LOG_ERR);
        }
      }
    }

    if (!$error)
    {
      $sql = "DELETE FROM ".MAIN_DB_PREFIX."entrepot";
      $sql .= " WHERE rowid = ".$this->id;
      $resql1 = $this->db->query($sql);
      if (!$resql1)
      {
        $error++;
        $this->errors[] = $this->db->lasterror();
        dol_syslog(get_class($this)."::delete Error ".$this->db->lasterror(), LOG_ERR);
      }
    }

    if (!$error)
    {
      // Update denormalized fields because we change content of produt_stock. Warning: Do not use "SET p.stock", does not works with pgsql
      $sql = "UPDATE ".MAIN_DB_PREFIX."product as p SET stock = (SELECT SUM(ps.reel) FROM ".MAIN_DB_PREFIX."product_stock as ps WHERE ps.fk_product = p.rowid)";
      $resql2 = $this->db->query($sql);
      if (!$resql2)
      {
        $error++;
        $this->errors[] = $this->db->lasterror();
        dol_syslog(get_class($this)."::delete Error ".$this->db->lasterror(), LOG_ERR);
      }
    }

    if (!$error)
    {
      $this->db->commit();
      return 1;
    } else {
      $this->db->rollback();
      return -1;
    }
  }


  public function fetch($id, $ref = '')
  {
    global $conf;

    dol_syslog(get_class($this)."::fetch id=".$id." ref=".$ref);

    // Check parameters
    if (!$id && !$ref)
    {
      $this->error = 'ErrorWrongParameters';
      dol_syslog(get_class($this)."::fetch ".$this->error);
      return -1;
    }

    $sql  = "SELECT rowid, entity, fk_parent, ref as label, description, statut, lieu, address, zip, town, fk_pays as country_id, phone, fax,";
    $sql .= " model_pdf, import_key";
    $sql .= " FROM ".MAIN_DB_PREFIX."entrepot";
    if ($id)
    {
      $sql .= " WHERE rowid = '".$id."'";
    } else {
      $sql .= " WHERE entity = ".$conf->entity;
      if ($ref) $sql .= " AND ref = '".$this->db->escape($ref)."'";
    }

    $result = $this->db->query($sql);
    if ($result)
    {
      if ($this->db->num_rows($result) > 0)
      {
        $obj = $this->db->fetch_object($result);

        $this->id             = $obj->rowid;
        $this->entity         = $obj->entity;
        $this->fk_parent      = $obj->fk_parent;
        $this->ref            = $obj->label;
        $this->label          = $obj->label;
        $this->libelle        = $obj->label; // deprecated
        $this->description    = $obj->description;
        $this->statut         = $obj->statut;
        $this->lieu           = $obj->lieu;
        $this->address        = $obj->address;
        $this->zip            = $obj->zip;
        $this->town           = $obj->town;
        $this->country_id     = $obj->country_id;
        $this->phone          = $obj->phone;
        $this->fax            = $obj->fax;

        $this->model_pdf      = $obj->model_pdf;
        $this->import_key     = $obj->import_key;

        // Retrieve all extrafield
        // fetch optionals attributes and labels
        $this->fetch_optionals();

        include_once DOL_DOCUMENT_ROOT.'/core/lib/company.lib.php';
        $tmp = getCountry($this->country_id, 'all');
        $this->country = $tmp['label'];
        $this->country_code = $tmp['code'];

        return 1;
      } else {
        $this->error = "Record Not Found";
        return 0;
      }
    } else {
      $this->error = $this->db->error();
      return -1;
    }
  }


  public function info($id)
  {
    $sql = "SELECT e.rowid, e.datec, e.tms as datem, e.fk_user_author";
    $sql .= " FROM ".MAIN_DB_PREFIX."entrepot as e";
    $sql .= " WHERE e.rowid = ".$id;

    dol_syslog(get_class($this)."::info", LOG_DEBUG);
    $result = $this->db->query($sql);
    if ($result)
    {
      if ($this->db->num_rows($result))
      {
        $obj = $this->db->fetch_object($result);

        $this->id = $obj->rowid;

        if ($obj->fk_user_author) {
          $cuser = new User($this->db);
          $cuser->fetch($obj->fk_user_author);
          $this->user_creation = $cuser;
        }

        if ($obj->fk_user_valid) {
          $vuser = new User($this->db);
          $vuser->fetch($obj->fk_user_valid);
          $this->user_validation = $vuser;
        }

        $this->date_creation     = $this->db->jdate($obj->datec);
        $this->date_modification = $this->db->jdate($obj->datem);
      }

      $this->db->free($result);
    } else {
      dol_print_error($this->db);
    }
  }


  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function list_array($status = 1)
  {
    // phpcs:enable
    $liste = array();

    $sql = "SELECT rowid, ref as label";
    $sql .= " FROM ".MAIN_DB_PREFIX."entrepot";
    $sql .= " WHERE entity IN (".getEntity('stock').")";
    $sql .= " AND statut = ".$status;

    $result = $this->db->query($sql);
    $i = 0;
    $num = $this->db->num_rows($result);
    if ($result)
    {
      while ($i < $num)
      {
        $row = $this->db->fetch_row($result);
        $liste[$row[0]] = $row[1];
        $i++;
      }
      $this->db->free($result);
    }
    return $liste;
  }

  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function nb_different_products()
  {
    // phpcs:enable
    $ret = array();

    $sql = "SELECT count(distinct p.rowid) as nb";
    $sql .= " FROM ".MAIN_DB_PREFIX."product_stock as ps";
    $sql .= ", ".MAIN_DB_PREFIX."product as p";
    $sql .= " WHERE ps.fk_entrepot = ".$this->id;
    $sql .= " AND ps.fk_product = p.rowid";

    //print $sql;
    $result = $this->db->query($sql);
    if ($result)
    {
      $obj = $this->db->fetch_object($result);
      $ret['nb'] = $obj->nb;
      $this->db->free($result);
    } else {
      $this->error = $this->db->lasterror();
      return -1;
    }

    return $ret;
  }

  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function nb_products()
  {
    // phpcs:enable
    $ret = array();

    $sql = "SELECT sum(ps.reel) as nb, sum(ps.reel * p.pmp) as value";
    $sql .= " FROM ".MAIN_DB_PREFIX."product_stock as ps";
    $sql .= ", ".MAIN_DB_PREFIX."product as p";
    $sql .= " WHERE ps.fk_entrepot = ".$this->id;
    $sql .= " AND ps.fk_product = p.rowid";

    //print $sql;
    $result = $this->db->query($sql);
    if ($result)
    {
      $obj = $this->db->fetch_object($result);
      $ret['nb'] = $obj->nb;
      $ret['value'] = $obj->value;
      $this->db->free($result);
    } else {
      $this->error = $this->db->lasterror();
      return -1;
    }

    return $ret;
  }

  public function getLibStatut($mode = 0)
  {
    return $this->LibStatut($this->statut, $mode);
  }

  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function LibStatut($status, $mode = 0)
  {
    // phpcs:enable
    global $langs;

    $statusType = 'status5';
    if ($status > 0) $statusType = 'status4';

    $langs->load('stocks');
    $label = $langs->trans($this->statuts[$status]);
    $labelshort = $langs->trans($this->statuts[$status]);

    return dolGetStatus($label, $labelshort, '', $statusType, $mode);
  }


  public function getNomUrl($withpicto = 0, $option = '', $showfullpath = 0, $notooltip = 0)
  {
    global $conf, $langs, $hookmanager;
    $langs->load("stocks");

    if (!empty($conf->dol_no_mouse_hover)) $notooltip = 1; // Force disable tooltips

    if (!empty($conf->global->MAIN_OPTIMIZEFORTEXTBROWSER) && $withpicto) $withpicto = 0;

    $result = '';

    $label = img_picto('', $this->picto).' <u class="paddingrightonly">'.$langs->trans("Warehouse").'</u>';
    if (isset($this->statut)) {
      $label .= ' '.$this->getLibStatut(5);
    }
    $label .= '<br><b>'.$langs->trans('Ref').':</b> '.(empty($this->ref) ? (empty($this->label) ? $this->libelle : $this->label) : $this->ref);
    if (!empty($this->lieu)) {
      $label .= '<br><b>'.$langs->trans('LocationSummary').':</b> '.$this->lieu;
    }

    $url = DOL_URL_ROOT.'/product/stock/card.php?id='.$this->id;

    $linkclose = '';
    if (empty($notooltip))
    {
      if (!empty($conf->global->MAIN_OPTIMIZEFORTEXTBROWSER))
      {
        $label = $langs->trans("Warehouse");
        $linkclose .= ' alt="'.dol_escape_htmltag($label, 1).'"';
      }
      $linkclose .= ' title="'.dol_escape_htmltag($label, 1).'"';
      $linkclose .= ' class="classfortooltip"';
    }

    $linkstart = '<a href="'.$url.'"';
    $linkstart .= $linkclose.'>';
    $linkend = '</a>';

    $result .= $linkstart;
    if ($withpicto) $result .= img_object(($notooltip ? '' : $label), ($this->picto ? $this->picto : 'generic'), ($notooltip ? (($withpicto != 2) ? 'class="paddingright"' : '') : 'class="'.(($withpicto != 2) ? 'paddingright ' : '').'classfortooltip"'), 0, 0, $notooltip ? 0 : 1);
    if ($withpicto != 2) $result .= (($showfullpath || !empty($conf->global->STOCK_ALWAYS_SHOW_FULL_ARBO)) ? $this->get_full_arbo() : (empty($this->label) ? $this->libelle : $this->label));
    $result .= $linkend;

    global $action;
    $hookmanager->initHooks(array('warehousedao'));
    $parameters = array('id'=>$this->id, 'getnomurl'=>$result, 'withpicto' => $withpicto, 'option' => $option, 'showfullpath' => $showfullpath, 'notooltip'=> $notooltip);
    $reshook = $hookmanager->executeHooks('getNomUrl', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
    if ($reshook > 0) {
      $result = $hookmanager->resPrint;
    } else {
      $result .= $hookmanager->resPrint;
    }

    return $result;
  }

  public function initAsSpecimen()
  {
    global $user, $langs, $conf, $mysoc;

    $now = dol_now();

    // Initialize parameters
    $this->id = 0;
    $this->label = 'WAREHOUSE SPECIMEN';
    $this->description = 'WAREHOUSE SPECIMEN '.dol_print_date($now, 'dayhourlog');
    $this->statut = 1;
    $this->specimen = 1;

    $this->lieu = 'Location test';
    $this->address = '21 jump street';
    $this->zip = '99999';
    $this->town = 'MyTown';
    $this->country_id = 1;
    $this->country_code = 'FR';
  }

  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function get_full_arbo()
  {
    // phpcs:enable
    global $user, $langs, $conf;

    $TArbo = array(empty($this->label) ? $this->libelle : $this->label);

    $protection = 100; // We limit depth of warehouses to 100

    $warehousetmp = new Entrepot($this->db);

    $parentid = $this->fk_parent; // If parent_id not defined on current object, we do not start consecutive searches of parents
    $i = 0;
    while ($parentid > 0 && $i < $protection)
    {
      $sql = 'SELECT fk_parent FROM '.MAIN_DB_PREFIX.'entrepot WHERE rowid = '.$parentid;
      $resql = $this->db->query($sql);
      if ($resql)
      {
        $objarbo = $this->db->fetch_object($resql);
        if ($objarbo)
        {
          $warehousetmp->fetch($parentid);
          $TArbo[] = $warehousetmp->label;
          $parentid = $objarbo->fk_parent;
        } else break;
      } else dol_print_error($this->db);

      $i++;
    }

    return implode(' >> ', array_reverse($TArbo));
  }

  // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
  public function get_children_warehouses($id, &$TChildWarehouses)
  {
    // phpcs:enable

    $sql = 'SELECT rowid
        FROM '.MAIN_DB_PREFIX.'entrepot
        WHERE fk_parent = '.$id;

    $resql = $this->db->query($sql);
    if ($resql) {
      while ($res = $this->db->fetch_object($resql)) {
        $TChildWarehouses[] = $res->rowid;
        $this->get_children_warehouses($res->rowid, $TChildWarehouses);
      }
    }

    return $TChildWarehouses;
  }

  public function generateDocument($modele, $outputlangs = '', $hidedetails = 0, $hidedesc = 0, $hideref = 0)
  {
    global $conf, $user, $langs;

    $langs->load("stocks");
    $outputlangs->load("products");

    if (!dol_strlen($modele)) {
      $modele = 'standard';

      if ($this->model_pdf) {
        $modele = $this->model_pdf;
      } elseif (!empty($conf->global->STOCK_ADDON_PDF)) {
        $modele = $conf->global->STOCK_ADDON_PDF;
      }
    }

    $modelpath = "core/modules/stock/doc/";

    return $this->commonGenerateDocument($modelpath, $modele, $outputlangs, $hidedetails, $hidedesc, $hideref);
  }

  public function setCategories($categories)
  {
    $type_categ = Categorie::TYPE_WAREHOUSE;

    // Handle single category
    if (!is_array($categories)) {
      $categories = array($categories);
    }

    // Get current categories
    require_once DOL_DOCUMENT_ROOT.'/categories/class/categorie.class.php';
    $c = new Categorie($this->db);
    $existing = $c->containing($this->id, $type_categ, 'id');

    // Diff
    if (is_array($existing)) {
      $to_del = array_diff($existing, $categories);
      $to_add = array_diff($categories, $existing);
    } else {
      $to_del = array(); // Nothing to delete
      $to_add = $categories;
    }

    // Process
    foreach ($to_del as $del) {
      if ($c->fetch($del) > 0) {
        $c->del_type($this, $type_categ);
      }
    }
    foreach ($to_add as $add) {
      if ($c->fetch($add) > 0) {
        $c->add_type($this, $type_categ);
      }
    }

    return;
  }
}