dolibarr 19.0.3
companypaymentmode.class.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2017 Laurent Destailleur <eldy@users.sourceforge.net>
3 * Copyright (C) ---Put here your own copyright and developer email---
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 3 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <https://www.gnu.org/licenses/>.
17 */
18
25// Put here all includes required by your class file
26require_once DOL_DOCUMENT_ROOT.'/core/class/commonobject.class.php';
27//require_once DOL_DOCUMENT_ROOT . '/societe/class/societe.class.php';
28//require_once DOL_DOCUMENT_ROOT . '/product/class/product.class.php';
29
34{
38 public $element = 'companypaymentmode';
39
43 public $table_element = 'societe_rib';
44
49 public $ismultientitymanaged = 'fk_soc@societe';
50
54 public $isextrafieldmanaged = 0;
55
59 public $picto = 'generic';
60
61
62 const STATUS_ENABLED = 1;
63 const STATUS_CANCELED = 0;
64
65
83 // BEGIN MODULEBUILDER PROPERTIES
87 public $fields = array(
88 'rowid' =>array('type'=>'integer', 'label'=>'Rowid', 'enabled'=>1, 'visible'=>-2, 'notnull'=>1, 'position'=>10),
89 'fk_soc' =>array('type'=>'integer', 'label'=>'Fk soc', 'enabled'=>1, 'visible'=>-2, 'notnull'=>1, 'position'=>15),
90 'label' =>array('type'=>'varchar(30)', 'label'=>'Label', 'enabled'=>1, 'visible'=>-2, 'position'=>30),
91 'bank' =>array('type'=>'varchar(255)', 'label'=>'Bank', 'enabled'=>1, 'visible'=>-2, 'position'=>35),
92 'code_banque' =>array('type'=>'varchar(128)', 'label'=>'Code banque', 'enabled'=>1, 'visible'=>-2, 'position'=>40),
93 'code_guichet' =>array('type'=>'varchar(6)', 'label'=>'Code guichet', 'enabled'=>1, 'visible'=>-2, 'position'=>45),
94 'number' =>array('type'=>'varchar(255)', 'label'=>'Number', 'enabled'=>1, 'visible'=>-2, 'position'=>50),
95 'cle_rib' =>array('type'=>'varchar(5)', 'label'=>'Cle rib', 'enabled'=>1, 'visible'=>-2, 'position'=>55),
96 'bic' =>array('type'=>'varchar(20)', 'label'=>'Bic', 'enabled'=>1, 'visible'=>-2, 'position'=>60),
97 'iban_prefix' =>array('type'=>'varchar(34)', 'label'=>'Iban prefix', 'enabled'=>1, 'visible'=>-2, 'position'=>65),
98 'domiciliation' =>array('type'=>'varchar(255)', 'label'=>'Domiciliation', 'enabled'=>1, 'visible'=>-2, 'position'=>70),
99 'proprio' =>array('type'=>'varchar(60)', 'label'=>'Proprio', 'enabled'=>1, 'visible'=>-2, 'position'=>75),
100 'owner_address' =>array('type'=>'text', 'label'=>'Owner address', 'enabled'=>1, 'visible'=>-2, 'position'=>80),
101 'default_rib' =>array('type'=>'tinyint(4)', 'label'=>'Default rib', 'enabled'=>1, 'visible'=>-2, 'notnull'=>1, 'position'=>85),
102 'rum' =>array('type'=>'varchar(32)', 'label'=>'Rum', 'enabled'=>1, 'visible'=>-2, 'position'=>90),
103 'date_rum' =>array('type'=>'date', 'label'=>'Date rum', 'enabled'=>1, 'visible'=>-2, 'position'=>95),
104 'frstrecur' =>array('type'=>'varchar(16)', 'label'=>'Frstrecur', 'enabled'=>1, 'visible'=>-2, 'position'=>100),
105 'type' =>array('type'=>'varchar(32)', 'label'=>'Type', 'enabled'=>1, 'visible'=>-2, 'position'=>110),
106 'last_four' =>array('type'=>'varchar(4)', 'label'=>'Last four', 'enabled'=>1, 'visible'=>-2, 'position'=>115),
107 'card_type' =>array('type'=>'varchar(255)', 'label'=>'Card type', 'enabled'=>1, 'visible'=>-2, 'position'=>120),
108 'cvn' =>array('type'=>'varchar(255)', 'label'=>'Cvn', 'enabled'=>1, 'visible'=>-2, 'position'=>125),
109 'exp_date_month' =>array('type'=>'integer', 'label'=>'Exp date month', 'enabled'=>1, 'visible'=>-2, 'position'=>130),
110 'exp_date_year' =>array('type'=>'integer', 'label'=>'Exp date year', 'enabled'=>1, 'visible'=>-2, 'position'=>135),
111 'country_code' =>array('type'=>'varchar(10)', 'label'=>'Country code', 'enabled'=>1, 'visible'=>-2, 'position'=>140),
112 'approved' =>array('type'=>'integer', 'label'=>'Approved', 'enabled'=>1, 'visible'=>-2, 'position'=>145),
113 'email' =>array('type'=>'varchar(255)', 'label'=>'Email', 'enabled'=>1, 'visible'=>-2, 'position'=>150),
114 'max_total_amount_of_all_payments' =>array('type'=>'double(24,8)', 'label'=>'Max total amount of all payments', 'enabled'=>1, 'visible'=>-2, 'position'=>155),
115 'preapproval_key' =>array('type'=>'varchar(255)', 'label'=>'Preapproval key', 'enabled'=>1, 'visible'=>-2, 'position'=>160),
116 'total_amount_of_all_payments' =>array('type'=>'double(24,8)', 'label'=>'Total amount of all payments', 'enabled'=>1, 'visible'=>-2, 'position'=>165),
117 'stripe_card_ref' =>array('type'=>'varchar(128)', 'label'=>'ExternalSystemID', 'enabled'=>1, 'visible'=>-2, 'position'=>170, 'help'=>'IDOfPaymentInAnExternalSystem'),
118 'stripe_account' =>array('type'=>'varchar(128)', 'label'=>'ExternalSystemCustomerAccount', 'enabled'=>1, 'visible'=>-2, 'position'=>171, 'help'=>'IDOfCustomerInAnExternalSystem'),
119 'ext_payment_site' =>array('type'=>'varchar(128)', 'label'=>'ExternalSystem', 'enabled'=>1, 'visible'=>-2, 'position'=>172, 'help'=>'NameOfExternalSystem'),
120 'status' =>array('type'=>'integer', 'label'=>'Status', 'enabled'=>1, 'visible'=>-2, 'notnull'=>1, 'position'=>175),
121 'starting_date' =>array('type'=>'date', 'label'=>'Starting date', 'enabled'=>1, 'visible'=>-2, 'position'=>180),
122 'ending_date' =>array('type'=>'date', 'label'=>'Ending date', 'enabled'=>1, 'visible'=>-2, 'position'=>185),
123 'datec' =>array('type'=>'datetime', 'label'=>'DateCreation', 'enabled'=>1, 'visible'=>-2, 'position'=>20),
124 'tms' =>array('type'=>'timestamp', 'label'=>'Tms', 'enabled'=>1, 'visible'=>-2, 'notnull'=>1, 'position'=>25),
125 'import_key' =>array('type'=>'varchar(14)', 'label'=>'Import key', 'enabled'=>1, 'visible'=>-2, 'position'=>105),
126 //'aaa' =>array('type'=>'date', 'label'=>'Ending date', 'enabled'=>0, 'visible'=>-2, 'position'=>185),
127 );
128
132 public $rowid;
133
137 public $fk_soc;
138
142 public $label;
143
144 public $bank;
145 public $code_banque;
146 public $code_guichet;
147 public $number;
148 public $cle_rib;
149 public $bic;
150
156 public $iban;
157
162 public $iban_prefix;
163 public $domiciliation;
164 public $proprio;
165 public $owner_address;
166 public $default_rib;
167 public $rum;
168 public $date_rum;
169 public $frstrecur;
170 public $type;
171 public $last_four;
172 public $card_type;
173 public $cvn;
174 public $exp_date_month;
175 public $exp_date_year;
176 public $country_code;
177 public $approved;
178 public $email;
179 public $max_total_amount_of_all_payments;
180 public $preapproval_key;
181 public $total_amount_of_all_payments;
182 public $stripe_card_ref; // External system payment mode ID
183 public $stripe_account; // External system customer ID
184 public $ext_payment_site; // External system 'StripeLive', 'StripeTest', 'StancerLive', 'StancerTest', ...
185
189 public $status;
190
191 public $starting_date;
192 public $ending_date;
193
199 public $datec;
200
206 public $tms;
207
208 public $import_key;
209 // END MODULEBUILDER PROPERTIES
210
211
217 public function __construct(DoliDB $db)
218 {
219 global $conf;
220
221 $this->db = $db;
222
223 if (!getDolGlobalString('MAIN_SHOW_TECHNICAL_ID') && isset($this->fields['rowid'])) {
224 $this->fields['rowid']['visible'] = 0;
225 }
226 if (!isModEnabled('multicompany') && isset($this->fields['entity'])) {
227 $this->fields['entity']['enabled'] = 0;
228 }
229 }
230
238 public function create(User $user, $notrigger = false)
239 {
240 $idpayment = $this->createCommon($user, $notrigger);
241
242 return $idpayment;
243 }
244
252 public function createFromClone(User $user, $fromid)
253 {
254 global $hookmanager, $langs;
255 $error = 0;
256
257 dol_syslog(__METHOD__, LOG_DEBUG);
258
259 $object = new self($this->db);
260
261 $this->db->begin();
262
263 // Load source object
264 $object->fetchCommon($fromid);
265 // Reset some properties
266 unset($object->id);
267 unset($object->fk_user_creat);
268 unset($object->import_key);
269
270 // Clear fields
271 $object->ref = "copy_of_".$object->ref;
272 // $object->title = $langs->trans("CopyOf")." ".$object->title;
273
274 // Create clone
275 $object->context['createfromclone'] = 'createfromclone';
276 $result = $object->createCommon($user);
277 if ($result < 0) {
278 $error++;
279 $this->error = $object->error;
280 $this->errors = $object->errors;
281 }
282
283 unset($object->context['createfromclone']);
284
285 // End
286 if (!$error) {
287 $this->db->commit();
288 return $object;
289 } else {
290 $this->db->rollback();
291 return -1;
292 }
293 }
294
305 public function fetch($id, $ref = null, $socid = 0, $type = '', $morewhere = '')
306 {
307 if ($socid) {
308 $morewhere .= " AND fk_soc = ".((int) $socid)." AND default_rib = 1";
309 }
310 if ($type) {
311 $morewhere .= " AND type = '".$this->db->escape($type)."'";
312 }
313
314 $result = $this->fetchCommon($id, $ref, $morewhere);
315
316 // For backward compatibility
317 $this->iban = $this->iban_prefix;
318
319 //if ($result > 0 && !empty($this->table_element_line)) $this->fetchLines();
320 return $result;
321 }
322
328 /*public function fetchLines()
329 {
330 $this->lines=array();
331
332 // Load lines with object CompanyPaymentModeLine
333
334 return count($this->lines)?1:0;
335 }*/
336
344 public function update(User $user, $notrigger = false)
345 {
346 return $this->updateCommon($user, $notrigger);
347 }
348
356 public function delete(User $user, $notrigger = false)
357 {
358 return $this->deleteCommon($user, $notrigger);
359 }
360
371 public function getNomUrl($withpicto = 0, $option = '', $notooltip = 0, $morecss = '', $save_lastsearch_value = -1)
372 {
373 global $db, $conf, $langs;
374 global $dolibarr_main_authentication, $dolibarr_main_demo;
375 global $menumanager;
376
377 if (!empty($conf->dol_no_mouse_hover)) {
378 $notooltip = 1; // Force disable tooltips
379 }
380
381 $result = '';
382 $companylink = '';
383
384 $label = '<u>'.$langs->trans("CompanyPaymentMode").'</u>';
385 $label .= '<br>';
386 $label .= '<b>'.$langs->trans('Ref').':</b> '.$this->ref;
387
388 $url = '';
389
390 if ($option != 'nolink') {
391 // Add param to save lastsearch_values or not
392 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
393 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
394 $add_save_lastsearch_values = 1;
395 }
396 if ($add_save_lastsearch_values) {
397 $url .= '&save_lastsearch_values=1';
398 }
399 }
400
401 $linkclose = '';
402 if (empty($notooltip)) {
403 if (getDolGlobalString('MAIN_OPTIMIZEFORTEXTBROWSER')) {
404 $label = $langs->trans("ShowCompanyPaymentMode");
405 $linkclose .= ' alt="'.dol_escape_htmltag($label, 1).'"';
406 }
407 $linkclose .= ' title="'.dol_escape_htmltag($label, 1).'"';
408 $linkclose .= ' class="classfortooltip'.($morecss ? ' '.$morecss : '').'"';
409 } else {
410 $linkclose = ($morecss ? ' class="'.$morecss.'"' : '');
411 }
412
413 $linkstart = '<a href="'.$url.'"';
414 $linkstart .= $linkclose.'>';
415 $linkend = '</a>';
416
417 $result .= $linkstart;
418 if ($withpicto) {
419 $result .= img_object(($notooltip ? '' : $label), ($this->picto ? $this->picto : 'generic'), ($notooltip ? (($withpicto != 2) ? 'class="paddingright"' : '') : 'class="'.(($withpicto != 2) ? 'paddingright ' : '').'classfortooltip"'), 0, 0, $notooltip ? 0 : 1);
420 }
421 if ($withpicto != 2) {
422 $result .= $this->ref;
423 }
424 $result .= $linkend;
425 //if ($withpicto != 2) $result.=(($addlabel && $this->label) ? $sep . dol_trunc($this->label, ($addlabel > 1 ? $addlabel : 0)) : '');
426
427 return $result;
428 }
429
437 public function setAsDefault($id = 0, $alltypes = 0)
438 {
439 $sql1 = "SELECT rowid as id, fk_soc, type FROM ".MAIN_DB_PREFIX."societe_rib";
440 $sql1 .= " WHERE rowid = ".($id ? $id : $this->id);
441
442 dol_syslog(get_class($this).'::setAsDefault', LOG_DEBUG);
443 $result1 = $this->db->query($sql1);
444 if ($result1) {
445 if ($this->db->num_rows($result1) == 0) {
446 return 0;
447 } else {
448 $obj = $this->db->fetch_object($result1);
449
450 $type = '';
451 if (empty($alltypes)) {
452 $type = $obj->type;
453 }
454
455 $this->db->begin();
456
457 $sql2 = "UPDATE ".MAIN_DB_PREFIX."societe_rib SET default_rib = 0, tms = tms";
458 $sql2 .= " WHERE default_rib <> 0 AND fk_soc = ".((int) $obj->fk_soc);
459 if ($type) {
460 $sql2 .= " AND type = '".$this->db->escape($type)."'";
461 }
462 dol_syslog(get_class($this).'::setAsDefault', LOG_DEBUG);
463 $result2 = $this->db->query($sql2);
464
465 $sql3 = "UPDATE ".MAIN_DB_PREFIX."societe_rib SET default_rib = 1";
466 $sql3 .= " WHERE rowid = ".((int) $obj->id);
467 if ($type) {
468 $sql3 .= " AND type = '".$this->db->escape($type)."'";
469 }
470 dol_syslog(get_class($this).'::setAsDefault', LOG_DEBUG);
471 $result3 = $this->db->query($sql3);
472
473 if (!$result2 || !$result3) {
474 dol_print_error($this->db);
475 $this->db->rollback();
476 return -1;
477 } else {
478 $this->db->commit();
479 return 1;
480 }
481 }
482 } else {
483 dol_print_error($this->db);
484 return -1;
485 }
486 }
487
494 public function getLibStatut($mode = 0)
495 {
496 return $this->LibStatut($this->status, $mode);
497 }
498
499 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
507 public function LibStatut($status, $mode = 0)
508 {
509 // phpcs:enable
510 if (empty($this->labelStatus) || empty($this->labelStatusShort)) {
511 global $langs;
512 //$langs->load("mymodule");
513 $this->labelStatus[self::STATUS_ENABLED] = $langs->transnoentitiesnoconv('Enabled');
514 $this->labelStatus[self::STATUS_CANCELED] = $langs->transnoentitiesnoconv('Disabled');
515 $this->labelStatusShort[self::STATUS_ENABLED] = $langs->transnoentitiesnoconv('Enabled');
516 $this->labelStatusShort[self::STATUS_CANCELED] = $langs->transnoentitiesnoconv('Disabled');
517 }
518
519 $statusType = 'status5';
520 if ($status == self::STATUS_ENABLED) {
521 $statusType = 'status4';
522 }
523
524 return dolGetStatus($this->labelStatus[$status], $this->labelStatusShort[$status], '', $statusType, $mode);
525 }
526
533 public function info($id)
534 {
535 $sql = 'SELECT rowid, date_creation as datec, tms as datem,';
536 $sql .= ' fk_user_creat, fk_user_modif';
537 $sql .= ' FROM '.MAIN_DB_PREFIX.$this->table_element.' as t';
538 $sql .= ' WHERE t.rowid = '.((int) $id);
539 $result = $this->db->query($sql);
540 if ($result) {
541 if ($this->db->num_rows($result)) {
542 $obj = $this->db->fetch_object($result);
543
544 $this->id = $obj->rowid;
545
546 $this->user_creation_id = $obj->fk_user_creat;
547 $this->user_modification_id = $obj->fk_user_modif;
548 $this->date_creation = $this->db->jdate($obj->datec);
549 $this->date_modification = empty($obj->datem) ? '' : $this->db->jdate($obj->datem);
550 }
551
552 $this->db->free($result);
553 } else {
554 dol_print_error($this->db);
555 }
556 }
557
564 public function initAsSpecimen()
565 {
566 $this->initAsSpecimenCommon();
567 }
568}
print $langs trans("AuditedSecurityEvents").'</strong >< span class="opacitymedium"></span >< br > status
Definition security.php:604
Parent class of all other business classes (invoices, contracts, proposals, orders,...
createCommon(User $user, $notrigger=false)
Create object into database.
deleteCommon(User $user, $notrigger=false, $forcechilddeletion=0)
Delete object in database.
initAsSpecimenCommon()
Initialise object with example values Id must be 0 if object instance is a specimen.
updateCommon(User $user, $notrigger=false)
Update object into database.
fetchCommon($id, $ref=null, $morewhere='', $noextrafields=0)
Load object in memory from the database.
Class for CompanyPaymentMode.
update(User $user, $notrigger=false)
Load object lines in memory from the database.
info($id)
Load the info information in the object.
setAsDefault($id=0, $alltypes=0)
Set a Payment mode as Default.
getLibStatut($mode=0)
Return label of the status.
__construct(DoliDB $db)
Constructor.
getNomUrl($withpicto=0, $option='', $notooltip=0, $morecss='', $save_lastsearch_value=-1)
Return a link to the object card (with optionaly the picto)
initAsSpecimen()
Initialise object with example values Id must be 0 if object instance is a specimen.
fetch($id, $ref=null, $socid=0, $type='', $morewhere='')
Load object in memory from the database.
LibStatut($status, $mode=0)
Return the status.
createFromClone(User $user, $fromid)
Clone and object into another one.
create(User $user, $notrigger=false)
Create object into database.
Class to manage Dolibarr database access.
Class to manage Dolibarr users.
dol_print_error($db='', $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0)
Show a picto called object_picto (generic function)
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.