]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - classes/User.php
Merge branch 'querybyid' into 0.7.x
[quix0rs-gnu-social.git] / classes / User.php
1 <?php
2 /*
3  * Laconica - a distributed open-source microblogging tool
4  * Copyright (C) 2008, 2009, Control Yourself, 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('LACONICA')) {
21     exit(1);
22 }
23
24 /**
25  * Table Definition for user
26  */
27
28 require_once INSTALLDIR.'/classes/Memcached_DataObject.php';
29 require_once 'Validate.php';
30
31 class User extends Memcached_DataObject
32 {
33     ###START_AUTOCODE
34     /* the code below is auto generated do not remove the above tag */
35
36     public $__table = 'user';                            // table name
37     public $id;                              // int(4)  primary_key not_null
38     public $nickname;                        // varchar(64)  unique_key
39     public $password;                        // varchar(255)
40     public $email;                           // varchar(255)  unique_key
41     public $incomingemail;                   // varchar(255)  unique_key
42     public $emailnotifysub;                  // tinyint(1)   default_1
43     public $emailnotifyfav;                  // tinyint(1)   default_1
44     public $emailnotifynudge;                // tinyint(1)   default_1
45     public $emailnotifymsg;                  // tinyint(1)   default_1
46     public $emailnotifyattn;                 // tinyint(1)   default_1
47     public $emailmicroid;                    // tinyint(1)   default_1
48     public $language;                        // varchar(50)
49     public $timezone;                        // varchar(50)
50     public $emailpost;                       // tinyint(1)   default_1
51     public $jabber;                          // varchar(255)  unique_key
52     public $jabbernotify;                    // tinyint(1)
53     public $jabberreplies;                   // tinyint(1)
54     public $jabbermicroid;                   // tinyint(1)   default_1
55     public $updatefrompresence;              // tinyint(1)
56     public $sms;                             // varchar(64)  unique_key
57     public $carrier;                         // int(4)
58     public $smsnotify;                       // tinyint(1)
59     public $smsreplies;                      // tinyint(1)
60     public $smsemail;                        // varchar(255)
61     public $uri;                             // varchar(255)  unique_key
62     public $autosubscribe;                   // tinyint(1)
63     public $urlshorteningservice;            // varchar(50)   default_ur1.ca
64     public $inboxed;                         // tinyint(1)
65     public $created;                         // datetime()   not_null
66     public $modified;                        // timestamp()   not_null default_CURRENT_TIMESTAMP
67
68     /* Static get */
69     function staticGet($k,$v=NULL)
70     {
71         return Memcached_DataObject::staticGet('User',$k,$v);
72     }
73
74     /* the code above is auto generated do not remove the tag below */
75     ###END_AUTOCODE
76
77     function getProfile()
78     {
79         return Profile::staticGet('id', $this->id);
80     }
81
82     function isSubscribed($other)
83     {
84         assert(!is_null($other));
85         // XXX: cache results of this query
86         $sub = Subscription::pkeyGet(array('subscriber' => $this->id,
87                                            'subscribed' => $other->id));
88         return (is_null($sub)) ? false : true;
89     }
90
91     // 'update' won't write key columns, so we have to do it ourselves.
92
93     function updateKeys(&$orig)
94     {
95         $parts = array();
96         foreach (array('nickname', 'email', 'jabber', 'incomingemail', 'sms', 'carrier', 'smsemail', 'language', 'timezone') as $k) {
97             if (strcmp($this->$k, $orig->$k) != 0) {
98                 $parts[] = $k . ' = ' . $this->_quote($this->$k);
99             }
100         }
101         if (count($parts) == 0) {
102             // No changes
103             return true;
104         }
105         $toupdate = implode(', ', $parts);
106
107         $table = $this->tableName();
108         if(common_config('db','quote_identifiers')) {
109             $table = '"' . $table . '"';
110         }
111         $qry = 'UPDATE ' . $table . ' SET ' . $toupdate .
112           ' WHERE id = ' . $this->id;
113         $orig->decache();
114         $result = $this->query($qry);
115         if ($result) {
116             $this->encache();
117         }
118         return $result;
119     }
120
121     function allowed_nickname($nickname)
122     {
123         // XXX: should already be validated for size, content, etc.
124         static $blacklist = array('rss', 'xrds', 'doc', 'main',
125                                   'settings', 'notice', 'user',
126                                   'search', 'avatar', 'tag', 'tags',
127                                   'api', 'message', 'group', 'groups',
128                                   'local');
129         $merged = array_merge($blacklist, common_config('nickname', 'blacklist'));
130         return !in_array($nickname, $merged);
131     }
132
133     function getCurrentNotice($dt=null)
134     {
135         $profile = $this->getProfile();
136         if (!$profile) {
137             return null;
138         }
139         return $profile->getCurrentNotice($dt);
140     }
141
142     function getCarrier()
143     {
144         return Sms_carrier::staticGet('id', $this->carrier);
145     }
146
147     function subscribeTo($other)
148     {
149         $sub = new Subscription();
150         $sub->subscriber = $this->id;
151         $sub->subscribed = $other->id;
152
153         $sub->created = common_sql_now(); // current time
154
155         if (!$sub->insert()) {
156             return false;
157         }
158
159         return true;
160     }
161
162     function hasBlocked($other)
163     {
164
165         $block = Profile_block::get($this->id, $other->id);
166
167         if (is_null($block)) {
168             $result = false;
169         } else {
170             $result = true;
171             $block->free();
172         }
173
174         return $result;
175     }
176
177     static function register($fields) {
178
179         // MAGICALLY put fields into current scope
180
181         extract($fields);
182
183         $profile = new Profile();
184
185         $profile->query('BEGIN');
186
187         $profile->nickname = $nickname;
188         $profile->profileurl = common_profile_url($nickname);
189
190         if (!empty($fullname)) {
191             $profile->fullname = $fullname;
192         }
193         if (!empty($homepage)) {
194             $profile->homepage = $homepage;
195         }
196         if (!empty($bio)) {
197             $profile->bio = $bio;
198         }
199         if (!empty($location)) {
200             $profile->location = $location;
201         }
202
203         $profile->created = common_sql_now();
204
205         $id = $profile->insert();
206
207         if (empty($id)) {
208             common_log_db_error($profile, 'INSERT', __FILE__);
209             return false;
210         }
211
212         $user = new User();
213
214         $user->id = $id;
215         $user->nickname = $nickname;
216
217         if (!empty($password)) { // may not have a password for OpenID users
218             $user->password = common_munge_password($password, $id);
219         }
220
221         // Users who respond to invite email have proven their ownership of that address
222
223         if (!empty($code)) {
224             $invite = Invitation::staticGet($code);
225             if ($invite && $invite->address && $invite->address_type == 'email' && $invite->address == $email) {
226                 $user->email = $invite->address;
227             }
228         }
229
230         $inboxes = common_config('inboxes', 'enabled');
231
232         if ($inboxes === true || $inboxes == 'transitional') {
233             $user->inboxed = 1;
234         }
235
236         $user->created = common_sql_now();
237         $user->uri = common_user_uri($user);
238
239         $result = $user->insert();
240
241         if (!$result) {
242             common_log_db_error($user, 'INSERT', __FILE__);
243             return false;
244         }
245
246         // Everyone is subscribed to themself
247
248         $subscription = new Subscription();
249         $subscription->subscriber = $user->id;
250         $subscription->subscribed = $user->id;
251         $subscription->created = $user->created;
252
253         $result = $subscription->insert();
254
255         if (!$result) {
256             common_log_db_error($subscription, 'INSERT', __FILE__);
257             return false;
258         }
259
260         if (!empty($email) && !$user->email) {
261
262             $confirm = new Confirm_address();
263             $confirm->code = common_confirmation_code(128);
264             $confirm->user_id = $user->id;
265             $confirm->address = $email;
266             $confirm->address_type = 'email';
267
268             $result = $confirm->insert();
269             if (!$result) {
270                 common_log_db_error($confirm, 'INSERT', __FILE__);
271                 return false;
272             }
273         }
274
275         if (!empty($code) && $user->email) {
276             $user->emailChanged();
277         }
278
279         // Default system subscription
280
281         $defnick = common_config('newuser', 'default');
282
283         if (!empty($defnick)) {
284             $defuser = User::staticGet('nickname', $defnick);
285             if (empty($defuser)) {
286                 common_log(LOG_WARNING, sprintf("Default user %s does not exist.", $defnick),
287                            __FILE__);
288             } else {
289                 $defsub = new Subscription();
290                 $defsub->subscriber = $user->id;
291                 $defsub->subscribed = $defuser->id;
292                 $defsub->created = $user->created;
293
294                 $result = $defsub->insert();
295
296                 if (!$result) {
297                     common_log_db_error($defsub, 'INSERT', __FILE__);
298                     return false;
299                 }
300             }
301         }
302
303         $profile->query('COMMIT');
304
305         if ($email && !$user->email) {
306             mail_confirm_address($user, $confirm->code, $profile->nickname, $email);
307         }
308
309         // Welcome message
310
311         $welcome = common_config('newuser', 'welcome');
312
313         if (!empty($welcome)) {
314             $welcomeuser = User::staticGet('nickname', $welcome);
315             if (empty($welcomeuser)) {
316                 common_log(LOG_WARNING, sprintf("Welcome user %s does not exist.", $defnick),
317                            __FILE__);
318             } else {
319                 $notice = Notice::saveNew($welcomeuser->id,
320                                           sprintf(_('Welcome to %1$s, @%2$s!'),
321                                                   common_config('site', 'name'),
322                                                   $user->nickname),
323                                           'system');
324             }
325         }
326
327         return $user;
328     }
329
330     // Things we do when the email changes
331
332     function emailChanged()
333     {
334
335         $invites = new Invitation();
336         $invites->address = $this->email;
337         $invites->address_type = 'email';
338
339         if ($invites->find()) {
340             while ($invites->fetch()) {
341                 $other = User::staticGet($invites->user_id);
342                 subs_subscribe_to($other, $this);
343             }
344         }
345     }
346
347     function hasFave($notice)
348     {
349         $cache = common_memcache();
350
351         // XXX: Kind of a hack.
352
353         if ($cache) {
354             // This is the stream of favorite notices, in rev chron
355             // order. This forces it into cache.
356
357             $ids = Fave::stream($this->id, 0, NOTICE_CACHE_WINDOW);
358
359             // If it's in the list, then it's a fave
360
361             if (in_array($notice->id, $ids)) {
362                 return true;
363             }
364
365             // If we're not past the end of the cache window,
366             // then the cache has all available faves, so this one
367             // is not a fave.
368
369             if (count($ids) < NOTICE_CACHE_WINDOW) {
370                 return false;
371             }
372
373             // Otherwise, cache doesn't have all faves;
374             // fall through to the default
375         }
376
377         $fave = Fave::pkeyGet(array('user_id' => $this->id,
378                                     'notice_id' => $notice->id));
379         return ((is_null($fave)) ? false : true);
380     }
381
382     function mutuallySubscribed($other)
383     {
384         return $this->isSubscribed($other) &&
385           $other->isSubscribed($this);
386     }
387
388     function mutuallySubscribedUsers()
389     {
390         // 3-way join; probably should get cached
391         $UT = common_config('db','type')=='pgsql'?'"user"':'user';
392         $qry = "SELECT $UT.* " .
393           "FROM subscription sub1 JOIN $UT ON sub1.subscribed = $UT.id " .
394           "JOIN subscription sub2 ON $UT.id = sub2.subscriber " .
395           'WHERE sub1.subscriber = %d and sub2.subscribed = %d ' .
396           "ORDER BY $UT.nickname";
397         $user = new User();
398         $user->query(sprintf($qry, $this->id, $this->id));
399
400         return $user;
401     }
402
403     function getReplies($offset=0, $limit=NOTICES_PER_PAGE, $since_id=0, $before_id=0, $since=null)
404     {
405         $ids = Reply::stream($this->id, $offset, $limit, $since_id, $before_id, $since);
406         common_debug("Ids = " . implode(',', $ids));
407         return Notice::getStreamByIds($ids);
408     }
409
410     function getNotices($offset=0, $limit=NOTICES_PER_PAGE, $since_id=0, $before_id=0, $since=null)
411     {
412         $profile = $this->getProfile();
413         if (!$profile) {
414             return null;
415         } else {
416             return $profile->getNotices($offset, $limit, $since_id, $before_id);
417         }
418     }
419
420     function favoriteNotices($offset=0, $limit=NOTICES_PER_PAGE)
421     {
422         $ids = Fave::stream($this->id, $offset, $limit);
423         return Notice::getStreamByIds($ids);
424     }
425
426     function noticesWithFriends($offset=0, $limit=NOTICES_PER_PAGE, $since_id=0, $before_id=0, $since=null)
427     {
428         $enabled = common_config('inboxes', 'enabled');
429
430         // Complicated code, depending on whether we support inboxes yet
431         // XXX: make this go away when inboxes become mandatory
432
433         if ($enabled === false ||
434             ($enabled == 'transitional' && $this->inboxed == 0)) {
435             $qry =
436               'SELECT notice.* ' .
437               'FROM notice JOIN subscription ON notice.profile_id = subscription.subscribed ' .
438               'WHERE subscription.subscriber = %d ';
439             return Notice::getStream(sprintf($qry, $this->id),
440                                      'user:notices_with_friends:' . $this->id,
441                                      $offset, $limit, $since_id, $before_id,
442                                      $order, $since);
443         } else if ($enabled === true ||
444                    ($enabled == 'transitional' && $this->inboxed == 1)) {
445
446             $ids = Notice_inbox::stream($this->id, $offset, $limit, $since_id, $before_id, $since);
447
448             return Notice::getStreamByIds($ids);
449         }
450     }
451
452     function blowFavesCache()
453     {
454         $cache = common_memcache();
455         if ($cache) {
456             // Faves don't happen chronologically, so we need to blow
457             // ;last cache, too
458             $cache->delete(common_cache_key('fave:ids_by_user:'.$this->id));
459             $cache->delete(common_cache_key('fave:ids_by_user:'.$this->id.';last'));
460         }
461     }
462
463     function getSelfTags()
464     {
465         return Profile_tag::getTags($this->id, $this->id);
466     }
467
468     function setSelfTags($newtags)
469     {
470         return Profile_tag::setTags($this->id, $this->id, $newtags);
471     }
472
473     function block($other)
474     {
475         // Add a new block record
476
477         $block = new Profile_block();
478
479         // Begin a transaction
480
481         $block->query('BEGIN');
482
483         $block->blocker = $this->id;
484         $block->blocked = $other->id;
485
486         $result = $block->insert();
487
488         if (!$result) {
489             common_log_db_error($block, 'INSERT', __FILE__);
490             return false;
491         }
492
493         // Cancel their subscription, if it exists
494
495         $sub = Subscription::pkeyGet(array('subscriber' => $other->id,
496                                            'subscribed' => $this->id));
497
498         if ($sub) {
499             $result = $sub->delete();
500             if (!$result) {
501                 common_log_db_error($sub, 'DELETE', __FILE__);
502                 return false;
503             }
504         }
505
506         $block->query('COMMIT');
507
508         return true;
509     }
510
511     function unblock($other)
512     {
513         // Get the block record
514
515         $block = Profile_block::get($this->id, $other->id);
516
517         if (!$block) {
518             return false;
519         }
520
521         $result = $block->delete();
522
523         if (!$result) {
524             common_log_db_error($block, 'DELETE', __FILE__);
525             return false;
526         }
527
528         return true;
529     }
530
531     function isMember($group)
532     {
533         $profile = $this->getProfile();
534         return $profile->isMember($group);
535     }
536
537     function isAdmin($group)
538     {
539         $profile = $this->getProfile();
540         return $profile->isAdmin($group);
541     }
542
543     function getGroups($offset=0, $limit=null)
544     {
545         $qry =
546           'SELECT user_group.* ' .
547           'FROM user_group JOIN group_member '.
548           'ON user_group.id = group_member.group_id ' .
549           'WHERE group_member.profile_id = %d ' .
550           'ORDER BY group_member.created DESC ';
551
552         if ($offset) {
553             if (common_config('db','type') == 'pgsql') {
554                 $qry .= ' LIMIT ' . $limit . ' OFFSET ' . $offset;
555             } else {
556                 $qry .= ' LIMIT ' . $offset . ', ' . $limit;
557             }
558         }
559
560         $groups = new User_group();
561
562         $cnt = $groups->query(sprintf($qry, $this->id));
563
564         return $groups;
565     }
566
567     function getSubscriptions($offset=0, $limit=null)
568     {
569         $qry =
570           'SELECT profile.* ' .
571           'FROM profile JOIN subscription ' .
572           'ON profile.id = subscription.subscribed ' .
573           'WHERE subscription.subscriber = %d ' .
574           'AND subscription.subscribed != subscription.subscriber ' .
575           'ORDER BY subscription.created DESC ';
576
577         if (common_config('db','type') == 'pgsql') {
578             $qry .= ' LIMIT ' . $limit . ' OFFSET ' . $offset;
579         } else {
580             $qry .= ' LIMIT ' . $offset . ', ' . $limit;
581         }
582
583         $profile = new Profile();
584
585         $profile->query(sprintf($qry, $this->id));
586
587         return $profile;
588     }
589
590     function getSubscribers($offset=0, $limit=null)
591     {
592         $qry =
593           'SELECT profile.* ' .
594           'FROM profile JOIN subscription ' .
595           'ON profile.id = subscription.subscriber ' .
596           'WHERE subscription.subscribed = %d ' .
597           'AND subscription.subscribed != subscription.subscriber ' .
598           'ORDER BY subscription.created DESC ';
599
600         if ($offset) {
601             if (common_config('db','type') == 'pgsql') {
602                 $qry .= ' LIMIT ' . $limit . ' OFFSET ' . $offset;
603             } else {
604                 $qry .= ' LIMIT ' . $offset . ', ' . $limit;
605             }
606         }
607
608         $profile = new Profile();
609
610         $cnt = $profile->query(sprintf($qry, $this->id));
611
612         return $profile;
613     }
614
615     function getTaggedSubscribers($tag, $offset=0, $limit=null)
616     {
617         $qry =
618           'SELECT profile.* ' .
619           'FROM profile JOIN subscription ' .
620           'ON profile.id = subscription.subscriber ' .
621           'JOIN profile_tag ON (profile_tag.tagged = subscription.subscriber ' .
622           'AND profile_tag.tagger = subscription.subscribed) ' .
623           'WHERE subscription.subscribed = %d ' .
624           "AND profile_tag.tag = '%s' " .
625           'AND subscription.subscribed != subscription.subscriber ' .
626           'ORDER BY subscription.created DESC ';
627
628         if ($offset) {
629             if (common_config('db','type') == 'pgsql') {
630                 $qry .= ' LIMIT ' . $limit . ' OFFSET ' . $offset;
631             } else {
632                 $qry .= ' LIMIT ' . $offset . ', ' . $limit;
633             }
634         }
635
636         $profile = new Profile();
637
638         $cnt = $profile->query(sprintf($qry, $this->id, $tag));
639
640         return $profile;
641     }
642
643     function getTaggedSubscriptions($tag, $offset=0, $limit=null)
644     {
645         $qry =
646           'SELECT profile.* ' .
647           'FROM profile JOIN subscription ' .
648           'ON profile.id = subscription.subscribed ' .
649           'JOIN profile_tag on (profile_tag.tagged = subscription.subscribed ' .
650           'AND profile_tag.tagger = subscription.subscriber) ' .
651           'WHERE subscription.subscriber = %d ' .
652           "AND profile_tag.tag = '%s' " .
653           'AND subscription.subscribed != subscription.subscriber ' .
654           'ORDER BY subscription.created DESC ';
655
656         if (common_config('db','type') == 'pgsql') {
657             $qry .= ' LIMIT ' . $limit . ' OFFSET ' . $offset;
658         } else {
659             $qry .= ' LIMIT ' . $offset . ', ' . $limit;
660         }
661
662         $profile = new Profile();
663
664         $profile->query(sprintf($qry, $this->id, $tag));
665
666         return $profile;
667     }
668
669     function hasOpenID()
670     {
671         $oid = new User_openid();
672
673         $oid->user_id = $this->id;
674
675         $cnt = $oid->find();
676
677         return ($cnt > 0);
678     }
679 }