actions/profilecompletion.php

   1 <?php
   2 /**
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2008-2010, StatusNet, Inc.
   5  *
   6  * Subscription action.
   7  *
   8  * This program is free software: you can redistribute it and/or modify
   9  * it under the terms of the GNU Affero General Public License as published by
  10  * the Free Software Foundation, either version 3 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU Affero General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Affero General Public License
  19  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20  *
  21  * PHP version 5
  22  *
  23  * @category  Action
  24  * @package   StatusNet
  25  * @author    Shashi Gowda <connect2shashi@gmail.com>
  26  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPLv3
  27  * @link      http://status.net/
  28  */
  29
  30 if (!defined('STATUSNET')) {
  31     exit(1);
  32 }
  33
  34 require_once INSTALLDIR . '/lib/peopletageditform.php';
  35
  36 /**
  37  * Subscription action
  38  *
  39  * Subscribing to a profile. Does not work for OMB 0.1 remote subscriptions,
  40  * but may work for other remote subscription protocols, like OStatus.
  41  *
  42  * Takes parameters:
  43  *
  44  *    - subscribeto: a profile ID
  45  *    - token: session token to prevent CSRF attacks
  46  *    - ajax: boolean; whether to return Ajax or full-browser results
  47  *
  48  * Only works if the current user is logged in.
  49  *
  50  * @category  Action
  51  * @package   StatusNet
  52  * @author    Shashi Gowda <connect2shashi@gmail.com>
  53  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPLv3
  54  * @link      http://status.net/
  55  */
  56
  57 class ProfilecompletionAction extends Action
  58 {
  59     var $user;
  60     var $peopletag;
  61     var $field;
  62     var $msg;
  63
  64     /**
  65      * Check pre-requisites and instantiate attributes
  66      *
  67      * @param Array $args array of arguments (URL, GET, POST)
  68      *
  69      * @return boolean success flag
  70      */
  71     function prepare(array $args=array())
  72     {
  73         parent::prepare($args);
  74
  75         // CSRF protection
  76
  77         $token = $this->trimmed('token');
  78
  79         if (!$token || $token != common_session_token()) {
  80             // TRANS: Client error displayed when the session token does not match or is not given.
  81             $this->clientError(_('There was a problem with your session token.'.
  82                                  ' Try again, please.'));
  83         }
  84
  85         // Only for logged-in users
  86
  87         $this->user = common_current_user();
  88
  89         if (empty($this->user)) {
  90             // TRANS: Error message displayed when trying to perform an action that requires a logged in user.
  91             $this->clientError(_('Not logged in.'));
  92         }
  93
  94         $id = $this->arg('peopletag_id');
  95         $this->peopletag = Profile_list::getKV('id', $id);
  96
  97         if (empty($this->peopletag)) {
  98             // TRANS: Client error displayed trying to reference a non-existing list.
  99             $this->clientError(_('No such list.'));
 100         }
 101
 102         $field = $this->arg('field');
 103         if (!in_array($field, array('fulltext', 'nickname', 'fullname', 'description', 'location', 'uri'))) {
 104             // TRANS: Client error displayed when trying to add an unindentified field to profile.
 105             // TRANS: %s is a field name.
 106             $this->clientError(sprintf(_('Unidentified field %s.'), htmlspecialchars($field)), 404);
 107         }
 108         $this->field = $field;
 109
 110         return true;
 111     }
 112
 113     /**
 114      * Handle request
 115      *
 116      * Does the subscription and returns results.
 117      *
 118      * @param Array $args unused.
 119      *
 120      * @return void
 121      */
 122
 123     function handle(array $args=array())
 124     {
 125         $this->msg = null;
 126
 127         $this->startHTML('text/xml;charset=utf-8');
 128         $this->elementStart('head');
 129         // TRANS: Page title.
 130         $this->element('title', null, _m('TITLE','Search results'));
 131         $this->elementEnd('head');
 132         $this->elementStart('body');
 133         $profiles = $this->getResults();
 134
 135         if ($this->msg !== null) {
 136             $this->element('p', 'error', $this->msg);
 137         } else {
 138             if (count($profiles) > 0) {
 139                 $this->elementStart('ul', array('id' => 'profile_search_results', 'class' => 'profile-lister'));
 140                 foreach ($profiles as $profile) {
 141                     $this->showProfileItem($profile);
 142                 }
 143                 $this->elementEnd('ul');
 144             } else {
 145                 // TRANS: Output when there are no results for a search.
 146                 $this->element('p', 'error', _('No results.'));
 147             }
 148         }
 149         $this->elementEnd('body');
 150         $this->endHTML();
 151     }
 152
 153     function getResults()
 154     {
 155         $profiles = array();
 156         $q = $this->arg('q');
 157         $q = strtolower($q);
 158         if (strlen($q) < 3) {
 159             // TRANS: Error message in case a search is shorter than three characters.
 160             $this->msg = _('The search string must be at least 3 characters long.');
 161         }
 162         $page = $this->arg('page');
 163         $page = (int) (empty($page) ? 1 : $page);
 164
 165         $profile = new Profile();
 166         $search_engine = $profile->getSearchEngine('profile');
 167
 168         if (Event::handle('StartProfileCompletionSearch', array($this, &$profile, $search_engine))) {
 169             $search_engine->set_sort_mode('chron');
 170             $search_engine->limit((($page-1)*PROFILES_PER_PAGE), PROFILES_PER_PAGE + 1);
 171
 172             if (false === $search_engine->query($q)) {
 173                 $cnt = 0;
 174             }
 175             else {
 176                 $cnt = $profile->find();
 177             }
 178             Event::handle('EndProfileCompletionSearch', array($this, &$profile, $search_engine));
 179         }
 180
 181         while ($profile->fetch()) {
 182             $profiles[] = clone($profile);
 183         }
 184         return $this->filter($profiles);
 185     }
 186
 187     function filter($profiles)
 188     {
 189         $current = $this->user->getProfile();
 190         $filtered_profiles = array();
 191         foreach ($profiles as $profile) {
 192             if ($current->canTag($profile)) {
 193                 $filtered_profiles[] = $profile;
 194             }
 195         }
 196         return $filtered_profiles;
 197     }
 198
 199     function showProfileItem($profile)
 200     {
 201         $this->elementStart('li', 'entity_removable_profile');
 202         $item = new TaggedProfileItem($this, $profile);
 203         $item->show();
 204         $this->elementStart('span', 'entity_actions');
 205
 206         if ($profile->isTagged($this->peopletag)) {
 207             $untag = new UntagButton($this, $profile, $this->peopletag);
 208             $untag->show();
 209         } else {
 210             $tag = new TagButton($this, $profile, $this->peopletag);
 211             $tag->show();
 212         }
 213
 214         $this->elementEnd('span');
 215         $this->elementEnd('li');
 216     }
 217 }