Group_join_queue.php 4.11 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
<?php
/**
 * Table Definition for request_queue
 */
require_once INSTALLDIR.'/classes/Memcached_DataObject.php';

class Group_join_queue extends Managed_DataObject
{
    ###START_AUTOCODE
    /* the code below is auto generated do not remove the above tag */

    public $__table = 'group_join_queue';       // table name
    public $profile_id;
    public $group_id;
    public $created;

17 18 19 20
    /* Pkey get */
    function pkeyGet($k)
    { return Memcached_DataObject::pkeyGet('Group_join_queue',$k); }

21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
    /* the code above is auto generated do not remove the tag below */
    ###END_AUTOCODE

    public static function schemaDef()
    {
        return array(
            'description' => 'Holder for group join requests awaiting moderation.',
            'fields' => array(
                'profile_id' => array('type' => 'int', 'not null' => true, 'description' => 'remote or local profile making the request'),
                'group_id' => array('type' => 'int', 'description' => 'remote or local group to join, if any'),
                'created' => array('type' => 'datetime', 'not null' => true, 'description' => 'date this record was created'),
            ),
            'primary key' => array('profile_id', 'group_id'),
            'indexes' => array(
                'group_join_queue_profile_id_created_idx' => array('profile_id', 'created'),
                'group_join_queue_group_id_created_idx' => array('group_id', 'created'),
            ),
            'foreign keys' => array(
                'group_join_queue_profile_id_fkey' => array('profile', array('profile_id' => 'id')),
                'group_join_queue_group_id_fkey' => array('user_group', array('group_id' => 'id')),
            )
        );
    }

    public static function saveNew(Profile $profile, User_group $group)
    {
        $rq = new Group_join_queue();
        $rq->profile_id = $profile->id;
        $rq->group_id = $group->id;
        $rq->created = common_sql_now();
        $rq->insert();
        return $rq;
    }
54

55 56
    function getMember()
    {
57
        $member = Profile::getKV('id', $this->profile_id);
58 59 60 61

        if (empty($member)) {
            // TRANS: Exception thrown providing an invalid profile ID.
            // TRANS: %s is the invalid profile ID.
Siebrand Mazeland's avatar
Siebrand Mazeland committed
62
            throw new Exception(sprintf(_('Profile ID %s is invalid.'),$this->profile_id));
63 64 65 66 67 68 69
        }

        return $member;
    }

    function getGroup()
    {
70
        $group  = User_group::getKV('id', $this->group_id);
71 72 73 74

        if (empty($group)) {
            // TRANS: Exception thrown providing an invalid group ID.
            // TRANS: %s is the invalid group ID.
Siebrand Mazeland's avatar
Siebrand Mazeland committed
75
            throw new Exception(sprintf(_('Group ID %s is invalid.'),$this->group_id));
76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102
        }

        return $group;
    }

    /**
     * Abort the pending group join...
     *
     * @param User_group $group
     */
    function abort()
    {
        $profile = $this->getMember();
        $group = $this->getGroup();
        if ($request) {
            if (Event::handle('StartCancelJoinGroup', array($profile, $group))) {
                $this->delete();
                Event::handle('EndCancelJoinGroup', array($profile, $group));
            }
        }
    }

    /**
     * Complete a pending group join...
     *
     * @return Group_member object on success
     */
103
    function complete()
104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
    {
        $join = null;
        $profile = $this->getMember();
        $group = $this->getGroup();
        if (Event::handle('StartJoinGroup', array($profile, $group))) {
            $join = Group_member::join($group->id, $profile->id);
            $this->delete();
            Event::handle('EndJoinGroup', array($profile, $group));
        }
        if (!$join) {
            throw new Exception('Internal error: group join failed.');
        }
        $join->notify();
        return $join;
    }

120 121 122 123 124 125
    /**
     * Send notifications via email etc to group administrators about
     * this exciting new pending moderation queue item!
     */
    public function notify()
    {
126 127
        $joiner = Profile::getKV('id', $this->profile_id);
        $group = User_group::getKV('id', $this->group_id);
128 129
        mail_notify_group_join_pending($group, $joiner);
    }
130
}