plugins/QnA/QnAPlugin.php

   1 <?php
   2 /**
   3  * StatusNet - the distributed open-source microblogging tool
   4  * Copyright (C) 2011, StatusNet, Inc.
   5  *
   6  * Microapp plugin for Questions and Answers
   7  *
   8  * PHP version 5
   9  *
  10  * This program is free software: you can redistribute it and/or modify
  11  * it under the terms of the GNU Affero General Public License as published by
  12  * the Free Software Foundation, either version 3 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU Affero General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU Affero General Public License
  21  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  22  *
  23  * @category  QnA
  24  * @package   StatusNet
  25  * @author    Zach Copley <zach@status.net>
  26  * @copyright 2011 StatusNet, Inc.
  27  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  28  * @link      http://status.net/
  29  */
  30
  31 if (!defined('STATUSNET')) {
  32     // This check helps protect against security problems;
  33     // your code file can't be executed directly from the web.
  34     exit(1);
  35 }
  36
  37 /**
  38  * Question and Answer plugin
  39  *
  40  * @category  Plugin
  41  * @package   StatusNet
  42  * @author    Zach Copley <zach@status.net>
  43  * @copyright 2011 StatusNet, Inc.
  44  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  45  * @link      http://status.net/
  46  */
  47 class QnAPlugin extends MicroAppPlugin
  48 {
  49     /**
  50      * Set up our tables (question and answer)
  51      *
  52      * @see Schema
  53      * @see ColumnDef
  54      *
  55      * @return boolean hook value; true means continue processing, false means stop.
  56      */
  57     function onCheckSchema()
  58     {
  59         $schema = Schema::get();
  60
  61         $schema->ensureTable('qna_question', QnA_Question::schemaDef());
  62         $schema->ensureTable('qna_answer', QnA_Answer::schemaDef());
  63         $schema->ensureTable('qna_vote', QnA_Vote::schemaDef());
  64
  65         return true;
  66     }
  67
  68     /**
  69      * Load related modules when needed
  70      *
  71      * @param string $cls Name of the class to be loaded
  72      *
  73      * @return boolean hook value; true means continue processing, false means stop.
  74      */
  75     function onAutoload($cls)
  76     {
  77         $dir = dirname(__FILE__);
  78
  79         switch ($cls)
  80         {
  81         case 'QnanewquestionAction':
  82         case 'QnanewanswerAction':
  83         case 'QnashowquestionAction':
  84         case 'QnaclosequestionAction':
  85         case 'QnashowanswerAction':
  86         case 'QnareviseanswerAction':
  87         case 'QnavoteAction':
  88             include_once $dir . '/actions/'
  89                 . strtolower(mb_substr($cls, 0, -6)) . '.php';
  90             return false;
  91         case 'QnanewquestionForm':
  92         case 'QnashowquestionForm':
  93         case 'QnanewanswerForm':
  94         case 'QnashowanswerForm':
  95         case 'QnareviseanswerForm':
  96         case 'QnavoteForm':
  97             include_once $dir . '/lib/' . strtolower($cls).'.php';
  98             break;
  99         case 'QnA_Question':
 100         case 'QnA_Answer':
 101         case 'QnA_Vote':
 102             include_once $dir . '/classes/' . $cls.'.php';
 103             return false;
 104             break;
 105         default:
 106             return true;
 107         }
 108     }
 109
 110     /**
 111      * Map URLs to actions
 112      *
 113      * @param Net_URL_Mapper $m path-to-action mapper
 114      *
 115      * @return boolean hook value; true means continue processing, false means stop.
 116      */
 117
 118     function onRouterInitialized($m)
 119     {
 120         $UUIDregex = '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}';
 121
 122         $m->connect(
 123             'main/qna/newquestion',
 124             array('action' => 'qnanewquestion')
 125         );
 126         $m->connect(
 127             'answer/qna/closequestion',
 128             array('action' => 'qnaclosequestion')
 129         );
 130         $m->connect(
 131             'main/qna/newanswer',
 132             array('action' => 'qnanewanswer')
 133         );
 134         $m->connect(
 135             'main/qna/reviseanswer',
 136             array('action' => 'qnareviseanswer')
 137         );
 138         $m->connect(
 139             'question/vote/:id',
 140             array('action' => 'qnavote', 'type' => 'question'),
 141             array('id' => $UUIDregex)
 142         );
 143         $m->connect(
 144             'question/:id',
 145             array('action' => 'qnashowquestion'),
 146             array('id' => $UUIDregex)
 147         );
 148         $m->connect(
 149             'answer/vote/:id',
 150             array('action' => 'qnavote', 'type' => 'answer'),
 151             array('id' => $UUIDregex)
 152         );
 153         $m->connect(
 154             'answer/:id',
 155             array('action' => 'qnashowanswer'),
 156             array('id' => $UUIDregex)
 157         );
 158
 159         return true;
 160     }
 161
 162     function onPluginVersion(&$versions)
 163     {
 164         $versions[] = array(
 165             'name'        => 'QnA',
 166             'version'     => STATUSNET_VERSION,
 167             'author'      => 'Zach Copley',
 168             'homepage'    => 'http://status.net/wiki/Plugin:QnA',
 169             'description' =>
 170              _m('Question and Answers micro-app.')
 171         );
 172         return true;
 173     }
 174
 175     function appTitle() {
 176         return _m('Question');
 177     }
 178
 179     function tag() {
 180         return 'question';
 181     }
 182
 183     function types() {
 184         return array(
 185             QnA_Question::OBJECT_TYPE,
 186             QnA_Answer::OBJECT_TYPE
 187         );
 188     }
 189
 190     /**
 191      * Given a parsed ActivityStreams activity, save it into a notice
 192      * and other data structures.
 193      *
 194      * @param Activity $activity
 195      * @param Profile $actor
 196      * @param array $options=array()
 197      *
 198      * @return Notice the resulting notice
 199      */
 200     function saveNoticeFromActivity($activity, $actor, $options=array())
 201     {
 202         if (count($activity->objects) != 1) {
 203             throw new Exception('Too many activity objects.');
 204         }
 205
 206         $questionObj = $activity->objects[0];
 207
 208         if ($questinoObj->type != QnA_Question::OBJECT_TYPE) {
 209             throw new Exception('Wrong type for object.');
 210         }
 211
 212         $notice = null;
 213
 214         switch ($activity->verb) {
 215         case ActivityVerb::POST:
 216             $notice = QnA_Question::saveNew(
 217                 $actor,
 218                 $questionObj->title,
 219                 $questionObj->summary,
 220                 $options
 221             );
 222             break;
 223         case Answer::ObjectType:
 224             $question = QnA_Question::staticGet('uri', $questionObj->id);
 225             if (empty($question)) {
 226                 // FIXME: save the question
 227                 throw new Exception("Answer to unknown question.");
 228             }
 229             $notice = QnA_Answer::saveNew($actor, $question, $options);
 230             break;
 231         default:
 232             throw new Exception("Unknown object type received by QnA Plugin");
 233         }
 234
 235         return $notice;
 236     }
 237
 238     /**
 239      * Turn a Notice into an activity object
 240      *
 241      * @param Notice $notice
 242      *
 243      * @return ActivityObject
 244      */
 245
 246     function activityObjectFromNotice($notice)
 247     {
 248         $question = null;
 249
 250         switch ($notice->object_type) {
 251         case QnA_Question::OBJECT_TYPE:
 252             $question = QnA_Question::fromNotice($notice);
 253             break;
 254         case QnA_Answer::OBJECT_TYPE:
 255             $answer   = QnA_Answer::fromNotice($notice);
 256             $question = $answer->getQuestion();
 257             break;
 258         }
 259
 260         if (empty($question)) {
 261             throw new Exception("Unknown object type.");
 262         }
 263
 264         $notice = $question->getNotice();
 265
 266         if (empty($notice)) {
 267             throw new Exception("Unknown question notice.");
 268         }
 269
 270         $obj = new ActivityObject();
 271
 272         $obj->id      = $question->uri;
 273         $obj->type    = QnA_Question::OBJECT_TYPE;
 274         $obj->title   = $question->title;
 275         $obj->link    = $notice->bestUrl();
 276
 277         // XXX: probably need other stuff here
 278
 279         return $obj;
 280     }
 281
 282     /**
 283      * Change the verb on Answer notices
 284      *
 285      * @param Notice $notice
 286      *
 287      * @return ActivityObject
 288      */
 289
 290     function onEndNoticeAsActivity($notice, &$act) {
 291         switch ($notice->object_type) {
 292         case Answer::NORMAL:
 293         case Answer::ANONYMOUS:
 294             $act->verb = $notice->object_type;
 295             break;
 296         }
 297         return true;
 298     }
 299
 300     /**
 301      * Output our CSS class for QnA notice list elements
 302      *
 303      * @param NoticeListItem $nli The item being shown
 304      *
 305      * @return boolean hook value
 306      */
 307
 308     function onStartOpenNoticeListItemElement($nli)
 309     {
 310         $type = $nli->notice->object_type;
 311
 312         switch($type)
 313         {
 314         case QnA_Question::OBJECT_TYPE:
 315             $id = (empty($nli->repeat)) ? $nli->notice->id : $nli->repeat->id;
 316             $nli->out->elementStart(
 317                 'li', array(
 318                     'class' => 'hentry notice question',
 319                     'id'    => 'notice-' . $id
 320                 )
 321             );
 322             Event::handle('EndOpenNoticeListItemElement', array($nli));
 323             return false;
 324             break;
 325         case QnA_Answer::OBJECT_TYPE:
 326             $id = (empty($nli->repeat)) ? $nli->notice->id : $nli->repeat->id;
 327
 328             $cls = array('hentry', 'notice', 'answer');
 329
 330             $answer = QnA_Answer::staticGet('uri', $notice->uri);
 331
 332             if (!empty($answer) && !empty($answer->best)) {
 333                 $cls[] = 'best';
 334             }
 335
 336             $nli->out->elementStart(
 337                 'li',
 338                 array(
 339                     'class' => implode(' ', $cls),
 340                     'id'    => 'notice-' . $id
 341                 )
 342             );
 343             Event::handle('EndOpenNoticeListItemElement', array($nli));
 344             return false;
 345             break;
 346         default:
 347             return true;
 348         }
 349
 350         return true;
 351     }
 352
 353     /**
 354      * Custom HTML output for our notices
 355      *
 356      * @param Notice $notice
 357      * @param HTMLOutputter $out
 358      */
 359
 360     function showNotice($notice, $out)
 361     {
 362         switch ($notice->object_type) {
 363         case QnA_Question::OBJECT_TYPE:
 364             return $this->showNoticeQuestion($notice, $out);
 365         case QnA_Answer::OBJECT_TYPE:
 366             return $this->showNoticeAnswer($notice, $out);
 367         default:
 368             // TRANS: Exception thrown when performing an unexpected action on a question.
 369             // TRANS: %s is the unpexpected object type.
 370             throw new Exception(
 371                 sprintf(
 372                     _m('Unexpected type for QnA plugin: %s.'),
 373                     $notice->object_type
 374                 )
 375             );
 376         }
 377     }
 378
 379     function showNoticeQuestion($notice, $out)
 380     {
 381         $user = common_current_user();
 382
 383         // @hack we want regular rendering, then just add stuff after that
 384         $nli = new NoticeListItem($notice, $out);
 385         $nli->showNotice();
 386
 387         $out->elementStart('div', array('class' => 'entry-content question-desciption'));
 388
 389         $question = QnA_Question::getByNotice($notice);
 390
 391         if (!empty($question)) {
 392             if (empty($user)) {
 393                 $form = new QnashowquestionForm($out, $question);
 394                 $form->show();
 395             } else {
 396                 $profile = $user->getProfile();
 397                 $answer = $question->getAnswer($profile);
 398                 if (empty($answer)) {
 399                     $form = new QnanewanswerForm($out, $question);
 400                     $form->show();
 401                 } else {
 402                     $form = new QnashowquestionForm($out, $question);
 403                     $form->show();
 404                 }
 405             }
 406         } else {
 407             $out->text(_m('Question data is missing.'));
 408         }
 409         $out->elementEnd('div');
 410
 411         // @fixme
 412         $out->elementStart('div', array('class' => 'entry-content'));
 413     }
 414
 415     function showNoticeAnswer($notice, $out)
 416     {
 417         $user = common_current_user();
 418
 419         $answer   = QnA_Answer::getByNotice($notice);
 420         $question = $answer->getQuestion();
 421
 422         $nli = new NoticeListItem($notice, $out);
 423         $nli->showNotice();
 424
 425         $out->elementStart('div', array('class' => 'entry-content answer-content'));
 426
 427         if (!empty($answer)) {
 428             $form = new QnashowanswerForm($out, $answer);
 429             $form->show();
 430         } else {
 431             $out->text(_m('Answer data is missing.'));
 432         }
 433
 434         $out->elementEnd('div');
 435
 436         // @fixme
 437         $out->elementStart('div', array('class' => 'entry-content'));
 438     }
 439
 440     static function shorten($content, $notice)
 441     {
 442         $short = null;
 443
 444         if (Notice::contentTooLong($content)) {
 445             common_debug("content too long");
 446             $max = Notice::maxContent();
 447             $short = mb_substr($content, 0, $max - 1);
 448             $short .= sprintf(
 449                 '<a href="%s" rel="more" title="%s">…</a>',
 450                 $notice->uri,
 451                 _m('more')
 452             );
 453         } else {
 454             $short = $content;
 455         }
 456
 457         return $short;
 458     }
 459
 460     /**
 461      * Form for our app
 462      *
 463      * @param HTMLOutputter $out
 464      * @return Widget
 465      */
 466
 467     function entryForm($out)
 468     {
 469         return new QnanewquestionForm($out);
 470     }
 471
 472     /**
 473      * When a notice is deleted, clean up related tables.
 474      *
 475      * @param Notice $notice
 476      */
 477
 478     function deleteRelated($notice)
 479     {
 480         switch ($notice->object_type) {
 481         case QnA_Question::OBJECT_TYPE:
 482             common_log(LOG_DEBUG, "Deleting question from notice...");
 483             $question = QnA_Question::fromNotice($notice);
 484             $question->delete();
 485             break;
 486         case QnA_Answer::OBJECT_TYPE:
 487             common_log(LOG_DEBUG, "Deleting answer from notice...");
 488             $answer = QnA_Answer::fromNotice($notice);
 489             common_log(LOG_DEBUG, "to delete: $answer->id");
 490             $answer->delete();
 491             break;
 492         default:
 493             common_log(LOG_DEBUG, "Not deleting related, wtf...");
 494         }
 495     }
 496
 497     function onEndShowScripts($action)
 498     {
 499         // XXX maybe some cool shiz here
 500     }
 501
 502     function onEndShowStyles($action)
 503     {
 504         $action->cssLink($this->path('css/qna.css'));
 505         return true;
 506     }
 507 }