]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - classes/Profile.php
Remote Profile Action from ModPlus now more generic
[quix0rs-gnu-social.git] / classes / Profile.php
1 <?php
2 /*
3  * StatusNet - the distributed open-source microblogging tool
4  * Copyright (C) 2008-2011, StatusNet, Inc.
5  *
6  * This program is free software: you can redistribute it and/or modify
7  * it under the terms of the GNU Affero General Public License as published by
8  * the Free Software Foundation, either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU Affero General Public License for more details.
15  *
16  * You should have received a copy of the GNU Affero General Public License
17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
18  */
19
20 if (!defined('STATUSNET') && !defined('LACONICA')) { exit(1); }
21
22 /**
23  * Table Definition for profile
24  */
25 require_once INSTALLDIR.'/classes/Memcached_DataObject.php';
26
27 class Profile extends Managed_DataObject
28 {
29     ###START_AUTOCODE
30     /* the code below is auto generated do not remove the above tag */
31
32     public $__table = 'profile';                         // table name
33     public $id;                              // int(4)  primary_key not_null
34     public $nickname;                        // varchar(64)  multiple_key not_null
35     public $fullname;                        // varchar(255)  multiple_key
36     public $profileurl;                      // varchar(255)
37     public $homepage;                        // varchar(255)  multiple_key
38     public $bio;                             // text()  multiple_key
39     public $location;                        // varchar(255)  multiple_key
40     public $lat;                             // decimal(10,7)
41     public $lon;                             // decimal(10,7)
42     public $location_id;                     // int(4)
43     public $location_ns;                     // int(4)
44     public $created;                         // datetime()   not_null
45     public $modified;                        // timestamp()   not_null default_CURRENT_TIMESTAMP
46
47     public static function schemaDef()
48     {
49         $def = array(
50             'description' => 'local and remote users have profiles',
51             'fields' => array(
52                 'id' => array('type' => 'serial', 'not null' => true, 'description' => 'unique identifier'),
53                 'nickname' => array('type' => 'varchar', 'length' => 64, 'not null' => true, 'description' => 'nickname or username', 'collate' => 'utf8_general_ci'),
54                 'fullname' => array('type' => 'varchar', 'length' => 255, 'description' => 'display name', 'collate' => 'utf8_general_ci'),
55                 'profileurl' => array('type' => 'varchar', 'length' => 255, 'description' => 'URL, cached so we dont regenerate'),
56                 'homepage' => array('type' => 'varchar', 'length' => 255, 'description' => 'identifying URL', 'collate' => 'utf8_general_ci'),
57                 'bio' => array('type' => 'text', 'description' => 'descriptive biography', 'collate' => 'utf8_general_ci'),
58                 'location' => array('type' => 'varchar', 'length' => 255, 'description' => 'physical location', 'collate' => 'utf8_general_ci'),
59                 'lat' => array('type' => 'numeric', 'precision' => 10, 'scale' => 7, 'description' => 'latitude'),
60                 'lon' => array('type' => 'numeric', 'precision' => 10, 'scale' => 7, 'description' => 'longitude'),
61                 'location_id' => array('type' => 'int', 'description' => 'location id if possible'),
62                 'location_ns' => array('type' => 'int', 'description' => 'namespace for location'),
63
64                 'created' => array('type' => 'datetime', 'not null' => true, 'description' => 'date this record was created'),
65                 'modified' => array('type' => 'timestamp', 'not null' => true, 'description' => 'date this record was modified'),
66             ),
67             'primary key' => array('id'),
68             'indexes' => array(
69                 'profile_nickname_idx' => array('nickname'),
70             )
71         );
72
73         // Add a fulltext index
74
75         if (common_config('search', 'type') == 'fulltext') {
76             $def['fulltext indexes'] = array('nickname' => array('nickname', 'fullname', 'location', 'bio', 'homepage'));
77         }
78
79         return $def;
80     }
81         
82     /* the code above is auto generated do not remove the tag below */
83     ###END_AUTOCODE
84
85     public static function getByEmail($email)
86     {
87         // in the future, profiles should have emails stored...
88         $user = User::getKV('email', $email);
89         if (!($user instanceof User)) {
90             throw new NoSuchUserException(array('email'=>$email));
91         }
92         return $user->getProfile();
93     } 
94
95     protected $_user = -1;  // Uninitialized value distinct from null
96
97     public function getUser()
98     {
99         if ($this->_user === -1) {
100             $this->_user = User::getKV('id', $this->id);
101         }
102         if (!($this->_user instanceof User)) {
103             throw new NoSuchUserException(array('id'=>$this->id));
104         }
105
106         return $this->_user;
107     }
108
109     public function isLocal()
110     {
111         try {
112             $this->getUser();
113         } catch (NoSuchUserException $e) {
114             return false;
115         }
116         return true;
117     }
118
119     protected $_avatars = array();
120
121     public function getAvatar($width, $height=null)
122     {
123         return Avatar::byProfile($this, $width, $height);
124     }
125
126     public function setOriginal($filename)
127     {
128         $imagefile = new ImageFile($this->id, Avatar::path($filename));
129
130         $avatar = new Avatar();
131         $avatar->profile_id = $this->id;
132         $avatar->width = $imagefile->width;
133         $avatar->height = $imagefile->height;
134         $avatar->mediatype = image_type_to_mime_type($imagefile->type);
135         $avatar->filename = $filename;
136         $avatar->original = true;
137         $avatar->url = Avatar::url($filename);
138         $avatar->created = common_sql_now();
139
140         // XXX: start a transaction here
141         if (!Avatar::deleteFromProfile($this, true) || !$avatar->insert()) {
142             // If we can't delete the old avatars, let's abort right here.
143             @unlink(Avatar::path($filename));
144             return null;
145         }
146
147         foreach (array(AVATAR_PROFILE_SIZE, AVATAR_STREAM_SIZE, AVATAR_MINI_SIZE) as $size) {
148             // We don't do a scaled one if original is our scaled size
149             if (!($avatar->width == $size && $avatar->height == $size)) {
150                 try {
151                     Avatar::newSize($this, $size);
152                 } catch (Exception $e) {
153                     // should we abort the generation and live without smaller avatars?
154                 }
155             }
156         }
157
158         return $avatar;
159     }
160
161     /**
162      * Gets either the full name (if filled) or the nickname.
163      *
164      * @return string
165      */
166     function getBestName()
167     {
168         return ($this->fullname) ? $this->fullname : $this->nickname;
169     }
170
171     /**
172      * Gets the full name (if filled) with nickname as a parenthetical, or the nickname alone
173      * if no fullname is provided.
174      *
175      * @return string
176      */
177     function getFancyName()
178     {
179         if ($this->fullname) {
180             // TRANS: Full name of a profile or group (%1$s) followed by nickname (%2$s) in parentheses.
181             return sprintf(_m('FANCYNAME','%1$s (%2$s)'), $this->fullname, $this->nickname);
182         } else {
183             return $this->nickname;
184         }
185     }
186
187     /**
188      * Get the most recent notice posted by this user, if any.
189      *
190      * @return mixed Notice or null
191      */
192     function getCurrentNotice()
193     {
194         $notice = $this->getNotices(0, 1);
195
196         if ($notice->fetch()) {
197             if ($notice instanceof ArrayWrapper) {
198                 // hack for things trying to work with single notices
199                 return $notice->_items[0];
200             }
201             return $notice;
202         } else {
203             return null;
204         }
205     }
206
207     function getTaggedNotices($tag, $offset=0, $limit=NOTICES_PER_PAGE, $since_id=0, $max_id=0)
208     {
209         $stream = new TaggedProfileNoticeStream($this, $tag);
210
211         return $stream->getNotices($offset, $limit, $since_id, $max_id);
212     }
213
214     function getNotices($offset=0, $limit=NOTICES_PER_PAGE, $since_id=0, $max_id=0, Profile $scoped=null)
215     {
216         $stream = new ProfileNoticeStream($this, $scoped);
217
218         return $stream->getNotices($offset, $limit, $since_id, $max_id);
219     }
220
221     function isMember($group)
222     {
223         $groups = $this->getGroups(0, null);
224         $gs = $groups->fetchAll();
225         foreach ($gs as $g) {
226             if ($group->id == $g->id) {
227                 return true;
228             }
229         }
230         return false;
231     }
232
233     function isAdmin($group)
234     {
235         $gm = Group_member::pkeyGet(array('profile_id' => $this->id,
236                                           'group_id' => $group->id));
237         return (!empty($gm) && $gm->is_admin);
238     }
239
240     function isPendingMember($group)
241     {
242         $request = Group_join_queue::pkeyGet(array('profile_id' => $this->id,
243                                                    'group_id' => $group->id));
244         return !empty($request);
245     }
246
247     function getGroups($offset=0, $limit=PROFILES_PER_PAGE)
248     {
249         $ids = array();
250
251         $keypart = sprintf('profile:groups:%d', $this->id);
252
253         $idstring = self::cacheGet($keypart);
254
255         if ($idstring !== false) {
256             $ids = explode(',', $idstring);
257         } else {
258             $gm = new Group_member();
259
260             $gm->profile_id = $this->id;
261
262             if ($gm->find()) {
263                 while ($gm->fetch()) {
264                     $ids[] = $gm->group_id;
265                 }
266             }
267
268             self::cacheSet($keypart, implode(',', $ids));
269         }
270
271         if (!is_null($offset) && !is_null($limit)) {
272             $ids = array_slice($ids, $offset, $limit);
273         }
274
275         return User_group::multiGet('id', $ids);
276     }
277
278     function isTagged($peopletag)
279     {
280         $tag = Profile_tag::pkeyGet(array('tagger' => $peopletag->tagger,
281                                           'tagged' => $this->id,
282                                           'tag'    => $peopletag->tag));
283         return !empty($tag);
284     }
285
286     function canTag($tagged)
287     {
288         if (empty($tagged)) {
289             return false;
290         }
291
292         if ($tagged->id == $this->id) {
293             return true;
294         }
295
296         $all = common_config('peopletag', 'allow_tagging', 'all');
297         $local = common_config('peopletag', 'allow_tagging', 'local');
298         $remote = common_config('peopletag', 'allow_tagging', 'remote');
299         $subs = common_config('peopletag', 'allow_tagging', 'subs');
300
301         if ($all) {
302             return true;
303         }
304
305         $tagged_user = $tagged->getUser();
306         if (!empty($tagged_user)) {
307             if ($local) {
308                 return true;
309             }
310         } else if ($subs) {
311             return (Subscription::exists($this, $tagged) ||
312                     Subscription::exists($tagged, $this));
313         } else if ($remote) {
314             return true;
315         }
316         return false;
317     }
318
319     function getLists($auth_user, $offset=0, $limit=null, $since_id=0, $max_id=0)
320     {
321         $ids = array();
322
323         $keypart = sprintf('profile:lists:%d', $this->id);
324
325         $idstr = self::cacheGet($keypart);
326
327         if ($idstr !== false) {
328             $ids = explode(',', $idstr);
329         } else {
330             $list = new Profile_list();
331             $list->selectAdd();
332             $list->selectAdd('id');
333             $list->tagger = $this->id;
334             $list->selectAdd('id as "cursor"');
335
336             if ($since_id>0) {
337                $list->whereAdd('id > '.$since_id);
338             }
339
340             if ($max_id>0) {
341                 $list->whereAdd('id <= '.$max_id);
342             }
343
344             if($offset>=0 && !is_null($limit)) {
345                 $list->limit($offset, $limit);
346             }
347
348             $list->orderBy('id DESC');
349
350             if ($list->find()) {
351                 while ($list->fetch()) {
352                     $ids[] = $list->id;
353                 }
354             }
355
356             self::cacheSet($keypart, implode(',', $ids));
357         }
358
359         $showPrivate = (($auth_user instanceof User ||
360                             $auth_user instanceof Profile) &&
361                         $auth_user->id === $this->id);
362
363         $lists = array();
364
365         foreach ($ids as $id) {
366             $list = Profile_list::getKV('id', $id);
367             if (!empty($list) &&
368                 ($showPrivate || !$list->private)) {
369
370                 if (!isset($list->cursor)) {
371                     $list->cursor = $list->id;
372                 }
373
374                 $lists[] = $list;
375             }
376         }
377
378         return new ArrayWrapper($lists);
379     }
380
381     /**
382      * Get tags that other people put on this profile, in reverse-chron order
383      *
384      * @param (Profile|User) $auth_user  Authorized user (used for privacy)
385      * @param int            $offset     Offset from latest
386      * @param int            $limit      Max number to get
387      * @param datetime       $since_id   max date
388      * @param datetime       $max_id     min date
389      *
390      * @return Profile_list resulting lists
391      */
392
393     function getOtherTags($auth_user=null, $offset=0, $limit=null, $since_id=0, $max_id=0)
394     {
395         $list = new Profile_list();
396
397         $qry = sprintf('select profile_list.*, unix_timestamp(profile_tag.modified) as "cursor" ' .
398                        'from profile_tag join profile_list '.
399                        'on (profile_tag.tagger = profile_list.tagger ' .
400                        '    and profile_tag.tag = profile_list.tag) ' .
401                        'where profile_tag.tagged = %d ',
402                        $this->id);
403
404
405         if ($auth_user instanceof User || $auth_user instanceof Profile) {
406             $qry .= sprintf('AND ( ( profile_list.private = false ) ' .
407                             'OR ( profile_list.tagger = %d AND ' .
408                             'profile_list.private = true ) )',
409                             $auth_user->id);
410         } else {
411             $qry .= 'AND profile_list.private = 0 ';
412         }
413
414         if ($since_id > 0) {
415             $qry .= sprintf('AND (cursor > %d) ', $since_id);
416         }
417
418         if ($max_id > 0) {
419             $qry .= sprintf('AND (cursor < %d) ', $max_id);
420         }
421
422         $qry .= 'ORDER BY profile_tag.modified DESC ';
423
424         if ($offset >= 0 && !is_null($limit)) {
425             $qry .= sprintf('LIMIT %d OFFSET %d ', $limit, $offset);
426         }
427
428         $list->query($qry);
429         return $list;
430     }
431
432     function getPrivateTags($offset=0, $limit=null, $since_id=0, $max_id=0)
433     {
434         $tags = new Profile_list();
435         $tags->private = true;
436         $tags->tagger = $this->id;
437
438         if ($since_id>0) {
439            $tags->whereAdd('id > '.$since_id);
440         }
441
442         if ($max_id>0) {
443             $tags->whereAdd('id <= '.$max_id);
444         }
445
446         if($offset>=0 && !is_null($limit)) {
447             $tags->limit($offset, $limit);
448         }
449
450         $tags->orderBy('id DESC');
451         $tags->find();
452
453         return $tags;
454     }
455
456     function hasLocalTags()
457     {
458         $tags = new Profile_tag();
459
460         $tags->joinAdd(array('tagger', 'user:id'));
461         $tags->whereAdd('tagged  = '.$this->id);
462         $tags->whereAdd('tagger != '.$this->id);
463
464         $tags->limit(0, 1);
465         $tags->fetch();
466
467         return ($tags->N == 0) ? false : true;
468     }
469
470     function getTagSubscriptions($offset=0, $limit=null, $since_id=0, $max_id=0)
471     {
472         $lists = new Profile_list();
473         $subs = new Profile_tag_subscription();
474
475         $lists->joinAdd(array('id', 'profile_tag_subscription:profile_tag_id'));
476
477         #@fixme: postgres (round(date_part('epoch', my_date)))
478         $lists->selectAdd('unix_timestamp(profile_tag_subscription.created) as "cursor"');
479
480         $lists->whereAdd('profile_tag_subscription.profile_id = '.$this->id);
481
482         if ($since_id>0) {
483            $lists->whereAdd('cursor > '.$since_id);
484         }
485
486         if ($max_id>0) {
487             $lists->whereAdd('cursor <= '.$max_id);
488         }
489
490         if($offset>=0 && !is_null($limit)) {
491             $lists->limit($offset, $limit);
492         }
493
494         $lists->orderBy('"cursor" DESC');
495         $lists->find();
496
497         return $lists;
498     }
499
500     /**
501      * Request to join the given group.
502      * May throw exceptions on failure.
503      *
504      * @param User_group $group
505      * @return mixed: Group_member on success, Group_join_queue if pending approval, null on some cancels?
506      */
507     function joinGroup(User_group $group)
508     {
509         $join = null;
510         if ($group->join_policy == User_group::JOIN_POLICY_MODERATE) {
511             $join = Group_join_queue::saveNew($this, $group);
512         } else {
513             if (Event::handle('StartJoinGroup', array($group, $this))) {
514                 $join = Group_member::join($group->id, $this->id);
515                 self::blow('profile:groups:%d', $this->id);
516                 self::blow('group:member_ids:%d', $group->id);
517                 self::blow('group:member_count:%d', $group->id);
518                 Event::handle('EndJoinGroup', array($group, $this));
519             }
520         }
521         if ($join) {
522             // Send any applicable notifications...
523             $join->notify();
524         }
525         return $join;
526     }
527
528     /**
529      * Leave a group that this profile is a member of.
530      *
531      * @param User_group $group
532      */
533     function leaveGroup(User_group $group)
534     {
535         if (Event::handle('StartLeaveGroup', array($group, $this))) {
536             Group_member::leave($group->id, $this->id);
537             self::blow('profile:groups:%d', $this->id);
538             self::blow('group:member_ids:%d', $group->id);
539             self::blow('group:member_count:%d', $group->id);
540             Event::handle('EndLeaveGroup', array($group, $this));
541         }
542     }
543
544     function avatarUrl($size=AVATAR_PROFILE_SIZE)
545     {
546         return Avatar::urlByProfile($this, $size);
547     }
548
549     function getSubscribed($offset=0, $limit=null)
550     {
551         $subs = Subscription::getSubscribedIDs($this->id, $offset, $limit);
552         try {
553             $profiles = Profile::listFind('id', $subs);
554         } catch (NoResultException $e) {
555             return $e->obj;
556         }
557         return $profiles;
558     }
559
560     function getSubscribers($offset=0, $limit=null)
561     {
562         $subs = Subscription::getSubscriberIDs($this->id, $offset, $limit);
563         try {
564             $profiles = Profile::listFind('id', $subs);
565         } catch (NoResultException $e) {
566             return $e->obj;
567         }
568         return $profiles;
569     }
570
571     function getTaggedSubscribers($tag)
572     {
573         $qry =
574           'SELECT profile.* ' .
575           'FROM profile JOIN (subscription, profile_tag, profile_list) ' .
576           'ON profile.id = subscription.subscriber ' .
577           'AND profile.id = profile_tag.tagged ' .
578           'AND profile_tag.tagger = profile_list.tagger AND profile_tag.tag = profile_list.tag ' .
579           'WHERE subscription.subscribed = %d ' .
580           'AND subscription.subscribed != subscription.subscriber ' .
581           'AND profile_tag.tagger = %d AND profile_tag.tag = "%s" ' .
582           'AND profile_list.private = false ' .
583           'ORDER BY subscription.created DESC';
584
585         $profile = new Profile();
586         $tagged = array();
587
588         $cnt = $profile->query(sprintf($qry, $this->id, $this->id, $profile->escape($tag)));
589
590         while ($profile->fetch()) {
591             $tagged[] = clone($profile);
592         }
593         return $tagged;
594     }
595
596     /**
597      * Get pending subscribers, who have not yet been approved.
598      *
599      * @param int $offset
600      * @param int $limit
601      * @return Profile
602      */
603     function getRequests($offset=0, $limit=null)
604     {
605         $qry =
606           'SELECT profile.* ' .
607           'FROM profile JOIN subscription_queue '.
608           'ON profile.id = subscription_queue.subscriber ' .
609           'WHERE subscription_queue.subscribed = %d ' .
610           'ORDER BY subscription_queue.created DESC ';
611
612         if ($limit != null) {
613             if (common_config('db','type') == 'pgsql') {
614                 $qry .= ' LIMIT ' . $limit . ' OFFSET ' . $offset;
615             } else {
616                 $qry .= ' LIMIT ' . $offset . ', ' . $limit;
617             }
618         }
619
620         $members = new Profile();
621
622         $members->query(sprintf($qry, $this->id));
623         return $members;
624     }
625
626     function subscriptionCount()
627     {
628         $c = Cache::instance();
629
630         if (!empty($c)) {
631             $cnt = $c->get(Cache::key('profile:subscription_count:'.$this->id));
632             if (is_integer($cnt)) {
633                 return (int) $cnt;
634             }
635         }
636
637         $sub = new Subscription();
638         $sub->subscriber = $this->id;
639
640         $cnt = (int) $sub->count('distinct subscribed');
641
642         $cnt = ($cnt > 0) ? $cnt - 1 : $cnt;
643
644         if (!empty($c)) {
645             $c->set(Cache::key('profile:subscription_count:'.$this->id), $cnt);
646         }
647
648         return $cnt;
649     }
650
651     function subscriberCount()
652     {
653         $c = Cache::instance();
654         if (!empty($c)) {
655             $cnt = $c->get(Cache::key('profile:subscriber_count:'.$this->id));
656             if (is_integer($cnt)) {
657                 return (int) $cnt;
658             }
659         }
660
661         $sub = new Subscription();
662         $sub->subscribed = $this->id;
663         $sub->whereAdd('subscriber != subscribed');
664         $cnt = (int) $sub->count('distinct subscriber');
665
666         if (!empty($c)) {
667             $c->set(Cache::key('profile:subscriber_count:'.$this->id), $cnt);
668         }
669
670         return $cnt;
671     }
672
673     /**
674      * Is this profile subscribed to another profile?
675      *
676      * @param Profile $other
677      * @return boolean
678      */
679     function isSubscribed($other)
680     {
681         return Subscription::exists($this, $other);
682     }
683
684     /**
685      * Check if a pending subscription request is outstanding for this...
686      *
687      * @param Profile $other
688      * @return boolean
689      */
690     function hasPendingSubscription($other)
691     {
692         return Subscription_queue::exists($this, $other);
693     }
694
695     /**
696      * Are these two profiles subscribed to each other?
697      *
698      * @param Profile $other
699      * @return boolean
700      */
701     function mutuallySubscribed($other)
702     {
703         return $this->isSubscribed($other) &&
704           $other->isSubscribed($this);
705     }
706
707     function hasFave($notice)
708     {
709         $fave = Fave::pkeyGet(array('user_id' => $this->id,
710                                     'notice_id' => $notice->id));
711         return ((is_null($fave)) ? false : true);
712     }
713
714     function faveCount()
715     {
716         $c = Cache::instance();
717         if (!empty($c)) {
718             $cnt = $c->get(Cache::key('profile:fave_count:'.$this->id));
719             if (is_integer($cnt)) {
720                 return (int) $cnt;
721             }
722         }
723
724         $faves = new Fave();
725         $faves->user_id = $this->id;
726         $cnt = (int) $faves->count('notice_id');
727
728         if (!empty($c)) {
729             $c->set(Cache::key('profile:fave_count:'.$this->id), $cnt);
730         }
731
732         return $cnt;
733     }
734
735     function noticeCount()
736     {
737         $c = Cache::instance();
738
739         if (!empty($c)) {
740             $cnt = $c->get(Cache::key('profile:notice_count:'.$this->id));
741             if (is_integer($cnt)) {
742                 return (int) $cnt;
743             }
744         }
745
746         $notices = new Notice();
747         $notices->profile_id = $this->id;
748         $cnt = (int) $notices->count('distinct id');
749
750         if (!empty($c)) {
751             $c->set(Cache::key('profile:notice_count:'.$this->id), $cnt);
752         }
753
754         return $cnt;
755     }
756
757     function blowFavesCache()
758     {
759         $cache = Cache::instance();
760         if ($cache) {
761             // Faves don't happen chronologically, so we need to blow
762             // ;last cache, too
763             $cache->delete(Cache::key('fave:ids_by_user:'.$this->id));
764             $cache->delete(Cache::key('fave:ids_by_user:'.$this->id.';last'));
765             $cache->delete(Cache::key('fave:ids_by_user_own:'.$this->id));
766             $cache->delete(Cache::key('fave:ids_by_user_own:'.$this->id.';last'));
767         }
768         $this->blowFaveCount();
769     }
770
771     function blowSubscriberCount()
772     {
773         $c = Cache::instance();
774         if (!empty($c)) {
775             $c->delete(Cache::key('profile:subscriber_count:'.$this->id));
776         }
777     }
778
779     function blowSubscriptionCount()
780     {
781         $c = Cache::instance();
782         if (!empty($c)) {
783             $c->delete(Cache::key('profile:subscription_count:'.$this->id));
784         }
785     }
786
787     function blowFaveCount()
788     {
789         $c = Cache::instance();
790         if (!empty($c)) {
791             $c->delete(Cache::key('profile:fave_count:'.$this->id));
792         }
793     }
794
795     function blowNoticeCount()
796     {
797         $c = Cache::instance();
798         if (!empty($c)) {
799             $c->delete(Cache::key('profile:notice_count:'.$this->id));
800         }
801     }
802
803     static function maxBio()
804     {
805         $biolimit = common_config('profile', 'biolimit');
806         // null => use global limit (distinct from 0!)
807         if (is_null($biolimit)) {
808             $biolimit = common_config('site', 'textlimit');
809         }
810         return $biolimit;
811     }
812
813     static function bioTooLong($bio)
814     {
815         $biolimit = self::maxBio();
816         return ($biolimit > 0 && !empty($bio) && (mb_strlen($bio) > $biolimit));
817     }
818
819     function delete()
820     {
821         $this->_deleteNotices();
822         $this->_deleteSubscriptions();
823         $this->_deleteMessages();
824         $this->_deleteTags();
825         $this->_deleteBlocks();
826         Avatar::deleteFromProfile($this, true);
827
828         // Warning: delete() will run on the batch objects,
829         // not on individual objects.
830         $related = array('Reply',
831                          'Group_member',
832                          );
833         Event::handle('ProfileDeleteRelated', array($this, &$related));
834
835         foreach ($related as $cls) {
836             $inst = new $cls();
837             $inst->profile_id = $this->id;
838             $inst->delete();
839         }
840
841         parent::delete();
842     }
843
844     function _deleteNotices()
845     {
846         $notice = new Notice();
847         $notice->profile_id = $this->id;
848
849         if ($notice->find()) {
850             while ($notice->fetch()) {
851                 $other = clone($notice);
852                 $other->delete();
853             }
854         }
855     }
856
857     function _deleteSubscriptions()
858     {
859         $sub = new Subscription();
860         $sub->subscriber = $this->id;
861
862         $sub->find();
863
864         while ($sub->fetch()) {
865             $other = Profile::getKV('id', $sub->subscribed);
866             if (empty($other)) {
867                 continue;
868             }
869             if ($other->id == $this->id) {
870                 continue;
871             }
872             Subscription::cancel($this, $other);
873         }
874
875         $subd = new Subscription();
876         $subd->subscribed = $this->id;
877         $subd->find();
878
879         while ($subd->fetch()) {
880             $other = Profile::getKV('id', $subd->subscriber);
881             if (empty($other)) {
882                 continue;
883             }
884             if ($other->id == $this->id) {
885                 continue;
886             }
887             Subscription::cancel($other, $this);
888         }
889
890         $self = new Subscription();
891
892         $self->subscriber = $this->id;
893         $self->subscribed = $this->id;
894
895         $self->delete();
896     }
897
898     function _deleteMessages()
899     {
900         $msg = new Message();
901         $msg->from_profile = $this->id;
902         $msg->delete();
903
904         $msg = new Message();
905         $msg->to_profile = $this->id;
906         $msg->delete();
907     }
908
909     function _deleteTags()
910     {
911         $tag = new Profile_tag();
912         $tag->tagged = $this->id;
913         $tag->delete();
914     }
915
916     function _deleteBlocks()
917     {
918         $block = new Profile_block();
919         $block->blocked = $this->id;
920         $block->delete();
921
922         $block = new Group_block();
923         $block->blocked = $this->id;
924         $block->delete();
925     }
926
927     // XXX: identical to Notice::getLocation.
928
929     public function getLocation()
930     {
931         $location = null;
932
933         if (!empty($this->location_id) && !empty($this->location_ns)) {
934             $location = Location::fromId($this->location_id, $this->location_ns);
935         }
936
937         if (is_null($location)) { // no ID, or Location::fromId() failed
938             if (!empty($this->lat) && !empty($this->lon)) {
939                 $location = Location::fromLatLon($this->lat, $this->lon);
940             }
941         }
942
943         if (is_null($location)) { // still haven't found it!
944             if (!empty($this->location)) {
945                 $location = Location::fromName($this->location);
946             }
947         }
948
949         return $location;
950     }
951
952     public function shareLocation()
953     {
954         $cfg = common_config('location', 'share');
955
956         if ($cfg == 'always') {
957             return true;
958         } else if ($cfg == 'never') {
959             return false;
960         } else { // user
961             $share = common_config('location', 'sharedefault');
962
963             // Check if user has a personal setting for this
964             $prefs = User_location_prefs::getKV('user_id', $this->id);
965
966             if (!empty($prefs)) {
967                 $share = $prefs->share_location;
968                 $prefs->free();
969             }
970
971             return $share;
972         }
973     }
974
975     function hasRole($name)
976     {
977         $has_role = false;
978         if (Event::handle('StartHasRole', array($this, $name, &$has_role))) {
979             $role = Profile_role::pkeyGet(array('profile_id' => $this->id,
980                                                 'role' => $name));
981             $has_role = !empty($role);
982             Event::handle('EndHasRole', array($this, $name, $has_role));
983         }
984         return $has_role;
985     }
986
987     function grantRole($name)
988     {
989         if (Event::handle('StartGrantRole', array($this, $name))) {
990
991             $role = new Profile_role();
992
993             $role->profile_id = $this->id;
994             $role->role       = $name;
995             $role->created    = common_sql_now();
996
997             $result = $role->insert();
998
999             if (!$result) {
1000                 throw new Exception("Can't save role '$name' for profile '{$this->id}'");
1001             }
1002
1003             if ($name == 'owner') {
1004                 User::blow('user:site_owner');
1005             }
1006
1007             Event::handle('EndGrantRole', array($this, $name));
1008         }
1009
1010         return $result;
1011     }
1012
1013     function revokeRole($name)
1014     {
1015         if (Event::handle('StartRevokeRole', array($this, $name))) {
1016
1017             $role = Profile_role::pkeyGet(array('profile_id' => $this->id,
1018                                                 'role' => $name));
1019
1020             if (empty($role)) {
1021                 // TRANS: Exception thrown when trying to revoke an existing role for a user that does not exist.
1022                 // TRANS: %1$s is the role name, %2$s is the user ID (number).
1023                 throw new Exception(sprintf(_('Cannot revoke role "%1$s" for user #%2$d; does not exist.'),$name, $this->id));
1024             }
1025
1026             $result = $role->delete();
1027
1028             if (!$result) {
1029                 common_log_db_error($role, 'DELETE', __FILE__);
1030                 // TRANS: Exception thrown when trying to revoke a role for a user with a failing database query.
1031                 // TRANS: %1$s is the role name, %2$s is the user ID (number).
1032                 throw new Exception(sprintf(_('Cannot revoke role "%1$s" for user #%2$d; database error.'),$name, $this->id));
1033             }
1034
1035             if ($name == 'owner') {
1036                 User::blow('user:site_owner');
1037             }
1038
1039             Event::handle('EndRevokeRole', array($this, $name));
1040
1041             return true;
1042         }
1043     }
1044
1045     function isSandboxed()
1046     {
1047         return $this->hasRole(Profile_role::SANDBOXED);
1048     }
1049
1050     function isSilenced()
1051     {
1052         return $this->hasRole(Profile_role::SILENCED);
1053     }
1054
1055     function sandbox()
1056     {
1057         $this->grantRole(Profile_role::SANDBOXED);
1058     }
1059
1060     function unsandbox()
1061     {
1062         $this->revokeRole(Profile_role::SANDBOXED);
1063     }
1064
1065     function silence()
1066     {
1067         $this->grantRole(Profile_role::SILENCED);
1068         if (common_config('notice', 'hidespam')) {
1069             $this->flushVisibility();
1070         }
1071     }
1072
1073     function unsilence()
1074     {
1075         $this->revokeRole(Profile_role::SILENCED);
1076         if (common_config('notice', 'hidespam')) {
1077             $this->flushVisibility();
1078         }
1079     }
1080
1081     function flushVisibility()
1082     {
1083         // Get all notices
1084         $stream = new ProfileNoticeStream($this, $this);
1085         $ids = $stream->getNoticeIds(0, CachingNoticeStream::CACHE_WINDOW);
1086         foreach ($ids as $id) {
1087             self::blow('notice:in-scope-for:%d:null', $id);
1088         }
1089     }
1090
1091     /**
1092      * Does this user have the right to do X?
1093      *
1094      * With our role-based authorization, this is merely a lookup for whether the user
1095      * has a particular role. The implementation currently uses a switch statement
1096      * to determine if the user has the pre-defined role to exercise the right. Future
1097      * implementations may allow per-site roles, and different mappings of roles to rights.
1098      *
1099      * @param $right string Name of the right, usually a constant in class Right
1100      * @return boolean whether the user has the right in question
1101      */
1102     public function hasRight($right)
1103     {
1104         $result = false;
1105
1106         if ($this->hasRole(Profile_role::DELETED)) {
1107             return false;
1108         }
1109
1110         if (Event::handle('UserRightsCheck', array($this, $right, &$result))) {
1111             switch ($right)
1112             {
1113             case Right::DELETEOTHERSNOTICE:
1114             case Right::MAKEGROUPADMIN:
1115             case Right::SANDBOXUSER:
1116             case Right::SILENCEUSER:
1117             case Right::DELETEUSER:
1118             case Right::DELETEGROUP:
1119             case Right::TRAINSPAM:
1120             case Right::REVIEWSPAM:
1121                 $result = $this->hasRole(Profile_role::MODERATOR);
1122                 break;
1123             case Right::CONFIGURESITE:
1124                 $result = $this->hasRole(Profile_role::ADMINISTRATOR);
1125                 break;
1126             case Right::GRANTROLE:
1127             case Right::REVOKEROLE:
1128                 $result = $this->hasRole(Profile_role::OWNER);
1129                 break;
1130             case Right::NEWNOTICE:
1131             case Right::NEWMESSAGE:
1132             case Right::SUBSCRIBE:
1133             case Right::CREATEGROUP:
1134                 $result = !$this->isSilenced();
1135                 break;
1136             case Right::PUBLICNOTICE:
1137             case Right::EMAILONREPLY:
1138             case Right::EMAILONSUBSCRIBE:
1139             case Right::EMAILONFAVE:
1140                 $result = !$this->isSandboxed();
1141                 break;
1142             case Right::WEBLOGIN:
1143                 $result = !$this->isSilenced();
1144                 break;
1145             case Right::API:
1146                 $result = !$this->isSilenced();
1147                 break;
1148             case Right::BACKUPACCOUNT:
1149                 $result = common_config('profile', 'backup');
1150                 break;
1151             case Right::RESTOREACCOUNT:
1152                 $result = common_config('profile', 'restore');
1153                 break;
1154             case Right::DELETEACCOUNT:
1155                 $result = common_config('profile', 'delete');
1156                 break;
1157             case Right::MOVEACCOUNT:
1158                 $result = common_config('profile', 'move');
1159                 break;
1160             default:
1161                 $result = false;
1162                 break;
1163             }
1164         }
1165         return $result;
1166     }
1167
1168     // FIXME: Can't put Notice typing here due to ArrayWrapper
1169     public function hasRepeated($notice)
1170     {
1171         // XXX: not really a pkey, but should work
1172
1173         $notice = Notice::pkeyGet(array('profile_id' => $this->id,
1174                                         'repeat_of' => $notice->id));
1175
1176         return !empty($notice);
1177     }
1178
1179     /**
1180      * Returns an XML string fragment with limited profile information
1181      * as an Atom <author> element.
1182      *
1183      * Assumes that Atom has been previously set up as the base namespace.
1184      *
1185      * @param Profile $cur the current authenticated user
1186      *
1187      * @return string
1188      */
1189     function asAtomAuthor($cur = null)
1190     {
1191         $xs = new XMLStringer(true);
1192
1193         $xs->elementStart('author');
1194         $xs->element('name', null, $this->nickname);
1195         $xs->element('uri', null, $this->getUri());
1196         if ($cur != null) {
1197             $attrs = Array();
1198             $attrs['following'] = $cur->isSubscribed($this) ? 'true' : 'false';
1199             $attrs['blocking']  = $cur->hasBlocked($this) ? 'true' : 'false';
1200             $xs->element('statusnet:profile_info', $attrs, null);
1201         }
1202         $xs->elementEnd('author');
1203
1204         return $xs->getString();
1205     }
1206
1207     /**
1208      * Extra profile info for atom entries
1209      *
1210      * Clients use some extra profile info in the atom stream.
1211      * This gives it to them.
1212      *
1213      * @param User $cur Current user
1214      *
1215      * @return array representation of <statusnet:profile_info> element or null
1216      */
1217
1218     function profileInfo($cur)
1219     {
1220         $profileInfoAttr = array('local_id' => $this->id);
1221
1222         if ($cur != null) {
1223             // Whether the current user is a subscribed to this profile
1224             $profileInfoAttr['following'] = $cur->isSubscribed($this) ? 'true' : 'false';
1225             // Whether the current user is has blocked this profile
1226             $profileInfoAttr['blocking']  = $cur->hasBlocked($this) ? 'true' : 'false';
1227         }
1228
1229         return array('statusnet:profile_info', $profileInfoAttr, null);
1230     }
1231
1232     /**
1233      * Returns an XML string fragment with profile information as an
1234      * Activity Streams <activity:actor> element.
1235      *
1236      * Assumes that 'activity' namespace has been previously defined.
1237      *
1238      * @return string
1239      */
1240     function asActivityActor()
1241     {
1242         return $this->asActivityNoun('actor');
1243     }
1244
1245     /**
1246      * Returns an XML string fragment with profile information as an
1247      * Activity Streams noun object with the given element type.
1248      *
1249      * Assumes that 'activity', 'georss', and 'poco' namespace has been
1250      * previously defined.
1251      *
1252      * @param string $element one of 'actor', 'subject', 'object', 'target'
1253      *
1254      * @return string
1255      */
1256     function asActivityNoun($element)
1257     {
1258         $noun = ActivityObject::fromProfile($this);
1259         return $noun->asString('activity:' . $element);
1260     }
1261
1262     /**
1263      * Returns the profile's canonical url, not necessarily a uri/unique id
1264      *
1265      * @return string $profileurl
1266      */
1267     public function getUrl()
1268     {
1269         if (empty($this->profileurl) ||
1270                 !filter_var($this->profileurl, FILTER_VALIDATE_URL)) {
1271             throw new InvalidUrlException($this->profileurl);
1272         }
1273         return $this->profileurl;
1274     }
1275
1276     /**
1277      * Returns the best URI for a profile. Plugins may override.
1278      *
1279      * @return string $uri
1280      */
1281     public function getUri()
1282     {
1283         $uri = null;
1284
1285         // give plugins a chance to set the URI
1286         if (Event::handle('StartGetProfileUri', array($this, &$uri))) {
1287
1288             // check for a local user first
1289             $user = User::getKV('id', $this->id);
1290
1291             if (!empty($user)) {
1292                 $uri = $user->uri;
1293             }
1294
1295             Event::handle('EndGetProfileUri', array($this, &$uri));
1296         }
1297
1298         return $uri;
1299     }
1300
1301     function hasBlocked($other)
1302     {
1303         $block = Profile_block::exists($this, $other);
1304         return !empty($block);
1305     }
1306
1307     function getAtomFeed()
1308     {
1309         $feed = null;
1310
1311         if (Event::handle('StartProfileGetAtomFeed', array($this, &$feed))) {
1312             $user = User::getKV('id', $this->id);
1313             if (!empty($user)) {
1314                 $feed = common_local_url('ApiTimelineUser', array('id' => $user->id,
1315                                                                   'format' => 'atom'));
1316             }
1317             Event::handle('EndProfileGetAtomFeed', array($this, $feed));
1318         }
1319
1320         return $feed;
1321     }
1322
1323     static function fromURI($uri)
1324     {
1325         $profile = null;
1326
1327         if (Event::handle('StartGetProfileFromURI', array($uri, &$profile))) {
1328             // Get a local user or remote (OMB 0.1) profile
1329             $user = User::getKV('uri', $uri);
1330             if (!empty($user)) {
1331                 $profile = $user->getProfile();
1332             }
1333             Event::handle('EndGetProfileFromURI', array($uri, $profile));
1334         }
1335
1336         return $profile;
1337     }
1338
1339     function canRead(Notice $notice)
1340     {
1341         if ($notice->scope & Notice::SITE_SCOPE) {
1342             $user = $this->getUser();
1343             if (empty($user)) {
1344                 return false;
1345             }
1346         }
1347
1348         if ($notice->scope & Notice::ADDRESSEE_SCOPE) {
1349             $replies = $notice->getReplies();
1350
1351             if (!in_array($this->id, $replies)) {
1352                 $groups = $notice->getGroups();
1353
1354                 $foundOne = false;
1355
1356                 foreach ($groups as $group) {
1357                     if ($this->isMember($group)) {
1358                         $foundOne = true;
1359                         break;
1360                     }
1361                 }
1362
1363                 if (!$foundOne) {
1364                     return false;
1365                 }
1366             }
1367         }
1368
1369         if ($notice->scope & Notice::FOLLOWER_SCOPE) {
1370             $author = $notice->getProfile();
1371             if (!Subscription::exists($this, $author)) {
1372                 return false;
1373             }
1374         }
1375
1376         return true;
1377     }
1378
1379     static function current()
1380     {
1381         $user = common_current_user();
1382         if (empty($user)) {
1383             $profile = null;
1384         } else {
1385             $profile = $user->getProfile();
1386         }
1387         return $profile;
1388     }
1389
1390     /**
1391      * Magic function called at serialize() time.
1392      *
1393      * We use this to drop a couple process-specific references
1394      * from DB_DataObject which can cause trouble in future
1395      * processes.
1396      *
1397      * @return array of variable names to include in serialization.
1398      */
1399
1400     function __sleep()
1401     {
1402         $vars = parent::__sleep();
1403         $skip = array('_user', '_avatars');
1404         return array_diff($vars, $skip);
1405     }
1406
1407     public function getProfile()
1408     {
1409         return $this;
1410     }
1411 }