git.roojs.org Git - Pman.Core/blob - DataObjects/Core_person.php

   1 <?php
   2 /**
   3  * Table Definition for Person
   4  */
   5 class_exists('DB_DataObject') ? '' : require_once 'DB/DataObject.php';
   6
   7
   8 class Pman_Core_DataObjects_Core_person extends DB_DataObject
   9 {
  10     ###START_AUTOCODE
  11     /* the code below is auto generated do not remove the above tag */
  12
  13     public $__table = 'core_person';                          // table name
  14     public $id;                              // int(11)  not_null primary_key auto_increment
  15     public $email;                           // string(128)  not_null
  16     public $alt_email;
  17
  18     public $company_id;                      // int(11)
  19     public $office_id;                       // int(11)
  20     public $name;                            // string(128)  not_null
  21     public $firstname;                            // string(128)  not_null
  22     public $lastname;                            // string(128)  not_null
  23     public $phone;                           // string(32)  not_null
  24     public $fax;                             // string(32)  not_null
  25
  26     public $role;                            // string(32)  not_null
  27     public $remarks;                         // blob(65535)  not_null blob
  28     public $passwd;                          // string(64)  not_null
  29     public $owner_id;                        // int(11)  not_null
  30     public $lang;                            // string(8)
  31     public $no_reset_sent;                   // int(11)
  32     public $action_type;                     // string(32)
  33     public $project_id;                      // int(11)
  34
  35
  36     public $active;                          // int(11)  not_null
  37     public $deleted_by;                      // int(11)  not_null
  38     public $deleted_dt;                      // datetime(19)  binary
  39
  40
  41     public $name_facebook; // VARCHAR(128) NULL;
  42     public $url_blog; // VARCHAR(256) NULL ;
  43     public $url_twitter; // VARCHAR(256) NULL ;
  44     public $url_linkedin; // VARCHAR(256) NULL ;
  45     public $linkedin_id; // VARCHAR(256) NULL ;
  46
  47     public $phone_mobile; // varchar(32)  NOT NULL  DEFAULT '';
  48     public $phone_direct; // varchar(32)  NOT NULL  DEFAULT '';
  49     public $countries; // VARCHAR(128) NULL;
  50
  51     /* the code above is auto generated do not remove the tag below */
  52     ###END_AUTOCODE
  53
  54     function owner()
  55     {
  56         $p = DB_DataObject::Factory($this->tableName());
  57         $p->get($this->owner_id);
  58         return $p;
  59     }
  60
  61     /**
  62      *
  63      *
  64      *
  65      *
  66      *  FIXME !!!! -- USE Pman_Core_Mailer !!!!!
  67      *
  68      *
  69      *
  70      *
  71      */
  72     function buildMail($templateFile, $args)
  73     {
  74
  75         $args = (array) $args;
  76         $content  = clone($this);
  77
  78         foreach((array)$args as $k=>$v) {
  79             $content->$k = $v;
  80         }
  81
  82         $ff = HTML_FlexyFramework::get();
  83
  84
  85         //?? is this really the place for this???
  86         if (
  87                 !$ff->cli &&
  88                 empty($args['no_auth']) &&
  89                 !in_array($templateFile, array(
  90                     // templates that can be sent without authentication.
  91                      'password_reset' ,
  92                      'password_welcome'
  93                  ))
  94             ) {
  95
  96             $content->authUser = $this->getAuthUser();
  97             if (!$content->authUser) {
  98                 return PEAR::raiseError("Not authenticated");
  99             }
 100         }
 101
 102         // should handle x-forwarded...
 103
 104         $content->HTTP_HOST = isset($_SERVER["HTTP_HOST"]) ?
 105             $_SERVER["HTTP_HOST"] :
 106             (isset($ff->HTTP_HOST) ? $ff->HTTP_HOST : 'localhost');
 107
 108         /* use the regex compiler, as it doesnt parse <tags */
 109
 110         $tops = array(
 111             'compiler'    => 'Flexy',
 112             'nonHTML' => true,
 113             'filters' => array('SimpleTags','Mail'),
 114             //     'debug'=>1,
 115         );
 116
 117
 118
 119         if (!empty($args['templateDir'])) {
 120             $tops['templateDir'] = $args['templateDir'];
 121         }
 122
 123
 124
 125         require_once 'HTML/Template/Flexy.php';
 126         $template = new HTML_Template_Flexy( $tops );
 127         $template->compile("mail/$templateFile.txt");
 128
 129         /* use variables from this object to ouput data. */
 130         $mailtext = $template->bufferedOutputObject($content);
 131
 132         $htmlbody = false;
 133         // if a html file with the same name exists, use that as the body
 134         // I've no idea where this code went, it was here before..
 135         if (false !== $template->resolvePath ( "mail/$templateFile.html" )) {
 136             $tops['nonHTML'] = false;
 137             $template = new HTML_Template_Flexy( $tops );
 138             $template->compile("mail/$templateFile.html");
 139             $htmlbody = $template->bufferedOutputObject($content);
 140
 141         }
 142
 143
 144
 145         //echo "<PRE>";print_R($mailtext);
 146         //print_R($mailtext);exit;
 147         /* With the output try and send an email, using a few tricks in Mail_MimeDecode. */
 148         require_once 'Mail/mimeDecode.php';
 149         require_once 'Mail.php';
 150
 151         $decoder = new Mail_mimeDecode($mailtext);
 152         $parts = $decoder->getSendArray();
 153
 154         if (is_a($parts,'PEAR_Error')) {
 155             return $parts;
 156             //echo "PROBLEM: {$parts->message}";
 157             //exit;
 158         }
 159         list($recipents,$headers,$body) = $parts;
 160         $recipents = array($this->email);
 161         if (!empty($content->bcc) && is_array($content->bcc)) {
 162             $recipents =array_merge($recipents, $content->bcc);
 163         }
 164         $headers['Date'] = date('r');
 165
 166         if ($htmlbody !== false) {
 167             require_once 'Mail/mime.php';
 168             $mime = new Mail_mime(array('eol' => "\n"));
 169             $mime->setTXTBody($body);
 170             $mime->setHTMLBody($htmlbody);
 171             // I think there might be code in mediaoutreach toEmail somewhere
 172             // h embeds images here..
 173             $body = $mime->get();
 174             $headers = $mime->headers($headers);
 175
 176         }
 177
 178
 179
 180         return array(
 181             'recipients' => $recipents,
 182             'headers'    => $headers,
 183             'body'      => $body
 184         );
 185
 186
 187     }
 188
 189
 190     /**
 191      * send a template
 192      * - user must be authenticate or args[no_auth] = true
 193      *   or template = password_[reset|welcome]
 194      *
 195      */
 196     function sendTemplate($templateFile, $args)
 197     {
 198
 199         $ar = $this->buildMail($templateFile, $args);
 200
 201
 202         //print_r($recipents);exit;
 203         $mailOptions = PEAR::getStaticProperty('Mail','options');
 204         $mail = Mail::factory("SMTP",$mailOptions);
 205
 206         if (PEAR::isError($mail)) {
 207             return $mail;
 208         }
 209         $oe = error_reporting(E_ALL & ~E_NOTICE & ~E_STRICT);
 210         $ret = $mail->send($ar['recipients'],$ar['headers'],$ar['body']);
 211         error_reporting($oe);
 212
 213         return $ret;
 214
 215     }
 216
 217
 218
 219
 220     function getEmailFrom()
 221     {
 222         if (empty($this->name)) {
 223             return $this->email;
 224         }
 225
 226         return '"' . addslashes($this->name) . '" <' . $this->email . '>';
 227     }
 228
 229     function toEventString()
 230     {
 231         return empty($this->name) ? $this->email : $this->name;
 232     }
 233
 234     function verifyAuth()
 235     {
 236         $ff= HTML_FlexyFramework::get();
 237         if (!empty($ff->Pman['auth_comptype']) &&
 238             (!$this->company_id || ($ff->Pman['auth_comptype'] != $this->company()->comptype))
 239            ){
 240
 241             $sesPrefix = $this->sesPrefix();
 242
 243             $_SESSION[get_class($this)][$sesPrefix .'-auth'] = "";
 244
 245             return false;
 246
 247             //$ff->page->jerr("Login not permited to outside companies");
 248         }
 249         return true;
 250
 251     }
 252
 253
 254     //   ---------------- authentication / passwords and keys stuff  ----------------
 255     function isAuth()
 256     {
 257         @session_start();
 258
 259         $ff= HTML_FlexyFramework::get();
 260
 261         $sesPrefix = $this->sesPrefix();
 262
 263         if (!empty($_SESSION[get_class($this)][$sesPrefix .'-auth'])) {
 264             // in session...
 265             $a = unserialize($_SESSION[get_class($this)][$sesPrefix .'-auth']);
 266
 267             $u = DB_DataObject::factory($this->tableName());
 268             if ($a->id && $u->get($a->id)) { //&& strlen($u->passwd)) {
 269
 270                 return $u->verifyAuth();  // got authentication...
 271
 272
 273             }
 274
 275             unset($_SESSION[get_class($this)][$sesPrefix .'-auth']);
 276             unset($_SESSION[get_class($this)][$sesPrefix .'-timeout']);
 277             setcookie('Pman.timeout', -1, time() + (30*60), '/');
 278
 279         }
 280
 281         // http basic auth..
 282         $u = DB_DataObject::factory($this->tableName());
 283
 284         if (!empty($_SERVER['PHP_AUTH_USER'])
 285             &&
 286             !empty($_SERVER['PHP_AUTH_PW'])
 287             &&
 288             $u->get('email', $_SERVER['PHP_AUTH_USER'])
 289             &&
 290             $u->checkPassword($_SERVER['PHP_AUTH_PW'])
 291            ) {
 292             $_SESSION[get_class($this)][$sesPrefix .'-auth'] = serialize($u);
 293             return true;
 294         }
 295         //die("test init");
 296         if (!$this->canInitializeSystem()) {
 297           //  die("can not init");
 298             return false;
 299         }
 300
 301
 302         // local auth -
 303         $default_admin = false;
 304         if (!empty($ff->Pman['local_autoauth']) &&
 305             ($ff->Pman['local_autoauth'] === true) &&
 306             (!empty($_SERVER['SERVER_ADDR'])) &&
 307             (
 308                 (
 309                     $_SERVER['SERVER_ADDR'] == '127.0.0.1' &&
 310                     $_SERVER['REMOTE_ADDR'] == '127.0.0.1'
 311                 )
 312                 ||
 313                 (
 314                     $_SERVER['SERVER_ADDR'] == '::1' &&
 315                     $_SERVER['REMOTE_ADDR'] == '::1'
 316                 )
 317             )
 318         ) {
 319             $group = DB_DataObject::factory('core_group');
 320             $group->get('name', 'Administrators');
 321
 322             $member = DB_DataObject::factory('core_group_member');
 323             $member->autoJoin();
 324             $member->group_id = $group->id;
 325             $member->whereAdd("
 326                 join_user_id_id.id IS NOT NULL
 327             ");
 328             if($member->find(true)){
 329                 $default_admin = DB_DataObject::factory($this->tableName());
 330                 if(!$default_admin->get($member->user_id)){
 331                     $default_admin = false;
 332                 }
 333             }
 334         }
 335
 336         //var_dump($ff->Pman['local_autoauth']);         var_dump($_SERVER); exit;
 337         $u = DB_DataObject::factory($this->tableName());
 338         $ff = HTML_FlexyFramework::get();
 339
 340         if (!empty($ff->Pman['local_autoauth']) &&
 341             (!empty($_SERVER['SERVER_ADDR'])) &&
 342             (
 343                 (
 344                     $_SERVER['SERVER_ADDR'] == '127.0.0.1' &&
 345                     $_SERVER['REMOTE_ADDR'] == '127.0.0.1'
 346                 )
 347                 ||
 348                 (
 349                     $_SERVER['SERVER_ADDR'] == '::1' &&
 350                     $_SERVER['REMOTE_ADDR'] == '::1'
 351                 )
 352             ) &&
 353             ($default_admin ||  $u->get('email', $ff->Pman['local_autoauth']))
 354         ) {
 355
 356             $user = $default_admin ? $default_admin->toArray() : $u->toArray();
 357
 358             $_SESSION[get_class($this)][$sesPrefix .'-auth'] = serialize((object) $user);
 359             return true;
 360         }
 361
 362         //var_dump(session_id());
 363         //var_dump($_SESSION[__CLASS__]);
 364
 365         //if (!empty(   $_SESSION[__CLASS__][$sesPrefix .'-empty'] )) {
 366         //    return false;
 367         //}
 368         //die("got this far?");
 369         // not in session or not matched...
 370         $u = DB_DataObject::factory($this->tableName());
 371         $u->whereAdd(' LENGTH(passwd) > 0');
 372         $n = $u->count();
 373         $_SESSION[get_class($this)][$sesPrefix .'-empty']  = $n;
 374         if (class_exists('PEAR')) {
 375             $error =  PEAR::getStaticProperty('DB_DataObject','lastError');
 376             if ($error) {
 377                 die($error->toString()); // not really a good thing to do...
 378             }
 379         }
 380         if (!$n){ // authenticated as there are no users in the system...
 381             return true;
 382         }
 383
 384         return false;
 385
 386     }
 387
 388     function canInitializeSystem()
 389     {
 390
 391         return !strcasecmp(get_class($this) , __CLASS__);
 392     }
 393
 394     function getAuthUser()
 395     {
 396         if (!$this->isAuth()) {
 397             return false;
 398         }
 399
 400         $ff= HTML_FlexyFramework::get();
 401
 402         $sesPrefix = $this->sesPrefix();
 403
 404         //var_dump(array(get_class($this),$sesPrefix .'-auth'));
 405
 406         if (!empty($_SESSION[get_class($this)][$sesPrefix .'-auth'])) {
 407             $a = unserialize($_SESSION[get_class($this)][$sesPrefix .'-auth']);
 408
 409             $u = DB_DataObject::factory($this->tableName()); // allow extending this ...
 410             $u->autoJoin();
 411             if ($u->get($a->id)) { /// && strlen($u->passwd)) {  // should work out the pid .. really..
 412
 413                 $_SESSION[get_class($this)][$sesPrefix .'-auth-timeout'] = time() + (30*60); // eg. 30 minutes
 414                 setcookie('Pman.timeout', time() + (30*60), time() + (30*60), '/');
 415
 416                 $user = clone ($u);
 417                 return clone($user);
 418
 419             }
 420             unset($_SESSION[get_class($this)][$sesPrefix .'-auth']);
 421             unset($_SESSION[get_class($this)][$sesPrefix .'-timeout']);
 422             setcookie('Pman.timeout', -1, time() + (30*60), '/');
 423
 424         }
 425
 426
 427
 428         if (!$this->canInitializeSystem()) {
 429             return false;
 430         }
 431
 432
 433
 434         if (empty(   $_SESSION[get_class($this)][$sesPrefix .'-empty'] )) {
 435             $u = DB_DataObject::factory($this->tableName());
 436             $u->whereAdd(' LENGTH(passwd) > 0');
 437             $_SESSION[get_class($this)][$sesPrefix .'-empty']  = $u->count();
 438         }
 439
 440
 441         if (
 442             isset(   $_SESSION[get_class($this)][$sesPrefix .'-empty'] ) &&
 443             $_SESSION[get_class($this)][$sesPrefix .'-empty']  < 1
 444         ) {
 445
 446             // fake person - open system..
 447             //$ce = DB_DataObject::factory('core_enum');
 448             //$ce->initEnums();
 449
 450
 451             $u = DB_DataObject::factory($this->tableName());
 452             $u->id = -1;
 453
 454             // if a company has been created fill that in in company_id_id
 455             $c = DB_DAtaObject::factory('core_company')->lookupOwner();
 456             if ($c) {
 457                 $u->company_id_id = $c->pid();
 458                 $u->company_id = $c->pid();
 459             }
 460
 461             return $u;
 462
 463         }
 464         return false;
 465     }
 466     function login()
 467     {
 468         $this->isAuth(); // force session start..
 469         if (!$this->verifyAuth()) { // check for company valid..
 470             return false;
 471         }
 472
 473         // open up iptables at login..
 474         $dbname = $this->databaseNickname();
 475         touch( '/tmp/run_pman_admin_iptables-'.$dbname);
 476
 477         // refresh admin group if we are logged in as one..
 478         //DB_DataObject::debugLevel(1);
 479         $g = DB_DataObject::factory('core_group');
 480         $g->type = 0;
 481         $g->get('name', 'Administrators');
 482         $gm = DB_DataObject::Factory('core_group_member');
 483         if (in_array($g->id,$gm->listGroupMembership($this))) {
 484             // refresh admin groups.
 485             $gr = DB_DataObject::Factory('core_group_right');
 486             $gr->applyDefs($g, 0);
 487         }
 488
 489         $sesPrefix = $this->sesPrefix();
 490
 491         // we should not store the whole data in the session - otherwise it get's huge.
 492         $p = DB_DAtaObject::Factory($this->tableName());
 493         $p->get($this->pid());
 494
 495         $d = $p->toArray();
 496
 497         $_SESSION[get_class($this)][$sesPrefix .'-auth-timeout'] = time() + (30*60); // eg. 30 minutes
 498         setcookie('Pman.timeout', time() + (30*60), time() + (30*60), '/');
 499
 500         //var_dump(array(get_class($this),$sesPrefix .'-auth'));
 501         $_SESSION[get_class($this)][$sesPrefix .'-auth'] = serialize((object)$d);
 502         // ensure it's written so that ajax calls can fetch it..
 503
 504
 505
 506     }
 507     function logout()
 508     {
 509         $this->isAuth(); // force session start..
 510
 511         $sesPrefix = $this->sesPrefix();
 512
 513         $_SESSION[get_class($this)][$sesPrefix .'-auth-timeout'] = -1;
 514
 515         $_SESSION[get_class($this)][$sesPrefix .'-auth'] = "";
 516
 517     }
 518     function genPassKey ($t)
 519     {
 520         return md5($this->email . $t. $this->passwd);
 521     }
 522     function simpleAuthKey($m = 0)
 523     {
 524         $month = $m > -1 ? date('Y-m') : date('Y-m', strtotime('LAST MONTH'));
 525
 526         return md5(implode(',' ,  array($month, $this->email , $this->passwd, $this->id)));
 527     }
 528
 529     function checkTwoFactorAuthentication($val)
 530     {
 531         require_once 'System.php';
 532
 533         $oathtool = System::which('oathtool');
 534
 535         if (!$oathtool) {
 536             return false;
 537         }
 538
 539         $oath_key = $_SESSION[__CLASS__]['oath'][$this->id];
 540
 541         $cmd = "{$oathtool} --totp --base32 {$oath_key}";
 542
 543         $password = exec($cmd);
 544
 545         return ($password == $val) ? true : false;
 546     }
 547
 548     function checkPassword($val)
 549     {
 550         if (substr($this->passwd,0,1) == '$') {
 551             if (function_exists('pasword_verify')) {
 552                 return password_verify($val, $this->passwd);
 553             }
 554             return crypt($val,$this->passwd) == $this->passwd ;
 555         }
 556         // old style md5 passwords...- cant be used with courier....
 557         return md5($val) == $this->passwd;
 558     }
 559
 560     function setPassword($value)
 561     {
 562         if (function_exists('pasword_hash')) {
 563             return password_hash($value);
 564         }
 565
 566         $salt='';
 567         while(strlen($salt)<9) {
 568             $salt.=chr(rand(64,126));
 569             //php -r var_dump(crypt('testpassword', '$1$'. (rand(64,126)). '$'));
 570         }
 571         $this->passwd = crypt($value, '$1$'. $salt. '$');
 572
 573
 574     }
 575
 576     function generatePassword($length = 5) // genearte a password (add set 'rawPasswd' to it's value)
 577     {
 578         require_once 'Text/Password.php';
 579         $this->rawPasswd = strtr(ucfirst(Text_Password::create($length)).ucfirst(Text_Password::create($length)), array(
 580         "a"=>"4", "e"=>"3",  "i"=>"1",  "o"=>"0", "s"=>"5",  "t"=>"7"));
 581         $this->setPassword($this->rawPasswd);
 582         return $this->rawPasswd;
 583     }
 584
 585     function company()
 586     {
 587         $x = DB_DataObject::factory('core_company');
 588         $x->autoJoin();
 589         $x->get($this->company_id);
 590         return $x;
 591     }
 592     function loadCompany()
 593     {
 594         $this->company = $this->company();
 595     }
 596
 597     function active()
 598     {
 599         return $this->active;
 600     }
 601     function authUserName($n) // set username prior to acheck user exists query.
 602     {
 603
 604         $this->whereAdd('LENGTH(passwd) > 1');
 605         $this->email = $n;
 606     }
 607     function lang()
 608     {
 609         if (!func_num_args()) {
 610             return $this->lang;
 611         }
 612         $val = array_shift(func_get_args());
 613         if ($val == $this->lang) {
 614             return;
 615         }
 616         $uu = clone($this);
 617         $this->lang = $val;
 618         $this->update($uu);
 619         return $this->lang;
 620     }
 621
 622
 623     function authUserArray()
 624     {
 625
 626         $aur = $this->toArray();
 627
 628         if ($this->id < 1) {
 629             return $aur;
 630         }
 631
 632
 633         //DB_DataObject::debugLevel(1);
 634         $c = DB_Dataobject::factory('core_company');
 635         $im = DB_Dataobject::factory('Images');
 636         $c->joinAdd($im, 'LEFT');
 637         $c->selectAdd();
 638         $c->selectAs($c, 'company_id_%s');
 639         $c->selectAs($im, 'company_id_logo_id_%s');
 640         $c->id = $this->company_id;
 641         $c->limit(1);
 642         $c->find(true);
 643
 644         $aur = array_merge( $c->toArray(),$aur);
 645
 646         if (empty($c->company_id_logo_id_id))  {
 647
 648             $im = DB_Dataobject::factory('Images');
 649             $im->ontable = DB_DataObject::factory('core_company')->tableName();
 650             $im->onid = $c->id;
 651             $im->imgtype = 'LOGO';
 652             $im->limit(1);
 653             $im->selectAdd();
 654             $im->selectAs($im,  'company_id_logo_id_%s');
 655             if ($im->find(true)) {
 656
 657                 foreach($im->toArray() as $k=>$v) {
 658                     if (!preg_match('/^company_id_logo_id_/', $k)) {
 659                         continue;
 660                     }
 661                     $aur[$k] = $v;
 662                 }
 663             }
 664         }
 665
 666         // perms + groups.
 667         $aur['perms']  = $this->getPerms();
 668         $g = DB_DataObject::Factory('core_group_member');
 669         $aur['groups']  = $g->listGroupMembership($this, 'name');
 670
 671         $aur['passwd'] = '';
 672         $aur['dailykey'] = '';
 673         $aur['oath_key'] = '';
 674
 675         $aur['oath_key_enable'] = !empty($this->oath_key);
 676
 677         return $aur;
 678     }
 679
 680     //   ----------PERMS------  ----------------
 681     function getPerms()
 682     {
 683          //DB_DataObject::debugLevel(1);
 684         // find out all the groups they are a member of.. + Default..
 685
 686         // ------ INIITIALIZE IF NO GROUPS ARE SET UP.
 687
 688         $g = DB_DataObject::Factory('core_group_right');
 689         if (!$g->count()) {
 690             $g->genDefault();
 691         }
 692
 693         if ($this->id < 0) {
 694             return $g->adminRights(); // system is not set up - so they get full rights.
 695         }
 696         //DB_DataObject::debugLevel(1);
 697         $g = DB_DataObject::Factory('core_group_member');
 698         $g->whereAdd('group_id is NOT NULL AND user_id IS NOT NULL');
 699         if (!$g->count()) {
 700             // add the current user to the admin group..
 701             $g = DB_DataObject::Factory('core_group');
 702             if ($g->get('name', 'Administrators')) {
 703                 $gm = DB_DataObject::Factory('core_group_member');
 704                 $gm->group_id = $g->id;
 705                 $gm->user_id = $this->id;
 706                 $gm->insert();
 707             }
 708
 709         }
 710
 711         // ------ STANDARD PERMISSION HANDLING.
 712         $isOwner = $this->company()->comptype == 'OWNER';
 713         $g = DB_DataObject::Factory('core_group_member');
 714         $grps = $g->listGroupMembership($this);
 715        //var_dump($grps);
 716         $isAdmin = $g->inAdmin;   //???  what???
 717         //echo '<PRE>'; print_r($grps);var_dump($isAdmin);
 718         // the load all the perms for those groups, and add them all together..
 719         // then load all those
 720         $g = DB_DataObject::Factory('core_group_right');
 721         $ret =  $g->listPermsFromGroupIds($grps, $isAdmin, $isOwner);
 722         //echo '<PRE>';print_r($ret);
 723         return $ret;
 724
 725
 726     }
 727     /**
 728      *Basic group fetching - probably needs to filter by type eventually.
 729      *
 730      *@param String $what - fetchall() argument - eg. 'name' returns names of all groups that they are members of.
 731      */
 732
 733     function groups($what=false)
 734     {
 735         $g = DB_DataObject::Factory('core_group_member');
 736         $grps = $g->listGroupMembership($this);
 737         $g = DB_DataObject::Factory('core_group');
 738         $g->whereAddIn('id', $grps, 'int');
 739         return $g->fetchAll($what);
 740
 741     }
 742
 743
 744
 745     function hasPerm($name, $lvl)
 746     {
 747         static $pcache = array();
 748
 749         if (!isset($pcache[$this->id])) {
 750             $pcache[$this->id] = $this->getPerms();
 751         }
 752
 753        // echo "<PRE>";print_r($pcache[$au->id]);
 754        // var_dump($pcache[$au->id]);
 755         if (empty($pcache[$this->id][$name])) {
 756             return false;
 757         }
 758
 759         return strpos($pcache[$this->id][$name], $lvl) > -1;
 760
 761     }
 762
 763     //  ------------ROO HOOKS------------------------------------
 764     function applyFilters($q, $au, $roo)
 765     {
 766         //DB_DataObject::DebugLevel(1);
 767         if(!empty($q['_generate_oath_key'])){
 768             $o = clone($this);
 769             $this->oath_key = $this->getOathKey();
 770             $this->update($o);
 771             $roo->jok('OK');
 772         }
 773
 774         if(!empty($q['_to_qr_code'])){
 775
 776             $person = DB_DataObject::factory('Core_person');
 777             $person->id = $q['id'];
 778
 779             if(!$person->find(true)) {
 780                 $roo->jerr('_invalid_person');
 781             }
 782
 783             $hash = $this->getOathKey();
 784
 785             $_SESSION[__CLASS__]['oath'][$person->id] = $hash;
 786
 787             $qrcode = $person->generateQRCode($hash);
 788
 789             if(empty($qrcode)){
 790                 $roo->jerr('Fail to generate QR Code');
 791             }
 792
 793             $roo->jok($qrcode);
 794         }
 795
 796         if(!empty($q['two_factor_auth_code'])) {
 797
 798             $person = DB_DataObject::factory('core_person');
 799             $person->get($q['id']);
 800
 801             if($person->checkTwoFactorAuthentication($q['two_factor_auth_code'])) {
 802                 $roo->jok('DONE');
 803             }
 804
 805             $roo->jerr('_invalid_auth_code');
 806         }
 807
 808         if(!empty($q['oath_key_disable'])) {
 809
 810             $person = DB_DataObject::factory('core_person');
 811             $person->get($q['id']);
 812
 813             $o = clone($person);
 814
 815             $person->oath_key = '';
 816             $person->update($o);
 817
 818             $roo->jok('DONE');
 819         }
 820
 821         if (!empty($q['query']['is_owner'])) {
 822             $this->whereAdd(" join_company_id_id.comptype = 'OWNER'");
 823         }
 824
 825         if (!empty($q['query']['person_not_internal'])) {
 826             $this->whereAdd(" join_company_id_id.isOwner = 0 ");
 827         }
 828
 829         if (!empty($q['query']['person_internal_only_all'])) {
 830
 831
 832             // must be internal and not current user (need for distribution list)
 833             // user has a projectdirectory entry and role is not blank.
 834             //DB_DataObject::DebugLevel(1);
 835             $pd = DB_DataObject::factory('ProjectDirectory');
 836             $pd->whereAdd("role != ''");
 837             $pd->selectAdd();
 838             $pd->selectAdd('distinct(person_id) as person_id');
 839             $roled = $pd->fetchAll('person_id');
 840             $rs = $roled  ? "  OR
 841                     {$this->tableName()}.id IN (".implode(',', $roled) . ")
 842                     " : '';
 843             $this->whereAdd(" join_company_id_id.comptype = 'OWNER' $rs ");
 844
 845         }
 846         // -- for distribution
 847         if (!empty($q['query']['person_internal_only'])) {
 848             // must be internal and not current user (need for distribution list)
 849             $this->whereAdd(" join_company_id_id.comptype = 'OWNER'");
 850
 851             //$this->whereAdd(($this->tableName() == 'Person' ? 'Person' : "join_person_id_id") .
 852             //    ".id  != ".$au->id);
 853             $this->whereAdd("{$this->tableName()}.id != {$au->id}");
 854         }
 855
 856         if (!empty($q['query']['comptype_or_company_id'])) {
 857            // DB_DataObject::debugLevel(1);
 858             $bits = explode(',', $q['query']['comptype_or_company_id']);
 859             $id = (int) array_pop($bits);
 860             $ct = $this->escape($bits[0]);
 861
 862             $this->whereAdd(" join_company_id_id.comptype = '$ct' OR {$this->tableName()}.company_id = $id");
 863
 864         }
 865
 866
 867         // staff list..
 868         if (!empty($q['query']['person_inactive'])) {
 869            // DB_Dataobject::debugLevel(1);
 870             $this->active = 1;
 871         }
 872         $tn_p = $this->tableName();
 873         $tn_gm = DB_DataObject::Factory('core_group_member')->tableName();
 874         $tn_g = DB_DataObject::Factory('core_group')->tableName();
 875
 876         ///---------------- Group views --------
 877         if (!empty($q['query']['in_group'])) {
 878             // DB_DataObject::debugLevel(1);
 879             $ing = (int) $q['query']['in_group'];
 880             if ($q['query']['in_group'] == -1) {
 881
 882                 // list all staff who are not in a group.
 883                 $this->whereAdd("{$this->tableName()}.id NOT IN (
 884                     SELECT distinct(user_id) FROM $tn_gm LEFT JOIN
 885                         $tn_g ON $tn_g.id = $tn_gm.group_id)");
 886
 887             } else {
 888
 889                 $this->whereAdd("$tn_p.id IN (
 890                     SELECT distinct(user_id) FROM $tn_gm
 891                         WHERE group_id = $ing
 892                     )");
 893                }
 894
 895         }
 896
 897         if(!empty($q['in_group_name'])){
 898
 899             $v = $this->escape($q['in_group_name']);
 900
 901             $this->whereAdd("
 902                 $tn_p.id IN (
 903                     SELECT
 904                         DISTINCT(user_id) FROM $tn_gm
 905                     LEFT JOIN
 906                         $tn_g
 907                     ON
 908                         $tn_g.id = $tn_gm.group_id
 909                     WHERE
 910                         $tn_g.name = '{$v}'
 911                 )"
 912             );
 913         }
 914
 915         // #2307 Search Country!!
 916         if (!empty($q['query']['in_country'])) {
 917             // DB_DataObject::debugLevel(1);
 918             $inc = $q['query']['in_country'];
 919             $this->whereAdd("$tn_p.countries LIKE '%{$inc}%'");
 920         }
 921
 922         if (!empty($q['query']['not_in_directory'])) {
 923             // it's a Person list..
 924             // DB_DATaobjecT::debugLevel(1);
 925
 926             // specific to project directory which is single comp. login
 927             //
 928             $owncomp = DB_DataObject::Factory('core_company');
 929             $owncomp->get('comptype', 'OWNER');
 930             if ($q['company_id'] == $owncomp->id) {
 931                 $this->active =1;
 932             }
 933
 934
 935
 936             if ( $q['query']['not_in_directory'] > -1) {
 937                 $tn_pd = DB_DataObject::Factory('ProjectDirectory')->tableName();
 938                 // can list current - so that it does not break!!!
 939                 $this->whereAdd("$tn_p.id NOT IN
 940                     ( SELECT distinct person_id FROM $tn_pd WHERE
 941                         project_id = " . $q['query']['not_in_directory'] . " AND
 942                         company_id = " . $this->company_id . ')');
 943             }
 944         }
 945
 946         if (!empty($q['query']['role'])) {
 947             // it's a Person list..
 948             // DB_DATaobjecT::debugLevel(1);
 949
 950             // specific to project directory which is single comp. login
 951             //
 952             $tn_pd = DB_DataObject::Factory('ProjectDirectory')->tableName();
 953                 // can list current - so that it does not break!!!
 954             $this->whereAdd("$tn_p.id IN
 955                     ( SELECT distinct person_id FROM $tn_pd WHERE
 956                         role = '". $this->escape($q['query']['role']) ."'
 957             )");
 958
 959         }
 960
 961
 962         if (!empty($q['query']['project_member_of'])) {
 963                // this is also a flag to return if they are a member..
 964             //DB_DataObject::debugLevel(1);
 965             $do = DB_DataObject::factory('ProjectDirectory');
 966             $do->project_id = $q['query']['project_member_of'];
 967             $tn_pd = DB_DataObject::Factory('ProjectDirectory')->tableName();
 968             $this->joinAdd($do,array('joinType' => 'LEFT', 'useWhereAsOn' => true));
 969             $this->selectAdd("IF($tn_pd.id IS NULL, 0,  $tn_pd.id )  as is_member");
 970
 971
 972             if (!empty($q['query']['project_member_filter'])) {
 973                 $this->having('is_member !=0');
 974
 975             }
 976
 977         }
 978
 979         if(!empty($q['query']['name'])){
 980             $this->whereAdd("
 981                 {$this->tableName()}.name LIKE '%{$this->escape($q['query']['name'])}%'
 982             ");
 983         }
 984          if(!empty($q['query']['name_starts'])){
 985             $this->whereAdd("
 986                 {$this->tableName()}.name LIKE '{$this->escape($q['query']['name_starts'])}%'
 987             ");
 988         }
 989
 990         if (!empty($q['query']['search'])) {
 991
 992             // use our magic search builder...
 993
 994              require_once 'Text/SearchParser.php';
 995             $x = new Text_SearchParser($q['query']['search']);
 996
 997             $props = array(
 998                     "$tn_p.name",
 999                     "$tn_p.email",
1000                     "$tn_p.role",
1001                     "$tn_p.phone",
1002                     "$tn_p.remarks",
1003                     "join_company_id_id.name"
1004             );
1005             $tbcols = $this->table();
1006             foreach(array('firstname','lastname') as $k) {
1007                 if (isset($tbcols[$k])) {
1008                     $props[] = "{$tn_p}.{$k}";
1009                 }
1010             }
1011
1012
1013
1014
1015             $str =  $x->toSQL(array(
1016                 'default' => $props,
1017                 'map' => array(
1018                     'company' => 'join_company_id_id.name',
1019                     //'country' => 'Clipping.country',
1020                     //  'media' => 'Clipping.media_name',
1021                 ),
1022                 'escape' => array($this->getDatabaseConnection(), 'escapeSimple'), /// pear db or mdb object..
1023
1024             ));
1025
1026
1027             $this->whereAdd($str); /*
1028                         $tn_p.name LIKE '%$s%'  OR
1029                         $tn_p.email LIKE '%$s%'  OR
1030                         $tn_p.role LIKE '%$s%'  OR
1031                         $tn_p.phone LIKE '%$s%' OR
1032                         $tn_p.remarks LIKE '%$s%'
1033
1034                     ");*/
1035         }
1036
1037         // project directory rules -- this may distrupt things.
1038         $p = DB_DataObject::factory('ProjectDirectory');
1039         // if project directories are set up, then we can apply project query rules..
1040         if ($p->count()) {
1041             $p->autoJoin();
1042             $pids = $p->projects($au);
1043             if (isset($q['query']['project_id'])) {
1044                 $pid = (int)$q['query']['project_id'];
1045                 if (!in_array($pid, $pids)) {
1046                     $roo->jerr("Project not in users valid projects");
1047                 }
1048                 $pids = array($pid);
1049             }
1050             // project roles..
1051             //if (empty($q['_anyrole'])) {  // should be project_directry_role
1052             //    $p->whereAdd("{$p->tableName()}.role != ''");
1053             // }
1054             if (!empty($q['query']['role'])) {  // should be project_directry_role
1055                 $role = $this->escape($q['query']['role']);
1056
1057                 $p->whereAdd("{$p->tableName()}.role LIKE '%{$role}%'");
1058
1059             }
1060
1061             if (!$roo->hasPerm('Core.Projects_All', 'S')) {
1062                 $peps = $p->people($pids);
1063                 $this->whereAddIn("{$tn}.id", $peps, 'int');
1064             }
1065         }
1066
1067         // fixme - this needs a more generic fix - it was from the mtrack_person code...
1068         if (isset($q['query']['ticket_id'])) {
1069             // find out what state the ticket is in.
1070             $t = DB_DataObject::Factory('mtrack_ticket');
1071             $t->autoJoin();
1072             $t->get($q['query']['ticket_id']);
1073
1074             if (!$this->checkPerm('S', $au)) {
1075                 $roo->jerr("permssion denied to query state of ticket");
1076             }
1077
1078             $p = DB_DataObject::factory('ProjectDirectory');
1079             $pids = array($t->project_id);
1080
1081             $peps = $p->people($pids);
1082
1083             $this->whereAddIn($this->tableName().'.id', $peps, 'int');
1084
1085             //$this->whereAdd('join_prole != ''");
1086
1087         }
1088
1089         /*
1090          * Seems we never expose oath_key / passwd, so...
1091          */
1092
1093         if($this->tableName() == 'core_person'){
1094             $this->_extra_cols = array('length_passwd', 'length_oath_key');
1095
1096             $this->selectAdd("
1097                 LENGTH({$this->tableName()}.passwd) AS length_passwd,
1098                 LENGTH({$this->tableName()}.oath_key) AS length_oath_key
1099             ");
1100         }
1101
1102
1103     }
1104
1105     function setFromRoo($ar, $roo)
1106     {
1107         $this->setFrom($ar);
1108
1109         if(!empty($ar['_enable_oath_key'])){
1110             $oath_key = $this->getOathKey();
1111         }
1112
1113         if (!empty($ar['passwd1'])) {
1114             $this->setPassword($ar['passwd1']);
1115         }
1116
1117         if (    $this->id &&
1118                 ($this->email == $roo->old->email)&&
1119                 ($this->company_id == $roo->old->company_id)
1120             ) {
1121             return true;
1122         }
1123         if (empty($this->email)) {
1124             return true;
1125         }
1126         // this only applies to our owner company..
1127         $c = $this->company();
1128         if (empty($c->comptype_name) || $c->comptype_name != 'OWNER') {
1129             return true;
1130         }
1131
1132
1133         $xx = DB_Dataobject::factory($this->tableName());
1134         $xx->setFrom(array(
1135             'email' => $this->email,
1136            // 'company_id' => $x->company_id
1137         ));
1138
1139         if ($xx->count()) {
1140             return "Duplicate Email found";
1141         }
1142
1143         return true;
1144     }
1145     /**
1146      *
1147      * before Delete - delete significant dependancies..
1148      * this is called after checkPerm..
1149      */
1150
1151     function beforeDelete($dependants_array, $roo)
1152     {
1153         //delete group membership except for admin group..
1154         // if they are a member of admin group do not delete anything.
1155         $default_admin = false;
1156
1157         $e = DB_DataObject::Factory('Events');
1158         $e->whereAdd('person_id = ' . $this->id);
1159
1160         $g = DB_DataObject::Factory('core_group');
1161         $g->get('name', 'Administrators');  // select * from core_group where name = 'Administrators'
1162
1163         $p = DB_DataObject::Factory('core_group_member');
1164         $p->setFrom(array(
1165             'user_id' => $this->id,
1166             'group_id' => $g->id
1167         ));
1168
1169         if ($p->count()) {
1170            $roo->jerr("Please remove this user from the Administrator group before deleting");
1171         }
1172
1173
1174         $p = DB_DataObject::Factory('core_group_member');
1175         $p->user_id = $this->id;
1176         $mem = $p->fetchAll();  // fetch all the rows and set the $mem variable to the rows data, just like mysqli_fetch_assoc
1177         $e->logDeletedRecord($mem);
1178
1179         foreach($mem as $p) {
1180             $p->delete();
1181         }
1182
1183         $e = DB_DataObject::Factory('Events');
1184         $e->person_id = $this->id;
1185         $eve = $e->fetchAll();  // fetch all the rows and set the $mem variable to the rows data, just like mysqli_fetch_assoc
1186
1187         $e->logDeletedRecord($eve);
1188         foreach($eve as $e) {
1189             $e->delete();
1190         }
1191
1192
1193         // anything else?
1194
1195     }
1196
1197
1198     /***
1199      * Check if the a user has access to modify this item.
1200      * @param String $lvl Level (eg. Core.Projects)
1201      * @param Pman_Core_DataObjects_Person $au The authenticated user.
1202      * @param boolean $changes alllow changes???
1203      *
1204      * @return false if no access..
1205      */
1206     function checkPerm($lvl, $au, $changes=false) //heck who is trying to access this. false == access denied..
1207     {
1208
1209        // do we have an empty system..
1210         if ($au && $au->id == -1) {
1211             return true;
1212         }
1213         // if not authenticated... do not allow in???
1214         if (!$au ) {
1215             return false;
1216         }
1217
1218         // determine if it's staff!!!
1219         $owncomp = DB_DataObject::Factory('core_company');
1220         $owncomp->get('comptype', 'OWNER');
1221         $isStaff = ($au->company_id ==  $owncomp->id);
1222
1223
1224         if (!$isStaff) {
1225
1226             // - can not change company!!!
1227             if ($changes &&
1228                 isset($changes['company_id']) &&
1229                 $changes['company_id'] != $au->company_id) {
1230                 return false;
1231             }
1232             // can only set new emails..
1233             if ($changes &&
1234                     !empty($this->email) &&
1235                     isset($changes['email']) &&
1236                     $changes['email'] != $this->email) {
1237                 return false;
1238             }
1239
1240
1241             // mtrack had the idea that all 'S' should be allowed.. - but filtered later..
1242             // ???? do we want this?
1243
1244             // edit self... - what about other staff members...
1245
1246             //return $this->company_id == $au->company_id;
1247         }
1248
1249
1250         // yes, only owner company can mess with this...
1251
1252
1253
1254
1255         switch ($lvl) {
1256             // extra case change passwod?
1257             case 'P': //??? password
1258                 // standard perms -- for editing + if the user is dowing them selves..
1259                 $ret = $isStaff ? $au->hasPerm("Core.Staff", "E") : $au->hasPerm("Core.Person", "E");
1260                 return $ret || $au->id == $this->id;
1261
1262             default:
1263                 return $isStaff ? $au->hasPerm("Core.Staff", $lvl) : $au->hasPerm("Core.Person", $lvl);
1264
1265         }
1266         return false;
1267     }
1268
1269     function beforeInsert($req, $roo)
1270     {
1271         $p = DB_DataObject::factory('core_person');
1272         if ($roo->authUser->id > -1 ||  $p->count() > 1) {
1273             return;
1274         }
1275         $c = DB_DataObject::Factory('core_company');
1276         $tc = $c->count();
1277
1278         if (!$tc || $tc> 1) {
1279             $roo->jerr("can not create initial user as multiple companies already exist");
1280         }
1281         $c->find(true);
1282         $this->company_id = $c->id;
1283         $this->email = trim($this->email);
1284
1285     }
1286
1287     function onInsert($req, $roo)
1288     {
1289
1290         $p = DB_DataObject::factory('core_person');
1291         if ($roo->authUser->id < 0 && $p->count() == 1) {
1292             // this seems a bit risky...
1293
1294             $g = DB_DataObject::factory('core_group');
1295             $g->initGroups();
1296
1297             $g->type = 0;
1298             $g->get('name', 'Administrators');
1299
1300             $p = DB_DataObject::factory('core_group_member');
1301             $p->group_id = $g->id;
1302             $p->user_id = $this->id;
1303             if (!$p->count()) {
1304                 $p->insert();
1305                 $roo->addEvent("ADD", $p, $g->toEventString(). " Added " . $this->toEventString());
1306             }
1307             $this->login();
1308         }
1309         if (!empty($req['project_id_addto'])) {
1310             $pd = DB_DataObject::factory('ProjectDirectory');
1311             $pd->project_id = $req['project_id_addto'];
1312             $pd->person_id = $this->id;
1313             $pd->ispm =0;
1314             $pd->office_id = $this->office_id;
1315             $pd->company_id = $this->company_id;
1316             $pd->insert();
1317         }
1318
1319     }
1320
1321     function importFromArray($roo, $persons, $opts)
1322     {
1323         if (empty($opts['prefix'])) {
1324             $roo->jerr("opts[prefix] is empty - you can not just create passwords based on the user names");
1325         }
1326
1327         if (!is_array($persons) || empty($persons)) {
1328             $roo->jerr("error in the person data. - empty on not valid");
1329         }
1330         DB_DataObject::factory('core_group')->initGroups();
1331
1332         foreach($persons as $person){
1333             $p = DB_DataObject::factory('core_person');
1334             if($p->get('name', $person['name'])){
1335                 continue;
1336             }
1337             $p->setFrom($person);
1338
1339             $companies = DB_DataObject::factory('core_company');
1340             if(!$companies->get('comptype', 'OWNER')){
1341                 $roo->jerr("Missing OWNER companies!");
1342             }
1343             $p->company_id = $companies->pid();
1344             // strip the 'spaces etc.. make lowercase..
1345             $name = strtolower(str_replace(' ', '', $person['name']));
1346             $p->setPassword("{$opts['prefix']}{$name}");
1347             $p->insert();
1348             // set up groups
1349             // if $person->groups is set.. then
1350             // add this person to that group eg. groups : [ 'Administrator' ]
1351             if(!empty($person['groups'])){
1352                 $groups = DB_DataObject::factory('core_group');
1353                 if(!$groups->get('name', $person['groups'])){
1354                     $roo->jerr("Missing groups : {$person['groups']}");
1355                 }
1356                 $gm = DB_DataObject::factory('core_group_member');
1357                 $gm->change($p, $groups, true);
1358             }
1359
1360             $p->onInsert(array(), $roo);
1361         }
1362     }
1363
1364     // this is for the To: "{getEmailName()}" <email@address>
1365     // not good for Dear XXXX, - use {person.firstname} for that.
1366     function getEmailName()
1367     {
1368         $name = array();
1369
1370         if(!empty($this->honor)){
1371             array_push($name, $this->honor);
1372         }
1373
1374         if(!empty($this->name)){
1375             array_push($name, $this->name);
1376
1377             return implode(' ', $name);
1378         }
1379
1380         if(!empty($this->firstname) || !empty($this->lastname)){
1381             array_push($name, $this->firstname);
1382             array_push($name, $this->lastname);
1383
1384             $name = array_filter($name);
1385
1386             return implode(' ', $name);
1387         }
1388
1389         return $this->email;
1390     }
1391
1392     function sesPrefix()
1393     {
1394         $ff= HTML_FlexyFramework::get();
1395
1396         $appname = empty($ff->appNameShort) ? $ff->project : $ff->project . '-' . $ff->appNameShort;
1397
1398         $dname = method_exists($this, 'getDatabaseConnection') ? $this->getDatabaseConnection()->dsn['database'] : $this->databaseNickname();
1399
1400         $sesPrefix = $appname.'-' .get_class($this) .'-' . $dname;
1401
1402         return $sesPrefix;
1403     }
1404
1405     function loginPublic()
1406     {
1407         $this->isAuth(); // force session start..
1408
1409         $db = $this->getDatabaseConnection();
1410
1411         $ff = HTML_FlexyFramework::get();
1412
1413         if(empty($ff->Pman) || empty($ff->Pman['login_public'])){
1414             return false;
1415         }
1416
1417         $sesPrefix = $ff->Pman['login_public'] . '-' .get_class($this) .'-'.$db->dsn['database'] ;
1418
1419         $p = DB_DAtaObject::Factory($this->tableName());
1420         $p->get($this->pid());
1421
1422         $_SESSION[get_class($this)][$sesPrefix .'-auth'] = serialize((object)$p->toArray());
1423
1424         return true;
1425     }
1426
1427     function beforeUpdate($old, $q, $roo)
1428     {
1429         $this->email = trim($this->email);
1430     }
1431
1432     function getOathKey()
1433     {
1434         require 'Base32.php';
1435
1436         $base32 = new Base32();
1437
1438         return $base32->base32_encode(bin2hex(openssl_random_pseudo_bytes(10)));
1439     }
1440
1441     function generateQRCode($hash)
1442     {
1443         if(
1444             empty($this->email) &&
1445             empty($hash)
1446         ){
1447             return false;
1448         }
1449
1450         $issuer = (empty($this->name)) ?
1451             rawurlencode('ROOJS') : rawurlencode($this->name);
1452
1453         $uri = "otpauth://totp/{$issuer}:{$this->email}?secret={$hash}&issuer={$issuer}&algorithm=SHA1&digits=6&period=30";
1454
1455         require_once 'Image/QRCode.php';
1456
1457         $qrcode = new Image_QRCode();
1458
1459         $image = $qrcode->makeCode($uri, array(
1460             'output_type' => 'return'
1461         ));
1462
1463         ob_start();
1464         imagepng($image);
1465         $base64 = base64_encode(ob_get_contents());
1466         ob_end_clean();
1467
1468         return "data:image/png;base64,{$base64}";
1469     }
1470
1471  }