lib/plugin/WikiForum.php

   1 <?php
   2
   3 /*
   4  * Copyright 2004 $ThePhpWikiProgrammingTeam
   5  *
   6  * This file is part of PhpWiki.
   7  *
   8  * PhpWiki is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * PhpWiki 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 General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License along
  19  * with PhpWiki; if not, write to the Free Software Foundation, Inc.,
  20  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  21  */
  22
  23 /**
  24  * This plugin handles a threaded list of comments/news associated with a
  25  * particular page (one page per topic) and provides an input form for
  26  * adding a new message.
  27  *
  28  *   <<WikiForum>>
  29  *
  30  * To provide information for the MainForum page (CategoryForum)
  31  * summary output mode is possible.
  32  *
  33  *   <<WikiForum page=SubTopic1 mode=summary info=title,numposts,ctime,author >>
  34  *   <<WikiForum page=SubTopic2 mode=summary info=title,numposts,ctime,author >>
  35  *
  36  * TODO: For admin user, put checkboxes beside comments to allow for bulk removal.
  37  * threaded identation for level of reply
  38  *   (probably no date, just index as pagetitle)
  39  * reply link from within message (?mode=add)
  40  * layout
  41  * pagetype: header: link to parent, no redirects,
  42  *
  43  * @author: Reini Urban
  44  */
  45
  46 include_once 'lib/plugin/WikiBlog.php';
  47
  48 class WikiPlugin_WikiForum
  49     extends WikiPlugin_WikiBlog
  50 {
  51     function getDescription()
  52     {
  53         return _("Handles threaded topics with comments/news and provide a input form.");
  54     }
  55
  56     function getDefaultArguments()
  57     {
  58         return array('pagename' => '[pagename]',
  59             'order' => 'normal', // oldest first
  60             'mode' => 'show,add', // 'summary',
  61             'info' => '',
  62             'noheader' => false
  63         );
  64     }
  65
  66     function run($dbi, $argstr, &$request, $basepage)
  67     {
  68         $args = $this->getArgs($argstr, $request);
  69         if (!$args['pagename']) {
  70             return $this->error(sprintf(_("A required argument “%s” is missing."), 'pagename'));
  71         }
  72
  73         // Get our form args.
  74         $forum = $request->getArg('forum');
  75         $request->setArg('forum', false);
  76
  77         if ($request->isPost() and !empty($forum['add'])) {
  78             return $this->add($request, $forum, 'wikiforum');
  79         }
  80
  81         // Now we display previous comments and/or provide entry box
  82         // for new comments
  83         $html = HTML();
  84         foreach (explode(',', $args['mode']) as $show) {
  85             if (!empty($seen[$show]))
  86                 continue;
  87             $seen[$show] = 1;
  88
  89             switch ($show) {
  90                 case 'summary': // main page: list of all titles
  91                     $html->pushContent($this->showTopics($request, $args));
  92                     break;
  93                 case 'show': // list of all contents
  94                     $html->pushContent($this->showAll($request, $args, 'wikiforum'));
  95                     break;
  96                 case 'add': // add to or create a new thread
  97                     $html->pushContent($this->showForm($request, $args, 'forumadd'));
  98                     break;
  99                 default:
 100                     return $this->error(sprintf("Bad mode (“%s”)", $show));
 101             }
 102         }
 103         // FIXME: on empty showTopics() and mode!=add and mode!=summary provide a showForm() here.
 104         return $html;
 105     }
 106
 107     // Table of titles(subpages) without content
 108     // TODO: use $args['info']
 109     function showTopics($request, $args)
 110     {
 111         global $WikiTheme;
 112
 113         $dbi = $request->getDbh();
 114         $topics = $this->findBlogs($dbi, $args['pagename'], 'wikiforum');
 115         $html = HTML::table();
 116         $row = HTML::tr(HTML::th('title'),
 117             HTML::th('last post'),
 118             HTML::th('author'));
 119         $html->pushContent($row);
 120         foreach ($topics as $rev) {
 121             //TODO: get numposts, number of replies
 122             $meta = $rev->get('wikiforum');
 123             // format as list, not as wikiforum content
 124             $page = new WikiPageName($rev, $args['pagename']);
 125             $row = HTML::tr(HTML::td(WikiLink($page, 'if_known', $rev->get('summary'))),
 126                 HTML::td($WikiTheme->formatDateTime($meta['ctime'])),
 127                 HTML::td(WikiLink($meta['creator'], 'if_known')));
 128             $html->pushContent($row);
 129         }
 130         return $html;
 131     }
 132 }
 133
 134 // Local Variables:
 135 // mode: php
 136 // tab-width: 8
 137 // c-basic-offset: 4
 138 // c-hanging-comment-ender-p: nil
 139 // indent-tabs-mode: nil
 140 // End: