dolibarr 25.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-2026 MDW <mdeweerd@users.noreply.github.com>
5 * Copyright (C) 2024-2026 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
76 public $type_label;
77
84 public $resource_id;
85
89 public $resource_type;
90
97 public $element_id;
98
102 public $element_type;
103
107 public $busy;
108
112 public $mandatory;
113
117 public $fulldayevent;
118
122 public $fk_user_create;
123
127 public $objelement;
128
132 public $cache_code_type_resource;
133
134
140 public function __construct(DoliDB $db)
141 {
142 $this->db = $db;
143 $this->status = 0;
144
145 $this->cache_code_type_resource = array();
146 }
147
155 public function create(User $user, int $no_trigger = 0)
156 {
157 global $conf;
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 .= (int) (empty($this->entity) ? ((int) $conf->entity) : ((int) $this->entity)) . ", ";
206 foreach ($new_resource_values as $value) {
207 $sql .= " " . (!empty($value) ? "'" . $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 = ".((int) $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 = 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 (isset($this->url)) {
379 $this->url = trim($this->url);
380 }
381 if (isset($this->fk_code_type_resource)) {
382 $this->fk_code_type_resource = trim($this->fk_code_type_resource);
383 }
384 if (isset($this->note_public)) {
385 $this->note_public = trim($this->note_public);
386 }
387 if (isset($this->note_private)) {
388 $this->note_private = trim($this->note_private);
389 }
390
391 // $this->oldcopy should have been set by the caller of update (here properties were already modified)
392 if (is_null($this->oldcopy) || (is_object($this->oldcopy) && $this->oldcopy->isEmpty())) {
393 $this->oldcopy = dol_clone($this, 2);
394 }
395
396 // Update request
397 $sql = "UPDATE ".MAIN_DB_PREFIX.$this->table_element." SET";
398 $sql .= " ref=".(isset($this->ref) ? "'".$this->db->escape($this->ref)."'" : "null").",";
399 $sql .= " address=".(isset($this->address) ? "'".$this->db->escape($this->address)."'" : "null").",";
400 $sql .= " zip=".(isset($this->zip) ? "'".$this->db->escape($this->zip)."'" : "null").",";
401 $sql .= " town=".(isset($this->town) ? "'".$this->db->escape($this->town)."'" : "null").",";
402 $sql .= " fk_country=".($this->country_id > 0 ? (int) $this->country_id : "null").",";
403 $sql .= " fk_state=".($this->state_id > 0 ? (int) $this->state_id : "null").",";
404 $sql .= " description=".(isset($this->description) ? "'".$this->db->escape($this->description)."'" : "null").",";
405 $sql .= " phone=".(isset($this->phone) ? "'".$this->db->escape($this->phone)."'" : "null").",";
406 $sql .= " email=".(isset($this->email) ? "'".$this->db->escape($this->email)."'" : "null").",";
407 $sql .= " max_users=".(isset($this->max_users) ? (int) $this->max_users : "null").",";
408 $sql .= " url=".(isset($this->url) ? "'".$this->db->escape($this->url)."'" : "null").",";
409 $sql .= " fk_code_type_resource=".(isset($this->fk_code_type_resource) ? "'".$this->db->escape($this->fk_code_type_resource)."'" : "null").",";
410 $sql .= " note_public=".(isset($this->note_public) ? "'".$this->db->escape($this->note_public)."'" : "null").",";
411 $sql .= " note_private=".(isset($this->note_private) ? "'".$this->db->escape($this->note_private)."'" : "null").",";
412 $sql .= " tms=" . ("'" . $this->db->idate($this->date_modification) . "',");
413 $sql .= " fk_user_modif=" . (!empty($user->id) ? ((int) $user->id) : "null");
414 $sql .= " WHERE rowid=".((int) $this->id);
415
416 $this->db->begin();
417
418 dol_syslog(get_class($this)."::update", LOG_DEBUG);
419 $resql = $this->db->query($sql);
420 if (!$resql) {
421 $error++;
422 $this->errors[] = "Error ".$this->db->lasterror();
423 }
424
425 if (!$error && $user !== null) {
426 if (!$notrigger) {
427 // Call trigger
428 $result = $this->call_trigger('RESOURCE_MODIFY', $user);
429 if ($result < 0) {
430 $error++;
431 }
432 // End call triggers
433 }
434 }
435
436 if (!$error && (is_object($this->oldcopy) && $this->oldcopy->ref !== $this->ref)) {
437 // We remove directory
438 if (!empty($conf->resource->dir_output)) {
439 $olddir = $conf->resource->dir_output."/".dol_sanitizeFileName($this->oldcopy->ref);
440 $newdir = $conf->resource->dir_output."/".dol_sanitizeFileName($this->ref);
441 if (file_exists($olddir)) {
442 $res = @rename($olddir, $newdir);
443 if (!$res) {
444 $langs->load("errors");
445 $this->error = $langs->trans('ErrorFailToRenameDir', $olddir, $newdir);
446 $error++;
447 }
448 }
449 }
450 }
451
452 if (!$error) {
453 // Actions on extra fields
454 $result = $this->insertExtraFields();
455 if ($result < 0) {
456 $error++;
457 }
458 }
459
460 // Commit or rollback
461 if ($error) {
462 foreach ($this->errors as $errmsg) {
463 dol_syslog(get_class($this)."::update ".$errmsg, LOG_ERR);
464 $this->error .= ($this->error ? ', '.$errmsg : $errmsg);
465 }
466 $this->db->rollback();
467 return -1 * $error;
468 } else {
469 $this->db->commit();
470 return 1;
471 }
472 }
473
480 public function fetchElementResource(int $id)
481 {
482 $sql = "SELECT";
483 $sql .= " t.rowid,";
484 $sql .= " t.resource_id,";
485 $sql .= " t.resource_type,";
486 $sql .= " t.element_id,";
487 $sql .= " t.element_type,";
488 $sql .= " t.busy,";
489 $sql .= " t.mandatory,";
490 $sql .= " t.fk_user_create,";
491 $sql .= " t.tms as date_modification";
492 $sql .= " FROM ".MAIN_DB_PREFIX."element_resources as t";
493 $sql .= " WHERE t.rowid = ".((int) $id);
494
495 dol_syslog(get_class($this)."::fetch", LOG_DEBUG);
496 $resql = $this->db->query($sql);
497 if ($resql) {
498 if ($this->db->num_rows($resql)) {
499 $obj = $this->db->fetch_object($resql);
500
501 $this->id = $obj->rowid;
502 $this->resource_id = $obj->resource_id;
503 $this->resource_type = $obj->resource_type;
504 $this->element_id = $obj->element_id;
505 $this->element_type = $obj->element_type;
506 $this->busy = $obj->busy;
507 $this->mandatory = $obj->mandatory;
508 $this->fk_user_create = $obj->fk_user_create;
509 $this->date_modification = $obj->date_modification;
510
511 /*if ($obj->resource_id && $obj->resource_type) {
512 $this->objresource = fetchObjectByElement($obj->resource_id, $obj->resource_type);
513 }*/
514 if ($obj->element_id && $obj->element_type) {
515 $this->objelement = fetchObjectByElement($obj->element_id, $obj->element_type);
516 }
517 }
518 $this->db->free($resql);
519
520 return $this->id;
521 } else {
522 $this->error = "Error ".$this->db->lasterror();
523 return -1;
524 }
525 }
526
534 public function delete(User $user, int $notrigger = 0)
535 {
536 global $conf;
537
538 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
539
540 $rowid = $this->id;
541
542 $error = 0;
543
544 $this->db->begin();
545
546 $sql = "DELETE FROM ".MAIN_DB_PREFIX.$this->table_element;
547 $sql .= " WHERE rowid = ".((int) $rowid);
548
549 dol_syslog(get_class($this), LOG_DEBUG);
550 if ($this->db->query($sql)) {
551 $sql = "DELETE FROM ".MAIN_DB_PREFIX."element_resources";
552 $sql .= " WHERE element_type='resource' AND resource_id = ".((int) $rowid);
553 dol_syslog(get_class($this)."::delete", LOG_DEBUG);
554 $resql = $this->db->query($sql);
555 if (!$resql) {
556 $this->error = $this->db->lasterror();
557 $error++;
558 }
559 } else {
560 $this->error = $this->db->lasterror();
561 $error++;
562 }
563
564 // Removed extrafields
565 if (!$error) {
566 $result = $this->deleteExtraFields();
567 if ($result < 0) {
568 $error++;
569 dol_syslog(get_class($this)."::delete error -3 ".$this->error, LOG_ERR);
570 }
571 }
572
573 if (!$notrigger) {
574 // Call trigger
575 $result = $this->call_trigger('RESOURCE_DELETE', $user);
576 if ($result < 0) {
577 $error++;
578 }
579 // End call triggers
580 }
581
582 if (!$error) {
583 // We remove directory
585 if (!empty($conf->resource->dir_output)) {
586 $dir = $conf->resource->dir_output."/".dol_sanitizeFileName($this->ref);
587 if (file_exists($dir)) {
588 $res = @dol_delete_dir_recursive($dir);
589 if (!$res) {
590 $this->errors[] = 'ErrorFailToDeleteDir';
591 $error++;
592 }
593 }
594 }
595 }
596
597 if (!$error) {
598 $this->db->commit();
599 return 1;
600 } else {
601 $this->db->rollback();
602 return -1;
603 }
604 }
605
616 public function fetchAll(string $sortorder, string $sortfield, int $limit, int $offset, $filter = '')
617 {
618 require_once DOL_DOCUMENT_ROOT.'/core/class/extrafields.class.php';
619 $extrafields = new ExtraFields($this->db);
620
621 $sql = "SELECT ";
622 $sql .= " t.rowid,";
623 $sql .= " t.entity,";
624 $sql .= " t.ref,";
625 $sql .= " t.address,";
626 $sql .= " t.zip,";
627 $sql .= " t.town,";
628 $sql .= " t.fk_country,";
629 $sql .= " t.fk_state,";
630 $sql .= " t.description,";
631 $sql .= " t.phone,";
632 $sql .= " t.email,";
633 $sql .= " t.max_users,";
634 $sql .= " t.url,";
635 $sql .= " t.fk_code_type_resource,";
636 $sql .= " t.tms as date_modification,";
637 $sql .= " t.datec as date_creation,";
638 // Add fields from extrafields
639 if (!empty($extrafields->attributes[$this->table_element]) && !empty($extrafields->attributes[$this->table_element]['label'])) {
640 foreach ($extrafields->attributes[$this->table_element]['label'] as $key => $val) {
641 $sql .= ($extrafields->attributes[$this->table_element]['type'][$key] != 'separate' ? "ef.".$key." as options_".$key.', ' : '');
642 }
643 }
644 $sql .= " ty.label as type_label";
645 $sql .= " FROM ".MAIN_DB_PREFIX.$this->table_element." as t";
646 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX."c_type_resource as ty ON ty.code=t.fk_code_type_resource";
647 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX.$this->table_element."_extrafields as ef ON ef.fk_object=t.rowid";
648 $sql .= " WHERE t.entity IN (".getEntity('resource').")";
649
650 // Manage filter
651 if (is_array($filter)) {
652 foreach ($filter as $key => $value) {
653 if (strpos($key, 'date')) {
654 $sql .= " AND ".$this->db->sanitize($key)." = '".$this->db->idate($value)."'";
655 } elseif (strpos($key, 'ef.') !== false) {
656 $sql .= " AND ".$this->db->sanitize($key)." = ".((float) $value);
657 } else {
658 $sql .= " AND ".$this->db->sanitize($key)." LIKE '%".$this->db->escape($this->db->escapeforlike($value))."%'";
659 }
660 }
661
662 $filter = '';
663 }
664
665 // Manage filter
666 $errormessage = '';
667 $sql .= forgeSQLFromUniversalSearchCriteria($filter, $errormessage);
668 if ($errormessage) {
669 $this->errors[] = $errormessage;
670 dol_syslog(__METHOD__.' '.implode(',', $this->errors), LOG_ERR);
671 return -1;
672 }
673
674 $sql .= $this->db->order($sortfield, $sortorder);
675 if ($limit) {
676 $sql .= $this->db->plimit($limit, $offset);
677 }
678
679 dol_syslog(get_class($this)."::fetchAll", LOG_DEBUG);
680
681 $this->lines = array();
682 $resql = $this->db->query($sql);
683 if ($resql) {
684 $num = $this->db->num_rows($resql);
685 if ($num) {
686 while ($obj = $this->db->fetch_object($resql)) {
687 $line = new Dolresource($this->db);
688 $line->id = $obj->rowid;
689 $line->ref = $obj->ref;
690 $line->address = $obj->address;
691 $line->zip = $obj->zip;
692 $line->town = $obj->town;
693 $line->country_id = $obj->fk_country;
694 $line->state_id = $obj->fk_state;
695 $line->description = $obj->description;
696 $this->phone = $obj->phone;
697 $this->email = $obj->email;
698 $this->max_users = $obj->max_users;
699 $this->url = $obj->url;
700 $line->fk_code_type_resource = $obj->fk_code_type_resource;
701 $line->date_modification = $obj->date_modification;
702 $line->date_creation = $obj->date_creation;
703 $line->type_label = $obj->type_label;
704
705 // fetch optionals attributes and labels
706
707 $line->fetch_optionals();
708
709 $this->lines[] = $line;
710 }
711 $this->db->free($resql);
712 }
713 return $num;
714 } else {
715 $this->error = $this->db->lasterror();
716 return -1;
717 }
718 }
719
727 public function updateElementResource($user = null, int $notrigger = 0)
728 {
729 $error = 0;
730 $this->date_modification = dol_now();
731
732 // Clean parameters
733 if (!is_numeric($this->resource_id)) {
734 $this->resource_id = 0;
735 }
736 if (isset($this->resource_type)) {
737 $this->resource_type = trim($this->resource_type);
738 }
739 if (!is_numeric($this->element_id)) {
740 $this->element_id = 0;
741 }
742 if (isset($this->element_type)) {
743 $this->element_type = trim($this->element_type);
744 }
745 if (isset($this->busy)) {
746 $this->busy = (int) $this->busy;
747 }
748 if (isset($this->mandatory)) {
749 $this->mandatory = (int) $this->mandatory;
750 }
751
752 // Update request
753 $sql = "UPDATE ".MAIN_DB_PREFIX."element_resources SET";
754 $sql .= " resource_id = ".(isset($this->resource_id) ? (int) $this->resource_id : "null").",";
755 $sql .= " resource_type = ".(isset($this->resource_type) ? "'".$this->db->escape($this->resource_type)."'" : "null").",";
756 $sql .= " element_id = ".(isset($this->element_id) ? (int) $this->element_id : "null").",";
757 $sql .= " element_type = ".(isset($this->element_type) ? "'".$this->db->escape($this->element_type)."'" : "null").",";
758 $sql .= " busy = ".(isset($this->busy) ? (int) $this->busy : "null").",";
759 $sql .= " mandatory = ".(isset($this->mandatory) ? (int) $this->mandatory : "null").",";
760 $sql .= " tms = ".(dol_strlen((string) $this->date_modification) != 0 ? "'".$this->db->idate($this->date_modification)."'" : 'null');
761 $sql .= " WHERE rowid=".((int) $this->id);
762
763 $this->db->begin();
764
765 dol_syslog(get_class($this)."::update", LOG_DEBUG);
766 $resql = $this->db->query($sql);
767 if (!$resql) {
768 $error++;
769 $this->errors[] = "Error ".$this->db->lasterror();
770 }
771
772 if (!$error && $user !== null) {
773 if (!$notrigger) {
774 // Call trigger
775 $result = $this->call_trigger('RESOURCE_MODIFY', $user);
776 if ($result < 0) {
777 $error++;
778 }
779 // End call triggers
780 }
781 }
782
783 // Commit or rollback
784 if ($error) {
785 foreach ($this->errors as $errmsg) {
786 dol_syslog(get_class($this)."::update ".$errmsg, LOG_ERR);
787 $this->error .= ($this->error ? ', '.$errmsg : $errmsg);
788 }
789 $this->db->rollback();
790 return -1 * $error;
791 } else {
792 $this->db->commit();
793 return 1;
794 }
795 }
796
797
806 public function getElementResources(string $element, int $element_id, string $resource_type = '')
807 {
808 // Links between objects are stored in this table
809 $sql = 'SELECT rowid, resource_id, resource_type, busy, mandatory';
810 $sql .= ' FROM '.MAIN_DB_PREFIX.'element_resources';
811 $sql .= " WHERE element_id=".((int) $element_id)." AND element_type='".$this->db->escape($element)."'";
812 if ($resource_type) {
813 $sql .= " AND resource_type LIKE '%".$this->db->escape($resource_type)."%'";
814 }
815 $sql .= ' ORDER BY resource_type';
816
817 dol_syslog(get_class($this)."::getElementResources", LOG_DEBUG);
818
819 $resources = array();
820 $resql = $this->db->query($sql);
821 if ($resql) {
822 $num = $this->db->num_rows($resql);
823 $i = 0;
824 while ($i < $num) {
825 $obj = $this->db->fetch_object($resql);
826
827 $resources[$i] = array(
828 'rowid' => $obj->rowid,
829 'resource_id' => $obj->resource_id,
830 'resource_type' => $obj->resource_type,
831 'busy' => $obj->busy,
832 'mandatory' => $obj->mandatory
833 );
834 $i++;
835 }
836 }
837
838 return $resources;
839 }
840
848 public function fetchElementResources(string $elementType, int $elementId)
849 {
850 $resources = $this->getElementResources($elementType, $elementId);
851 $i = 0;
852 foreach ($resources as $resource) {
853 $this->lines[$i] = fetchObjectByElement($resource['resource_id'], $resource['resource_type']);
854 $i++;
855 }
856 return $i;
857 }
858
865 {
866 global $langs;
867
868 if (is_array($this->cache_code_type_resource) && count($this->cache_code_type_resource)) {
869 return 0; // Cache deja charge
870 }
871
872 $sql = "SELECT rowid, code, label, active";
873 $sql .= " FROM ".MAIN_DB_PREFIX."c_type_resource";
874 $sql .= " WHERE active > 0";
875 $sql .= " ORDER BY rowid";
876 dol_syslog(get_class($this)."::load_cache_code_type_resource", LOG_DEBUG);
877 $resql = $this->db->query($sql);
878 if ($resql) {
879 $num = $this->db->num_rows($resql);
880 $i = 0;
881 while ($i < $num) {
882 $obj = $this->db->fetch_object($resql);
883
884 $label = ($langs->trans("ResourceTypeShort".$obj->code) != "ResourceTypeShort".$obj->code ? $langs->trans("ResourceTypeShort".$obj->code) : ($obj->label != '-' ? $obj->label : ''));
885 $this->cache_code_type_resource[$obj->rowid]['code'] = $obj->code;
886 $this->cache_code_type_resource[$obj->rowid]['label'] = $label;
887 $this->cache_code_type_resource[$obj->rowid]['active'] = $obj->active;
888 $i++;
889 }
890 return $num;
891 } else {
892 dol_print_error($this->db);
893 return -1;
894 }
895 }
896
903 public function getTooltipContentArray($params)
904 {
905 global $langs;
906
907 $langs->load('resource');
908
909 $datas = [];
910
911 $datas['picto'] = img_picto('', $this->picto).' <u>'.$langs->trans("Resource").'</u>';
912 $datas['ref'] = '<br><b>'.$langs->trans('Ref').':</b> '.$this->ref;
913 /*if (isset($this->status)) {
914 $datas['status'] = '<br><b>' . $langs->trans("Status").":</b> ".$this->getLibStatut(5);
915 }*/
916 if (isset($this->type_label)) {
917 $datas['label'] = '<br><b>'.$langs->trans("ResourceType").":</b> ".$this->type_label;
918 }
919
920 return $datas;
921 }
922
934 public function getNomUrl($withpicto = 0, string $option = '', string $get_params = '', int $notooltip = 0, string $morecss = '', int $save_lastsearch_value = -1)
935 {
936 global $langs, $hookmanager, $action;
937
938 $result = '';
939 $params = [
940 'id' => $this->id,
941 'objecttype' => $this->element,
942 ];
943 $classfortooltip = 'classfortooltip';
944 $dataparams = '';
945 if (getDolGlobalInt('MAIN_ENABLE_AJAX_TOOLTIP')) {
946 $classfortooltip = 'classforajaxtooltip';
947 $dataparams = ' data-params="'.dol_escape_htmltag(json_encode($params)).'"';
948 $label = '';
949 } else {
950 $label = implode($this->getTooltipContentArray($params));
951 }
952
953 $url = DOL_URL_ROOT.'/resource/card.php?id='.$this->id;
954
955 if ($option != 'nolink') {
956 // Add param to save lastsearch_values or not
957 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
958 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
959 $add_save_lastsearch_values = 1;
960 }
961 if ($add_save_lastsearch_values) {
962 $url .= '&save_lastsearch_values=1';
963 }
964 }
965
966 $linkclose = '';
967 if (empty($notooltip)) {
968 if (getDolGlobalString('MAIN_OPTIMIZEFORTEXTBROWSER')) {
969 $label = $langs->trans("ShowResource");
970 $linkclose .= ' alt="'.dolPrintHTMLForAttribute($label).'"';
971 }
972 $linkclose .= ($label ? ' title="'.dolPrintHTMLForAttribute($label).'"' : ' title="tocomplete"');
973 $linkclose .= $dataparams.' class="'.$classfortooltip.($morecss ? ' '.$morecss : '').'"';
974 } else {
975 $linkclose = ($morecss ? ' class="'.$morecss.'"' : '');
976 }
977
978 $linkstart = '<a href="'.$url.$get_params.'"';
979 $linkstart .= $linkclose.'>';
980 $linkend = '</a>';
981 /*$linkstart = '<a href="'.DOL_URL_ROOT.'/resource/card.php?id='.$this->id.$get_params.'" title="'.dol_escape_htmltag($label, 1).'" class="classfortooltip">';
982 $linkend = '</a>';*/
983
984 $result .= $linkstart;
985 if ($withpicto) {
986 $result .= img_object(($notooltip ? '' : $label), ($this->picto ?: 'generic'), (($withpicto != 2) ? 'class="paddingright"' : ''), 0, 0, $notooltip ? 0 : 1);
987 }
988 if ($withpicto != 2) {
989 $result .= $this->ref;
990 }
991 $result .= $linkend;
992
993 $hookmanager->initHooks(array($this->element . 'dao'));
994 $parameters = array('id' => $this->id, 'getnomurl' => &$result);
995 $reshook = $hookmanager->executeHooks('getNomUrl', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
996 if ($reshook > 0) {
997 $result = $hookmanager->resPrint;
998 } else {
999 $result .= $hookmanager->resPrint;
1000 }
1001 return $result;
1002 }
1003
1004
1011 public function getLibStatut(int $mode = 0)
1012 {
1013 return $this->getLibStatusLabel($this->status, $mode);
1014 }
1015
1023 public static function getLibStatusLabel(int $status, int $mode = 0)
1024 {
1025 return '';
1026 }
1027
1033 public function loadStateBoard()
1034 {
1035 $this->nb = array();
1036
1037 $sql = "SELECT count(r.rowid) as nb";
1038 $sql .= " FROM ".MAIN_DB_PREFIX."resource as r";
1039 $sql .= " WHERE r.entity IN (".getEntity('resource').")";
1040
1041 $resql = $this->db->query($sql);
1042 if ($resql) {
1043 while ($obj = $this->db->fetch_object($resql)) {
1044 $this->nb["dolresource"] = $obj->nb;
1045 }
1046 $this->db->free($resql);
1047 return 1;
1048 } else {
1049 dol_print_error($this->db);
1050 $this->error = $this->db->error();
1051 return -1;
1052 }
1053 }
1054
1073 public function getBookingConflicts($resourceId, $resourceType, $dateStart, $dateEnd, $excludeElementType = '', $excludeElementId = 0)
1074 {
1075 $conflicts = array();
1076
1077 // Conflicts against agenda events (actioncomm has a real date range: datep / datep2,
1078 // exposed on the ActionComm object as the properties $datep / $datef). Skipped entirely
1079 // if the Agenda module is disabled, since there is then nothing meaningful to check.
1080 if (isModEnabled('agenda')) {
1081 $sql = "SELECT ac.id as element_id, ac.label as ref";
1082 $sql .= " FROM ".MAIN_DB_PREFIX."element_resources as er";
1083 $sql .= " INNER JOIN ".MAIN_DB_PREFIX."actioncomm as ac ON ac.id = er.element_id AND er.element_type = 'action'";
1084 $sql .= " WHERE er.resource_id = ".((int) $resourceId);
1085 $sql .= " AND er.resource_type = '".$this->db->escape($resourceType)."'";
1086 $sql .= " AND er.busy = 1";
1087 if ($excludeElementType == 'action' && $excludeElementId > 0) {
1088 $sql .= " AND ac.id <> ".((int) $excludeElementId);
1089 }
1090 $sql .= " AND ac.datep <= '".$this->db->idate($dateEnd)."'";
1091 $sql .= " AND (ac.datep2 IS NULL OR ac.datep2 >= '".$this->db->idate($dateStart)."')";
1092
1093 $resql = $this->db->query($sql);
1094 if (!$resql) {
1095 $this->error = $this->db->lasterror();
1096 return -1;
1097 }
1098 while ($obj = $this->db->fetch_object($resql)) {
1099 $conflicts[] = array('element_type' => 'action', 'element_id' => (int) $obj->element_id, 'ref' => $obj->ref);
1100 }
1101 $this->db->free($resql);
1102 }
1103
1104 // Conflicts against interventions (fichinter has no usable header date range, so derive
1105 // [min(line date), max(line date + duree)] from its lines instead). Skipped entirely if
1106 // the Intervention module is disabled.
1107 if (isModEnabled('intervention')) {
1108 $sql = "SELECT f.rowid as element_id, f.ref as ref, MIN(fd.date) as dmin, MAX(fd.date + INTERVAL fd.duree SECOND) as dmax";
1109 $sql .= " FROM ".MAIN_DB_PREFIX."element_resources as er";
1110 $sql .= " INNER JOIN ".MAIN_DB_PREFIX."fichinter as f ON f.rowid = er.element_id AND er.element_type = 'fichinter'";
1111 $sql .= " INNER JOIN ".MAIN_DB_PREFIX."fichinterdet as fd ON fd.fk_fichinter = f.rowid";
1112 $sql .= " WHERE er.resource_id = ".((int) $resourceId);
1113 $sql .= " AND er.resource_type = '".$this->db->escape($resourceType)."'";
1114 $sql .= " AND er.busy = 1";
1115 if ($excludeElementType == 'fichinter' && $excludeElementId > 0) {
1116 $sql .= " AND f.rowid <> ".((int) $excludeElementId);
1117 }
1118 $sql .= " GROUP BY f.rowid, f.ref";
1119 $sql .= " HAVING MIN(fd.date) <= '".$this->db->idate($dateEnd)."'";
1120 $sql .= " AND MAX(fd.date + INTERVAL fd.duree SECOND) >= '".$this->db->idate($dateStart)."'";
1121
1122 $resql = $this->db->query($sql);
1123 if (!$resql) {
1124 $this->error = $this->db->lasterror();
1125 return -1;
1126 }
1127 while ($obj = $this->db->fetch_object($resql)) {
1128 $conflicts[] = array('element_type' => 'fichinter', 'element_id' => (int) $obj->element_id, 'ref' => $obj->ref);
1129 }
1130 $this->db->free($resql);
1131 }
1132
1133 return $conflicts;
1134 }
1135}
$id
Support class for third parties, contacts, members, users or resources.
Definition account.php:47
$object ref
Definition info.php:90
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.
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.
fetch(int $id, string $ref='')
Load object into memory from database.
fetchElementResources(string $elementType, int $elementId)
Return an int number of resources linked to the element.
getBookingConflicts($resourceId, $resourceType, $dateStart, $dateEnd, $excludeElementType='', $excludeElementId=0)
Look for an existing "busy" booking of a resource that overlaps a given date range,...
static getLibStatusLabel(int $status, int $mode=0)
Get status.
loadCacheCodeTypeResource()
Load in cache resource type code (setup in dictionary)
update($user=null, int $notrigger=0)
Update object in database.
getTooltipContentArray($params)
getTooltipContentArray
fetchElementResource(int $id)
Load data of resource links into memory from database.
getNomUrl($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)
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.
updateElementResource($user=null, int $notrigger=0)
Update element resource in database.
getLibStatut(int $mode=0)
Get status label.
Class to manage standard extra fields.
Class to manage Dolibarr users.
print $langs trans("Ref").' m titre as m m statut as status
Or an array listing all the potential status of the object: array: int of the status => translated la...
Definition index.php:169
print $script_file $mode $langs defaultlang(is_numeric($duration_value) ? " delay=". $duration_value :"").(is_numeric($duration_value2) ? " after cd cd cd description as p label as s rowid as s nom as s email
Sender: Who sends the email ("Sender" has sent emails on behalf of "From").
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:
if(!isModEnabled('ai')||!getDolGlobalString('AI_ASSISTANT_ENABLED')) global $db
API class for accounts.
dol_delete_dir_recursive($dir, $count=0, $nophperrors=0, $onlysub=0, &$countdeleted=0, $indexdatabase=1, $nolog=0, $level=0)
Remove a directory $dir and its subdirectories (or only files and subdirectories)
dol_now($mode='gmt')
Return date for now.
dol_sanitizeFileName($str, $newstr='_', $unaccent=1, $includequotes=0, $allowdash=0)
Clean a string to use it as a file name.
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
forgeSQLFromUniversalSearchCriteria($filter, &$errorstr='', $noand=0, $nopar=0, $noerror=0, $forbiddenfields=array())
forgeSQLFromUniversalSearchCriteria
dol_clone($srcobject, $native=2)
Create a clone of instance of object (new instance with same value for each properties) With native =...
getDolGlobalString($key, $default='')
Return a Dolibarr global constant string value.
isModEnabled($module)
Is Dolibarr module enabled.
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.
div refaddress div address
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2, $allowothertags=array())
Show picto whatever it's its name (generic function)
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $allowothertags=array())
Show a picto called object_picto (generic function)
dol_print_error($db=null, $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...