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 'date_last_reset_password' => array('type' => 'datetime', 'label' => 'PreviousResetPassword', 'visible' => 0, 'enabled' => 1, 'position' => 53, 'notnull' => 0,),
114 //'note_public' => array('type'=>'html', 'label'=>'NotePublic', 'visible'=>-1, 'enabled'=>1, 'position'=>45, 'notnull'=>-1,),
115 'note_private' => array('type' => 'html', 'label' => 'NotePrivate', 'visible' => -1, 'enabled' => 1, 'position' => 46, 'notnull' => -1,),
116 'date_creation' => array('type' => 'datetime', 'label' => 'DateCreation', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => 1,),
117 'tms' => array('type' => 'timestamp', 'label' => 'DateModification', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => 1,),
118 'fk_user_creat' => array('type' => 'integer', 'label' => 'UserAuthor', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => 1,),
119 'fk_user_modif' => array('type' => 'integer', 'label' => 'UserModif', 'visible' => -2, 'enabled' => 1, 'position' => 500, 'notnull' => -1,),
120 'import_key' => array('type' => 'varchar(14)', 'label' => 'ImportId', 'visible' => -2, 'enabled' => 1, 'position' => 1000, 'notnull' => -1, 'index' => 1,),
121 'status' => array('type' => 'integer', 'label' => 'Status', 'visible' => 1, 'enabled' => 1, 'position' => 1000, 'notnull' => 1, 'index' => 1, 'default' => 1, 'arrayofkeyval' => array('1' => 'Active', '0' => 'Disabled')),
122 );
123
127 public $rowid;
128
132 public $entity;
133
134 public $key_account;
135 public $login;
136 public $pass_encoding;
137 public $pass_crypted;
138 public $pass_temp;
139
143 public $fk_soc;
144
145 public $site;
146 public $site_account;
147
151 public $date_last_login;
152
153 public $date_last_reset_password;
154 public $date_previous_login;
155 public $note_private;
156
160 public $fk_user_creat;
161
165 public $fk_user_modif;
166
167 public $import_key;
168
172 public $status;
173
174 // END MODULEBUILDER PROPERTIES
175
176
177 const STATUS_ENABLED = 1;
178 const STATUS_DISABLED = 0;
179
180
186 public function __construct(DoliDB $db)
187 {
188 global $langs;
189
190 $this->db = $db;
191
192 $this->ismultientitymanaged = 0;
193
194 if (!getDolGlobalString('MAIN_SHOW_TECHNICAL_ID')) {
195 $this->fields['rowid']['visible'] = 0;
196 }
197
198 // add site type list and set visible
199 $site_type_list = array();
200
201 if (isModEnabled('webportal')) {
202 $this->fields['site']['visible'] = 1;
203 $this->fields['site']['enabled'] = 1;
204 $site_type_list['dolibarr_portal'] = $langs->trans('WebsiteTypeDolibarrPortal');
205 }
206
207 if (isModEnabled('website')) {
208 $this->fields['fk_website']['visible'] = 1;
209 $this->fields['fk_website']['enabled'] = 1;
210 $this->fields['site']['visible'] = 1;
211 $this->fields['site']['enabled'] = 1;
212 $site_type_list['dolibarr_website'] = $langs->trans('WebsiteTypeDolibarrWebsite');
213 }
214
215 $this->fields['site']['arrayofkeyval'] = $site_type_list;
216 }
217
225 public function create(User $user, $notrigger = 0)
226 {
227 return $this->createCommon($user, $notrigger);
228 }
229
237 public function createFromClone(User $user, $fromid)
238 {
239 global $hookmanager, $langs;
240 $error = 0;
241
242 dol_syslog(__METHOD__, LOG_DEBUG);
243
244 $object = new self($this->db);
245
246 $this->db->begin();
247
248 // Load source object
249 $object->fetchCommon($fromid);
250 // Reset some properties
251 unset($object->id);
252 unset($object->fk_user_creat);
253 unset($object->import_key);
254
255 // Clear fields
256 $object->ref = "copy_of_".$object->ref;
257 // $object->title = $langs->trans("CopyOf")." ".$object->title;
258
259 // Create clone
260 $object->context['createfromclone'] = 'createfromclone';
261 $result = $object->createCommon($user);
262 if ($result < 0) {
263 $error++;
264 $this->error = $object->error;
265 $this->errors = $object->errors;
266 }
267
268 unset($object->context['createfromclone']);
269
270 // End
271 if (!$error) {
272 $this->db->commit();
273 return $object;
274 } else {
275 $this->db->rollback();
276 return -1;
277 }
278 }
279
287 public function fetch($id, $ref = null)
288 {
289 $result = $this->fetchCommon($id, $ref);
290 if ($result > 0 && !empty($this->table_element_line)) {
291 $this->fetchLines();
292 }
293 return $result;
294 }
295
301 public function fetchLines()
302 {
303 $this->lines = array();
304
305 // Load lines with object societeAccountLine
306
307 return count($this->lines) ? 1 : 0;
308 }
309
320 public function getCustomerAccount($id, $site, $status = 0, $site_account = '')
321 {
322 $sql = "SELECT sa.key_account as key_account, sa.entity";
323 $sql .= " FROM ".MAIN_DB_PREFIX."societe_account as sa";
324 $sql .= " WHERE sa.fk_soc = ".((int) $id);
325 $sql .= " AND sa.entity IN (".getEntity('societe').")";
326 $sql .= " AND sa.site = '".$this->db->escape($site)."' AND sa.status = ".((int) $status);
327 $sql .= " AND sa.key_account IS NOT NULL AND sa.key_account <> ''";
328 $sql .= " AND (sa.site_account = '' OR sa.site_account IS NULL OR sa.site_account = '".$this->db->escape($site_account)."')";
329 $sql .= " ORDER BY sa.site_account DESC"; // To get the entry with a site_account defined in priority
330
331 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);
332 $result = $this->db->query($sql);
333 if ($result) {
334 if ($this->db->num_rows($result)) {
335 $obj = $this->db->fetch_object($result);
336 $key = $obj->key_account;
337 } else {
338 $key = '';
339 }
340 } else {
341 $key = '';
342 }
343
344 return $key;
345 }
346
356 public function getThirdPartyID($id, $site, $status = 0)
357 {
358 $socid = 0;
359
360 $sql = "SELECT sa.fk_soc as fk_soc, sa.key_account, sa.entity";
361 $sql .= " FROM ".MAIN_DB_PREFIX."societe_account as sa";
362 $sql .= " WHERE sa.key_account = '".$this->db->escape($id)."'";
363 $sql .= " AND sa.entity IN (".getEntity('societe').")";
364 $sql .= " AND sa.site = '".$this->db->escape($site)."' AND sa.status = ".((int) $status);
365 $sql .= " AND sa.fk_soc > 0";
366
367 dol_syslog(get_class($this)."::getCustomerAccount Try to find the first thirdparty id for ".$site." for external id=".$id, LOG_DEBUG);
368 $result = $this->db->query($sql);
369 if ($result) {
370 if ($this->db->num_rows($result)) {
371 $obj = $this->db->fetch_object($result);
372 $socid = $obj->fk_soc;
373 }
374 }
375
376 return $socid;
377 }
378
386 public function update(User $user, $notrigger = 0)
387 {
388 return $this->updateCommon($user, $notrigger);
389 }
390
398 public function delete(User $user, $notrigger = 0)
399 {
400 return $this->deleteCommon($user, $notrigger);
401 }
402
409 public function getTooltipContentArray($params)
410 {
411 global $langs, $user;
412
413 $langs->loadLangs(['companies, commercial', 'website']);
414
415 $datas = [];
416 $option = $params['option'] ?? '';
417
418 $datas['picto'] = '<u>'.$langs->trans("WebsiteAccount").'</u>';
419 $datas['login'] = '<br><b>'.$langs->trans('Login').':</b> '.$this->login;
420
421 return $datas;
422 }
423
434 public function getNomUrl($withpicto = 0, $option = '', $notooltip = 0, $morecss = '', $save_lastsearch_value = -1)
435 {
436 global $db, $conf, $langs;
437 global $dolibarr_main_authentication, $dolibarr_main_demo;
438 global $menumanager;
439
440 if (!empty($conf->dol_no_mouse_hover)) {
441 $notooltip = 1; // Force disable tooltips
442 }
443
444 $result = '';
445
446 $this->ref = $this->login;
447
448 $label = '<u>'.$langs->trans("WebsiteAccount").'</u>';
449 $label .= '<br>';
450 $label .= '<b>'.$langs->trans('Login').':</b> '.$this->ref;
451 //$label.= '<b>' . $langs->trans('WebSite') . ':</b> ' . $this->ref;
452
453 $url = DOL_URL_ROOT.'/website/websiteaccount_card.php?id='.$this->id;
454
455 if ($option != 'nolink') {
456 // Add param to save lastsearch_values or not
457 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
458 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
459 $add_save_lastsearch_values = 1;
460 }
461 if ($add_save_lastsearch_values) {
462 $url .= '&save_lastsearch_values=1';
463 }
464 }
465
466 $linkclose = '';
467 $classfortooltip = 'classfortooltip';
468 $dataparams = '';
469 if (getDolGlobalInt('MAIN_ENABLE_AJAX_TOOLTIP')) {
470 $params = [
471 'id' => $this->id,
472 'objecttype' => $this->element,
473 'option' => $option,
474 ];
475 $classfortooltip = 'classforajaxtooltip';
476 $dataparams = ' data-params="'.dol_escape_htmltag(json_encode($params)).'"';
477 $label = '';
478 }
479
480 if (empty($notooltip)) {
481 if (getDolGlobalString('MAIN_OPTIMIZEFORTEXTBROWSER')) {
482 $label = $langs->trans("WebsiteAccount");
483 $linkclose .= ' alt="'.dol_escape_htmltag($label, 1).'"';
484 }
485 $linkclose .= ($label ? ' title="'.dol_escape_htmltag($label, 1).'"' : ' title="tocomplete"');
486 $linkclose .= $dataparams.' class="'.$classfortooltip.($morecss ? ' '.$morecss : '').'"';
487 } else {
488 $linkclose = ($morecss ? ' class="'.$morecss.'"' : '');
489 }
490
491 $linkstart = '<a href="'.$url.'"';
492 $linkstart .= $linkclose.'>';
493 $linkend = '</a>';
494
495 $result .= $linkstart;
496 if ($withpicto) {
497 $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);
498 }
499 if ($withpicto != 2) {
500 $result .= $this->ref;
501 }
502 $result .= $linkend;
503
504 return $result;
505 }
506
513 public function getLibStatut($mode = 0)
514 {
515 return $this->LibStatut($this->status, $mode);
516 }
517
518 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
526 public function LibStatut($status, $mode = 0)
527 {
528 // phpcs:enable
529 if (is_null($status)) {
530 return '';
531 }
532
533 if (empty($this->labelStatus) || empty($this->labelStatusShort)) {
534 global $langs;
535 //$langs->load("mymodule@mymodule");
536 $this->labelStatus[self::STATUS_ENABLED] = $langs->transnoentitiesnoconv('Enabled');
537 $this->labelStatus[self::STATUS_DISABLED] = $langs->transnoentitiesnoconv('Disabled');
538 $this->labelStatusShort[self::STATUS_ENABLED] = $langs->transnoentitiesnoconv('Enabled');
539 $this->labelStatusShort[self::STATUS_DISABLED] = $langs->transnoentitiesnoconv('Disabled');
540 }
541
542 $statusType = 'status4';
543 //if ($status == self::STATUS_VALIDATED) $statusType = 'status1';
544 if ($status == self::STATUS_DISABLED) {
545 $statusType = 'status6';
546 }
547
548 return dolGetStatus($this->labelStatus[$status], $this->labelStatusShort[$status], '', $statusType, $mode);
549 }
550
557 public function info($id)
558 {
559 $sql = 'SELECT rowid, date_creation as datec, tms as datem,';
560 $sql .= ' fk_user_creat, fk_user_modif';
561 $sql .= ' FROM '.MAIN_DB_PREFIX.$this->table_element.' as t';
562 $sql .= ' WHERE t.rowid = '.((int) $id);
563 $result = $this->db->query($sql);
564 if ($result) {
565 if ($this->db->num_rows($result)) {
566 $obj = $this->db->fetch_object($result);
567 $this->id = $obj->rowid;
568
569 $this->user_creation_id = $obj->fk_user_creat;
570 $this->user_modification_id = $obj->fk_user_modif;
571 $this->date_creation = $this->db->jdate($obj->datec);
572 $this->date_modification = empty($obj->datem) ? '' : $this->db->jdate($obj->datem);
573 }
574
575 $this->db->free($result);
576 } else {
577 dol_print_error($this->db);
578 }
579 }
580
587 public function initAsSpecimen()
588 {
589 return $this->initAsSpecimenCommon();
590 }
591}
if( $user->socid > 0) if(! $user->hasRight('accounting', 'chartofaccount')) $object
Definition card.php:58
$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.
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:162
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 a Dolibarr global constant string value.
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.