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 (Exception $e) {
 284             // Any new ones we forgot about
 285                 // TRANS: Error message in OStatus plugin. Do not translate the domain names example.com
 286                 // TRANS: and example.net, as these are official standard domain names for use in examples.
 287             $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.");
 288             common_debug(sprintf('Bad feed URL: %s %s', get_class($e), $e->getMessage()), __FILE__);
 289         }
 290
 291         return false;
 292     }
 293
 294     function validateRemoteProfile()
 295     {
 296         // Send us to the respective subscription form for conf
 297         if ($this->oprofile->isGroup()) {
 298             $target = common_local_url('ostatusgroup', array(), array('profile' => $this->profile_uri));
 299             common_redirect($target, 303);
 300         } else if ($this->oprofile->isPeopletag()) {
 301             $target = common_local_url('ostatuspeopletag', array(), array('profile' => $this->profile_uri));
 302             common_redirect($target, 303);
 303         }
 304     }
 305
 306     /**
 307      * Attempt to finalize subscription.
 308      * validateFeed must have been run first.
 309      *
 310      * Calls showForm on failure or success on success.
 311      */
 312     function saveFeed()
 313     {
 314         // And subscribe the current user to the local profile
 315         $local = $this->oprofile->localProfile();
 316         if ($this->scoped->isSubscribed($local)) {
 317             // TRANS: OStatus remote subscription dialog error.
 318             $this->showForm(_m('Already subscribed!'));
 319         } elseif (Subscription::start($this->scoped, $local)) {
 320             $this->success();
 321         } else {
 322             // TRANS: OStatus remote subscription dialog error.
 323             $this->showForm(_m('Remote subscription failed!'));
 324         }
 325     }
 326
 327     /**
 328      * Handle posts to this form
 329      *
 330      * @return void
 331      */
 332
 333     function handlePost()
 334     {
 335         // CSRF protection
 336         $token = $this->trimmed('token');
 337         if (!$token || $token != common_session_token()) {
 338             // TRANS: Client error displayed when the session token does not match or is not given.
 339             $this->showForm(_m('There was a problem with your session token. '.
 340                               'Try again, please.'));
 341             return;
 342         }
 343
 344         if ($this->oprofile) {
 345             if ($this->arg('submit')) {
 346                 $this->saveFeed();
 347                 return;
 348             }
 349         }
 350         $this->showForm();
 351     }
 352
 353     /**
 354      * Show the appropriate form based on our input state.
 355      */
 356     function showForm($err=null)
 357     {
 358         if ($err) {
 359             $this->error = $err;
 360         }
 361         if ($this->boolean('ajax')) {
 362             $this->startHTML('text/xml;charset=utf-8');
 363             $this->elementStart('head');
 364             // TRANS: Form title.
 365             $this->element('title', null, _m('Subscribe to user'));
 366             $this->elementEnd('head');
 367             $this->elementStart('body');
 368             $this->showContent();
 369             $this->elementEnd('body');
 370             $this->endHTML();
 371         } else {
 372             $this->showPage();
 373         }
 374     }
 375
 376     /**
 377      * Title of the page
 378      *
 379      * @return string Title of the page
 380      */
 381
 382     function title()
 383     {
 384         // TRANS: Page title for OStatus remote subscription form.
 385         return _m('Confirm');
 386     }
 387
 388     /**
 389      * Instructions for use
 390      *
 391      * @return instructions for use
 392      */
 393
 394     function getInstructions()
 395     {
 396         // TRANS: Instructions.
 397         return _m('You can subscribe to users from other supported sites. Paste their address or profile URI below:');
 398     }
 399
 400     function showPageNotice()
 401     {
 402         if (!empty($this->error)) {
 403             $this->element('p', 'error', $this->error);
 404         }
 405     }
 406
 407     /**
 408      * Content area of the page
 409      *
 410      * Shows a form for associating a remote OStatus account with this
 411      * StatusNet account.
 412      *
 413      * @return void
 414      */
 415     function showContent()
 416     {
 417         if ($this->oprofile) {
 418             $this->showPreviewForm();
 419         } else {
 420             $this->showInputForm();
 421         }
 422     }
 423
 424     function showScripts()
 425     {
 426         parent::showScripts();
 427         $this->autofocus('feedurl');
 428     }
 429
 430     function selfLink()
 431     {
 432         return common_local_url('ostatussub');
 433     }
 434
 435     /**
 436      * Disable the send-notice form at the top of the page.
 437      * This is really just a hack for the broken CSS in the Cloudy theme,
 438      * I think; copying from other non-notice-navigation pages that do this
 439      * as well. There will be plenty of others also broken.
 440      *
 441      * @fixme fix the cloudy theme
 442      * @fixme do this in a more general way
 443      */
 444     function showNoticeForm() {
 445         // nop
 446     }
 447 }