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 getName()
  52     {
  53         return _("WikiForum");
  54     }
  55
  56     function getDescription()
  57     {
  58         return _("Handles threaded topics with comments/news and provide a input form");
  59     }
  60
  61     function getDefaultArguments()
  62     {
  63         return array('pagename' => '[pagename]',
  64             'order' => 'normal', // oldest first
  65             'mode' => 'show,add', // 'summary',
  66             'info' => '',
  67             'noheader' => false
  68         );
  69     }
  70
  71     function run($dbi, $argstr, &$request, $basepage)
  72     {
  73         $args = $this->getArgs($argstr, $request);
  74         if (!$args['pagename']) {
  75             return $this->error(sprintf(_("A required argument '%s' is missing."), 'pagename'));
  76         }
  77
  78         // Get our form args.
  79         $forum = $request->getArg('forum');
  80         $request->setArg('forum', false);
  81
  82         if ($request->isPost() and !empty($forum['add'])) {
  83             return $this->add($request, $forum, 'wikiforum');
  84         }
  85
  86         // Now we display previous comments and/or provide entry box
  87         // for new comments
  88         $html = HTML();
  89         foreach (explode(',', $args['mode']) as $show) {
  90             if (!empty($seen[$show]))
  91                 continue;
  92             $seen[$show] = 1;
  93
  94             switch ($show) {
  95                 case 'summary': // main page: list of all titles
  96                     $html->pushContent($this->showTopics($request, $args));
  97                     break;
  98                 case 'show': // list of all contents
  99                     $html->pushContent($this->showAll($request, $args, 'wikiforum'));
 100                     break;
 101                 case 'add': // add to or create a new thread
 102                     $html->pushContent($this->showForm($request, $args, 'forumadd'));
 103                     break;
 104                 default:
 105                     return $this->error(sprintf("Bad mode ('%s')", $show));
 106             }
 107         }
 108         // FIXME: on empty showTopics() and mode!=add and mode!=summary provide a showForm() here.
 109         return $html;
 110     }
 111
 112     // Table of titles(subpages) without content
 113     // TODO: use $args['info']
 114     function showTopics($request, $args)
 115     {
 116         global $WikiTheme;
 117
 118         $dbi = $request->getDbh();
 119         $topics = $this->findBlogs($dbi, $args['pagename'], 'wikiforum');
 120         $html = HTML::table(array('border' => 0));
 121         $row = HTML::tr(HTML::th('title'),
 122             HTML::th('last post'),
 123             HTML::th('author'));
 124         $html->pushContent($row);
 125         foreach ($topics as $rev) {
 126             //TODO: get numposts, number of replies
 127             $meta = $rev->get('wikiforum');
 128             // format as list, not as wikiforum content
 129             $page = new WikiPageName($rev, $args['pagename']);
 130             $row = HTML::tr(HTML::td(WikiLink($page, 'if_known', $rev->get('summary'))),
 131                 HTML::td($WikiTheme->formatDateTime($meta['ctime'])),
 132                 HTML::td(WikiLink($meta['creator'], 'if_known')));
 133             $html->pushContent($row);
 134         }
 135         return $html;
 136     }
 137 }
 138
 139 // Local Variables:
 140 // mode: php
 141 // tab-width: 8
 142 // c-basic-offset: 4
 143 // c-hanging-comment-ender-p: nil
 144 // indent-tabs-mode: nil
 145 // End: