3 * Table Definition for request_queue
5 require_once INSTALLDIR.'/classes/Memcached_DataObject.php';
7 class Group_join_queue extends Managed_DataObject
10 /* the code below is auto generated do not remove the above tag */
12 public $__table = 'group_join_queue'; // table name
18 function staticGet($k,$v=null)
19 { return Memcached_DataObject::staticGet('Group_join_queue',$k,$v); }
23 { return Memcached_DataObject::pkeyGet('Group_join_queue',$k); }
25 /* the code above is auto generated do not remove the tag below */
28 public static function schemaDef()
31 'description' => 'Holder for group join requests awaiting moderation.',
33 'profile_id' => array('type' => 'int', 'not null' => true, 'description' => 'remote or local profile making the request'),
34 'group_id' => array('type' => 'int', 'description' => 'remote or local group to join, if any'),
35 'created' => array('type' => 'datetime', 'not null' => true, 'description' => 'date this record was created'),
37 'primary key' => array('profile_id', 'group_id'),
39 'group_join_queue_profile_id_created_idx' => array('profile_id', 'created'),
40 'group_join_queue_group_id_created_idx' => array('group_id', 'created'),
42 'foreign keys' => array(
43 'group_join_queue_profile_id_fkey' => array('profile', array('profile_id' => 'id')),
44 'group_join_queue_group_id_fkey' => array('user_group', array('group_id' => 'id')),
49 public static function saveNew(Profile $profile, User_group $group)
51 $rq = new Group_join_queue();
52 $rq->profile_id = $profile->id;
53 $rq->group_id = $group->id;
54 $rq->created = common_sql_now();
61 $member = Profile::staticGet('id', $this->profile_id);
64 // TRANS: Exception thrown providing an invalid profile ID.
65 // TRANS: %s is the invalid profile ID.
66 throw new Exception(sprintf(_('Profile ID %s is invalid.'),$this->profile_id));
74 $group = User_group::staticGet('id', $this->group_id);
77 // TRANS: Exception thrown providing an invalid group ID.
78 // TRANS: %s is the invalid group ID.
79 throw new Exception(sprintf(_('Group ID %s is invalid.'),$this->group_id));
86 * Abort the pending group join...
88 * @param User_group $group
92 $profile = $this->getMember();
93 $group = $this->getGroup();
95 if (Event::handle('StartCancelJoinGroup', array($profile, $group))) {
97 Event::handle('EndCancelJoinGroup', array($profile, $group));
103 * Complete a pending group join...
105 * @return Group_member object on success
110 $profile = $this->getMember();
111 $group = $this->getGroup();
112 if (Event::handle('StartJoinGroup', array($profile, $group))) {
113 $join = Group_member::join($group->id, $profile->id);
115 Event::handle('EndJoinGroup', array($profile, $group));
118 throw new Exception('Internal error: group join failed.');
125 * Send notifications via email etc to group administrators about
126 * this exciting new pending moderation queue item!
128 public function notify()
130 $joiner = Profile::staticGet('id', $this->profile_id);
131 $group = User_group::staticGet('id', $this->group_id);
132 mail_notify_group_join_pending($group, $joiner);