X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=classes%2FGroup_member.php;h=8873942318b04329512c6b5c8c184ab9365e5e59;hb=eb6b4628b95f1bb770b01df86eacab756f28364b;hp=c40d06a1db0ebf99c61ea22ad80b438ac3cf1eff;hpb=99194e03fa50b61f99164674afc949b4bbefd44a;p=quix0rs-gnu-social.git

diff --git a/classes/Group_member.php b/classes/Group_member.php
index c40d06a1db..8873942318 100644
--- a/classes/Group_member.php
+++ b/classes/Group_member.php
@@ -3,7 +3,7 @@
  * Table Definition for group_member
  */
 
-class Group_member extends Memcached_DataObject
+class Group_member extends Managed_DataObject
 {
     ###START_AUTOCODE
     /* the code below is auto generated do not remove the above tag */
@@ -12,6 +12,7 @@ class Group_member extends Memcached_DataObject
     public $group_id;                        // int(4)  primary_key not_null
     public $profile_id;                      // int(4)  primary_key not_null
     public $is_admin;                        // tinyint(1)
+    public $uri;                             // varchar(255)
     public $created;                         // datetime()   not_null
     public $modified;                        // timestamp()   not_null default_CURRENT_TIMESTAMP
 
@@ -21,11 +22,50 @@ class Group_member extends Memcached_DataObject
     /* the code above is auto generated do not remove the tag below */
     ###END_AUTOCODE
 
+    public static function schemaDef()
+    {
+        return array(
+            'fields' => array(
+                'group_id' => array('type' => 'int', 'not null' => true, 'description' => 'foreign key to user_group'),
+                'profile_id' => array('type' => 'int', 'not null' => true, 'description' => 'foreign key to profile table'),
+                'is_admin' => array('type' => 'int', 'size' => 'tiny', 'default' => 0, 'description' => 'is this user an admin?'),
+                'uri' => array('type' => 'varchar', 'length' => 255, 'description' => 'universal identifier'),
+                'created' => array('type' => 'datetime', 'not null' => true, 'description' => 'date this record was created'),
+                'modified' => array('type' => 'timestamp', 'not null' => true, 'description' => 'date this record was modified'),
+            ),
+            'primary key' => array('group_id', 'profile_id'),
+            'unique keys' => array(
+                'group_member_uri_key' => array('uri'),
+            ),
+            'foreign keys' => array(
+                'group_member_group_id_fkey' => array('user_group', array('group_id' => 'id')),
+                'group_member_profile_id_fkey' => array('profile', array('profile_id' => 'id')),
+            ),
+            'indexes' => array(
+                // @fixme probably we want a (profile_id, created) index here?
+                'group_member_profile_id_idx' => array('profile_id'),
+                'group_member_created_idx' => array('created'),
+                'group_member_profile_id_created_idx' => array('profile_id', 'created'),
+                'group_member_group_id_created_idx' => array('group_id', 'created'),
+            ),
+        );
+    }
+
     function pkeyGet($kv)
     {
         return Memcached_DataObject::pkeyGet('Group_member', $kv);
     }
 
+    /**
+     * Method to add a user to a group.
+     * In most cases, you should call Profile->joinGroup() instead.
+     *
+     * @param integer $group_id   Group to add to
+     * @param integer $profile_id Profile being added
+     * 
+     * @return Group_member new membership object
+     */
+
     static function join($group_id, $profile_id)
     {
         $member = new Group_member();
@@ -33,6 +73,7 @@ class Group_member extends Memcached_DataObject
         $member->group_id   = $group_id;
         $member->profile_id = $profile_id;
         $member->created    = common_sql_now();
+        $member->uri        = self::newURI($profile_id, $group_id, $member->created);
 
         $result = $member->insert();
 
@@ -42,7 +83,7 @@ class Group_member extends Memcached_DataObject
             throw new Exception(_("Group join failed."));
         }
 
-        return true;
+        return $member;
     }
 
     static function leave($group_id, $profile_id)
@@ -92,6 +133,31 @@ class Group_member extends Memcached_DataObject
         return $group;
     }
 
+    /**
+     * Get stream of memberships by member
+     *
+     * @param integer $memberId profile ID of the member to fetch for
+     * @param integer $offset   offset from start of stream to get
+     * @param integer $limit    number of memberships to get
+     *
+     * @return Group_member stream of memberships, use fetch() to iterate
+     */
+
+    static function byMember($memberId, $offset=0, $limit=GROUPS_PER_PAGE)
+    {
+        $membership = new Group_member();
+
+        $membership->profile_id = $memberId;
+
+        $membership->orderBy('created DESC');
+
+        $membership->limit($offset, $limit);
+
+        $membership->find();
+
+        return $membership;
+    }
+
     function asActivity()
     {
         $member = $this->getMember();
@@ -99,10 +165,7 @@ class Group_member extends Memcached_DataObject
 
         $act = new Activity();
 
-        $act->id = TagURI::mint('join:%d:%d:%s',
-                                $member->id,
-                                $group->id,
-                                common_date_iso8601($this->created));
+        $act->id = $this->getURI();
 
         $act->actor     = ActivityObject::fromProfile($member);
         $act->verb      = ActivityVerb::JOIN;
@@ -118,6 +181,39 @@ class Group_member extends Memcached_DataObject
                                 $member->getBestName(),
                                 $group->getBestName());
 
+        $url = common_local_url('AtomPubShowMembership',
+                                array('profile' => $member->id,
+                                      'group' => $group->id));
+
+        $act->selfLink = $url;
+        $act->editLink = $url;
+
         return $act;
     }
+
+    /**
+     * Send notifications via email etc to group administrators about
+     * this exciting new membership!
+     */
+    public function notify()
+    {
+        mail_notify_group_join($this->getGroup(), $this->getMember());
+    }
+
+    function getURI()
+    {
+        if (!empty($this->uri)) {
+            return $this->uri;
+        } else {
+            return self::newURI($this->profile_id, $this->group_id, $this->created);
+        }
+    }
+
+    static function newURI($profile_id, $group_id, $created)
+    {
+        return TagURI::mint('join:%d:%d:%s',
+                            $profile_id,
+                            $group_id,
+                            common_date_iso8601($created));
+    }
 }