plugins/OStatus/actions/ostatussub.php

   1 <?php
   2 /*
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2009-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 /**
  21  * @package OStatusPlugin
  22  * @maintainer Brion Vibber <brion@status.net>
  23  */
  24
  25 if (!defined('GNUSOCIAL') && !defined('STATUSNET')) { exit(1); }
  26
  27 /**
  28  * Key UI methods:
  29  *
  30  *  showInputForm() - form asking for a remote profile account or URL
  31  *                    We end up back here on errors
  32  *
  33  *  showPreviewForm() - surrounding form for preview-and-confirm
  34  *    preview() - display profile for a remote user
  35  *
  36  *  success() - redirects to subscriptions page on subscribe
  37  */
  38 class OStatusSubAction extends Action
  39 {
  40     protected $profile_uri; // provided acct: or URI of remote entity
  41     protected $oprofile; // Ostatus_profile of remote entity, if valid
  42
  43     protected function prepare(array $args=array())
  44     {
  45         parent::prepare($args);
  46
  47         if (!common_logged_in()) {
  48             // XXX: selfURL() didn't work. :<
  49             common_set_returnto($_SERVER['REQUEST_URI']);
  50             if (Event::handle('RedirectToLogin', array($this, null))) {
  51                 common_redirect(common_local_url('login'), 303);
  52             }
  53             return false;
  54         }
  55
  56         if ($this->pullRemoteProfile()) {
  57             $this->validateRemoteProfile();
  58         }
  59         return true;
  60     }
  61
  62     /**
  63      * Handle the submission.
  64      */
  65     protected function handle()
  66     {
  67         parent::handle();
  68         if ($_SERVER['REQUEST_METHOD'] == 'POST') {
  69             $this->handlePost();
  70         } else {
  71             $this->showForm();
  72         }
  73     }
  74
  75     /**
  76      * Show the initial form, when we haven't yet been given a valid
  77      * remote profile.
  78      */
  79     function showInputForm()
  80     {
  81         $this->elementStart('form', array('method' => 'post',
  82                                           'id' => 'form_ostatus_sub',
  83                                           'class' => 'form_settings',
  84                                           'action' => $this->selfLink()));
  85
  86         $this->hidden('token', common_session_token());
  87
  88         $this->elementStart('fieldset', array('id' => 'settings_feeds'));
  89
  90         $this->elementStart('ul', 'form_data');
  91         $this->elementStart('li');
  92         $this->input('profile',
  93                      // TRANS: Field label for a field that takes an OStatus user address.
  94                      _m('Subscribe to'),
  95                      $this->profile_uri,
  96                      // TRANS: Tooltip for field label "Subscribe to".
  97                      _m('OStatus user\'s address, like nickname@example.com or http://example.net/nickname.'));
  98         $this->elementEnd('li');
  99         $this->elementEnd('ul');
 100         // TRANS: Button text.
 101         $this->submit('validate', _m('BUTTON','Continue'));
 102
 103         $this->elementEnd('fieldset');
 104
 105         $this->elementEnd('form');
 106     }
 107
 108     /**
 109      * Show the preview-and-confirm form. We've got a valid remote
 110      * profile and are ready to poke it!
 111      *
 112      * This controls the wrapper form; actual profile display will
 113      * be in previewUser() or previewGroup() depending on the type.
 114      */
 115     function showPreviewForm()
 116     {
 117         $ok = $this->preview();
 118         if (!$ok) {
 119             // @todo FIXME maybe provide a cancel button or link back?
 120             return;
 121         }
 122
 123         $this->elementStart('div', 'entity_actions');
 124         $this->elementStart('ul');
 125         $this->elementStart('li', 'entity_subscribe');
 126         $this->elementStart('form', array('method' => 'post',
 127                                           'id' => 'form_ostatus_sub',
 128                                           'class' => 'form_remote_authorize',
 129                                           'action' =>
 130                                           $this->selfLink()));
 131         $this->elementStart('fieldset');
 132         $this->hidden('token', common_session_token());
 133         $this->hidden('profile', $this->profile_uri);
 134         if ($this->oprofile->isGroup()) {
 135             // TRANS: Button text.
 136             $this->submit('submit', _m('Join'), 'submit', null,
 137                          // TRANS: Tooltip for button "Join".
 138                          _m('BUTTON','Join this group'));
 139         } else {
 140             // TRANS: Button text.
 141             $this->submit('submit', _m('BUTTON','Confirm'), 'submit', null,
 142                          // TRANS: Tooltip for button "Confirm".
 143                          _m('Subscribe to this user'));
 144         }
 145         $this->elementEnd('fieldset');
 146         $this->elementEnd('form');
 147         $this->elementEnd('li');
 148         $this->elementEnd('ul');
 149         $this->elementEnd('div');
 150     }
 151
 152     /**
 153      * Show a preview for a remote user's profile
 154      * @return boolean true if we're ok to try subscribing
 155      */
 156     function preview()
 157     {
 158         // Throws NoProfileException on localProfile when remote user's Profile not found
 159         $profile = $this->oprofile->localProfile();
 160
 161         if ($this->scoped->isSubscribed($profile)) {
 162             $this->element('div', array('class' => 'error'),
 163                            // TRANS: Extra paragraph in remote profile view when already subscribed.
 164                            _m('You are already subscribed to this user.'));
 165             $ok = false;
 166         } else {
 167             $ok = true;
 168         }
 169
 170         $avatarUrl = $profile->avatarUrl(AVATAR_PROFILE_SIZE);
 171
 172         $this->showEntity($profile,
 173                           $profile->profileurl,
 174                           $avatarUrl,
 175                           $profile->bio);
 176         return $ok;
 177     }
 178
 179     function showEntity($entity, $profile, $avatar, $note)
 180     {
 181         $nickname = $entity->nickname;
 182         $fullname = $entity->fullname;
 183         $homepage = $entity->homepage;
 184         $location = $entity->location;
 185
 186         $this->elementStart('div', 'entity_profile vcard');
 187         $this->element('img', array('src' => $avatar,
 188                                     'class' => 'photo avatar entity_depiction',
 189                                     'width' => AVATAR_PROFILE_SIZE,
 190                                     'height' => AVATAR_PROFILE_SIZE,
 191                                     'alt' => $nickname));
 192
 193         $hasFN = ($fullname !== '') ? 'nickname' : 'fn nickname entity_nickname';
 194         $this->elementStart('a', array('href' => $profile,
 195                                        'class' => 'url '.$hasFN));
 196         $this->raw($nickname);
 197         $this->elementEnd('a');
 198
 199         if (!is_null($fullname)) {
 200             $this->elementStart('div', 'fn entity_fn');
 201             $this->raw($fullname);
 202             $this->elementEnd('div');
 203         }
 204
 205         if (!is_null($location)) {
 206             $this->elementStart('div', 'label entity_location');
 207             $this->raw($location);
 208             $this->elementEnd('div');
 209         }
 210
 211         if (!is_null($homepage)) {
 212             $this->elementStart('a', array('href' => $homepage,
 213                                            'class' => 'url entity_url'));
 214             $this->raw($homepage);
 215             $this->elementEnd('a');
 216         }
 217
 218         if (!is_null($note)) {
 219             $this->elementStart('div', 'note entity_note');
 220             $this->raw($note);
 221             $this->elementEnd('div');
 222         }
 223         $this->elementEnd('div');
 224     }
 225
 226     /**
 227      * Redirect on successful remote user subscription
 228      */
 229     function success()
 230     {
 231         $url = common_local_url('subscriptions', array('nickname' => $this->scoped->nickname));
 232         common_redirect($url, 303);
 233     }
 234
 235     /**
 236      * Pull data for a remote profile and check if it's valid.
 237      * Fills out error UI string in $this->error
 238      * Fills out $this->oprofile on success.
 239      *
 240      * @return boolean
 241      */
 242     function pullRemoteProfile()
 243     {
 244         $this->profile_uri = $this->trimmed('profile');
 245         try {
 246             if (Validate::email($this->profile_uri)) {
 247                 $this->oprofile = Ostatus_profile::ensureWebfinger($this->profile_uri);
 248             } else if (Validate::uri($this->profile_uri)) {
 249                 $this->oprofile = Ostatus_profile::ensureProfileURL($this->profile_uri);
 250             } else {
 251                 // TRANS: Error message in OStatus plugin. Do not translate the domain names example.com
 252                 // TRANS: and example.net, as these are official standard domain names for use in examples.
 253                 $this->error = _m("Sorry, we could not reach that address. Please make sure that the OStatus address is like nickname@example.com or http://example.net/nickname.");
 254                 common_debug('Invalid address format.', __FILE__);
 255                 return false;
 256             }
 257             return true;
 258         } catch (FeedSubBadURLException $e) {
 259                 // TRANS: Error message in OStatus plugin. Do not translate the domain names example.com
 260                 // TRANS: and example.net, as these are official standard domain names for use in examples.
 261             $this->error = _m('Sorry, we could not reach that address. Please make sure that the OStatus address is like nickname@example.com or http://example.net/nickname.');
 262             common_debug('Invalid URL or could not reach server.', __FILE__);
 263         } catch (FeedSubBadResponseException $e) {
 264             // TRANS: Error text.
 265             $this->error = _m('Sorry, we could not reach that feed. Please try that OStatus address again later.');
 266             common_debug('Cannot read feed; server returned error.', __FILE__);
 267         } catch (FeedSubEmptyException $e) {
 268             // TRANS: Error text.
 269             $this->error = _m('Sorry, we could not reach that feed. Please try that OStatus address again later.');
 270             common_debug('Cannot read feed; server returned an empty page.', __FILE__);
 271         } catch (FeedSubBadHTMLException $e) {
 272             // TRANS: Error text.
 273             $this->error = _m('Sorry, we could not reach that feed. Please try that OStatus address again later.');
 274             common_debug('Bad HTML, could not find feed link.', __FILE__);
 275         } catch (FeedSubNoFeedException $e) {
 276             // TRANS: Error text.
 277             $this->error = _m("Sorry, we could not reach that feed. Please try that OStatus address again later.");
 278             common_debug('Could not find a feed linked from this URL.', __FILE__);
 279         } catch (FeedSubUnrecognizedTypeException $e) {
 280             // TRANS: Error text.
 281             $this->error = _m("Sorry, we could not reach that feed. Please try that OStatus address again later.");
 282             common_debug('Not a recognized feed type.', __FILE__);
 283         } catch (FeedSubNoHubException $e) {
 284             // TRANS: Error text.
 285             $this->error = _m("Sorry, that feed is not Pubsubhubub enabled.");
 286             common_debug('No hub found.', __FILE__);
 287         } catch (Exception $e) {
 288             // Any new ones we forgot about
 289                 // TRANS: Error message in OStatus plugin. Do not translate the domain names example.com
 290                 // TRANS: and example.net, as these are official standard domain names for use in examples.
 291             $this->error = _m("Sorry, we could not reach that address. Please make sure that the OStatus address is like nickname@example.com or http://example.net/nickname.");
 292             common_debug(sprintf('Bad feed URL: %s %s', get_class($e), $e->getMessage()), __FILE__);
 293         }
 294
 295         return false;
 296     }
 297
 298     function validateRemoteProfile()
 299     {
 300         // Send us to the respective subscription form for conf
 301         if ($this->oprofile->isGroup()) {
 302             $target = common_local_url('ostatusgroup', array(), array('profile' => $this->profile_uri));
 303             common_redirect($target, 303);
 304         } else if ($this->oprofile->isPeopletag()) {
 305             $target = common_local_url('ostatuspeopletag', array(), array('profile' => $this->profile_uri));
 306             common_redirect($target, 303);
 307         }
 308     }
 309
 310     /**
 311      * Attempt to finalize subscription.
 312      * validateFeed must have been run first.
 313      *
 314      * Calls showForm on failure or success on success.
 315      */
 316     function saveFeed()
 317     {
 318         // And subscribe the current user to the local profile
 319         $local = $this->oprofile->localProfile();
 320         if ($this->scoped->isSubscribed($local)) {
 321             // TRANS: OStatus remote subscription dialog error.
 322             $this->showForm(_m('Already subscribed!'));
 323         } elseif (Subscription::start($this->scoped, $local)) {
 324             $this->success();
 325         } else {
 326             // TRANS: OStatus remote subscription dialog error.
 327             $this->showForm(_m('Remote subscription failed!'));
 328         }
 329     }
 330
 331     /**
 332      * Handle posts to this form
 333      *
 334      * @return void
 335      */
 336
 337     function handlePost()
 338     {
 339         // CSRF protection
 340         $token = $this->trimmed('token');
 341         if (!$token || $token != common_session_token()) {
 342             // TRANS: Client error displayed when the session token does not match or is not given.
 343             $this->showForm(_m('There was a problem with your session token. '.
 344                               'Try again, please.'));
 345             return;
 346         }
 347
 348         if ($this->oprofile) {
 349             if ($this->arg('submit')) {
 350                 $this->saveFeed();
 351                 return;
 352             }
 353         }
 354         $this->showForm();
 355     }
 356
 357     /**
 358      * Show the appropriate form based on our input state.
 359      */
 360     function showForm($err=null)
 361     {
 362         if ($err) {
 363             $this->error = $err;
 364         }
 365         if ($this->boolean('ajax')) {
 366             $this->startHTML('text/xml;charset=utf-8');
 367             $this->elementStart('head');
 368             // TRANS: Form title.
 369             $this->element('title', null, _m('Subscribe to user'));
 370             $this->elementEnd('head');
 371             $this->elementStart('body');
 372             $this->showContent();
 373             $this->elementEnd('body');
 374             $this->endHTML();
 375         } else {
 376             $this->showPage();
 377         }
 378     }
 379
 380     /**
 381      * Title of the page
 382      *
 383      * @return string Title of the page
 384      */
 385
 386     function title()
 387     {
 388         // TRANS: Page title for OStatus remote subscription form.
 389         return _m('Confirm');
 390     }
 391
 392     /**
 393      * Instructions for use
 394      *
 395      * @return instructions for use
 396      */
 397
 398     function getInstructions()
 399     {
 400         // TRANS: Instructions.
 401         return _m('You can subscribe to users from other supported sites. Paste their address or profile URI below:');
 402     }
 403
 404     function showPageNotice()
 405     {
 406         if (!empty($this->error)) {
 407             $this->element('p', 'error', $this->error);
 408         }
 409     }
 410
 411     /**
 412      * Content area of the page
 413      *
 414      * Shows a form for associating a remote OStatus account with this
 415      * StatusNet account.
 416      *
 417      * @return void
 418      */
 419     function showContent()
 420     {
 421         if ($this->oprofile) {
 422             $this->showPreviewForm();
 423         } else {
 424             $this->showInputForm();
 425         }
 426     }
 427
 428     function showScripts()
 429     {
 430         parent::showScripts();
 431         $this->autofocus('feedurl');
 432     }
 433
 434     function selfLink()
 435     {
 436         return common_local_url('ostatussub');
 437     }
 438
 439     /**
 440      * Disable the send-notice form at the top of the page.
 441      * This is really just a hack for the broken CSS in the Cloudy theme,
 442      * I think; copying from other non-notice-navigation pages that do this
 443      * as well. There will be plenty of others also broken.
 444      *
 445      * @fixme fix the cloudy theme
 446      * @fixme do this in a more general way
 447      */
 448     function showNoticeForm() {
 449         // nop
 450     }
 451 }