dolibarr 24.0.0-beta
categorie.class.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2005 Matthieu Valleton <mv@seeschloss.org>
3 * Copyright (C) 2005 Davoleau Brice <brice.davoleau@gmail.com>
4 * Copyright (C) 2005 Rodolphe Quiedeville <rodolphe@quiedeville.org>
5 * Copyright (C) 2006-2012 Regis Houssin <regis.houssin@inodbox.com>
6 * Copyright (C) 2006-2012 Laurent Destailleur <eldy@users.sourceforge.net>
7 * Copyright (C) 2007 Patrick Raguin <patrick.raguin@gmail.com>
8 * Copyright (C) 2013-2016 Juanjo Menent <jmenent@2byte.es>
9 * Copyright (C) 2013-2018 Philippe Grand <philippe.grand@atoo-net.com>
10 * Copyright (C) 2015 Marcos García <marcosgdf@gmail.com>
11 * Copyright (C) 2015 Raphaël Doursenaud <rdoursenaud@gpcsolutions.fr>
12 * Copyright (C) 2016-2025 Charlene Benke <charlene@patas-monkey.com>
13 * Copyright (C) 2018-2026 Frédéric France <frederic.france@free.fr>
14 * Copyright (C) 2022-2023 Solution Libre SAS <contact@solution-libre.fr>
15 * Copyright (C) 2023-2024 Benjamin Falière <benjamin.faliere@altairis.fr>
16 * Copyright (C) 2024-2026 MDW <mdeweerd@users.noreply.github.com>
17 * Copyright (C) 2025 Alexandre Spangaro <alexandre@inovea-conseil.com>
18 *
19 * This program is free software; you can redistribute it and/or modify
20 * it under the terms of the GNU General Public License as published by
21 * the Free Software Foundation; either version 3 of the License, or
22 * (at your option) any later version.
23 *
24 * This program is distributed in the hope that it will be useful,
25 * but WITHOUT ANY WARRANTY; without even the implied warranty of
26 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
27 * GNU General Public License for more details.
28 *
29 * You should have received a copy of the GNU General Public License
30 * along with this program. If not, see <https://www.gnu.org/licenses/>.
31 */
32
39require_once DOL_DOCUMENT_ROOT.'/core/class/commonobject.class.php';
40require_once DOL_DOCUMENT_ROOT.'/product/class/product.class.php';
41require_once DOL_DOCUMENT_ROOT.'/ticket/class/ticket.class.php';
42require_once DOL_DOCUMENT_ROOT.'/fourn/class/fournisseur.class.php';
43require_once DOL_DOCUMENT_ROOT.'/contact/class/contact.class.php';
44require_once DOL_DOCUMENT_ROOT.'/knowledgemanagement/class/knowledgerecord.class.php';
45
46
51{
52 // Categories types (we use string because we want to accept any modules/types in a future)
53 const TYPE_PRODUCT = 'product';
54 const TYPE_SUPPLIER = 'supplier';
55 const TYPE_CUSTOMER = 'customer';
56 const TYPE_MEMBER = 'member';
57 const TYPE_CONTACT = 'contact';
58 const TYPE_USER = 'user';
59 const TYPE_PROJECT = 'project';
60 const TYPE_ACCOUNT = 'bank_account';
61 const TYPE_BANK_LINE = 'bank_line';
62 const TYPE_WAREHOUSE = 'warehouse';
63 const TYPE_ACTIONCOMM = 'actioncomm';
64 const TYPE_WEBSITE_PAGE = 'website_page';
65 const TYPE_TICKET = 'ticket';
66 const TYPE_KNOWLEDGEMANAGEMENT = 'knowledgemanagement';
67 const TYPE_FICHINTER = 'fichinter';
68 const TYPE_ORDER = 'order';
69 const TYPE_INVOICE = 'invoice';
70 const TYPE_SUPPLIER_ORDER = 'supplier_order';
71 const TYPE_SUPPLIER_INVOICE = 'supplier_invoice';
72 const TYPE_SUPPLIER_PROPOSAL = 'supplier_proposal';
73 const TYPE_PROPOSAL = 'propal';
74 const TYPE_PROJECT_TASK = 'project_task';
75 const TYPE_MO = 'mo';
76
77
81 public $picto = 'category';
82
83
87 public $MAP_ID = array(
88 'product' => 0,
89 'service' => 0,
90 'supplier' => 1,
91 'customer' => 2,
92 'member' => 3,
93 'contact' => 4,
94 'bank_account' => 5,
95 'project' => 6,
96 'user' => 7,
97 'bank_line' => 8,
98 'warehouse' => 9,
99 'actioncomm' => 10,
100 'website_page' => 11,
101 'ticket' => 12,
102 'knowledgemanagement' => 13,
103 'fichinter' => 14,
104 'order' => 16,
105 'invoice' => 17,
106 'supplier_order' => 20,
107 'supplier_invoice' => 21,
108 'supplier_proposal' => 22,
109 'propal' => 23,
110 'project_task' => 24,
111 'mo' => 25,
112 );
113
119 /*
120 public static $MAP_ID_TO_CODE = array(
121 0 => 'product',
122 1 => 'supplier',
123 2 => 'customer',
124 3 => 'member',
125 4 => 'contact',
126 5 => 'bank_account',
127 6 => 'project',
128 7 => 'user',
129 8 => 'bank_line',
130 9 => 'warehouse',
131 10 => 'actioncomm',
132 11 => 'website_page',
133 12 => 'ticket',
134 13 => 'knowledgemanagement',
135 14 => 'fichinter',
136 16 => 'order',
137 17 => 'invoice',
138 20 => 'supplier_order',
139 21 => 'supplier_invoice',
140 22 => 'supplier_proposal',
141 23 => 'propal',
142 24 => 'project_task'
143 );
144 */
145
149 public $MAP_CAT_FK = array(
150 'customer' => 'soc',
151 'supplier' => 'soc',
152 'contact' => 'socpeople',
153 'bank_account' => 'account',
154 );
155
159 public $MAP_CAT_TABLE = array(
160 'customer' => 'societe',
161 'supplier' => 'fournisseur',
162 'bank_account' => 'account',
163 );
164
168 public $MAP_OBJ_CLASS = array(
169 'product' => 'Product',
170 'service' => 'Product',
171 'customer' => 'Societe',
172 'supplier' => 'Fournisseur',
173 'member' => 'Adherent',
174 'contact' => 'Contact',
175 'user' => 'User',
176 'account' => 'Account', // old for bank account
177 'bank_account' => 'Account',
178 'project' => 'Project',
179 'warehouse' => 'Entrepot',
180 'actioncomm' => 'ActionComm',
181 'website_page' => 'WebsitePage',
182 'ticket' => 'Ticket',
183 'knowledgemanagement' => 'KnowledgeRecord',
184 'fichinter' => 'Fichinter',
185 'order' => 'Commande',
186 'invoice' => 'Facture',
187 'supplier_order' => 'CommandeFournisseur',
188 'supplier_invoice' => 'FactureFournisseur',
189 'supplier_proposal' => 'SupplierProposal',
190 'propal' => 'Propal',
191 'project_task' => 'Task',
192 'mo' => 'Mo',
193 );
194
198 public static $MAP_TYPE_TITLE_AREA = array(
199 'product' => 'Products',
200 'service' => 'Services',
201 'customer' => 'ProspectsOrCustomers',
202 'supplier' => 'Suppliers',
203 'member' => 'Members',
204 'contact' => 'Contacts',
205 'user' => 'Users',
206 'account' => 'Accounts', // old for bank account
207 'bank_account' => 'BankAccounts',
208 'bank_line' => 'BankTransactions',
209 'project' => 'Projects',
210 'warehouse' => 'Warehouse',
211 'actioncomm' => 'AgendaEvents',
212 'website_page' => 'WebsitePages',
213 'ticket' => 'Tickets',
214 'knowledgemanagement' => 'KnowledgeRecords',
215 'fichinter' => 'Interventions',
216 'order' => 'Orders',
217 'invoice' => 'Invoices',
218 'supplier_order' => 'SuppliersOrders',
219 'supplier_invoice' => 'SuppliersInvoices',
220 'propal' => 'Proposals',
221 'supplier_proposal' => 'SupplierProposals',
222 'project_task' => 'Tasks',
223 'mo' => 'MOs'
224 );
225
230 public $MAP_OBJ_TABLE = array(
231 'customer' => 'societe',
232 'supplier' => 'societe',
233 'member' => 'adherent',
234 'contact' => 'socpeople',
235 'account' => 'bank_account', // old for bank account
236 'project' => 'projet',
237 'warehouse' => 'entrepot',
238 'knowledgemanagement' => 'knowledgemanagement_knowledgerecord',
239 'fichinter' => 'fichinter',
240 'order' => 'commande',
241 'invoice' => 'facture',
242 'supplier_order' => 'commande_fournisseur',
243 'supplier_invoice' => 'facture_fourn',
244 'project_task' => 'projet_task',
245 'mo' => 'mrp_mo'
246 );
247
251 public $element = 'category';
252
256 public $table_element = 'categorie';
257
261 public $fk_parent;
262
266 public $label;
267
271 public $description;
272
276 public $color;
277
281 public $position;
282
286 public $visible;
287
291 public $socid;
292
316 public $type;
317
321 public $cats = array();
322
326 public $motherof = array();
327
331 public $childs = array();
332
336 public $multilangs = array();
337
341 public $imgWidth;
342
346 public $imgHeight;
347
372 public $fields = array(
373 'rowid' => array('type' => 'integer', 'label' => 'TechnicalID', 'enabled' => 1, 'position' => 10, 'notnull' => 1, 'visible' => 0,),
374 'entity' => array('type' => 'integer', 'label' => 'Entity', 'enabled' => 1, 'visible' => 0, 'default' => '1', 'notnull' => 1, 'index' => 1, 'position' => 5),
375 'fk_parent' => array('type' => 'integer', 'label' => 'ParentCategory', 'enabled' => 1, 'position' => 20, 'notnull' => 1, 'visible' => 0, 'css' => 'maxwidth500 widthcentpercentminusxx',),
376 'label' => array('type' => 'varchar(180)', 'label' => 'Ref', 'enabled' => 1, 'position' => 25, 'notnull' => 1, 'visible' => 1, 'alwayseditable' => 1, 'css' => 'minwidth300', 'cssview' => 'wordbreak', 'csslist' => 'tdoverflowmax150', 'showoncombobox' => 1),
377 'ref_ext' => array('type' => 'varchar(255)', 'label' => 'RefExt', 'enabled' => 1, 'position' => 30, 'notnull' => 0, 'visible' => 0, 'alwayseditable' => 1,),
378 'type' => array('type' => 'integer', 'label' => 'Type', 'enabled' => 1, 'position' => 35, 'notnull' => 1, 'visible' => 0, 'alwayseditable' => 1,),
379 'description' => array('type' => 'text', 'label' => 'Description', 'enabled' => 1, 'position' => 40, 'notnull' => 0, 'visible' => 1, 'alwayseditable' => 1,),
380 'color' => array('type' => 'varchar(8)', 'label' => 'Color', 'enabled' => 1, 'position' => 45, 'notnull' => 0, 'visible' => 1, 'alwayseditable' => 1,),
381 'position' => array('type' => 'integer', 'label' => 'Position', 'enabled' => 1, 'position' => 50, 'notnull' => 0, 'visible' => -1, 'alwayseditable' => 1,),
382 'fk_soc' => array('type' => 'integer:Societe:societe/class/societe.class.php', 'label' => 'ThirdParty', 'picto' => 'company', 'enabled' => 1, 'position' => 55, 'notnull' => 0, 'visible' => 0, 'alwayseditable' => 1, 'css' => 'maxwidth500 widthcentpercentminusxx', 'csslist' => 'tdoverflowmax150',),
383 'visible' => array('type' => 'integer', 'label' => 'Visible', 'enabled' => 1, 'position' => 60, 'notnull' => 1, 'visible' => 0, 'alwayseditable' => 1,),
384 'import_key' => array('type' => 'varchar(14)', 'label' => 'ImportId', 'enabled' => 1, 'position' => 900, 'notnull' => 0, 'visible' => -2, 'alwayseditable' => 1,),
385 'date_creation' => array('type' => 'datetime', 'label' => 'DateCreation', 'enabled' => 1, 'position' => 70, 'notnull' => 0, 'visible' => -1, 'alwayseditable' => 1,),
386 'tms' => array('type' => 'timestamp', 'label' => 'DateModification', 'enabled' => 1, 'position' => 75, 'notnull' => 1, 'visible' => -1, 'alwayseditable' => 1,),
387 'fk_user_creat' => array('type' => 'integer:User:user/class/user.class.php', 'label' => 'UserAuthor', 'enabled' => 1, 'position' => 80, 'notnull' => 0, 'visible' => -2, 'alwayseditable' => 1, 'css' => 'maxwidth500 widthcentpercentminusxx', 'csslist' => 'tdoverflowmax150',),
388 'fk_user_modif' => array('type' => 'integer:User:user/class/user.class.php', 'label' => 'UserModif', 'enabled' => 1, 'position' => 85, 'notnull' => -1, 'visible' => -2, 'alwayseditable' => 1, 'css' => 'maxwidth500 widthcentpercentminusxx', 'csslist' => 'tdoverflowmax150',),
389 );
390
396 public function __construct($db)
397 {
398 global $hookmanager;
399
400 $this->db = $db;
401
402 $this->ismultientitymanaged = 1;
403 $this->isextrafieldmanaged = 1;
404
405 if (is_object($hookmanager)) {
406 $hookmanager->initHooks(array('category'));
407 $parameters = array();
408 $reshook = $hookmanager->executeHooks('constructCategory', $parameters, $this); // Note that $action and $object may have been modified by some hooks
409 if ($reshook >= 0 && !empty($hookmanager->resArray)) {
410 foreach ($hookmanager->resArray as $mapList) {
412 $mapId = $mapList['id'];
413 $mapCode = $mapList['code'];
414 //self::$MAP_ID_TO_CODE[$mapId] = $mapCode;
415 $this->MAP_ID[$mapCode] = $mapId;
416 $this->MAP_CAT_FK[$mapCode] = isset($mapList['cat_fk']) ? $mapList['cat_fk'] : null;
417 $this->MAP_CAT_TABLE[$mapCode] = isset($mapList['cat_table']) ? $mapList['cat_table'] : null;
418 $this->MAP_OBJ_CLASS[$mapCode] = $mapList['obj_class'];
419 $this->MAP_OBJ_TABLE[$mapCode] = $mapList['obj_table'];
420 self::$MAP_TYPE_TITLE_AREA[$mapCode] = isset($mapList['label']) ? $mapList['label'] : null;
421 }
422 }
423 }
424 }
425
431 public function getMapList()
432 {
433 $mapList = array();
434
435 foreach ($this->MAP_ID as $mapCode => $mapId) {
436 $mapList[] = array(
437 'id' => $mapId,
438 'code' => $mapCode,
439 'cat_fk' => (empty($this->MAP_CAT_FK[$mapCode]) ? $mapCode : $this->MAP_CAT_FK[$mapCode]),
440 'cat_table' => (empty($this->MAP_CAT_TABLE[$mapCode]) ? $mapCode : $this->MAP_CAT_TABLE[$mapCode]),
441 'obj_class' => (empty($this->MAP_OBJ_CLASS[$mapCode]) ? $mapCode : $this->MAP_OBJ_CLASS[$mapCode]),
442 'obj_table' => (empty($this->MAP_OBJ_TABLE[$mapCode]) ? $mapCode : $this->MAP_OBJ_TABLE[$mapCode]),
443 );
444 }
445
446 return $mapList;
447 }
448
454 public function getMapId()
455 {
456 return $this->MAP_ID;
457 }
458
468 public function fetch($id, $label = '', $type = null, $ref_ext = '')
469 {
470 // Check parameters
471 if (empty($id) && empty($label) && empty($ref_ext)) {
472 $this->error = "No category to search for";
473 return -1;
474 }
475 if (!is_null($type) && !is_numeric($type)) {
476 $type = $this->MAP_ID[$type];
477 }
478
479 $sql = "SELECT rowid, fk_parent, entity, label, description, color, position, fk_soc, visible, type, ref_ext";
480 $sql .= ", date_creation, tms, fk_user_creat, fk_user_modif, import_key";
481 $sql .= " FROM ".MAIN_DB_PREFIX."categorie";
482 if ($id) {
483 $sql .= " WHERE rowid = ".((int) $id);
484 } elseif (!empty($ref_ext)) {
485 $sql .= " WHERE ref_ext LIKE '".$this->db->escape($ref_ext)."'";
486 } else {
487 $sql .= " WHERE label = '".$this->db->escape($label)."' AND entity IN (".getEntity('category').")";
488 if (!is_null($type)) {
489 $sql .= " AND type = ".((int) $type);
490 }
491 }
492
493 dol_syslog(get_class($this)."::fetch", LOG_DEBUG);
494 $resql = $this->db->query($sql);
495 if ($resql) {
496 if ($this->db->num_rows($resql) > 0 && $res = $this->db->fetch_array($resql)) {
497 $this->id = $res['rowid'];
498 //$this->ref = $res['rowid'];
499 $this->fk_parent = (int) $res['fk_parent'];
500 $this->label = $res['label'];
501 $this->description = $res['description'];
502 $this->color = $res['color'];
503 $this->position = $res['position'];
504 $this->socid = (int) $res['fk_soc'];
505 $this->visible = (int) $res['visible'];
506 $this->type = $res['type'];
507 $this->ref_ext = $res['ref_ext'];
508 $this->entity = (int) $res['entity'];
509 $this->date_creation = $this->db->jdate($res['date_creation']);
510 $this->date_modification = $this->db->jdate($res['tms']);
511 $this->user_creation_id = (int) $res['fk_user_creat'];
512 $this->user_modification_id = (int) $res['fk_user_modif'];
513 $this->import_key = $res['import_key'];
514
515 // Retrieve all extrafields
516 // fetch optionals attributes and labels
517 $this->fetch_optionals();
518
519 $this->db->free($resql);
520
521 // multilangs
522 if (getDolGlobalInt('MAIN_MULTILANGS')) {
523 $this->getMultiLangs();
524 }
525
526 return 1;
527 } else {
528 $this->error = "No category found";
529 return 0;
530 }
531 } else {
532 dol_print_error($this->db);
533 $this->error = $this->db->lasterror;
534 $this->errors[] = $this->db->lasterror;
535 return -1;
536 }
537 }
538
549 public function create($user, $notrigger = 0)
550 {
551 global $conf, $langs;
552 $langs->load('categories');
553
554 $type = $this->type;
555
556 if (!is_numeric($type)) {
557 $type = $this->MAP_ID[$type];
558 }
559
560 $error = 0;
561
562 dol_syslog(get_class($this).'::create', LOG_DEBUG);
563
564 // Clean parameters
565 $this->label = trim($this->label);
566 $this->description = trim($this->description);
567 $this->color = trim($this->color);
568 $this->position = (int) $this->position;
569 if (isset($this->import_key)) {
570 $this->import_key = trim($this->import_key);
571 }
572 $this->ref_ext = trim($this->ref_ext);
573 if (empty($this->visible)) {
574 $this->visible = 0;
575 }
576 $this->fk_parent = ($this->fk_parent != "" ? intval($this->fk_parent) : 0);
577
578 if ($this->already_exists()) {
579 $this->error = $langs->trans("ImpossibleAddCat", $this->label);
580 $this->error .= " : ".$langs->trans("CategoryExistsAtSameLevel");
581 dol_syslog($this->error, LOG_WARNING);
582 return -4;
583 }
584
585 $this->db->begin();
586 $now = dol_now();
587 $sql = "INSERT INTO ".MAIN_DB_PREFIX."categorie (";
588 $sql .= "fk_parent,";
589 $sql .= " label,";
590 $sql .= " description,";
591 $sql .= " color,";
592 $sql .= " position,";
593 if (getDolGlobalString('CATEGORY_ASSIGNED_TO_A_CUSTOMER')) {
594 $sql .= "fk_soc,";
595 }
596 $sql .= " visible,";
597 $sql .= " type,";
598 $sql .= " import_key,";
599 $sql .= " ref_ext,";
600 $sql .= " entity,";
601 $sql .= " date_creation,";
602 $sql .= " fk_user_creat";
603 $sql .= ") VALUES (";
604 $sql .= (int) $this->fk_parent.",";
605 $sql .= "'".$this->db->escape($this->label)."', ";
606 $sql .= "'".$this->db->escape($this->description)."', ";
607 $sql .= "'".$this->db->escape($this->color)."', ";
608 $sql .= (int) $this->position.",";
609 if (getDolGlobalString('CATEGORY_ASSIGNED_TO_A_CUSTOMER')) {
610 $sql .= ($this->socid > 0 ? $this->socid : 'null').", ";
611 }
612 $sql .= "'".$this->db->escape((string) $this->visible)."', ";
613 $sql .= ((int) $type).", ";
614 $sql .= (!empty($this->import_key) ? "'".$this->db->escape($this->import_key)."'" : 'null').", ";
615 $sql .= (!empty($this->ref_ext) ? "'".$this->db->escape($this->ref_ext)."'" : 'null').", ";
616 $sql .= (int) $conf->entity.", ";
617 $sql .= "'".$this->db->idate($now)."', ";
618 $sql .= (int) $user->id;
619 $sql .= ")";
620
621 $res = $this->db->query($sql);
622 if ($res) {
623 $id = $this->db->last_insert_id(MAIN_DB_PREFIX."categorie");
624
625 if ($id > 0) {
626 $this->id = $id;
627
628 $action = 'create';
629
630 // Actions on extra fields
631 $result = $this->insertExtraFields();
632 if ($result < 0) {
633 $error++;
634 }
635
636 if (!$error && !$notrigger) {
637 // Call trigger
638 $result = $this->call_trigger('CATEGORY_CREATE', $user);
639 if ($result < 0) {
640 $error++;
641 }
642 // End call triggers
643 }
644
645 if (!$error) {
646 $this->db->commit();
647 return $id;
648 } else {
649 $this->db->rollback();
650 return -3;
651 }
652 } else {
653 $this->db->rollback();
654 return -2;
655 }
656 } else {
657 $this->error = $this->db->error();
658 $this->db->rollback();
659 return -1;
660 }
661 }
662
672 public function update(User $user, $notrigger = 0)
673 {
674 global $langs;
675
676 $error = 0;
677
678 // Clean parameters
679 $this->label = trim($this->label);
680 $this->description = trim($this->description);
681 $this->ref_ext = trim($this->ref_ext);
682 $this->fk_parent = ($this->fk_parent != "" ? intval($this->fk_parent) : 0);
683 $this->visible = ($this->visible != "" ? intval($this->visible) : 0);
684
685 if ($this->fk_parent > 0 && $this->fk_parent == $this->id) {
686 $langs->load('categories');
687 $this->error = $langs->trans("ErrorCategoryCannotBeItsOwnParent");
688 dol_syslog($this->error, LOG_WARNING);
689 return -1;
690 }
691
692 if ($this->already_exists()) {
693 $this->error = $langs->trans("ImpossibleUpdateCat");
694 $this->error .= " : ".$langs->trans("CategoryExistsAtSameLevel");
695 return -1;
696 }
697
698 $this->db->begin();
699
700 $sql = "UPDATE ".MAIN_DB_PREFIX."categorie";
701 $sql .= " SET label = '".$this->db->escape($this->label)."',";
702 $sql .= " description = '".$this->db->escape($this->description)."',";
703 $sql .= " ref_ext = '".$this->db->escape($this->ref_ext)."',";
704 $sql .= " color = '".$this->db->escape($this->color)."'";
705 $sql .= ", position = ".(int) $this->position;
706 if (getDolGlobalString('CATEGORY_ASSIGNED_TO_A_CUSTOMER')) {
707 $sql .= ", fk_soc = ".($this->socid > 0 ? $this->socid : 'null');
708 }
709 $sql .= ", visible = ".(int) $this->visible;
710 $sql .= ", fk_parent = ".(int) $this->fk_parent;
711 $sql .= ", fk_user_modif = ".(int) $user->id;
712 $sql .= " WHERE rowid = ".((int) $this->id);
713
714 dol_syslog(get_class($this)."::update", LOG_DEBUG);
715 if ($this->db->query($sql)) {
716 // Multilangs
717 if (getDolGlobalInt('MAIN_MULTILANGS')) {
718 if ($this->setMultiLangs($user, $notrigger) < 0) {
719 $this->db->rollback();
720 return -2;
721 }
722 }
723
724 $action = 'update';
725
726 // Actions on extra fields
727 $result = $this->insertExtraFields();
728 if ($result < 0) {
729 $error++;
730 }
731
732 if (!$error && !$notrigger) {
733 // Call trigger
734 $result = $this->call_trigger('CATEGORY_MODIFY', $user);
735 if ($result < 0) {
736 $error++;
737 }
738 // End call triggers
739 }
740
741 if (!$error) {
742 $this->db->commit();
743 return 1;
744 } else {
745 $this->db->rollback();
746 return -1;
747 }
748 } else {
749 $this->db->rollback();
750 dol_print_error($this->db);
751 return -1;
752 }
753 }
754
762 public function delete($user, $notrigger = 0)
763 {
764 $error = 0;
765
766 // Clean parameters
767 $this->fk_parent = ($this->fk_parent != "" ? intval($this->fk_parent) : 0);
768
769 dol_syslog(get_class($this)."::remove");
770
771 $this->db->begin();
772
773 if (/* !$error && */ !$notrigger) {
774 // Call trigger
775 $result = $this->call_trigger('CATEGORY_DELETE', $user);
776 if ($result < 0) {
777 $error++;
778 }
779 // End call triggers
780 }
781
782 /* FIX #1317 : Check for child category and move up 1 level*/
783 if (!$error) {
784 $sql = "UPDATE ".MAIN_DB_PREFIX."categorie";
785 $sql .= " SET fk_parent = ".((int) $this->fk_parent);
786 $sql .= " WHERE fk_parent = ".((int) $this->id);
787
788 if (!$this->db->query($sql)) {
789 $this->error = $this->db->lasterror();
790 $error++;
791 }
792 }
793
794 $arraydelete = array(
795 'categorie_account' => 'fk_categorie',
796 'categorie_actioncomm' => 'fk_categorie',
797 'categorie_contact' => 'fk_categorie',
798 'categorie_fournisseur' => 'fk_categorie',
799 'categorie_knowledgemanagement' => array('field' => 'fk_categorie', 'enabled' => isModEnabled('knowledgemanagement')),
800 'categorie_fichinter' => array('field' => 'fk_categorie', 'enabled' => false ), // not yet fully implemented (wait 22) isModEnabled('intervention')),
801 'categorie_member' => 'fk_categorie',
802 'categorie_user' => 'fk_categorie',
803 'categorie_product' => 'fk_categorie',
804 'categorie_project' => 'fk_categorie',
805 'categorie_project_task' => array('field' => 'fk_categorie', 'enabled' => isModEnabled('project')),
806 'categorie_societe' => 'fk_categorie',
807 'categorie_ticket' => array('field' => 'fk_categorie', 'enabled' => isModEnabled('ticket')),
808 'categorie_warehouse' => array('field' => 'fk_categorie', 'enabled' => isModEnabled('stock')),
809 'categorie_website_page' => array('field' => 'fk_categorie', 'enabled' => isModEnabled('website')),
810 'category_bankline' => 'fk_categ',
811 'categorie_lang' => 'fk_category',
812 'categorie' => 'rowid',
813 );
814 foreach ($arraydelete as $key => $value) {
815 $sanitizedvalue = $value;
816 if (is_array($value)) {
817 if (empty($value['enabled'])) {
818 continue;
819 }
820 $sanitizedvalue = $value['field'];
821 }
822
823 $sql = "DELETE FROM ".$this->db->sanitize(MAIN_DB_PREFIX.$key);
824 $sql .= " WHERE ".$this->db->sanitize($sanitizedvalue)." = ".((int) $this->id);
825 if (!$this->db->query($sql)) {
826 $this->errors[] = $this->db->lasterror();
827 dol_syslog("Error sql=".$sql." ".$this->error, LOG_ERR);
828 $error++;
829 }
830 }
831
832 // Removed extrafields
833 if (!$error) {
834 $result = $this->deleteExtraFields();
835 if ($result < 0) {
836 $error++;
837 dol_syslog(get_class($this)."::delete erreur ".$this->error, LOG_ERR);
838 }
839 }
840
841 if (!$error) {
842 $this->db->commit();
843 return 1;
844 } else {
845 $this->db->rollback();
846 return -1;
847 }
848 }
849
850 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
859 public function add_type($obj, $type = '')
860 {
861 // phpcs:enable
862 global $user;
863
864 $error = 0;
865
866 if ($this->id == -1) {
867 return -2;
868 }
869
870 if (empty($type)) {
871 $type = $obj->element;
872 }
873
874 dol_syslog(get_class($this).'::add_type', LOG_DEBUG);
875
876 $this->db->begin();
877
878 $sql = "INSERT INTO ".MAIN_DB_PREFIX."categorie_".(empty($this->MAP_CAT_TABLE[$type]) ? $type : $this->MAP_CAT_TABLE[$type]);
879 $sql .= " (fk_categorie, fk_".(empty($this->MAP_CAT_FK[$type]) ? $type : $this->MAP_CAT_FK[$type]).")";
880 $sql .= " VALUES (".((int) $this->id).", ".((int) $obj->id).")";
881
882 if ($this->db->query($sql)) {
883 if (getDolGlobalString('CATEGORIE_RECURSIV_ADD')) {
884 $sql = 'SELECT fk_parent FROM '.MAIN_DB_PREFIX.'categorie';
885 $sql .= " WHERE rowid = ".((int) $this->id);
886
887 dol_syslog(get_class($this)."::add_type", LOG_DEBUG);
888 $resql = $this->db->query($sql);
889 if ($resql) {
890 if ($this->db->num_rows($resql) > 0) {
891 $objparent = $this->db->fetch_object($resql);
892
893 if (!empty($objparent->fk_parent)) {
894 $cat = new Categorie($this->db);
895 $cat->id = $objparent->fk_parent;
896 if (!$cat->containsObject($type, $obj->id)) {
897 $result = $cat->add_type($obj, $type);
898 if ($result < 0) {
899 $this->error = $cat->error;
900 $error++;
901 }
902 }
903 }
904 }
905 } else {
906 $error++;
907 $this->error = $this->db->lasterror();
908 }
909
910 if ($error) {
911 $this->db->rollback();
912 return -1;
913 }
914 }
915
916 // Call trigger
917 $this->context = array('linkto' => $obj); // Save object we want to link category to into category instance to provide information to trigger
918 $result = $this->call_trigger('CATEGORY_MODIFY', $user);
919 if ($result < 0) {
920 $error++;
921 }
922 // End call triggers
923
924 if (!$error) {
925 $this->db->commit();
926 return 1;
927 } else {
928 $this->db->rollback();
929 return -2;
930 }
931 } else {
932 $this->db->rollback();
933 if ($this->db->lasterrno() == 'DB_ERROR_RECORD_ALREADY_EXISTS') {
934 $this->error = $this->db->lasterrno();
935 return -3;
936 } else {
937 $this->error = $this->db->lasterror();
938 }
939 return -1;
940 }
941 }
942
943 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
952 public function del_type($obj, $type)
953 {
954 // phpcs:enable
955 global $user;
956
957 $error = 0;
958
959 // For backward compatibility
960 if ($type == 'societe') {
961 $type = 'customer';
962 dol_syslog(get_class($this)."::del_type(): type 'societe' is deprecated, please use 'customer' instead", LOG_WARNING);
963 } elseif ($type == 'fournisseur') {
964 $type = 'supplier';
965 dol_syslog(get_class($this)."::del_type(): type 'fournisseur' is deprecated, please use 'supplier' instead", LOG_WARNING);
966 }
967
968 $this->db->begin();
969
970 $sql = "DELETE FROM ".MAIN_DB_PREFIX."categorie_".(empty($this->MAP_CAT_TABLE[$type]) ? $type : $this->MAP_CAT_TABLE[$type]);
971 $sql .= " WHERE fk_categorie = ".((int) $this->id);
972 $sql .= " AND fk_".(empty($this->MAP_CAT_FK[$type]) ? $type : $this->MAP_CAT_FK[$type])." = ".((int) $obj->id);
973
974 dol_syslog(get_class($this).'::del_type', LOG_DEBUG);
975 if ($this->db->query($sql)) {
976 // Call trigger
977 $this->context = array('unlinkoff' => $obj); // Save object we want to link category to into category instance to provide information to trigger
978 $result = $this->call_trigger('CATEGORY_MODIFY', $user);
979 if ($result < 0) {
980 $error++;
981 }
982 // End call triggers
983
984 if (!$error) {
985 $this->db->commit();
986 return 1;
987 } else {
988 $this->db->rollback();
989 return -2;
990 }
991 } else {
992 $this->db->rollback();
993 $this->error = $this->db->lasterror();
994 return -1;
995 }
996 }
997
1016 public function getObjectsInCateg($type, $onlyids = 0, $limit = 0, $offset = 0, $sortfield = '', $sortorder = 'ASC', $filter = '', $filtermode = 'AND', $filterlang = '')
1017 {
1018 global $user;
1019
1020 if (empty($onlyids)) {
1021 dol_syslog("getObjectsInCateg: This method used with parameter onlyids=0 is deprecated. Try by using instead getListForItem().", LOG_WARNING);
1022 }
1023
1024 $objs = array();
1025
1026 $classnameforobj = $this->MAP_OBJ_CLASS[$type];
1027 if (!empty($classnameforobj) && class_exists($classnameforobj)) {
1028 $tmpobj = new $classnameforobj($this->db);
1031 $sql = "SELECT c.fk_".(empty($this->MAP_CAT_FK[$type]) ? $type : $this->MAP_CAT_FK[$type])." as fk_object";
1032 $sql .= " FROM ".MAIN_DB_PREFIX."categorie_".(empty($this->MAP_CAT_TABLE[$type]) ? $type : $this->MAP_CAT_TABLE[$type])." as c";
1033 $sql .= ", ".MAIN_DB_PREFIX.(empty($this->MAP_OBJ_TABLE[$type]) ? $type : $this->MAP_OBJ_TABLE[$type])." as o";
1034 if (!empty($filterlang)) {
1035 $sql .= ", ".MAIN_DB_PREFIX.(empty($this->MAP_OBJ_TABLE[$type]) ? $type : $this->MAP_OBJ_TABLE[$type])."_lang as ol";
1036 }
1037 $sql .= " WHERE o.entity IN (".getEntity($tmpobj->element).")";
1038 $sql .= " AND c.fk_categorie = ".((int) $this->id);
1039 // Compatibility with actioncomm table which has id instead of rowid
1040 if ((array_key_exists($type, $this->MAP_OBJ_TABLE) && $this->MAP_OBJ_TABLE[$type] == "actioncomm") || $type == "actioncomm") {
1041 $sql .= " AND c.fk_".(empty($this->MAP_CAT_FK[$type]) ? $type : $this->MAP_CAT_FK[$type])." = o.id";
1042 } else {
1043 $sql .= " AND c.fk_".(empty($this->MAP_CAT_FK[$type]) ? $type : $this->MAP_CAT_FK[$type])." = o.rowid";
1044 }
1045 if (!empty($filterlang)) {
1046 $sql .= " AND ol.fk_".(empty($this->MAP_OBJ_TABLE[$type]) ? $type : $this->MAP_OBJ_TABLE[$type])." = o.rowid";
1047 $sql .= " AND ol.lang = '".$this->db->escape($filterlang)."'";
1048 }
1049 // Protection for external users
1050 if (($type == 'customer' || $type == 'supplier') && $user->socid > 0) {
1051 $sql .= " AND o.rowid = ".((int) $user->socid);
1052 }
1053
1054 $errormessage = '';
1055 $sql .= forgeSQLFromUniversalSearchCriteria($filter, $errormessage);
1056 if ($errormessage) {
1057 $this->errors[] = $errormessage;
1058 dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
1059 return -1;
1060 }
1061
1062 $sql .= $this->db->order($sortfield, $sortorder);
1063 if ($limit > 0 || $offset > 0) {
1064 $sql .= $this->db->plimit($limit + 1, $offset);
1065 }
1066
1067 dol_syslog(get_class($this)."::getObjectsInCateg", LOG_DEBUG);
1068
1069 $resql = $this->db->query($sql);
1070 if ($resql) {
1071 while ($rec = $this->db->fetch_array($resql)) {
1072 if ($onlyids) {
1073 $objs[] = $rec['fk_object'];
1074 } else {
1075 $tmpobj = new $classnameforobj($this->db);
1076 $tmpobj->fetch($rec['fk_object']); // The fetch will set $tmpobj->id only if it succeed.
1077 // @phpstan-ignore-next-line
1078 if ($tmpobj->id > 0) { // Failing fetch may happen for example when a category supplier was set and third party was moved as customer only. The object supplier can't be loaded.
1079 $objs[] = $tmpobj;
1080 }
1081 }
1082 }
1083 } else {
1084 $this->error = $this->db->error().' sql='.$sql;
1085 return -1;
1086 }
1087 }
1088
1089 return $objs;
1090 }
1091
1100 public function containsObject($type, $object_id)
1101 {
1102 $sql = "SELECT COUNT(*) as nb FROM ".MAIN_DB_PREFIX."categorie_".(empty($this->MAP_CAT_TABLE[$type]) ? $type : $this->MAP_CAT_TABLE[$type]);
1103 $sql .= " WHERE fk_categorie = ".((int) $this->id)." AND fk_".(empty($this->MAP_CAT_FK[$type]) ? $type : $this->MAP_CAT_FK[$type])." = ".((int) $object_id);
1104
1105 dol_syslog(get_class($this)."::containsObject", LOG_DEBUG);
1106
1107 $resql = $this->db->query($sql);
1108 if ($resql) {
1109 return $this->db->fetch_object($resql)->nb;
1110 } else {
1111 $this->error = $this->db->error();
1112 return -1;
1113 }
1114 }
1115
1128 public function getListForItem($id, $type = 'customer', $sortfield = "s.rowid", $sortorder = 'ASC', $limit = 0, $page = 0)
1129 {
1130 $categories = array();
1131
1132 $type = sanitizeVal($type, 'aZ09');
1133
1134 $sub_type = $type;
1135 $subcol_name = "fk_".$type;
1136 if ($type == "customer") {
1137 $sub_type = "societe";
1138 $subcol_name = "fk_soc";
1139 }
1140 if ($type == "supplier") {
1141 $sub_type = "fournisseur";
1142 $subcol_name = "fk_soc";
1143 }
1144 if ($type == "contact") {
1145 $subcol_name = "fk_socpeople";
1146 }
1147
1148 $idoftype = (int) (array_key_exists($type, $this->MAP_ID) ? $this->MAP_ID[$type] : -1);
1149
1150 $sql = "SELECT s.rowid";
1151 $sqlfields = $sql; // $sql fields to remove for count total
1152 $sql .= " FROM ".MAIN_DB_PREFIX."categorie as s, ".MAIN_DB_PREFIX."categorie_".$this->db->sanitize($sub_type)." as sub";
1153 $sql .= ' WHERE s.entity IN ('.getEntity('category').')';
1154 $sql .= ' AND s.type = '.((int) $idoftype);
1155 $sql .= ' AND s.rowid = sub.fk_categorie';
1156 $sql .= " AND sub.".$this->db->sanitize($subcol_name)." = ".((int) $id);
1157
1158 $offset = 0;
1159 $nbtotalofrecords = '';
1160 if (!getDolGlobalInt('MAIN_DISABLE_FULL_SCANLIST')) {
1161 $sqlforcount = preg_replace('/^'.preg_quote($sqlfields, '/').'/', 'SELECT COUNT(*) as nbtotalofrecords', $sql);
1162 $sqlforcount = preg_replace('/GROUP BY .*$/', '', $sqlforcount);
1163
1164 $resql = $this->db->query($sqlforcount);
1165 if ($resql) {
1166 $objforcount = $this->db->fetch_object($resql);
1167 $nbtotalofrecords = $objforcount->nbtotalofrecords;
1168 } else {
1169 dol_print_error($this->db);
1170 }
1171
1172 if (($limit >= (int) $nbtotalofrecords) && $page > 0) {
1173 return [];
1174 }
1175
1176 if (($page * $limit) >= (int) $nbtotalofrecords) { // if total resultset is smaller or equal then paging size (filtering), goto and load page 0
1177 $page = 0;
1178 $offset = 0;
1179 }
1180 $this->db->free($resql);
1181 }
1182
1183 $sql .= $this->db->order($sortfield, $sortorder);
1184 if ($limit) {
1185 if ($page < 0) {
1186 $page = 0;
1187 }
1188 $offset = $limit * $page;
1189
1190 $sql .= $this->db->plimit($limit + 1, $offset);
1191 }
1192
1193 $result = $this->db->query($sql);
1194 if ($result) {
1195 $i = 0;
1196 $num = $this->db->num_rows($result);
1197 $min = min($num, ($limit <= 0 ? $num : $limit));
1198 while ($i < $min) {
1199 $obj = $this->db->fetch_object($result);
1200 $category_static = new Categorie($this->db);
1201 if ($category_static->fetch($obj->rowid)) {
1202 $categories[$i]['id'] = $category_static->id;
1203 $categories[$i]['fk_parent'] = $category_static->fk_parent;
1204 $categories[$i]['label'] = $category_static->label;
1205 $categories[$i]['description'] = $category_static->description;
1206 $categories[$i]['color'] = $category_static->color;
1207 $categories[$i]['position'] = $category_static->position;
1208 $categories[$i]['socid'] = $category_static->socid;
1209 $categories[$i]['ref_ext'] = $category_static->ref_ext;
1210 $categories[$i]['visible'] = $category_static->visible;
1211 $categories[$i]['type'] = $category_static->type;
1212 $categories[$i]['entity'] = $category_static->entity;
1213 $categories[$i]['array_options'] = $category_static->array_options;
1214
1215 // multilangs
1216 if (getDolGlobalInt('MAIN_MULTILANGS') && isset($category_static->multilangs)) {
1217 $categories[$i]['multilangs'] = $category_static->multilangs;
1218 }
1219 }
1220 $i++;
1221 }
1222 } else {
1223 $this->error = $this->db->lasterror();
1224 return -1;
1225 }
1226 if (!count($categories)) {
1227 return [];
1228 }
1229
1230 return $categories;
1231 }
1232
1233 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1239 public function get_filles()
1240 {
1241 // phpcs:enable
1242 $sql = "SELECT rowid FROM ".MAIN_DB_PREFIX."categorie";
1243 $sql .= " WHERE fk_parent = ".((int) $this->id);
1244 $sql .= " AND entity IN (".getEntity('category').")";
1245
1246 $res = $this->db->query($sql);
1247 if ($res) {
1248 $cats = array();
1249 while ($rec = $this->db->fetch_array($res)) {
1250 $cat = new Categorie($this->db);
1251 $cat->fetch($rec['rowid']);
1252 $cats[] = $cat;
1253 }
1254 return $cats;
1255 } else {
1256 dol_print_error($this->db);
1257 return -1;
1258 }
1259 }
1260
1261 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1268 protected function load_motherof()
1269 {
1270 // phpcs:enable
1271 $this->motherof = array();
1272
1273 // Load array[child]=parent
1274 $sql = "SELECT fk_parent as id_parent, rowid as id_son";
1275 $sql .= " FROM ".MAIN_DB_PREFIX."categorie";
1276 $sql .= " WHERE fk_parent <> 0";
1277 $sql .= " AND entity IN (".getEntity('category').")";
1278
1279 dol_syslog(get_class($this)."::load_motherof", LOG_DEBUG);
1280 $resql = $this->db->query($sql);
1281 if ($resql) {
1282 while ($obj = $this->db->fetch_object($resql)) {
1283 $this->motherof[$obj->id_son] = $obj->id_parent;
1284 }
1285 return 1;
1286 } else {
1287 dol_print_error($this->db);
1288 return -1;
1289 }
1290 }
1291
1292 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1313 public function get_full_arbo($type, $fromid = 0, $include = 0, $forcelangcode = '')
1314 {
1315 // phpcs:enable
1316 global $langs;
1317
1318 if (!is_numeric($type)) {
1319 $type = $this->MAP_ID[$type];
1320 }
1321 if (is_null($type)) {
1322 $this->error = 'BadValueForParameterType';
1323 return -1;
1324 }
1325
1326 if (is_string($fromid)) {
1327 $fromid = explode(',', $fromid);
1328 } elseif (is_numeric($fromid)) {
1329 if ($fromid > 0) {
1330 $fromid = array($fromid);
1331 } else {
1332 $fromid = array();
1333 }
1334 } elseif (!is_array($fromid)) {
1335 $fromid = array();
1336 }
1337
1338 $this->cats = array();
1339 $nbcateg = 0;
1340
1341 // Init this->motherof that is array(id_son=>id_parent, ...)
1342 $this->load_motherof();
1343
1344 if ($forcelangcode) {
1345 $current_lang = $forcelangcode;
1346 } else {
1347 $current_lang = $langs->getDefaultLang();
1348 }
1349
1350 // Init $this->cats array
1351 // Note: The DISTINCT reduces pb with old tables with duplicates but should not be used
1352 $sql = "SELECT DISTINCT c.rowid, c.label, c.ref_ext, c.description, c.color, c.position, c.fk_parent, c.visible";
1353 if (getDolGlobalInt('MAIN_MULTILANGS') && $current_lang !== 'none') {
1354 $sql .= ", t.label as label_trans, t.description as description_trans";
1355 }
1356 $sql .= " FROM ".MAIN_DB_PREFIX."categorie as c";
1357 if (getDolGlobalInt('MAIN_MULTILANGS') && $current_lang !== 'none') {
1358 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX."categorie_lang as t ON t.fk_category = c.rowid AND t.lang = '".$this->db->escape($current_lang)."'";
1359 }
1360 $sql .= " WHERE c.entity IN (".getEntity('category').")";
1361 $sql .= " AND c.type = ".(int) $type;
1362
1363 dol_syslog(get_class($this)."::get_full_arbo get category list", LOG_DEBUG);
1364
1365 $resql = $this->db->query($sql);
1366 if ($resql) {
1367 $i = 0;
1368 $nbcateg = $this->db->num_rows($resql);
1369
1370 while ($obj = $this->db->fetch_object($resql)) {
1371 $this->cats[(int) $obj->rowid]
1372 = array(
1373 'rowid' => (int) $obj->rowid,
1374 'id' => (int) $obj->rowid,
1375 'fk_parent' => (int) $obj->fk_parent,
1376 'label' => !empty($obj->label_trans) ? (string) $obj->label_trans : (string) $obj->label,
1377 'description' => !empty($obj->description_trans) ? (string) $obj->description_trans : (string) $obj->description,
1378 'color' => (string) $obj->color,
1379 'position' => (string) $obj->position,
1380 'visible' => (int) $obj->visible,
1381 'ref_ext' => (string) $obj->ref_ext,
1382 'picto' => 'category',
1383 // fields are filled with buildPathFromId later
1384 'fullpath' => '',
1385 'fulllabel' => '',
1386 'level' => null,
1387 );
1388 $i++;
1389 }
1390 } else {
1391 dol_print_error($this->db);
1392 return -1;
1393 }
1394
1395 // We add the fullpath property to each elements of first level (no parent exists)
1396 dol_syslog(get_class($this)."::get_full_arbo call to buildPathFromId", LOG_DEBUG);
1397
1398 foreach ($this->cats as $key => $val) {
1399 //print 'key='.$key.'<br>'."\n";
1400 $this->buildPathFromId($key, $nbcateg); // Process a branch from the root category key (this category has no parent) and adds level to $this->cats items
1401 }
1402
1403 // Include or exclude leaf (including $fromid) from tree
1404 if (count($fromid) > 0) {
1405 $keyfiltercatid = '('.implode('|', $fromid).')';
1406
1407 //print "Look to discard category ".$fromid."\n";
1408 $keyfilter1 = '^'.$keyfiltercatid.'$';
1409 $keyfilter2 = '_'.$keyfiltercatid.'$';
1410 $keyfilter3 = '^'.$keyfiltercatid.'_';
1411 $keyfilter4 = '_'.$keyfiltercatid.'_';
1412 foreach (array_keys($this->cats) as $key) {
1413 $fullpath = (string) $this->cats[$key]['fullpath'];
1414 $test = (preg_match('/'.$keyfilter1.'/', $fullpath) || preg_match('/'.$keyfilter2.'/', $fullpath)
1415 || preg_match('/'.$keyfilter3.'/', $fullpath) || preg_match('/'.$keyfilter4.'/', $fullpath));
1416
1417 if (($test && !$include) || (!$test && $include)) {
1418 unset($this->cats[$key]); // @phpstan-ignore-line
1419 }
1420 }
1421 }
1422
1423 dol_syslog(get_class($this)."::get_full_arbo dol_sort_array", LOG_DEBUG);
1424
1425 $this->cats = dol_sort_array($this->cats, 'fulllabel', 'asc', 1, 0, 1); // Sort on full label like "Label 1 >> Sublabel a >> Subsublabel"
1426
1427 return $this->cats;
1428 }
1429
1440 private function buildPathFromId($id_categ, $protection = 1000)
1441 {
1442 //dol_syslog(get_class($this)."::buildPathFromId id_categ=".$id_categ." protection=".$protection, LOG_DEBUG);
1443
1444 if (!empty($this->cats[$id_categ]['fullpath'])) {
1445 // Already defined
1446 dol_syslog(get_class($this)."::buildPathFromId fullpath and fulllabel already defined", LOG_WARNING);
1447 return -1;
1448 }
1449
1450 // $this->cats[$id_categ] is supposed to be already an array. We just want to complete it with property fullpath and fulllabel
1451
1452 // Define fullpath and fulllabel
1453 $this->cats[$id_categ]['fullpath'] = '_'.$id_categ;
1454 $this->cats[$id_categ]['fulllabel'] = $this->cats[$id_categ]['label'];
1455 $i = 0;
1456 $cursor_categ = $id_categ;
1457 //print 'Work for id_categ='.$id_categ.'<br>'."\n";
1458 while ((empty($protection) || $i < $protection) && !empty($this->motherof[$cursor_categ])) {
1459 //print '&nbsp; cursor_categ='.$cursor_categ.' i='.$i.' '.$this->motherof[$cursor_categ].'<br>'."\n";
1460 $this->cats[$id_categ]['fullpath'] = '_'.$this->motherof[$cursor_categ].$this->cats[$id_categ]['fullpath'];
1461 $this->cats[$id_categ]['fulllabel'] = (empty($this->cats[$this->motherof[$cursor_categ]]) ? 'NotFound' : $this->cats[$this->motherof[$cursor_categ]]['label']).' > '.$this->cats[$id_categ]['fulllabel'];
1462 //print '&nbsp; Result for id_categ='.$id_categ.' : '.$this->cats[$id_categ]['fullpath'].' '.$this->cats[$id_categ]['fulllabel'].'<br>'."\n";
1463 $i++;
1464 $cursor_categ = $this->motherof[$cursor_categ];
1465 }
1466 //print 'Result for id_categ='.$id_categ.' : '.$this->cats[$id_categ]['fullpath'].'<br>'."\n";
1467
1468 // We count number of _ to have level
1469 $nbunderscore = substr_count($this->cats[$id_categ]['fullpath'], '_');
1470 $this->cats[$id_categ]['level'] = ($nbunderscore ? $nbunderscore : null);
1471
1472 return 1;
1473 }
1474
1475
1476 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1484 public function get_all_categories($type = null, $parent = false)
1485 {
1486 // phpcs:enable
1487 if (!is_numeric($type) && !is_null($type)) {
1488 $type = $this->MAP_ID[$type];
1489 }
1490
1491 $sql = "SELECT rowid FROM ".MAIN_DB_PREFIX."categorie";
1492 $sql .= " WHERE entity IN (".getEntity('category').")";
1493 if (!is_null($type)) {
1494 $sql .= " AND type = ".(int) $type;
1495 }
1496 if ($parent) {
1497 $sql .= " AND fk_parent = 0";
1498 }
1499
1500 $res = $this->db->query($sql);
1501 if ($res) {
1502 $cats = array();
1503 while ($rec = $this->db->fetch_array($res)) {
1504 $cat = new Categorie($this->db);
1505 $cat->fetch($rec['rowid']);
1506 $cats[$rec['rowid']] = $cat;
1507 }
1508 return $cats;
1509 } else {
1510 dol_print_error($this->db);
1511 return -1;
1512 }
1513 }
1514
1515 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1522 public function get_main_categories($type = null)
1523 {
1524 // phpcs:enable
1525 return $this->get_all_categories($type, true);
1526 }
1527
1528 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1534 public function already_exists()
1535 {
1536 // phpcs:enable
1537 $type = $this->type;
1538
1539 if (!is_numeric($type)) {
1540 $type = $this->MAP_ID[$type];
1541 }
1542
1543 /* We have to select any rowid from llx_categorie which category's mother and label
1544 * are equals to those of the calling category
1545 */
1546 $sql = "SELECT c.rowid";
1547 $sql .= " FROM ".MAIN_DB_PREFIX."categorie as c ";
1548 $sql .= " WHERE c.entity IN (".getEntity('category').")";
1549 $sql .= " AND c.type = ".((int) $type);
1550 $sql .= " AND c.fk_parent = ".((int) $this->fk_parent);
1551 $sql .= " AND c.label = '".$this->db->escape($this->label)."'";
1552
1553 dol_syslog(get_class($this)."::already_exists", LOG_DEBUG);
1554
1555 $resql = $this->db->query($sql);
1556 if ($resql) {
1557 if ($this->db->num_rows($resql) > 0) { // Checking for empty resql
1558 $obj = $this->db->fetch_object($resql);
1559 /* If object called create, obj cannot have is id.
1560 * If object called update, he mustn't have the same label as an other category for this mother.
1561 * So if the result has the same id, update is not for label, and if result has an other one, update may be for label.
1562 */
1563 if (!empty($obj) && $obj->rowid > 0 && $obj->rowid != $this->id) {
1564 dol_syslog(get_class($this)."::already_exists category with name=".$this->label." and parent ".$this->fk_parent." exists: rowid=".$obj->rowid." current_id=".$this->id, LOG_DEBUG);
1565 return 1;
1566 }
1567 }
1568 dol_syslog(get_class($this)."::already_exists no category with same name=".$this->label." and same parent ".$this->fk_parent." than category id=".$this->id, LOG_DEBUG);
1569 return 0;
1570 } else {
1571 $this->error = $this->db->error();
1572 return -1;
1573 }
1574 }
1575
1576
1577 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1589 public function print_all_ways($sep = 'auto', $url = '', $nocolor = 0, $addpicto = 0, $notrunc = 0)
1590 {
1591 // phpcs:enable
1592 $ways = array();
1593
1594 if ($sep == 'auto') {
1595 $sep = '&gt;';
1596 }
1597
1598 $all_ways = $this->get_all_ways(); // Load array of categories from database to reach this->id
1599
1600 foreach ($all_ways as $way) { // It seems we always have 1 entry in this array.
1601 $w = array();
1602 $i = 0;
1603 $forced_color = '';
1604 foreach ($way as $cat) { // Loop on each successive categories to reach the target of current category
1605 $i++;
1606
1607 if (empty($nocolor)) {
1608 $forced_color = 'colortoreplace';
1609 if ($i == count($way)) { // Last category in hierarchy
1610 // Check contrast with background and correct text color
1611 $forced_color = 'categtextwhite'; // We want color white because the getNomUrl of a tag is always called inside a dark background like '<span color="bbb"></span>' to show it as a tag. TODO Add this in param to force when called outside of span.
1612 if ($cat->color && colorIsLight($cat->color)) {
1613 $forced_color = 'categtextblack';
1614 }
1615 }
1616 }
1617
1618 if ($url == '') {
1619 if (($i < count($way) && empty($notrunc)) && $i > 1) {
1620 $link = '';
1621 $linkend = '';
1622 } else {
1623 $link = '<a href="'.DOL_URL_ROOT.'/categories/viewcat.php?id='.((int) $cat->id).'&type='.urlencode($cat->type).'" class="'.(($i < count($way) && empty($notrunc)) ? 'small ' : '').$forced_color.'">';
1624 $linkend = '</a>';
1625 }
1626 $s = $link.(($addpicto && $i == 1) ? img_object('', 'category', 'class="paddingright"') : '');
1627 $s .= (($i < count($way) && empty($notrunc)) ? ($i == 1 ? dol_trunc($cat->label, 3) : '') : $cat->label);
1628 $s .= $linkend;
1629 $w[] = $s;
1630 } elseif ($url == 'none') {
1631 if (($i < count($way) && empty($notrunc)) && $i > 1) {
1632 $link = '';
1633 $linkend = '';
1634 } else {
1635 $link = '<span class="valignmiddle '.($i < count($way) ? 'small ' : '').$forced_color.'">';
1636 $linkend = '</span>';
1637 }
1638 $s = $link.(($addpicto && $i == 1) ? img_object('', 'category', 'class="paddingright"') : '');
1639 $s .= (($i < count($way) && empty($notrunc)) ? ($i == 1 ? dol_trunc($cat->label, 3) : '') : $cat->label);
1640 $s .= $linkend;
1641 $w[] = $s;
1642 } else {
1643 $w[] = '<a class="valignmiddle '.($i < count($way) ? 'small ' : '').$forced_color.'" href="'.DOL_URL_ROOT.'/'.$url.'?catid='.((int) $cat->id).'">'.($addpicto ? img_object('', 'category') : '').$cat->label.'</a>';
1644 }
1645 }
1646 $newcategwithpath = preg_replace('/colortoreplace/', $forced_color, implode('<span class="inline-block valignmiddle paddingleft paddingright small '.$forced_color.'">'.$sep.'</span>', $w));
1647
1648 $ways[] = $newcategwithpath;
1649 }
1650
1651 return $ways;
1652 }
1653
1654
1655 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1662 public function get_meres()
1663 {
1664 // phpcs:enable
1665 $parents = array();
1666
1667 $sql = "SELECT fk_parent FROM ".MAIN_DB_PREFIX."categorie";
1668 $sql .= " WHERE rowid = ".((int) $this->id);
1669
1670 $res = $this->db->query($sql);
1671
1672 if ($res) {
1673 while ($rec = $this->db->fetch_array($res)) {
1674 if ($rec['fk_parent'] > 0) {
1675 $cat = new Categorie($this->db);
1676 $cat->fetch($rec['fk_parent']);
1677 $parents[] = $cat;
1678 }
1679 }
1680 return $parents;
1681 } else {
1682 dol_print_error($this->db);
1683 return -1;
1684 }
1685 }
1686
1687 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1694 public function get_all_ways()
1695 {
1696 // phpcs:enable
1697 $ways = array();
1698
1699 $parents = $this->get_meres();
1700 if (is_array($parents)) {
1701 foreach ($parents as $parent) {
1702 $all_ways = $parent->get_all_ways(); // recursivity. TODO Add a protection for infinite loop
1703 foreach ($all_ways as $way) {
1704 $w = $way;
1705 $w[] = $this;
1706 $ways[] = $w;
1707 }
1708 }
1709 }
1710
1711 if (count($ways) == 0) {
1712 $ways[0][0] = $this;
1713 }
1714
1715 return $ways;
1716 }
1717
1728 public function containing($id, $type, $mode = 'object')
1729 {
1730 $cats = array();
1731
1732 if (is_numeric($type)) {
1733 $type = array_search($type, $this->MAP_ID);
1734 }
1735
1736 if ($type === Categorie::TYPE_BANK_LINE) { // TODO Remove this after migration of llx_category_bankline into llx_categorie_bankline
1737 // Load bank categories
1738 $sql = "SELECT c.label, c.rowid";
1739 $sql .= " FROM ".MAIN_DB_PREFIX."category_bankline as a, ".MAIN_DB_PREFIX."categorie as c";
1740 $sql .= " WHERE a.lineid=".((int) $id)." AND a.fk_categ = c.rowid";
1741 $sql .= " AND c.entity IN (".getEntity('category').")";
1742 $sql .= " ORDER BY c.label";
1743
1744 $res = $this->db->query($sql);
1745 if ($res) {
1746 while ($obj = $this->db->fetch_object($res)) {
1747 if ($mode == 'id') {
1748 $cats[] = $obj->rowid;
1749 } elseif ($mode == 'label') {
1750 $cats[] = $obj->label;
1751 } else {
1752 $cat = new Categorie($this->db);
1753 $cat->id = $obj->rowid;
1754 $cat->label = $obj->label;
1755 $cats[] = $cat;
1756 }
1757 }
1758 } else {
1759 dol_print_error($this->db);
1760 return -1;
1761 }
1762 } else {
1763 $sql = "SELECT ct.fk_categorie, c.label, c.rowid";
1764 $sql .= " FROM ".MAIN_DB_PREFIX."categorie_".(empty($this->MAP_CAT_TABLE[$type]) ? $type : $this->MAP_CAT_TABLE[$type])." as ct, ".MAIN_DB_PREFIX."categorie as c";
1765 $sql .= " WHERE ct.fk_categorie = c.rowid AND ct.fk_".(empty($this->MAP_CAT_FK[$type]) ? $type : $this->MAP_CAT_FK[$type])." = ".(int) $id;
1766 // This seems useless because the table already contains id of category of 1 unique type. So commented.
1767 // So now it works also with external added categories.
1768 //$sql .= " AND c.type = ".((int) $this->MAP_ID[$type]);
1769 $sql .= " AND c.entity IN (".getEntity('category').")";
1770
1771 $res = $this->db->query($sql);
1772 if ($res) {
1773 while ($obj = $this->db->fetch_object($res)) {
1774 if ($mode == 'id') {
1775 $cats[] = $obj->rowid;
1776 } elseif ($mode == 'label') {
1777 $cats[] = $obj->label;
1778 } else {
1779 $cat = new Categorie($this->db);
1780 $cat->fetch($obj->fk_categorie);
1781 $cats[] = $cat;
1782 }
1783 }
1784 } else {
1785 dol_print_error($this->db);
1786 return -1;
1787 }
1788 }
1789
1790 return $cats;
1791 }
1792
1804 public function rechercher($id, $nom, $type, $exact = false, $case = false)
1805 {
1806 // Deprecation warning
1807 if (is_numeric($type)) {
1808 dol_syslog(__METHOD__.': using numeric types is deprecated.', LOG_WARNING);
1809 }
1810
1811 $cats = array();
1812
1813 // For backward compatibility
1814 if (is_numeric($type)) {
1815 // We want to reverse lookup
1816 $map_type = array_flip($this->MAP_ID);
1817 $type = $map_type[$type];
1818 dol_syslog(get_class($this)."::rechercher(): numeric types are deprecated, please use string instead", LOG_WARNING);
1819 }
1820
1821 // Generation requete recherche
1822 $sql = "SELECT rowid FROM ".MAIN_DB_PREFIX."categorie";
1823 $sql .= " WHERE type = ".((int) $this->MAP_ID[$type]);
1824 $sql .= " AND entity IN (".getEntity('category').")";
1825 if ($nom) {
1826 if (!$exact) {
1827 $nom = '%'.$this->db->escape(str_replace('*', '%', $nom)).'%';
1828 }
1829 if (!$case) {
1830 $sql .= " AND label LIKE '".$this->db->escape($nom)."'";
1831 } else {
1832 $sql .= " AND label LIKE BINARY '".$this->db->escape($nom)."'";
1833 }
1834 }
1835 if ($id) {
1836 $sql .= " AND rowid = ".((int) $id);
1837 }
1838
1839 $res = $this->db->query($sql);
1840 if ($res) {
1841 while ($rec = $this->db->fetch_array($res)) {
1842 $cat = new Categorie($this->db);
1843 $cat->fetch($rec['rowid']);
1844 $cats[] = $cat;
1845 }
1846
1847 return $cats;
1848 } else {
1849 $this->error = $this->db->error().' sql='.$sql;
1850 return -1;
1851 }
1852 }
1853
1860 public function isAnyPhotoAvailable($sdir)
1861 {
1862 include_once DOL_DOCUMENT_ROOT . '/core/lib/files.lib.php';
1863 include_once DOL_DOCUMENT_ROOT . '/core/lib/images.lib.php';
1864
1865 $sdir .= '/' . get_exdir($this->id, 2, 0, 0, $this, 'category') . $this->id . "/photos/";
1866
1867 $dir_osencoded = dol_osencode($sdir);
1868 if (file_exists($dir_osencoded)) {
1869 $handle = opendir($dir_osencoded);
1870 if (is_resource($handle)) {
1871 while (($file = readdir($handle)) !== false) {
1872 if (!utf8_check($file)) {
1873 $file = mb_convert_encoding($file, 'UTF-8', 'ISO-8859-1'); // To be sure data is stored in UTF8 in memory
1874 }
1875 if (dol_is_file($sdir . $file) && image_format_supported($file) >= 0) {
1876 return true;
1877 }
1878 }
1879 }
1880 }
1881 return false;
1882 }
1883
1890 public function getTooltipContentArray($params)
1891 {
1892 global $langs;
1893
1894 $langs->load('categories');
1895
1896 $datas = [];
1897
1898 $datas['label'] = $langs->trans("ShowCategory").': '.($this->ref ? $this->ref : $this->label);
1899
1900 return $datas;
1901 }
1902
1916 public function getNomUrl($withpicto = 0, $option = '', $maxlength = 0, $moreparam = '', $notooltip = 0, $morecss = '', $save_lastsearch_value = 0)
1917 {
1918 global $conf, $langs, $hookmanager;
1919
1920 if (!empty($conf->dol_no_mouse_hover)) {
1921 $notooltip = 1; // Force disable tooltips
1922 }
1923
1924 $result = '';
1925 $params = [
1926 'id' => $this->id,
1927 'objecttype' => $this->element,
1928 'option' => $option,
1929 ];
1930 $classfortooltip = 'classfortooltip';
1931 $dataparams = '';
1932 if (getDolGlobalInt('MAIN_ENABLE_AJAX_TOOLTIP')) {
1933 $classfortooltip = 'classforajaxtooltip';
1934 $dataparams = ' data-params="'.dol_escape_htmltag(json_encode($params)).'"';
1935 $label = '';
1936 } else {
1937 $label = implode($this->getTooltipContentArray($params));
1938 }
1939
1940 $url = DOL_URL_ROOT.'/categories/viewcat.php?id='.$this->id.'&type='.$this->type.$moreparam.'&backtopage='.urlencode($_SERVER['PHP_SELF'].($moreparam ? '?'.$moreparam : ''));
1941
1942 if ($option !== 'nolink') {
1943 // Add param to save lastsearch_values or not
1944 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
1945 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
1946 $add_save_lastsearch_values = 1;
1947 }
1948 if (/* $url && */ $add_save_lastsearch_values) {
1949 $url .= '&save_lastsearch_values=1';
1950 }
1951 }
1952
1953 // Check contrast with background and correct text color
1954 $forced_color = 'categtextwhite'; // We want color white because the getNomUrl of a tag is always called inside a dark background like '<span color="bbb"></span>' to show it as a tag. TODO Add this in param to force when called outside of span.
1955 if ($this->color) {
1956 if (colorIsLight($this->color)) { // If color is light, we force color to dark
1957 $forced_color = 'categtextblack';
1958 }
1959 }
1960
1961 $linkclose = '';
1962 if (empty($notooltip)) {
1963 if (getDolGlobalInt('MAIN_OPTIMIZEFORTEXTBROWSER')) {
1964 $label = $langs->trans("ShowCategory");
1965 $linkclose .= ' alt="'.dolPrintHTMLForAttribute($label).'"';
1966 }
1967 $linkclose .= ($label ? ' title="'.dolPrintHTMLForAttribute($label).'"' : ' title="tocomplete"');
1968 $linkclose .= $dataparams.' class="'.$classfortooltip.' '.$forced_color.($morecss ? ' '.$morecss : '').'"';
1969 } else {
1970 $linkclose = ' class="'.$forced_color.($morecss ? ' '.$morecss : '').'"';
1971 }
1972
1973 if ($option == 'nolink' /* || empty($url) */) {
1974 $linkstart = '<span';
1975 } else {
1976 $linkstart = '<a href="'.$url.'"';
1977 }
1978 $linkstart .= $linkclose.'>';
1979 if ($option == 'nolink' /* || empty($url) */) {
1980 $linkend = '</span>';
1981 } else {
1982 $linkend = '</a>';
1983 }
1984
1985 $result .= $linkstart;
1986
1987 if ($withpicto) {
1988 $result .= img_object(($notooltip ? '' : $label), ($this->picto ? $this->picto : 'generic'), ($notooltip ? (($withpicto != 2) ? 'class="paddingright"' : '') : 'class="'.(($withpicto != 2) ? 'paddingright ' : '').'"'), 0, 0, $notooltip ? 0 : 1);
1989 }
1990
1991 if ($withpicto != 2) {
1992 $result .= dol_trunc(($this->ref ? $this->ref : $this->label), $maxlength);
1993 }
1994
1995 $result .= $linkend;
1996
1997 global $action;
1998 $hookmanager->initHooks(array($this->element . 'dao'));
1999 $parameters = array('id' => $this->id, 'getnomurl' => &$result);
2000 $reshook = $hookmanager->executeHooks('getNomUrl', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
2001 if ($reshook > 0) {
2002 $result = $hookmanager->resPrint;
2003 } else {
2004 $result .= $hookmanager->resPrint;
2005 }
2006 return $result;
2007 }
2008
2009
2010 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
2018 public function add_photo($sdir, $file)
2019 {
2020 // phpcs:enable
2021 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
2022
2023 $dir = $sdir.'/'.get_exdir($this->id, 2, 0, 0, $this, 'category').$this->id."/";
2024 $dir .= "photos/";
2025
2026 if (!file_exists($dir)) {
2027 dol_mkdir($dir);
2028 }
2029
2030 if (file_exists($dir)) {
2031 if (is_array($file['name'])) {
2032 $nbfile = count($file['name']);
2033 for ($i = 0; $i < $nbfile; $i++) {
2034 $originImage = $dir.$file['name'][$i];
2035
2036 // Cree fichier en taille origine
2037 dol_move_uploaded_file($file['tmp_name'][$i], $originImage, 1, 0, 0);
2038
2039 if (file_exists($originImage)) {
2040 // Create thumbs
2041 $this->addThumbs($originImage);
2042 }
2043 }
2044 } else {
2045 $originImage = $dir.$file['name'];
2046
2047 // Cree fichier en taille origine
2048 dol_move_uploaded_file($file['tmp_name'], $originImage, 1, 0, 0);
2049
2050 if (file_exists($originImage)) {
2051 // Create thumbs
2052 $this->addThumbs($originImage);
2053 }
2054 }
2055 }
2056 }
2057
2058 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
2066 public function liste_photos($dir, $nbmax = 0)
2067 {
2068 // phpcs:enable
2069 include_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
2070
2071 $nbphoto = 0;
2072 $tabobj = array();
2073
2074 $dirthumb = $dir.'thumbs/';
2075
2076 if (file_exists($dir)) {
2077 $handle = opendir($dir);
2078 if (is_resource($handle)) {
2079 while (($file = readdir($handle)) !== false) {
2080 if (dol_is_file($dir.$file) && preg_match('/(\.jpeg|\.jpg|\.bmp|\.gif|\.png|\.tiff)$/i', $dir.$file)) {
2081 $nbphoto++;
2082 $photo = $file;
2083
2084 // On determine nom du fichier vignette
2085 $photo_vignette = '';
2086 $regs = array();
2087 if (preg_match('/(\.jpeg|\.jpg|\.bmp|\.gif|\.png|\.tiff)$/i', $photo, $regs)) {
2088 $photo_vignette = preg_replace('/'.$regs[0].'/i', '', $photo).'_small'.$regs[0];
2089 }
2090
2091 // Object
2092 $obj = array();
2093 $obj['photo'] = $photo;
2094 if ($photo_vignette && is_file($dirthumb.$photo_vignette)) {
2095 $obj['photo_vignette'] = 'thumbs/'.$photo_vignette;
2096 } else {
2097 $obj['photo_vignette'] = "";
2098 }
2099
2100 $tabobj[$nbphoto - 1] = $obj;
2101
2102 // On continue ou on arrete de boucler
2103 if ($nbmax && $nbphoto >= $nbmax) {
2104 break;
2105 }
2106 }
2107 }
2108
2109 closedir($handle);
2110 }
2111 }
2112
2113 return $tabobj;
2114 }
2115
2116 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
2123 public function delete_photo($file)
2124 {
2125 // phpcs:enable
2126 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
2127
2128 $dir = dirname($file).'/'; // Chemin du dossier contenant l'image d'origine
2129 $dirthumb = $dir.'/thumbs/'; // Chemin du dossier contenant la vignette
2130 $filename = preg_replace('/'.preg_quote($dir, '/').'/i', '', $file); // Nom du fichier
2131
2132 // On efface l'image d'origine
2133 dol_delete_file($file, 0); // do not use disableglob, ecmfiles will not be deleted
2134
2135 // Si elle existe, on efface la vignette
2136 $regs = array();
2137 if (preg_match('/(\.jpeg|\.jpg|\.bmp|\.gif|\.png|\.tiff)$/i', $filename, $regs)) {
2138 $photo_vignette = preg_replace('/'.$regs[0].'/i', '', $filename).'_small'.$regs[0];
2139 if (file_exists($dirthumb.$photo_vignette)) {
2140 dol_delete_file($dirthumb.$photo_vignette, 1);
2141 }
2142 }
2143 }
2144
2145 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
2152 public function get_image_size($file)
2153 {
2154 // phpcs:enable
2155 $infoImg = getimagesize($file); // Recuperation des infos de l'image
2156 $this->imgWidth = $infoImg[0]; // Largeur de l'image
2157 $this->imgHeight = $infoImg[1]; // Hauteur de l'image
2158 }
2159
2168 public function setMultiLangs(User $user, $notrigger = 0)
2169 {
2170 global $langs;
2171
2172 $langs_available = $langs->get_available_languages();
2173 $current_lang = $langs->getDefaultLang();
2174
2175 foreach ($langs_available as $key => $value) {
2176 $sql = "SELECT rowid";
2177 $sql .= " FROM ".MAIN_DB_PREFIX."categorie_lang";
2178 $sql .= " WHERE fk_category=".((int) $this->id);
2179 $sql .= " AND lang = '".$this->db->escape($key)."'";
2180
2181 $result = $this->db->query($sql);
2182
2183 if ($key == $current_lang) {
2184 $sql2 = '';
2185 if ($this->db->num_rows($result)) { // if there is already a description line for this language
2186 $sql2 = "UPDATE ".MAIN_DB_PREFIX."categorie_lang";
2187 $sql2 .= " SET label = '".$this->db->escape($this->label)."',";
2188 $sql2 .= " description = '".$this->db->escape($this->description)."'";
2189 $sql2 .= " WHERE fk_category = ".((int) $this->id)." AND lang = '".$this->db->escape($key)."'";
2190 } else { // if no line in database
2191 $sql2 = "INSERT INTO ".MAIN_DB_PREFIX."categorie_lang (fk_category, lang, label, description)";
2192 $sql2 .= " VALUES(".((int) $this->id).", '".$this->db->escape($key)."', '".$this->db->escape($this->label)."'";
2193 $sql2 .= ", '".$this->db->escape($this->description)."')";
2194 }
2195 dol_syslog(get_class($this).'::setMultiLangs', LOG_DEBUG);
2196 if (!$this->db->query($sql2)) {
2197 $this->error = $this->db->lasterror();
2198 return -1;
2199 }
2200 $this->multilangs[$key]["label"] = $this->label;
2201 $this->multilangs[$key]["description"] = $this->description;
2202 } elseif (isset($this->multilangs[$key])) { // if there is already a description line for this language
2203 if ($this->db->num_rows($result)) {
2204 $sql2 = "UPDATE ".MAIN_DB_PREFIX."categorie_lang";
2205 $sql2 .= " SET label='".$this->db->escape($this->multilangs[$key]["label"])."',";
2206 $sql2 .= " description='".$this->db->escape($this->multilangs[$key]["description"])."'";
2207 $sql2 .= " WHERE fk_category=".((int) $this->id)." AND lang='".$this->db->escape($key)."'";
2208 } else { // if no line in database
2209 $sql2 = "INSERT INTO ".MAIN_DB_PREFIX."categorie_lang (fk_category, lang, label, description)";
2210 $sql2 .= " VALUES(".((int) $this->id).", '".$this->db->escape($key)."', '".$this->db->escape($this->multilangs[$key]["label"])."'";
2211 $sql2 .= ",'".$this->db->escape($this->multilangs[$key]["description"])."')";
2212 }
2213
2214 // We do not save if main fields are empty
2215 if ($this->multilangs[$key]["label"] || $this->multilangs[$key]["description"]) {
2216 dol_syslog(get_class($this).'::setMultiLangs', LOG_DEBUG);
2217 }
2218 if (!$this->db->query($sql2)) {
2219 $this->error = $this->db->lasterror();
2220 return -1;
2221 }
2222 }
2223 }
2224
2225 // Call trigger
2226 if (!$notrigger) {
2227 $result = $this->call_trigger('CATEGORY_SET_MULTILANGS', $user);
2228 if ($result < 0) {
2229 $this->error = $this->db->lasterror();
2230 return -1;
2231 }
2232 }
2233 // End call triggers
2234
2235 return 1;
2236 }
2237
2247 public function delMultiLangs($langtodelete, $user, $notrigger = 0)
2248 {
2249 $sql = "DELETE FROM ".$this->db->prefix()."categorie_lang";
2250 $sql .= " WHERE fk_category = ".((int) $this->id)." AND lang = '".$this->db->escape($langtodelete)."'";
2251
2252 dol_syslog(get_class($this).'::delMultiLangs', LOG_DEBUG);
2253 $result = $this->db->query($sql);
2254 if ($result) {
2255 if (empty($notrigger)) {
2256 // Call trigger
2257 $result = $this->call_trigger('CATEGORY_DEL_MULTILANGS', $user);
2258 if ($result < 0) {
2259 $this->error = $this->db->lasterror();
2260 dol_syslog(get_class($this).'::delMultiLangs error='.$this->error, LOG_ERR);
2261 return -1;
2262 }
2263 // End call triggers
2264 }
2265 return 1;
2266 } else {
2267 $this->error = $this->db->lasterror();
2268 dol_syslog(get_class($this).'::delMultiLangs error='.$this->error, LOG_ERR);
2269 return -1;
2270 }
2271 }
2272
2278 public function getMultiLangs()
2279 {
2280 global $langs;
2281
2282 $current_lang = $langs->getDefaultLang();
2283
2284 $sql = "SELECT lang, label, description";
2285 $sql .= " FROM ".MAIN_DB_PREFIX."categorie_lang";
2286 $sql .= " WHERE fk_category=".((int) $this->id);
2287
2288 $result = $this->db->query($sql);
2289 if ($result) {
2290 while ($obj = $this->db->fetch_object($result)) {
2291 //print 'lang='.$obj->lang.' current='.$current_lang.'<br>';
2292 if ($obj->lang == $current_lang) { // si on a les traduct. dans la langue courante on les charge en infos principales.
2293 $this->label = $obj->label;
2294 $this->description = $obj->description;
2295 }
2296 $this->multilangs[$obj->lang]["label"] = $obj->label;
2297 $this->multilangs[$obj->lang]["description"] = $obj->description;
2298 }
2299 return 1;
2300 } else {
2301 $this->error = $langs->trans("Error")." : ".$this->db->error()." - ".$sql;
2302 return -1;
2303 }
2304 }
2305
2312 public function getLibStatut($mode)
2313 {
2314 return '';
2315 }
2316
2317
2325 public function initAsSpecimen()
2326 {
2327 dol_syslog(get_class($this)."::initAsSpecimen");
2328
2329 // Initialise parameters
2330 $this->id = 0;
2331 $this->fk_parent = 0;
2332 $this->label = 'SPECIMEN';
2333 $this->specimen = 1;
2334 $this->description = 'This is a description';
2335 $this->socid = 1;
2336 $this->type = self::TYPE_PRODUCT;
2337
2338 return 1;
2339 }
2340
2349 public static function replaceThirdparty(DoliDB $dbs, $origin_id, $dest_id)
2350 {
2351 $tables = array(
2352 'categorie_societe'
2353 );
2354
2355 return CommonObject::commonReplaceThirdparty($dbs, $origin_id, $dest_id, $tables, 1);
2356 }
2357
2366 public static function getFilterJoinQuery($type, $rowIdName)
2367 {
2368 if ($type == 'bank_account') {
2369 $type = 'account';
2370 }
2371
2372 return " LEFT JOIN ".MAIN_DB_PREFIX."categorie_".$type." as cp ON ".$rowIdName." = cp.fk_".$type;
2373 }
2374
2384 public static function getFilterSelectQuery($type, $rowIdName, $searchList)
2385 {
2386 if ($type == 'bank_account') {
2387 $type = 'account';
2388 }
2389 if ($type == 'customer') {
2390 $type = 'societe';
2391 }
2392 if ($type == 'supplier') {
2393 $type = 'fournisseur';
2394 }
2395
2396 if (empty($searchList) && !is_array($searchList)) {
2397 return "";
2398 }
2399
2400 $searchCategorySqlList = array();
2401 foreach ($searchList as $searchCategory) {
2402 if (intval($searchCategory) == -2) {
2403 $searchCategorySqlList[] = " cp.fk_categorie IS NULL";
2404 } elseif (intval($searchCategory) > 0) {
2405 $searchCategorySqlList[] = " ".$rowIdName." IN (SELECT fk_".$type." FROM ".MAIN_DB_PREFIX."categorie_".$type." WHERE fk_categorie = ".((int) $searchCategory).")";
2406 }
2407 }
2408
2409 if (!empty($searchCategorySqlList)) {
2410 return " AND (".implode(' AND ', $searchCategorySqlList).")";
2411 } else {
2412 return "";
2413 }
2414 }
2415
2421 public function countNbOfCategories()
2422 {
2423 dol_syslog(get_class($this)."::count_all_categories", LOG_DEBUG);
2424 $sql = "SELECT COUNT(rowid) FROM ".MAIN_DB_PREFIX."categorie";
2425 $sql .= " WHERE entity IN (".getEntity('category').")";
2426
2427 $res = $this->db->query($sql);
2428 if ($res) {
2429 $obj = $this->db->fetch_object($res);
2430 return $obj->count;
2431 } else {
2432 dol_print_error($this->db);
2433 return -1;
2434 }
2435 }
2436}
print $object position
Definition edit.php:206
$object ref
Definition info.php:90
Class to manage categories.
getListForItem($id, $type='customer', $sortfield="s.rowid", $sortorder='ASC', $limit=0, $page=0)
Return the list of the categories of a given element (a product, a customer, ...).
get_image_size($file)
Load size of image file.
load_motherof()
Load the array this->motherof that is array(id_son=>id_parent, ...), so array of all child categories...
getLibStatut($mode)
Return label of contact status.
delete_photo($file)
Efface la photo de la categorie et sa vignette.
containing($id, $type, $mode='object')
Return list of categories (object instances or labels) linked to a given object having id $id and typ...
getTooltipContentArray($params)
getTooltipContentArray
countNbOfCategories()
Count all categories.
del_type($obj, $type)
Delete object from category.
buildPathFromId($id_categ, $protection=1000)
For category id_categ and its children available in this->cats, define property fullpath and fulllabe...
static getFilterSelectQuery($type, $rowIdName, $searchList)
Return the additional SQL SELECT query for filtering a list by a category.
create($user, $notrigger=0)
Add category into database.
rechercher($id, $nom, $type, $exact=false, $case=false)
Returns categories whose id or name matches.
getMultiLangs()
Load array this->multilangs.
isAnyPhotoAvailable($sdir)
Return if at least one photo is available.
already_exists()
Check if a category with same label already exists for this cat's parent or root and for this cat's t...
get_filles()
Return direct children ids of a category into an array.
initAsSpecimen()
Initialise an instance with random values.
get_all_categories($type=null, $parent=false)
Returns all categories.
static getFilterJoinQuery($type, $rowIdName)
Return the additional SQL JOIN query for filtering a list by a category.
containsObject($type, $object_id)
Check for the presence of a given object in the current category.
get_main_categories($type=null)
Returns the first level categories (which are not child)
getMapId()
Get MAP_ID.
static replaceThirdparty(DoliDB $dbs, $origin_id, $dest_id)
Function used to replace a thirdparty id with another one.
setMultiLangs(User $user, $notrigger=0)
Create or Update translations of categories labels.
getMapList()
Get map list.
$fields
'type' if the field format ('integer', 'integer:ObjectClass:PathToClass[:AddCreateButtonOrNot[:Filter...
get_meres()
Returns an array containing the list of parent categories Note: A category can only have one parent b...
get_full_arbo($type, $fromid=0, $include=0, $forcelangcode='')
Rebuilding the category tree as an array Return an array of table('id','id_mere',....
add_type($obj, $type='')
Link an object to the category.
print_all_ways($sep='auto', $url='', $nocolor=0, $addpicto=0, $notrunc=0)
Returns the path of the category, with the names of the categories separated by $sep (" >> " by defau...
update(User $user, $notrigger=0)
Update category.
liste_photos($dir, $nbmax=0)
Return an array with all photos inside the directory.
get_all_ways()
Returns in a array all possible paths to go to the category starting with the major categories repres...
getNomUrl($withpicto=0, $option='', $maxlength=0, $moreparam='', $notooltip=0, $morecss='', $save_lastsearch_value=0)
Return name and link of category (with picto) Use ->id, ->ref, ->label, ->color.
delMultiLangs($langtodelete, $user, $notrigger=0)
Delete a language for this category.
add_photo($sdir, $file)
Add the image uploaded as $file to the directory $sdir/<category>-<id>/photos/.
fetch($id, $label='', $type=null, $ref_ext='')
Load category into memory from database.
Parent class of all other business classes (invoices, contracts, proposals, orders,...
fetch_optionals($rowid=null, $optionsArray=null)
Function to get extra fields of an object into $this->array_options This method is in most cases call...
deleteExtraFields()
Delete all extra fields values for the current object.
static commonReplaceThirdparty(DoliDB $dbs, $origin_id, $dest_id, array $tables, $ignoreerrors=0)
Function used to replace a thirdparty id with another one.
insertExtraFields($trigger='', $userused=null)
Add/Update all extra fields values for the current object.
addThumbs($file, $quality=50)
Build thumb.
Class to manage Dolibarr database access.
Class to manage Dolibarr users.
print $script_file $mode $langs defaultlang(is_numeric($duration_value) ? " delay=". $duration_value :"").(is_numeric($duration_value2) ? " after cd cd cd description as description
Only used if Module[ID]Desc translation string is not found.
if(!isModEnabled('ai')||!getDolGlobalString('AI_ASSISTANT_ENABLED')) global $conf
The main.inc.php has been included so the following variable are now defined:
dol_delete_file($file, $disableglob=0, $nophperrors=0, $nohook=0, $object=null, $allowdotdot=false, $indexdatabase=1, $nolog=0)
Remove a file or several files with a mask.
dol_is_file($pathoffile)
Return if path is a file.
dol_move_uploaded_file($src_file, $dest_file, $allowoverwrite, $disablevirusscan=0, $uploaderrorcode=0, $nohook=0, $keyforsourcefile='addedfile', $upload_dir='', $mode=0)
Check validity of a file upload from an GUI page, and move it to its final destination.
dol_now($mode='gmt')
Return date for now.
dol_osencode($str)
Return a string encoded into OS filesystem encoding.
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $allowothertags=array())
Show a picto called object_picto (generic function)
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
dol_sort_array(&$array, $index, $order='asc', $natsort=0, $case_sensitive=0, $keepindex=0)
Advanced sort array by the value of a given key, which produces ascending (default) or descending out...
dol_print_error($db=null, $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
dol_trunc($string, $size=40, $trunc='right', $stringencoding='UTF-8', $nodot=0, $display=0)
Truncate a string to a particular length adding '…' if string larger than length.
getDolGlobalString($key, $default='')
Return a Dolibarr global constant string value.
sanitizeVal($out='', $check='alphanohtml', $filter=null, $options=null)
Return a sanitized or empty value after checking value against a rule.
isModEnabled($module)
Is Dolibarr module enabled.
utf8_check($str)
Check if a string is in UTF8.
get_exdir($num, $level, $alpha, $withoutslash, $object, $modulepart='')
Return a path to have a the directory according to object where files are stored.
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.
getEntity($element, $shared=1, $currentobject=null)
Get list of entity id to use.
dol_mkdir($dir, $dataroot='', $newmask='')
Creation of a directory (this can create recursive subdir)
image_format_supported($file, $acceptsvg=0)
Return if a filename is file name of a supported image format.
print $langs trans("Show") . '< td style="' . $timeColor . '" align="center"> s</td > badge status0 badge status4 badge status3 Error badge status8< td align="center">< span class="badge ' . $badge . '"></span ></td >< td align="center">< a href="#" class="button button-small" onclick="openLogModal(this)" data-req="' . dol_escape_htmltag($reqSafe) . '" data-res="' . dol_escape_htmltag($resSafe) . '" data-err="' . dol_escape_htmltag($errSafe) . '">< span class="fa fa-search-plus"></span ></a ></td ></tr >< tr >< td colspan="' . $colspan . '" class="opacitymedium"></td ></tr ></table ></div ></form > logModal none logModal none s a JSON string
buildzip.php
if(preg_match('/(crypted|dolcrypt):/i', $dolibarr_main_db_pass)||!empty($dolibarr_main_db_encrypted_pass)) $conf db type
'integer', 'integer:ObjectClass:PathToClass[:AddCreateButtonOrNot[:Filter[:Sortfield]]]',...
Definition repair.php:130