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->text($nickname);
 197         $this->elementEnd('a');
 198
 199         if (!is_null($fullname)) {
 200             $this->elementStart('div', 'fn entity_fn');
 201             $this->text($fullname);
 202             $this->elementEnd('div');
 203         }
 204
 205         if (!is_null($location)) {
 206             $this->elementStart('div', 'label entity_location');
 207             $this->text($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->text($homepage);
 215             $this->elementEnd('a');
 216         }
 217
 218         if (!is_null($note)) {
 219             $this->elementStart('div', 'note entity_note');
 220             $this->text($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         $validate = new Validate();
 245         try {
 246             $this->profile_uri = Discovery::normalize($this->trimmed('profile'));
 247         } catch (Exception $e) {
 248             $this->profile_uri = null;
 249         }
 250         try {
 251             if (Discovery::isAcct($this->profile_uri) && $validate->email(mb_substr($this->profile_uri, 5))) {
 252                 $this->oprofile = Ostatus_profile::ensureWebfinger($this->profile_uri);
 253             } else if ($validate->uri($this->profile_uri)) {
 254                 $this->oprofile = Ostatus_profile::ensureProfileURL($this->profile_uri);
 255             } else {
 256                 // TRANS: Error message in OStatus plugin. Do not translate the domain names example.com
 257                 // TRANS: and example.net, as these are official standard domain names for use in examples.
 258                 $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.");
 259                 common_debug('Invalid address format.', __FILE__);
 260                 return false;
 261             }
 262             return true;
 263         } catch (FeedSubBadURLException $e) {
 264                 // TRANS: Error message in OStatus plugin. Do not translate the domain names example.com
 265                 // TRANS: and example.net, as these are official standard domain names for use in examples.
 266             $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.');
 267             common_debug('Invalid URL or could not reach server.', __FILE__);
 268         } catch (FeedSubBadResponseException $e) {
 269             // TRANS: Error text.
 270             $this->error = _m('Sorry, we could not reach that feed. Please try that OStatus address again later.');
 271             common_debug('Cannot read feed; server returned error.', __FILE__);
 272         } catch (FeedSubEmptyException $e) {
 273             // TRANS: Error text.
 274             $this->error = _m('Sorry, we could not reach that feed. Please try that OStatus address again later.');
 275             common_debug('Cannot read feed; server returned an empty page.', __FILE__);
 276         } catch (FeedSubBadHTMLException $e) {
 277             // TRANS: Error text.
 278             $this->error = _m('Sorry, we could not reach that feed. Please try that OStatus address again later.');
 279             common_debug('Bad HTML, could not find feed link.', __FILE__);
 280         } catch (FeedSubNoFeedException $e) {
 281             // TRANS: Error text.
 282             $this->error = _m("Sorry, we could not reach that feed. Please try that OStatus address again later.");
 283             common_debug('Could not find a feed linked from this URL.', __FILE__);
 284         } catch (FeedSubUnrecognizedTypeException $e) {
 285             // TRANS: Error text.
 286             $this->error = _m("Sorry, we could not reach that feed. Please try that OStatus address again later.");
 287             common_debug('Not a recognized feed type.', __FILE__);
 288         } catch (FeedSubNoHubException $e) {
 289             // TRANS: Error text.
 290             $this->error = _m("Sorry, that feed is not Pubsubhubub enabled.");
 291             common_debug('No hub found.', __FILE__);
 292         } catch (Exception $e) {
 293             // Any new ones we forgot about
 294                 // TRANS: Error message in OStatus plugin. Do not translate the domain names example.com
 295                 // TRANS: and example.net, as these are official standard domain names for use in examples.
 296             $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.");
 297             common_debug(sprintf('Bad feed URL: %s %s', get_class($e), $e->getMessage()), __FILE__);
 298         }
 299
 300         return false;
 301     }
 302
 303     function validateRemoteProfile()
 304     {
 305         // Send us to the respective subscription form for conf
 306         if ($this->oprofile->isGroup()) {
 307             $target = common_local_url('ostatusgroup', array(), array('profile' => $this->profile_uri));
 308             common_redirect($target, 303);
 309         } else if ($this->oprofile->isPeopletag()) {
 310             $target = common_local_url('ostatuspeopletag', array(), array('profile' => $this->profile_uri));
 311             common_redirect($target, 303);
 312         }
 313     }
 314
 315     /**
 316      * Attempt to finalize subscription.
 317      * validateFeed must have been run first.
 318      *
 319      * Calls showForm on failure or success on success.
 320      */
 321     function saveFeed()
 322     {
 323         // And subscribe the current user to the local profile
 324         $local = $this->oprofile->localProfile();
 325         if ($this->scoped->isSubscribed($local)) {
 326             // TRANS: OStatus remote subscription dialog error.
 327             $this->showForm(_m('Already subscribed!'));
 328         } elseif (Subscription::start($this->scoped, $local)) {
 329             $this->success();
 330         } else {
 331             // TRANS: OStatus remote subscription dialog error.
 332             $this->showForm(_m('Remote subscription failed!'));
 333         }
 334     }
 335
 336     /**
 337      * Handle posts to this form
 338      *
 339      * @return void
 340      */
 341
 342     function handlePost()
 343     {
 344         // CSRF protection
 345         $token = $this->trimmed('token');
 346         if (!$token || $token != common_session_token()) {
 347             // TRANS: Client error displayed when the session token does not match or is not given.
 348             $this->showForm(_m('There was a problem with your session token. '.
 349                               'Try again, please.'));
 350             return;
 351         }
 352
 353         if ($this->oprofile) {
 354             if ($this->arg('submit')) {
 355                 $this->saveFeed();
 356                 return;
 357             }
 358         }
 359         $this->showForm();
 360     }
 361
 362     /**
 363      * Show the appropriate form based on our input state.
 364      */
 365     function showForm($err=null)
 366     {
 367         if ($err) {
 368             $this->error = $err;
 369         }
 370         if ($this->boolean('ajax')) {
 371             $this->startHTML('text/xml;charset=utf-8');
 372             $this->elementStart('head');
 373             // TRANS: Form title.
 374             $this->element('title', null, _m('Subscribe to user'));
 375             $this->elementEnd('head');
 376             $this->elementStart('body');
 377             $this->showContent();
 378             $this->elementEnd('body');
 379             $this->endHTML();
 380         } else {
 381             $this->showPage();
 382         }
 383     }
 384
 385     /**
 386      * Title of the page
 387      *
 388      * @return string Title of the page
 389      */
 390
 391     function title()
 392     {
 393         // TRANS: Page title for OStatus remote subscription form.
 394         return _m('Confirm');
 395     }
 396
 397     /**
 398      * Instructions for use
 399      *
 400      * @return instructions for use
 401      */
 402
 403     function getInstructions()
 404     {
 405         // TRANS: Instructions.
 406         return _m('You can subscribe to users from other supported sites. Paste their address or profile URI below:');
 407     }
 408
 409     function showPageNotice()
 410     {
 411         if (!empty($this->error)) {
 412             $this->element('p', 'error', $this->error);
 413         }
 414     }
 415
 416     /**
 417      * Content area of the page
 418      *
 419      * Shows a form for associating a remote OStatus account with this
 420      * StatusNet account.
 421      *
 422      * @return void
 423      */
 424     function showContent()
 425     {
 426         if ($this->oprofile) {
 427             $this->showPreviewForm();
 428         } else {
 429             $this->showInputForm();
 430         }
 431     }
 432
 433     function showScripts()
 434     {
 435         parent::showScripts();
 436         $this->autofocus('feedurl');
 437     }
 438
 439     function selfLink()
 440     {
 441         return common_local_url('ostatussub');
 442     }
 443
 444     /**
 445      * Disable the send-notice form at the top of the page.
 446      * This is really just a hack for the broken CSS in the Cloudy theme,
 447      * I think; copying from other non-notice-navigation pages that do this
 448      * as well. There will be plenty of others also broken.
 449      *
 450      * @fixme fix the cloudy theme
 451      * @fixme do this in a more general way
 452      */
 453     function showNoticeForm() {
 454         // nop
 455     }
 456 }