dolibarr 21.0.0-alpha
dolresource.class.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2013-2015 Jean-François Ferry <jfefe@aternatik.fr>
3 * Copyright (C) 2023-2024 William Mead <william.mead@manchenumerique.fr>
4 * Copyright (C) 2024 MDW <mdeweerd@users.noreply.github.com>
5 * Copyright (C) 2024 Frédéric France <frederic.france@free.fr>
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 3 of the License, or
10 * (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
19 */
20
27require_once DOL_DOCUMENT_ROOT."/core/class/commonobject.class.php";
28require_once DOL_DOCUMENT_ROOT."/core/lib/functions2.lib.php";
29require_once DOL_DOCUMENT_ROOT.'/core/class/commonpeople.class.php';
30
35{
36 use CommonPeople;
37
41 public $element = 'dolresource';
42
46 public $table_element = 'resource';
47
51 public $picto = 'resource';
52
56 public $description;
57
61 public $phone;
62
66 public $max_users;
67
71 public $fk_code_type_resource;
72
73 public $type_label;
74
81 public $resource_id;
82
86 public $resource_type;
87
94 public $element_id;
95
99 public $element_type;
100
104 public $busy;
105
109 public $mandatory;
110
114 public $fulldayevent;
115
119 public $fk_user_create;
120
125
129 public $cache_code_type_resource;
130
134 public $oldcopy;
135
136
142 public function __construct(DoliDB $db)
143 {
144 $this->db = $db;
145 $this->status = 0;
146
147 $this->cache_code_type_resource = array();
148 }
149
157 public function create(User $user, int $no_trigger = 0)
158 {
159 $error = 0;
160 $this->date_creation = dol_now();
161
162 // Clean parameters
163 $new_resource_values = [
164 $this->ref,
165 $this->address,
166 $this->zip,
167 $this->town,
168 $this->country_id,
169 $this->state_id,
170 $this->description,
171 $this->phone,
172 $this->email,
173 $this->max_users,
174 $this->url,
175 $this->fk_code_type_resource,
176 $this->note_public,
177 $this->note_private,
178 ];
179 foreach ($new_resource_values as $key => $value) {
180 if (isset($value)) {
181 $new_resource_values[$key] = trim($value);
182 }
183 }
184
185 // Insert request
186 $sql = "INSERT INTO ".MAIN_DB_PREFIX.$this->table_element."(";
187 $sql .= "entity,";
188 $sql .= "ref,";
189 $sql .= "address,";
190 $sql .= "zip,";
191 $sql .= "town,";
192 $sql .= "fk_country,";
193 $sql .= "fk_state,";
194 $sql .= "description,";
195 $sql .= "phone,";
196 $sql .= "email,";
197 $sql .= "max_users,";
198 $sql .= "url,";
199 $sql .= "fk_code_type_resource,";
200 $sql .= "note_public,";
201 $sql .= "note_private, ";
202 $sql .= "datec, ";
203 $sql .= "fk_user_author ";
204 $sql .= ") VALUES (";
205 $sql .= getEntity('resource') . ", ";
206 foreach ($new_resource_values as $value) {
207 $sql .= " " . ((isset($value) && $value > 0) ? "'" . $this->db->escape($value) . "'" : 'NULL') . ",";
208 }
209 $sql .= " '" . $this->db->idate($this->date_creation) . "',";
210 $sql .= " " . (!empty($user->id) ? ((int) $user->id) : "null");
211 $sql .= ")";
212
213 // Database session
214 $this->db->begin();
215 try {
216 dol_syslog(get_class($this) . "::create", LOG_DEBUG);
217 } catch (Exception $exception) {
218 error_log('dol_syslog error: ' . $exception->getMessage());
219 }
220 $resql = $this->db->query($sql);
221 if (!$resql) {
222 $error++;
223 $this->errors[] = "Error ".$this->db->lasterror();
224 }
225
226 if (!$error) {
227 $this->id = $this->db->last_insert_id(MAIN_DB_PREFIX.$this->table_element);
228 $result = $this->insertExtraFields();
229 if ($result < 0) {
230 $error = -1;
231 }
232 }
233
234 if (!$error && !$no_trigger) {
235 $result = $this->call_trigger('RESOURCE_CREATE', $user);
236 if ($result < 0) {
237 $error = -1;
238 }
239 }
240
241 // Commit or rollback
242 if ($error) {
243 foreach ($this->errors as $errmsg) {
244 try {
245 dol_syslog(get_class($this) . "::create " . $errmsg, LOG_ERR);
246 } catch (Exception $exception) {
247 error_log('dol_syslog error: ' . $exception->getMessage());
248 }
249 $this->error .= ($this->error ? ', '.$errmsg : $errmsg);
250 }
251 $this->db->rollback();
252 return $error;
253 } else {
254 $this->db->commit();
255 return $this->id;
256 }
257 }
258
266 public function fetch(int $id, string $ref = '')
267 {
268 $sql = "SELECT";
269 $sql .= " t.rowid,";
270 $sql .= " t.entity,";
271 $sql .= " t.ref,";
272 $sql .= " t.address,";
273 $sql .= " t.zip,";
274 $sql .= " t.town,";
275 $sql .= " t.fk_country,";
276 $sql .= " t.fk_state,";
277 $sql .= " t.description,";
278 $sql .= " t.phone,";
279 $sql .= " t.email,";
280 $sql .= " t.max_users,";
281 $sql .= " t.url,";
282 $sql .= " t.fk_code_type_resource,";
283 $sql .= " t.note_public,";
284 $sql .= " t.note_private,";
285 $sql .= " t.tms as date_modification,";
286 $sql .= " t.datec as date_creation,";
287 $sql .= " ty.label as type_label";
288 $sql .= " FROM ".MAIN_DB_PREFIX.$this->table_element." as t";
289 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX."c_type_resource as ty ON ty.code=t.fk_code_type_resource";
290 if ($id) {
291 $sql .= " WHERE t.rowid = ".($id);
292 } else {
293 $sql .= " WHERE t.ref = '".$this->db->escape($ref)."'";
294 }
295
296 dol_syslog(get_class($this)."::fetch", LOG_DEBUG);
297 $resql = $this->db->query($sql);
298 if ($resql) {
299 if ($this->db->num_rows($resql)) {
300 $obj = $this->db->fetch_object($resql);
301
302 $this->id = $obj->rowid;
303 $this->entity = $obj->entity;
304 $this->ref = $obj->ref;
305 $this->address = $obj->address;
306 $this->zip = $obj->zip;
307 $this->town = $obj->town;
308 $this->country_id = $obj->fk_country;
309 $this->state_id = $obj->fk_state;
310 $this->description = $obj->description;
311 $this->phone = $obj->phone;
312 $this->email = $obj->email;
313 $this->max_users = $obj->max_users;
314 $this->url = $obj->url;
315 $this->fk_code_type_resource = $obj->fk_code_type_resource;
316 $this->note_public = $obj->note_public;
317 $this->note_private = $obj->note_private;
318 $this->date_creation = $this->db->jdate($obj->date_creation);
319 $this->date_modification = $this->db->jdate($obj->date_modification);
320 $this->type_label = $obj->type_label;
321
322 // Retrieve all extrafield
323 // fetch optionals attributes and labels
324 $this->fetch_optionals();
325 }
326 $this->db->free($resql);
327
328 return $this->id;
329 } else {
330 $this->error = "Error ".$this->db->lasterror();
331 dol_syslog(get_class($this)."::fetch ".$this->error, LOG_ERR);
332 return -1;
333 }
334 }
335
336
344 public function update(User $user = null, int $notrigger = 0)
345 {
346 global $conf, $langs;
347 $error = 0;
348 $this->date_modification = dol_now();
349
350 // Clean parameters
351 if (isset($this->ref)) {
352 $this->ref = trim($this->ref);
353 }
354 if (isset($this->address)) {
355 $this->address = trim($this->address);
356 }
357 if (isset($this->zip)) {
358 $this->zip = trim($this->zip);
359 }
360 if (isset($this->town)) {
361 $this->town = trim($this->town);
362 }
363 if (!is_numeric($this->country_id)) {
364 $this->country_id = 0;
365 }
366 if (!is_numeric($this->state_id)) {
367 $this->state_id = 0;
368 }
369 if (isset($this->description)) {
370 $this->description = trim($this->description);
371 }
372 if (isset($this->phone)) {
373 $this->phone = trim($this->phone);
374 }
375 if (isset($this->email)) {
376 $this->email = trim($this->email);
377 }
378 if (!is_numeric($this->max_users)) {
379 $this->max_users = 0;
380 }
381 if (isset($this->url)) {
382 $this->url = trim($this->url);
383 }
384 if (isset($this->fk_code_type_resource)) {
385 $this->fk_code_type_resource = trim($this->fk_code_type_resource);
386 }
387
388 // $this->oldcopy should have been set by the caller of update (here properties were already modified)
389 if (is_null($this->oldcopy) || (is_object($this->oldcopy) && $this->oldcopy->isEmpty())) {
390 $this->oldcopy = dol_clone($this, 2);
391 }
392
393 // Update request
394 $sql = "UPDATE ".MAIN_DB_PREFIX.$this->table_element." SET";
395 $sql .= " ref=".(isset($this->ref) ? "'".$this->db->escape($this->ref)."'" : "null").",";
396 $sql .= " address=".(isset($this->address) ? "'".$this->db->escape($this->address)."'" : "null").",";
397 $sql .= " zip=".(isset($this->zip) ? "'".$this->db->escape($this->zip)."'" : "null").",";
398 $sql .= " town=".(isset($this->town) ? "'".$this->db->escape($this->town)."'" : "null").",";
399 $sql .= " fk_country=".($this->country_id > 0 ? (int) $this->country_id : "null").",";
400 $sql .= " fk_state=".($this->state_id > 0 ? (int) $this->state_id : "null").",";
401 $sql .= " description=".(isset($this->description) ? "'".$this->db->escape($this->description)."'" : "null").",";
402 $sql .= " phone=".(isset($this->phone) ? "'".$this->db->escape($this->phone)."'" : "null").",";
403 $sql .= " email=".(isset($this->email) ? "'".$this->db->escape($this->email)."'" : "null").",";
404 $sql .= " max_users=".(isset($this->max_users) ? (int) $this->max_users : "null").",";
405 $sql .= " url=".(isset($this->url) ? "'".$this->db->escape($this->url)."'" : "null").",";
406 $sql .= " fk_code_type_resource=".(isset($this->fk_code_type_resource) ? "'".$this->db->escape($this->fk_code_type_resource)."'" : "null").",";
407 $sql .= " tms=" . ("'" . $this->db->idate($this->date_modification) . "',");
408 $sql .= " fk_user_modif=" . (!empty($user->id) ? ((int) $user->id) : "null");
409 $sql .= " WHERE rowid=".((int) $this->id);
410
411 $this->db->begin();
412
413 dol_syslog(get_class($this)."::update", LOG_DEBUG);
414 $resql = $this->db->query($sql);
415 if (!$resql) {
416 $error++;
417 $this->errors[] = "Error ".$this->db->lasterror();
418 }
419
420 if (!$error) {
421 if (!$notrigger) {
422 // Call trigger
423 $result = $this->call_trigger('RESOURCE_MODIFY', $user);
424 if ($result < 0) {
425 $error++;
426 }
427 // End call triggers
428 }
429 }
430
431 if (!$error && (is_object($this->oldcopy) && $this->oldcopy->ref !== $this->ref)) {
432 // We remove directory
433 if (!empty($conf->resource->dir_output)) {
434 $olddir = $conf->resource->dir_output."/".dol_sanitizeFileName($this->oldcopy->ref);
435 $newdir = $conf->resource->dir_output."/".dol_sanitizeFileName($this->ref);
436 if (file_exists($olddir)) {
437 $res = @rename($olddir, $newdir);
438 if (!$res) {
439 $langs->load("errors");
440 $this->error = $langs->trans('ErrorFailToRenameDir', $olddir, $newdir);
441 $error++;
442 }
443 }
444 }
445 }
446
447 if (!$error) {
448 // Actions on extra fields
449 $result = $this->insertExtraFields();
450 if ($result < 0) {
451 $error++;
452 }
453 }
454
455 // Commit or rollback
456 if ($error) {
457 foreach ($this->errors as $errmsg) {
458 dol_syslog(get_class($this)."::update ".$errmsg, LOG_ERR);
459 $this->error .= ($this->error ? ', '.$errmsg : $errmsg);
460 }
461 $this->db->rollback();
462 return -1 * $error;
463 } else {
464 $this->db->commit();
465 return 1;
466 }
467 }
468
475 public function fetchElementResource(int $id)
476 {
477 $sql = "SELECT";
478 $sql .= " t.rowid,";
479 $sql .= " t.resource_id,";
480 $sql .= " t.resource_type,";
481 $sql .= " t.element_id,";
482 $sql .= " t.element_type,";
483 $sql .= " t.busy,";
484 $sql .= " t.mandatory,";
485 $sql .= " t.fk_user_create,";
486 $sql .= " t.tms as date_modification";
487 $sql .= " FROM ".MAIN_DB_PREFIX."element_resources as t";
488 $sql .= " WHERE t.rowid = ".($id);
489
490 dol_syslog(get_class($this)."::fetch", LOG_DEBUG);
491 $resql = $this->db->query($sql);
492 if ($resql) {
493 if ($this->db->num_rows($resql)) {
494 $obj = $this->db->fetch_object($resql);
495
496 $this->id = $obj->rowid;
497 $this->resource_id = $obj->resource_id;
498 $this->resource_type = $obj->resource_type;
499 $this->element_id = $obj->element_id;
500 $this->element_type = $obj->element_type;
501 $this->busy = $obj->busy;
502 $this->mandatory = $obj->mandatory;
503 $this->fk_user_create = $obj->fk_user_create;
504 $this->date_modification = $obj->date_modification;
505
506 /*if ($obj->resource_id && $obj->resource_type) {
507 $this->objresource = fetchObjectByElement($obj->resource_id, $obj->resource_type);
508 }*/
509 if ($obj->element_id && $obj->element_type) {
510 $this->objelement = fetchObjectByElement($obj->element_id, $obj->element_type);
511 }
512 }
513 $this->db->free($resql);
514
515 return $this->id;
516 } else {
517 $this->error = "Error ".$this->db->lasterror();
518 return -1;
519 }
520 }
521
529 public function delete(User $user, int $notrigger = 0)
530 {
531 global $conf;
532
533 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
534
535 $rowid = $this->id;
536
537 $error = 0;
538
539 $this->db->begin();
540
541 $sql = "DELETE FROM ".MAIN_DB_PREFIX.$this->table_element;
542 $sql .= " WHERE rowid = ".($rowid);
543
544 dol_syslog(get_class($this), LOG_DEBUG);
545 if ($this->db->query($sql)) {
546 $sql = "DELETE FROM ".MAIN_DB_PREFIX."element_resources";
547 $sql .= " WHERE element_type='resource' AND resource_id = ".((int) $rowid);
548 dol_syslog(get_class($this)."::delete", LOG_DEBUG);
549 $resql = $this->db->query($sql);
550 if (!$resql) {
551 $this->error = $this->db->lasterror();
552 $error++;
553 }
554 } else {
555 $this->error = $this->db->lasterror();
556 $error++;
557 }
558
559 // Removed extrafields
560 if (!$error) {
561 $result = $this->deleteExtraFields();
562 if ($result < 0) {
563 $error++;
564 dol_syslog(get_class($this)."::delete error -3 ".$this->error, LOG_ERR);
565 }
566 }
567
568 if (!$notrigger) {
569 // Call trigger
570 $result = $this->call_trigger('RESOURCE_DELETE', $user);
571 if ($result < 0) {
572 $error++;
573 }
574 // End call triggers
575 }
576
577 if (!$error) {
578 // We remove directory
580 if (!empty($conf->resource->dir_output)) {
581 $dir = $conf->resource->dir_output."/".dol_sanitizeFileName($this->ref);
582 if (file_exists($dir)) {
583 $res = @dol_delete_dir_recursive($dir);
584 if (!$res) {
585 $this->errors[] = 'ErrorFailToDeleteDir';
586 $error++;
587 }
588 }
589 }
590 }
591
592 if (!$error) {
593 $this->db->commit();
594 return 1;
595 } else {
596 $this->db->rollback();
597 return -1;
598 }
599 }
600
611 public function fetchAll(string $sortorder, string $sortfield, int $limit, int $offset, $filter = '')
612 {
613 require_once DOL_DOCUMENT_ROOT.'/core/class/extrafields.class.php';
614 $extrafields = new ExtraFields($this->db);
615
616 $sql = "SELECT ";
617 $sql .= " t.rowid,";
618 $sql .= " t.entity,";
619 $sql .= " t.ref,";
620 $sql .= " t.address,";
621 $sql .= " t.zip,";
622 $sql .= " t.town,";
623 $sql .= " t.fk_country,";
624 $sql .= " t.fk_state,";
625 $sql .= " t.description,";
626 $sql .= " t.phone,";
627 $sql .= " t.email,";
628 $sql .= " t.max_users,";
629 $sql .= " t.url,";
630 $sql .= " t.fk_code_type_resource,";
631 $sql .= " t.tms as date_modification,";
632 $sql .= " t.datec as date_creation,";
633 // Add fields from extrafields
634 if (!empty($extrafields->attributes[$this->table_element]) && !empty($extrafields->attributes[$this->table_element]['label'])) {
635 foreach ($extrafields->attributes[$this->table_element]['label'] as $key => $val) {
636 $sql .= ($extrafields->attributes[$this->table_element]['type'][$key] != 'separate' ? "ef.".$key." as options_".$key.', ' : '');
637 }
638 }
639 $sql .= " ty.label as type_label";
640 $sql .= " FROM ".MAIN_DB_PREFIX.$this->table_element." as t";
641 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX."c_type_resource as ty ON ty.code=t.fk_code_type_resource";
642 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX.$this->table_element."_extrafields as ef ON ef.fk_object=t.rowid";
643 $sql .= " WHERE t.entity IN (".getEntity('resource').")";
644
645 // Manage filter
646 if (is_array($filter)) {
647 foreach ($filter as $key => $value) {
648 if (strpos($key, 'date')) {
649 $sql .= " AND ".$this->db->sanitize($key)." = '".$this->db->idate($value)."'";
650 } elseif (strpos($key, 'ef.') !== false) {
651 $sql .= " AND ".$this->db->sanitize($key)." = ".((float) $value);
652 } else {
653 $sql .= " AND ".$this->db->sanitize($key)." LIKE '%".$this->db->escape($this->db->escapeforlike($value))."%'";
654 }
655 }
656
657 $filter = '';
658 }
659
660 // Manage filter
661 $errormessage = '';
662 $sql .= forgeSQLFromUniversalSearchCriteria($filter, $errormessage);
663 if ($errormessage) {
664 $this->errors[] = $errormessage;
665 dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
666 return -1;
667 }
668
669 $sql .= $this->db->order($sortfield, $sortorder);
670 if ($limit) {
671 $sql .= $this->db->plimit($limit, $offset);
672 }
673
674 dol_syslog(get_class($this)."::fetchAll", LOG_DEBUG);
675
676 $this->lines = array();
677 $resql = $this->db->query($sql);
678 if ($resql) {
679 $num = $this->db->num_rows($resql);
680 if ($num) {
681 while ($obj = $this->db->fetch_object($resql)) {
682 $line = new Dolresource($this->db);
683 $line->id = $obj->rowid;
684 $line->ref = $obj->ref;
685 $line->address = $obj->address;
686 $line->zip = $obj->zip;
687 $line->town = $obj->town;
688 $line->country_id = $obj->fk_country;
689 $line->state_id = $obj->fk_state;
690 $line->description = $obj->description;
691 $this->phone = $obj->phone;
692 $this->email = $obj->email;
693 $this->max_users = $obj->max_users;
694 $this->url = $obj->url;
695 $line->fk_code_type_resource = $obj->fk_code_type_resource;
696 $line->date_modification = $obj->date_modification;
697 $line->date_creation = $obj->date_creation;
698 $line->type_label = $obj->type_label;
699
700 // fetch optionals attributes and labels
701
702 $line->fetch_optionals();
703
704 $this->lines[] = $line;
705 }
706 $this->db->free($resql);
707 }
708 return $num;
709 } else {
710 $this->error = $this->db->lasterror();
711 return -1;
712 }
713 }
714
722 public function updateElementResource(User $user = null, int $notrigger = 0)
723 {
724 $error = 0;
725 $this->date_modification = dol_now();
726
727 // Clean parameters
728 if (!is_numeric($this->resource_id)) {
729 $this->resource_id = 0;
730 }
731 if (isset($this->resource_type)) {
732 $this->resource_type = trim($this->resource_type);
733 }
734 if (!is_numeric($this->element_id)) {
735 $this->element_id = 0;
736 }
737 if (isset($this->element_type)) {
738 $this->element_type = trim($this->element_type);
739 }
740 if (isset($this->busy)) {
741 $this->busy = (int) $this->busy;
742 }
743 if (isset($this->mandatory)) {
744 $this->mandatory = (int) $this->mandatory;
745 }
746
747 // Update request
748 $sql = "UPDATE ".MAIN_DB_PREFIX."element_resources SET";
749 $sql .= " resource_id = ".(isset($this->resource_id) ? (int) $this->resource_id : "null").",";
750 $sql .= " resource_type = ".(isset($this->resource_type) ? "'".$this->db->escape($this->resource_type)."'" : "null").",";
751 $sql .= " element_id = ".(isset($this->element_id) ? (int) $this->element_id : "null").",";
752 $sql .= " element_type = ".(isset($this->element_type) ? "'".$this->db->escape($this->element_type)."'" : "null").",";
753 $sql .= " busy = ".(isset($this->busy) ? (int) $this->busy : "null").",";
754 $sql .= " mandatory = ".(isset($this->mandatory) ? (int) $this->mandatory : "null").",";
755 $sql .= " tms = ".(dol_strlen($this->date_modification) != 0 ? "'".$this->db->idate($this->date_modification)."'" : 'null');
756 $sql .= " WHERE rowid=".((int) $this->id);
757
758 $this->db->begin();
759
760 dol_syslog(get_class($this)."::update", LOG_DEBUG);
761 $resql = $this->db->query($sql);
762 if (!$resql) {
763 $error++;
764 $this->errors[] = "Error ".$this->db->lasterror();
765 }
766
767 if (!$error) {
768 if (!$notrigger) {
769 // Call trigger
770 $result = $this->call_trigger('RESOURCE_MODIFY', $user);
771 if ($result < 0) {
772 $error++;
773 }
774 // End call triggers
775 }
776 }
777
778 // Commit or rollback
779 if ($error) {
780 foreach ($this->errors as $errmsg) {
781 dol_syslog(get_class($this)."::update ".$errmsg, LOG_ERR);
782 $this->error .= ($this->error ? ', '.$errmsg : $errmsg);
783 }
784 $this->db->rollback();
785 return -1 * $error;
786 } else {
787 $this->db->commit();
788 return 1;
789 }
790 }
791
792
801 public function getElementResources(string $element, int $element_id, string $resource_type = '')
802 {
803 // Links between objects are stored in this table
804 $sql = 'SELECT rowid, resource_id, resource_type, busy, mandatory';
805 $sql .= ' FROM '.MAIN_DB_PREFIX.'element_resources';
806 $sql .= " WHERE element_id=".((int) $element_id)." AND element_type='".$this->db->escape($element)."'";
807 if ($resource_type) {
808 $sql .= " AND resource_type LIKE '%".$this->db->escape($resource_type)."%'";
809 }
810 $sql .= ' ORDER BY resource_type';
811
812 dol_syslog(get_class($this)."::getElementResources", LOG_DEBUG);
813
814 $resources = array();
815 $resql = $this->db->query($sql);
816 if ($resql) {
817 $num = $this->db->num_rows($resql);
818 $i = 0;
819 while ($i < $num) {
820 $obj = $this->db->fetch_object($resql);
821
822 $resources[$i] = array(
823 'rowid' => $obj->rowid,
824 'resource_id' => $obj->resource_id,
825 'resource_type' => $obj->resource_type,
826 'busy' => $obj->busy,
827 'mandatory' => $obj->mandatory
828 );
829 $i++;
830 }
831 }
832
833 return $resources;
834 }
835
843 public function fetchElementResources(string $elementType, int $elementId)
844 {
845 $resources = $this->getElementResources($elementType, $elementId);
846 $i = 0;
847 foreach ($resources as $resource) {
848 $this->lines[$i] = fetchObjectByElement($resource['resource_id'], $resource['resource_type']);
849 $i++;
850 }
851 return $i;
852 }
853
860 {
861 global $langs;
862
863 if (is_array($this->cache_code_type_resource) && count($this->cache_code_type_resource)) {
864 return 0; // Cache deja charge
865 }
866
867 $sql = "SELECT rowid, code, label, active";
868 $sql .= " FROM ".MAIN_DB_PREFIX."c_type_resource";
869 $sql .= " WHERE active > 0";
870 $sql .= " ORDER BY rowid";
871 dol_syslog(get_class($this)."::load_cache_code_type_resource", LOG_DEBUG);
872 $resql = $this->db->query($sql);
873 if ($resql) {
874 $num = $this->db->num_rows($resql);
875 $i = 0;
876 while ($i < $num) {
877 $obj = $this->db->fetch_object($resql);
878
879 $label = ($langs->trans("ResourceTypeShort".$obj->code) != "ResourceTypeShort".$obj->code ? $langs->trans("ResourceTypeShort".$obj->code) : ($obj->label != '-' ? $obj->label : ''));
880 $this->cache_code_type_resource[$obj->rowid]['code'] = $obj->code;
881 $this->cache_code_type_resource[$obj->rowid]['label'] = $label;
882 $this->cache_code_type_resource[$obj->rowid]['active'] = $obj->active;
883 $i++;
884 }
885 return $num;
886 } else {
887 dol_print_error($this->db);
888 return -1;
889 }
890 }
891
898 public function getTooltipContentArray($params)
899 {
900 global $langs;
901
902 $langs->load('resource');
903
904 $datas = [];
905
906 $datas['picto'] = img_picto('', $this->picto).' <u>'.$langs->trans("Resource").'</u>';
907 $datas['ref'] = '<br><b>'.$langs->trans('Ref').':</b> '.$this->ref;
908 /*if (isset($this->status)) {
909 $datas['status'] = '<br><b>' . $langs->trans("Status").":</b> ".$this->getLibStatut(5);
910 }*/
911 if (isset($this->type_label)) {
912 $datas['label'] = '<br><b>'.$langs->trans("ResourceType").":</b> ".$this->type_label;
913 }
914
915 return $datas;
916 }
917
929 public function getNomUrl(int $withpicto = 0, string $option = '', string $get_params = '', int $notooltip = 0, string $morecss = '', int $save_lastsearch_value = -1)
930 {
931 global $langs, $hookmanager, $action;
932
933 $result = '';
934 $params = [
935 'id' => $this->id,
936 'objecttype' => $this->element,
937 ];
938 $classfortooltip = 'classfortooltip';
939 $dataparams = '';
940 if (getDolGlobalInt('MAIN_ENABLE_AJAX_TOOLTIP')) {
941 $classfortooltip = 'classforajaxtooltip';
942 $dataparams = ' data-params="'.dol_escape_htmltag(json_encode($params)).'"';
943 $label = '';
944 } else {
945 $label = implode($this->getTooltipContentArray($params));
946 }
947
948 $url = DOL_URL_ROOT.'/resource/card.php?id='.$this->id;
949
950 if ($option != 'nolink') {
951 // Add param to save lastsearch_values or not
952 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
953 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
954 $add_save_lastsearch_values = 1;
955 }
956 if ($add_save_lastsearch_values) {
957 $url .= '&save_lastsearch_values=1';
958 }
959 }
960
961 $linkclose = '';
962 if (empty($notooltip)) {
963 if (getDolGlobalString('MAIN_OPTIMIZEFORTEXTBROWSER')) {
964 $label = $langs->trans("ShowMyObject");
965 $linkclose .= ' alt="'.dol_escape_htmltag($label, 1).'"';
966 }
967 $linkclose .= ($label ? ' title="'.dol_escape_htmltag($label, 1).'"' : ' title="tocomplete"');
968 $linkclose .= $dataparams.' class="'.$classfortooltip.($morecss ? ' '.$morecss : '').'"';
969 } else {
970 $linkclose = ($morecss ? ' class="'.$morecss.'"' : '');
971 }
972
973 $linkstart = '<a href="'.$url.$get_params.'"';
974 $linkstart .= $linkclose.'>';
975 $linkend = '</a>';
976 /*$linkstart = '<a href="'.DOL_URL_ROOT.'/resource/card.php?id='.$this->id.$get_params.'" title="'.dol_escape_htmltag($label, 1).'" class="classfortooltip">';
977 $linkend = '</a>';*/
978
979 $result .= $linkstart;
980 if ($withpicto) {
981 $result .= img_object(($notooltip ? '' : $label), ($this->picto ?: 'generic'), (($withpicto != 2) ? 'class="paddingright"' : ''), 0, 0, $notooltip ? 0 : 1);
982 }
983 if ($withpicto != 2) {
984 $result .= $this->ref;
985 }
986 $result .= $linkend;
987
988 $hookmanager->initHooks(array($this->element . 'dao'));
989 $parameters = array('id' => $this->id, 'getnomurl' => &$result);
990 $reshook = $hookmanager->executeHooks('getNomUrl', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
991 if ($reshook > 0) {
992 $result = $hookmanager->resPrint;
993 } else {
994 $result .= $hookmanager->resPrint;
995 }
996 return $result;
997 }
998
999
1006 public function getLibStatut(int $mode = 0)
1007 {
1008 return $this->getLibStatusLabel($this->status, $mode);
1009 }
1010
1018 public static function getLibStatusLabel(int $status, int $mode = 0)
1019 {
1020 return '';
1021 }
1022
1028 public function loadStateBoard()
1029 {
1030 $this->nb = array();
1031
1032 $sql = "SELECT count(r.rowid) as nb";
1033 $sql .= " FROM ".MAIN_DB_PREFIX."resource as r";
1034 $sql .= " WHERE r.entity IN (".getEntity('resource').")";
1035
1036 $resql = $this->db->query($sql);
1037 if ($resql) {
1038 while ($obj = $this->db->fetch_object($resql)) {
1039 $this->nb["dolresource"] = $obj->nb;
1040 }
1041 $this->db->free($resql);
1042 return 1;
1043 } else {
1044 dol_print_error($this->db);
1045 $this->error = $this->db->error();
1046 return -1;
1047 }
1048 }
1049}
print $langs trans("AuditedSecurityEvents").'</strong >< span class="opacitymedium"></span >< br > status
Or an array listing all the potential status of the object: array: int of the status => translated la...
Definition security.php:626
$object ref
Definition info.php:79
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.
insertExtraFields($trigger='', $userused=null)
Add/Update all extra fields values for the current object.
call_trigger($triggerName, $user)
Call trigger based on this instance.
Class to manage Dolibarr database access.
DAO Resource object.
fetchAll(string $sortorder, string $sortfield, int $limit, int $offset, $filter='')
Load resource objects into $this->lines.
loadStateBoard()
Load indicators this->nb for state board.
getNomUrl(int $withpicto=0, string $option='', string $get_params='', int $notooltip=0, string $morecss='', int $save_lastsearch_value=-1)
Return clickable link of object (with optional picto)
fetch(int $id, string $ref='')
Load object into memory from database.
$objelement
Used by fetchElementResource() to return an object.
fetchElementResources(string $elementType, int $elementId)
Return an int number of resources linked to the element.
updateElementResource(User $user=null, int $notrigger=0)
Update element resource in database.
static getLibStatusLabel(int $status, int $mode=0)
Get status.
loadCacheCodeTypeResource()
Load in cache resource type code (setup in dictionary)
getTooltipContentArray($params)
getTooltipContentArray
fetchElementResource(int $id)
Load data of resource links into memory from database.
update(User $user=null, int $notrigger=0)
Update object in database.
getElementResources(string $element, int $element_id, string $resource_type='')
Return an array with resources linked to the element.
create(User $user, int $no_trigger=0)
Create object in database.
__construct(DoliDB $db)
Constructor.
getLibStatut(int $mode=0)
Get status label.
Class to manage standard extra fields.
Class to manage Dolibarr users.
trait CommonPeople
Support class for thirdparties, contacts, members, users or resources.
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.
dol_delete_dir_recursive($dir, $count=0, $nophperrors=0, $onlysub=0, &$countdeleted=0, $indexdatabase=1, $nolog=0)
Remove a directory $dir and its subdirectories (or only files and subdirectories)
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0)
Show a picto called object_picto (generic function)
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
forgeSQLFromUniversalSearchCriteria($filter, &$errorstr='', $noand=0, $nopar=0, $noerror=0)
forgeSQLFromUniversalSearchCriteria
dol_now($mode='auto')
Return date for now.
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
dol_clone($object, $native=0)
Create a clone of instance of object (new instance with same value for each properties) With native =...
fetchObjectByElement($element_id, $element_type, $element_ref='', $useCache=0, $maxCacheByType=10)
Fetch an object from its id and element_type Inclusion of classes is automatic.
dol_sanitizeFileName($str, $newstr='_', $unaccent=1)
Clean a string to use it as a file name.
dol_print_error($db=null, $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
getDolGlobalString($key, $default='')
Return dolibarr global constant string value.
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.