dolibarr 21.0.0-alpha
societeaccount.class.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2007-2017 Laurent Destailleur <eldy@users.sourceforge.net>
3 * Copyright (C) 2014-2016 Juanjo Menent <jmenent@2byte.es>
4 * Copyright (C) 2015 Florian Henry <florian.henry@open-concept.pro>
5 * Copyright (C) 2015 Raphaël Doursenaud <rdoursenaud@gpcsolutions.fr>
6 * Copyright (C) 2024 Frédéric France <frederic.france@free.fr>
7 * Copyright (C) 2024 MDW <mdeweerd@users.noreply.github.com>
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 3 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program. If not, see <https://www.gnu.org/licenses/>.
21 */
22
29// Put here all includes required by your class file
30require_once DOL_DOCUMENT_ROOT.'/core/class/commonobject.class.php';
31//require_once DOL_DOCUMENT_ROOT . '/societe/class/societe.class.php';
32//require_once DOL_DOCUMENT_ROOT . '/product/class/product.class.php';
33
38{
42 public $element = 'societeaccount';
43
47 public $table_element = 'societe_account';
48
52 public $picto = 'lock';
53
54
94 // BEGIN MODULEBUILDER PROPERTIES
99 public $fields = array(
100 'rowid' => array('type' => 'integer', 'label' => 'TechnicalID', 'visible' => -2, 'enabled' => 1, 'position' => 1, 'notnull' => 1, 'index' => 1, 'comment' => 'Id',),
101 'entity' => array('type' => 'integer', 'label' => 'Entity', 'visible' => 0, 'enabled' => 1, 'position' => 5, 'default' => 1),
102 'login' => array('type' => 'varchar(64)', 'label' => 'Login', 'visible' => 1, 'enabled' => 1, 'notnull' => 1, 'position' => 10, 'showoncombobox' => 1, 'autofocusoncreate' => 1),
103 'pass_encoding' => array('type' => 'varchar(24)', 'label' => 'PassEncoding', 'visible' => 0, 'enabled' => 1, 'position' => 30),
104 'pass_crypted' => array('type' => 'password', 'label' => 'Password', 'visible' => -1, 'enabled' => 1, 'position' => 31, 'notnull' => 1),
105 'pass_temp' => array('type' => 'varchar(128)', 'label' => 'Temp', 'visible' => 0, 'enabled' => 0, 'position' => 32, 'notnull' => -1,),
106 'fk_soc' => array('type' => 'integer:Societe:societe/class/societe.class.php', 'label' => 'ThirdParty', 'visible' => 1, 'enabled' => 1, 'position' => 40, 'notnull' => -1, 'index' => 1, 'picto' => 'company', 'css' => 'maxwidth300 widthcentpercentminusxx'),
107 'site' => array('type' => 'varchar(128)', 'label' => 'WebsiteTypeLabel', 'visible' => 0, 'enabled' => 0, 'position' => 41, 'notnull' => 1, 'default' => '', 'help' => 'Name of the website or service if this is account on an external website or service', 'csslist' => 'tdoverflowmax150', 'arrayofkeyval' => array(/* For static analysis, filled in constructor */)),
108 'fk_website' => array('type' => 'integer:Website:website/class/website.class.php', 'label' => 'WebSite', 'visible' => 0, 'enabled' => 0, 'position' => 42, 'notnull' => -1, 'index' => 1, 'picto' => 'website', 'css' => 'maxwidth300 widthcentpercentminusxx'),
109 'site_account' => array('type' => 'varchar(128)', 'label' => 'ExternalSiteAccount', 'visible' => 0, 'enabled' => 1, 'position' => 44, 'help' => 'A key to identify the account on external web site if this is an account on an external website'),
110 'key_account' => array('type' => 'varchar(128)', 'label' => 'KeyAccount', 'visible' => 0, 'enabled' => 1, 'position' => 48, 'notnull' => 0, 'index' => 1, 'searchall' => 1, 'comment' => 'The id of third party in the external web site (for site_account if site_account defined)',),
111 'date_last_login' => array('type' => 'datetime', 'label' => 'LastConnexion', 'visible' => 2, 'enabled' => 1, 'position' => 50, 'notnull' => 0,),
112 'date_previous_login' => array('type' => 'datetime', 'label' => 'PreviousConnexion', 'visible' => 2, 'enabled' => 1, 'position' => 51, 'notnull' => 0,),
113 //'note_public' => array('type'=>'html', 'label'=>'NotePublic', 'visible'=>-1, 'enabled'=>1, 'position'=>45, 'notnull'=>-1,),
114 'note_private' => array('type' => 'html', 'label' => 'NotePrivate', 'visible' => -1, 'enabled' => 1, 'position' => 46, 'notnull' => -1,),
115 'date_creation' => array('type' => 'datetime', 'label' => 'DateCreation', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => 1,),
116 'tms' => array('type' => 'timestamp', 'label' => 'DateModification', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => 1,),
117 'fk_user_creat' => array('type' => 'integer', 'label' => 'UserAuthor', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => 1,),
118 'fk_user_modif' => array('type' => 'integer', 'label' => 'UserModif', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => -1,),
119 'import_key' => array('type' => 'varchar(14)', 'label' => 'ImportId', 'visible' => -2, 'enabled' => 1, 'position' => 1000, 'notnull' => -1, 'index' => 1,),
120 'status' => array('type' => 'integer', 'label' => 'Status', 'visible' => 1, 'enabled' => 1, 'position' => 1000, 'notnull' => 1, 'index' => 1, 'default' => 1, 'arrayofkeyval' => array('1' => 'Active', '0' => 'Disabled')),
121 );
122
126 public $rowid;
127
131 public $entity;
132
133 public $key_account;
134 public $login;
135 public $pass_encoding;
136 public $pass_crypted;
137 public $pass_temp;
138
142 public $fk_soc;
143
144 public $site;
145 public $site_account;
146
150 public $date_last_login;
151
152
153 public $date_previous_login;
154 public $note_private;
155
159 public $fk_user_creat;
160
164 public $fk_user_modif;
165
166 public $import_key;
167
171 public $status;
172
173 // END MODULEBUILDER PROPERTIES
174
175
176 const STATUS_ENABLED = 1;
177 const STATUS_DISABLED = 0;
178
179
185 public function __construct(DoliDB $db)
186 {
187 global $langs;
188
189 $this->db = $db;
190
191 $this->ismultientitymanaged = 0;
192
193 if (!getDolGlobalString('MAIN_SHOW_TECHNICAL_ID')) {
194 $this->fields['rowid']['visible'] = 0;
195 }
196
197 // add site type list and set visible
198 $site_type_list = array();
199
200 if (isModEnabled('webportal')) {
201 $this->fields['site']['visible'] = 1;
202 $this->fields['site']['enabled'] = 1;
203 $site_type_list['dolibarr_portal'] = $langs->trans('WebsiteTypeDolibarrPortal');
204 }
205
206 if (isModEnabled('website')) {
207 $this->fields['fk_website']['visible'] = 1;
208 $this->fields['fk_website']['enabled'] = 1;
209 $this->fields['site']['visible'] = 1;
210 $this->fields['site']['enabled'] = 1;
211 $site_type_list['dolibarr_website'] = $langs->trans('WebsiteTypeDolibarrWebsite');
212 }
213
214 $this->fields['site']['arrayofkeyval'] = $site_type_list;
215 }
216
224 public function create(User $user, $notrigger = 0)
225 {
226 return $this->createCommon($user, $notrigger);
227 }
228
236 public function createFromClone(User $user, $fromid)
237 {
238 global $hookmanager, $langs;
239 $error = 0;
240
241 dol_syslog(__METHOD__, LOG_DEBUG);
242
243 $object = new self($this->db);
244
245 $this->db->begin();
246
247 // Load source object
248 $object->fetchCommon($fromid);
249 // Reset some properties
250 unset($object->id);
251 unset($object->fk_user_creat);
252 unset($object->import_key);
253
254 // Clear fields
255 $object->ref = "copy_of_".$object->ref;
256 // $object->title = $langs->trans("CopyOf")." ".$object->title;
257
258 // Create clone
259 $object->context['createfromclone'] = 'createfromclone';
260 $result = $object->createCommon($user);
261 if ($result < 0) {
262 $error++;
263 $this->error = $object->error;
264 $this->errors = $object->errors;
265 }
266
267 unset($object->context['createfromclone']);
268
269 // End
270 if (!$error) {
271 $this->db->commit();
272 return $object;
273 } else {
274 $this->db->rollback();
275 return -1;
276 }
277 }
278
286 public function fetch($id, $ref = null)
287 {
288 $result = $this->fetchCommon($id, $ref);
289 if ($result > 0 && !empty($this->table_element_line)) {
290 $this->fetchLines();
291 }
292 return $result;
293 }
294
300 public function fetchLines()
301 {
302 $this->lines = array();
303
304 // Load lines with object societeAccountLine
305
306 return count($this->lines) ? 1 : 0;
307 }
308
319 public function getCustomerAccount($id, $site, $status = 0, $site_account = '')
320 {
321 $sql = "SELECT sa.key_account as key_account, sa.entity";
322 $sql .= " FROM ".MAIN_DB_PREFIX."societe_account as sa";
323 $sql .= " WHERE sa.fk_soc = ".((int) $id);
324 $sql .= " AND sa.entity IN (".getEntity('societe').")";
325 $sql .= " AND sa.site = '".$this->db->escape($site)."' AND sa.status = ".((int) $status);
326 $sql .= " AND sa.key_account IS NOT NULL AND sa.key_account <> ''";
327 $sql .= " AND (sa.site_account = '' OR sa.site_account IS NULL OR sa.site_account = '".$this->db->escape($site_account)."')";
328 $sql .= " ORDER BY sa.site_account DESC"; // To get the entry with a site_account defined in priority
329
330 dol_syslog(get_class($this)."::getCustomerAccount Try to find the first system customer id for ".$site." of thirdparty id=".$id." (example: cus_.... for stripe)", LOG_DEBUG);
331 $result = $this->db->query($sql);
332 if ($result) {
333 if ($this->db->num_rows($result)) {
334 $obj = $this->db->fetch_object($result);
335 $key = $obj->key_account;
336 } else {
337 $key = '';
338 }
339 } else {
340 $key = '';
341 }
342
343 return $key;
344 }
345
355 public function getThirdPartyID($id, $site, $status = 0)
356 {
357 $socid = 0;
358
359 $sql = "SELECT sa.fk_soc as fk_soc, sa.key_account, sa.entity";
360 $sql .= " FROM ".MAIN_DB_PREFIX."societe_account as sa";
361 $sql .= " WHERE sa.key_account = '".$this->db->escape($id)."'";
362 $sql .= " AND sa.entity IN (".getEntity('societe').")";
363 $sql .= " AND sa.site = '".$this->db->escape($site)."' AND sa.status = ".((int) $status);
364 $sql .= " AND sa.fk_soc > 0";
365
366 dol_syslog(get_class($this)."::getCustomerAccount Try to find the first thirdparty id for ".$site." for external id=".$id, LOG_DEBUG);
367 $result = $this->db->query($sql);
368 if ($result) {
369 if ($this->db->num_rows($result)) {
370 $obj = $this->db->fetch_object($result);
371 $socid = $obj->fk_soc;
372 }
373 }
374
375 return $socid;
376 }
377
385 public function update(User $user, $notrigger = 0)
386 {
387 return $this->updateCommon($user, $notrigger);
388 }
389
397 public function delete(User $user, $notrigger = 0)
398 {
399 return $this->deleteCommon($user, $notrigger);
400 }
401
408 public function getTooltipContentArray($params)
409 {
410 global $langs, $user;
411
412 $langs->loadLangs(['companies, commercial', 'website']);
413
414 $datas = [];
415 $option = $params['option'] ?? '';
416
417 $datas['picto'] = '<u>'.$langs->trans("WebsiteAccount").'</u>';
418 $datas['login'] = '<br><b>'.$langs->trans('Login').':</b> '.$this->login;
419
420 return $datas;
421 }
422
433 public function getNomUrl($withpicto = 0, $option = '', $notooltip = 0, $morecss = '', $save_lastsearch_value = -1)
434 {
435 global $db, $conf, $langs;
436 global $dolibarr_main_authentication, $dolibarr_main_demo;
437 global $menumanager;
438
439 if (!empty($conf->dol_no_mouse_hover)) {
440 $notooltip = 1; // Force disable tooltips
441 }
442
443 $result = '';
444
445 $this->ref = $this->login;
446
447 $label = '<u>'.$langs->trans("WebsiteAccount").'</u>';
448 $label .= '<br>';
449 $label .= '<b>'.$langs->trans('Login').':</b> '.$this->ref;
450 //$label.= '<b>' . $langs->trans('WebSite') . ':</b> ' . $this->ref;
451
452 $url = DOL_URL_ROOT.'/website/websiteaccount_card.php?id='.$this->id;
453
454 if ($option != 'nolink') {
455 // Add param to save lastsearch_values or not
456 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
457 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
458 $add_save_lastsearch_values = 1;
459 }
460 if ($add_save_lastsearch_values) {
461 $url .= '&save_lastsearch_values=1';
462 }
463 }
464
465 $linkclose = '';
466 $classfortooltip = 'classfortooltip';
467 $dataparams = '';
468 if (getDolGlobalInt('MAIN_ENABLE_AJAX_TOOLTIP')) {
469 $params = [
470 'id' => $this->id,
471 'objecttype' => $this->element,
472 'option' => $option,
473 ];
474 $classfortooltip = 'classforajaxtooltip';
475 $dataparams = ' data-params="'.dol_escape_htmltag(json_encode($params)).'"';
476 $label = '';
477 }
478
479 if (empty($notooltip)) {
480 if (getDolGlobalString('MAIN_OPTIMIZEFORTEXTBROWSER')) {
481 $label = $langs->trans("WebsiteAccount");
482 $linkclose .= ' alt="'.dol_escape_htmltag($label, 1).'"';
483 }
484 $linkclose .= ($label ? ' title="'.dol_escape_htmltag($label, 1).'"' : ' title="tocomplete"');
485 $linkclose .= $dataparams.' class="'.$classfortooltip.($morecss ? ' '.$morecss : '').'"';
486 } else {
487 $linkclose = ($morecss ? ' class="'.$morecss.'"' : '');
488 }
489
490 $linkstart = '<a href="'.$url.'"';
491 $linkstart .= $linkclose.'>';
492 $linkend = '</a>';
493
494 $result .= $linkstart;
495 if ($withpicto) {
496 $result .= img_object(($notooltip ? '' : $label), ($this->picto ? $this->picto : 'generic'), ($notooltip ? (($withpicto != 2) ? 'class="paddingright"' : '') : $dataparams.' class="'.(($withpicto != 2) ? 'paddingright ' : '').$classfortooltip.'"'), 0, 0, $notooltip ? 0 : 1);
497 }
498 if ($withpicto != 2) {
499 $result .= $this->ref;
500 }
501 $result .= $linkend;
502
503 return $result;
504 }
505
512 public function getLibStatut($mode = 0)
513 {
514 return $this->LibStatut($this->status, $mode);
515 }
516
517 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
525 public function LibStatut($status, $mode = 0)
526 {
527 // phpcs:enable
528 if (is_null($status)) {
529 return '';
530 }
531
532 if (empty($this->labelStatus) || empty($this->labelStatusShort)) {
533 global $langs;
534 //$langs->load("mymodule@mymodule");
535 $this->labelStatus[self::STATUS_ENABLED] = $langs->transnoentitiesnoconv('Enabled');
536 $this->labelStatus[self::STATUS_DISABLED] = $langs->transnoentitiesnoconv('Disabled');
537 $this->labelStatusShort[self::STATUS_ENABLED] = $langs->transnoentitiesnoconv('Enabled');
538 $this->labelStatusShort[self::STATUS_DISABLED] = $langs->transnoentitiesnoconv('Disabled');
539 }
540
541 $statusType = 'status4';
542 //if ($status == self::STATUS_VALIDATED) $statusType = 'status1';
543 if ($status == self::STATUS_DISABLED) {
544 $statusType = 'status6';
545 }
546
547 return dolGetStatus($this->labelStatus[$status], $this->labelStatusShort[$status], '', $statusType, $mode);
548 }
549
556 public function info($id)
557 {
558 $sql = 'SELECT rowid, date_creation as datec, tms as datem,';
559 $sql .= ' fk_user_creat, fk_user_modif';
560 $sql .= ' FROM '.MAIN_DB_PREFIX.$this->table_element.' as t';
561 $sql .= ' WHERE t.rowid = '.((int) $id);
562 $result = $this->db->query($sql);
563 if ($result) {
564 if ($this->db->num_rows($result)) {
565 $obj = $this->db->fetch_object($result);
566 $this->id = $obj->rowid;
567
568 $this->user_creation_id = $obj->fk_user_creat;
569 $this->user_modification_id = $obj->fk_user_modif;
570 $this->date_creation = $this->db->jdate($obj->datec);
571 $this->date_modification = empty($obj->datem) ? '' : $this->db->jdate($obj->datem);
572 }
573
574 $this->db->free($result);
575 } else {
576 dol_print_error($this->db);
577 }
578 }
579
586 public function initAsSpecimen()
587 {
588 return $this->initAsSpecimenCommon();
589 }
590}
if( $user->socid > 0) if(! $user->hasRight('accounting', 'chartofaccount')) $object
Definition card.php:58
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,...
createCommon(User $user, $notrigger=0)
Create object in the database.
updateCommon(User $user, $notrigger=0)
Update object into database.
initAsSpecimenCommon()
Initialise object with example values Id must be 0 if object instance is a specimen.
fetchCommon($id, $ref=null, $morewhere='', $noextrafields=0)
Load object in memory from the database.
deleteCommon(User $user, $notrigger=0, $forcechilddeletion=0)
Delete object in database.
Class to manage Dolibarr database access.
Class for SocieteAccount.
initAsSpecimen()
Initialise object with example values Id must be 0 if object instance is a specimen.
fetch($id, $ref=null)
Load object in memory from the database.
info($id)
Charge les information d'ordre info dans l'objet commande.
getLibStatut($mode=0)
Return the label of a given status.
getNomUrl($withpicto=0, $option='', $notooltip=0, $morecss='', $save_lastsearch_value=-1)
Return a link to the object card (with optionally the picto)
getTooltipContentArray($params)
getTooltipContentArray
fetchLines()
Load object lines in memory from the database.
createFromClone(User $user, $fromid)
Clone and object into another one.
__construct(DoliDB $db)
Constructor.
update(User $user, $notrigger=0)
Update object into database.
getCustomerAccount($id, $site, $status=0, $site_account='')
Try to find the external customer id of a thirdparty for another site/system.
LibStatut($status, $mode=0)
Return the status.
getThirdPartyID($id, $site, $status=0)
Try to find the thirdparty id from an another site/system external id.
create(User $user, $notrigger=0)
Create object into database.
Class to manage Dolibarr users.
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0)
Show a picto called object_picto (generic function)
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
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.