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