plugins/OStatus/actions/groupsalmon.php

   1 <?php
   2 /*
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2010, 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')) {
  21     exit(1);
  22 }
  23
  24 /**
  25  * @package OStatusPlugin
  26  * @author James Walker <james@status.net>
  27  */
  28 class GroupsalmonAction extends SalmonAction
  29 {
  30     var $group = null;
  31
  32     function prepare($args)
  33     {
  34         parent::prepare($args);
  35
  36         $id = $this->trimmed('id');
  37
  38         if (!$id) {
  39             // TRANS: Client error.
  40             $this->clientError(_m('No ID.'));
  41         }
  42
  43         $this->group = User_group::getKV('id', $id);
  44
  45         if (empty($this->group)) {
  46             // TRANS: Client error.
  47             $this->clientError(_m('No such group.'));
  48         }
  49
  50
  51         $this->target = $this->group;
  52
  53         $oprofile = Ostatus_profile::getKV('group_id', $id);
  54         if ($oprofile) {
  55             // TRANS: Client error.
  56             $this->clientError(_m('Cannot accept remote posts for a remote group.'));
  57         }
  58
  59         return true;
  60     }
  61
  62     /**
  63      * We've gotten a post event on the Salmon backchannel, probably a reply.
  64      */
  65     function handlePost()
  66     {
  67         // @fixme process all objects?
  68         switch ($this->activity->objects[0]->type) {
  69         case ActivityObject::ARTICLE:
  70         case ActivityObject::BLOGENTRY:
  71         case ActivityObject::NOTE:
  72         case ActivityObject::STATUS:
  73         case ActivityObject::COMMENT:
  74             break;
  75         default:
  76             // TRANS: Client exception.
  77             throw new ClientException('Cannot handle that kind of post.');
  78         }
  79
  80         // Notice must be to the attention of this group
  81         $context = $this->activity->context;
  82
  83         if (empty($context->attention)) {
  84             // TRANS: Client exception.
  85             throw new ClientException("Not to the attention of anyone.");
  86         } else {
  87             $uri = common_local_url('groupbyid', array('id' => $this->group->id));
  88             if (!in_array($uri, $context->attention)) {
  89                 // TRANS: Client exception.
  90                 throw new ClientException("Not to the attention of this group.");
  91             }
  92         }
  93
  94         $profile = $this->ensureProfile();
  95         $this->saveNotice();
  96     }
  97
  98     /**
  99      * We've gotten a follow/subscribe notification from a remote user.
 100      * Save a subscription relationship for them.
 101      */
 102
 103     /**
 104      * Postel's law: consider a "follow" notification as a "join".
 105      */
 106     function handleFollow()
 107     {
 108         $this->handleJoin();
 109     }
 110
 111     /**
 112      * Postel's law: consider an "unfollow" notification as a "leave".
 113      */
 114     function handleUnfollow()
 115     {
 116         $this->handleLeave();
 117     }
 118
 119     /**
 120      * A remote user joined our group.
 121      * @fixme move permission checks and event call into common code,
 122      *        currently we're doing the main logic in joingroup action
 123      *        and so have to repeat it here.
 124      */
 125     function handleJoin()
 126     {
 127         $oprofile = $this->ensureProfile();
 128         if (!$oprofile) {
 129             // TRANS: Client error.
 130             $this->clientError(_m('Cannot read profile to set up group membership.'));
 131         }
 132         if ($oprofile->isGroup()) {
 133             // TRANS: Client error.
 134             $this->clientError(_m('Groups cannot join groups.'));
 135         }
 136
 137         common_log(LOG_INFO, "Remote profile {$oprofile->uri} joining local group {$this->group->nickname}");
 138         $profile = $oprofile->localProfile();
 139
 140         if ($profile->isMember($this->group)) {
 141             // Already a member; we'll take it silently to aid in resolving
 142             // inconsistencies on the other side.
 143             return true;
 144         }
 145
 146         if (Group_block::isBlocked($this->group, $profile)) {
 147             // TRANS: Client error displayed when trying to join a group the user is blocked from by a group admin.
 148             $this->clientError(_m('You have been blocked from that group by the admin.'), 403);
 149             return false;
 150         }
 151
 152         try {
 153             $profile->joinGroup($this->group);
 154         } catch (Exception $e) {
 155             // TRANS: Server error. %1$s is a profile URI, %2$s is a group nickname.
 156             $this->serverError(sprintf(_m('Could not join remote user %1$s to group %2$s.'),
 157                                        $oprofile->uri, $this->group->nickname));
 158         }
 159     }
 160
 161     /**
 162      * A remote user left our group.
 163      */
 164     function handleLeave()
 165     {
 166         $oprofile = $this->ensureProfile();
 167         if (!$oprofile) {
 168             // TRANS: Client error displayed when group membership cannot be cancelled
 169             // TRANS: because the remote profile could not be read.
 170             $this->clientError(_m('Cannot read profile to cancel group membership.'));
 171         }
 172         if ($oprofile->isGroup()) {
 173             // TRANS: Client error displayed when trying to have a group join another group.
 174             $this->clientError(_m('Groups cannot join groups.'));
 175         }
 176
 177         common_log(LOG_INFO, "Remote profile {$oprofile->uri} leaving local group {$this->group->nickname}");
 178         $profile = $oprofile->localProfile();
 179
 180         try {
 181             $profile->leaveGroup($this->group);
 182         } catch (Exception $e) {
 183             // TRANS: Server error. %1$s is a profile URI, %2$s is a group nickname.
 184             $this->serverError(sprintf(_m('Could not remove remote user %1$s from group %2$s.'),
 185                                        $oprofile->uri, $this->group->nickname));
 186             return;
 187         }
 188     }
 189 }