plugins/OStatus/actions/usersalmon.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('GNUSOCIAL')) { exit(1); }
  21
  22 /**
  23  * @package OStatusPlugin
  24  * @author James Walker <james@status.net>
  25  */
  26 class UsersalmonAction extends SalmonAction
  27 {
  28     protected function prepare(array $args=array())
  29     {
  30         parent::prepare($args);
  31
  32         $id = $this->trimmed('id');
  33
  34         if (!$id) {
  35             // TRANS: Client error displayed trying to perform an action without providing an ID.
  36             $this->clientError(_m('No ID.'));
  37         }
  38
  39         $this->user = User::getKV('id', $id);
  40
  41         if (!$this->user instanceof User) {
  42             // TRANS: Client error displayed when referring to a non-existing user.
  43             $this->clientError(_m('No such user.'));
  44         }
  45
  46         $this->target = $this->user->getProfile();
  47
  48         return true;
  49     }
  50
  51     /**
  52      * We've gotten a post event on the Salmon backchannel, probably a reply.
  53      *
  54      * @todo validate if we need to handle this post, then call into
  55      * ostatus_profile's general incoming-post handling.
  56      */
  57     function handlePost()
  58     {
  59         common_log(LOG_INFO, "Received post of '{$this->activity->objects[0]->id}' from '{$this->activity->actor->id}'");
  60
  61         // @fixme: process all activity objects?
  62         switch ($this->activity->objects[0]->type) {
  63         case ActivityObject::ARTICLE:
  64         case ActivityObject::BLOGENTRY:
  65         case ActivityObject::NOTE:
  66         case ActivityObject::STATUS:
  67         case ActivityObject::COMMENT:
  68             break;
  69         default:
  70             // TRANS: Client exception thrown when an undefied activity is performed.
  71             throw new ClientException(_m('Cannot handle that kind of post.'));
  72         }
  73
  74         // Notice must either be a) in reply to a notice by this user
  75         // or b) in reply to a notice to the attention of this user
  76         // or c) to the attention of this user
  77
  78         $context = $this->activity->context;
  79         $notice = false;
  80
  81         if (!empty($context->replyToID)) {
  82             $notice = Notice::getKV('uri', $context->replyToID);
  83         }
  84
  85         if ($notice instanceof Notice &&
  86             ($notice->profile_id == $this->target->id ||
  87              array_key_exists($this->target->id, $notice->getReplies())))
  88         {
  89             // In reply to a notice either from or mentioning this user.
  90         } elseif (!empty($context->attention) &&
  91                    array_key_exists($this->target->getUri(), $context->attention)) {
  92             // To the attention of this user.
  93         } else {
  94             // TRANS: Client exception.
  95             throw new ClientException(_m('Not to anyone in reply to anything.'));
  96         }
  97
  98         try {
  99             $this->saveNotice();
 100         } catch AlreadyFulfilledException($e) {
 101             return;
 102         }
 103     }
 104
 105     /**
 106      * We've gotten a follow/subscribe notification from a remote user.
 107      * Save a subscription relationship for them.
 108      */
 109     function handleFollow()
 110     {
 111         common_log(LOG_INFO, sprintf('Setting up subscription from remote %s to local %s', $this->oprofile->getUri(), $this->target->getNickname()));
 112         Subscription::start($this->actor, $this->target);
 113     }
 114
 115     /**
 116      * We've gotten an unfollow/unsubscribe notification from a remote user.
 117      * Check if we have a subscription relationship for them and kill it.
 118      *
 119      * @fixme probably catch exceptions on fail?
 120      */
 121     function handleUnfollow()
 122     {
 123         common_log(LOG_INFO, sprintf('Canceling subscription from remote %s to local %s', $this->oprofile->getUri(), $this->target->getNickname()));
 124         try {
 125             Subscription::cancel($this->actor, $this->target);
 126         } catch (NoProfileException $e) {
 127             common_debug('Could not find profile for Subscription: '.$e->getMessage());
 128         }
 129     }
 130
 131     function handleTag()
 132     {
 133         if ($this->activity->target->type == ActivityObject::_LIST) {
 134             if ($this->activity->objects[0]->type != ActivityObject::PERSON) {
 135                 // TRANS: Client exception.
 136                 throw new ClientException(_m('Not a person object.'));
 137             }
 138             // this is a peopletag
 139             $tagged = User::getKV('uri', $this->activity->objects[0]->id);
 140
 141             if (!$tagged instanceof User) {
 142                 // TRANS: Client exception.
 143                 throw new ClientException(_m('Unidentified profile being listed.'));
 144             }
 145
 146             if ($tagged->id !== $this->target->id) {
 147                 // TRANS: Client exception.
 148                 throw new ClientException(_m('This user is not the one being listed.'));
 149             }
 150
 151             // save the list
 152             $list   = Ostatus_profile::ensureActivityObjectProfile($this->activity->target);
 153
 154             $ptag = $list->localPeopletag();
 155             $result = Profile_tag::setTag($ptag->tagger, $tagged->id, $ptag->tag);
 156             if (!$result) {
 157                 // TRANS: Client exception.
 158                 throw new ClientException(_m('The listing could not be saved.'));
 159             }
 160         }
 161     }
 162
 163     function handleUntag()
 164     {
 165         if ($this->activity->target->type == ActivityObject::_LIST) {
 166             if ($this->activity->objects[0]->type != ActivityObject::PERSON) {
 167                 // TRANS: Client exception.
 168                 throw new ClientException(_m('Not a person object.'));
 169             }
 170             // this is a peopletag
 171             $tagged = User::getKV('uri', $this->activity->objects[0]->id);
 172
 173             if (!$tagged instanceof User) {
 174                 // TRANS: Client exception.
 175                 throw new ClientException(_m('Unidentified profile being unlisted.'));
 176             }
 177
 178             if ($tagged->id !== $this->target->id) {
 179                 // TRANS: Client exception.
 180                 throw new ClientException(_m('This user is not the one being unlisted.'));
 181             }
 182
 183             // save the list
 184             $list   = Ostatus_profile::ensureActivityObjectProfile($this->activity->target);
 185
 186             $ptag = $list->localPeopletag();
 187             $result = Profile_tag::unTag($ptag->tagger, $tagged->id, $ptag->tag);
 188
 189             if (!$result) {
 190                 // TRANS: Client exception.
 191                 throw new ClientException(_m('The listing could not be deleted.'));
 192             }
 193         }
 194     }
 195
 196     /**
 197      * @param ActivityObject $object
 198      * @return Notice
 199      * @throws ClientException on invalid input
 200      */
 201     function getNotice(ActivityObject $object)
 202     {
 203         switch ($object->type) {
 204         case ActivityObject::ARTICLE:
 205         case ActivityObject::BLOGENTRY:
 206         case ActivityObject::NOTE:
 207         case ActivityObject::STATUS:
 208         case ActivityObject::COMMENT:
 209             break;
 210         default:
 211             // TRANS: Client exception.
 212             throw new ClientException(_m('Cannot handle that kind of object for liking/faving.'));
 213         }
 214
 215         $notice = Notice::getKV('uri', $object->id);
 216
 217         if (!$notice instanceof Notice) {
 218             // TRANS: Client exception. %s is an object ID.
 219             throw new ClientException(sprintf(_m('Notice with ID %s unknown.'),$object->id));
 220         }
 221
 222         if ($notice->profile_id != $this->target->id) {
 223             // TRANS: Client exception. %1$s is a notice ID, %2$s is a user ID.
 224             throw new ClientException(sprintf(_m('Notice with ID %1$s not posted by %2$s.'), $object->id, $this->target->id));
 225         }
 226
 227         return $notice;
 228     }
 229 }