4 * Copyright 2004 $ThePhpWikiProgrammingTeam
6 * This file is part of PhpWiki.
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.
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.
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.
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.
30 * To provide information for the MainForum page (CategoryForum)
31 * summary output mode is possible.
33 * <<WikiForum page=SubTopic1 mode=summary info=title,numposts,ctime,author >>
34 * <<WikiForum page=SubTopic2 mode=summary info=title,numposts,ctime,author >>
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)
41 * pagetype: header: link to parent, no redirects,
43 * @author: Reini Urban
46 include_once 'lib/plugin/WikiBlog.php';
48 class WikiPlugin_WikiForum
49 extends WikiPlugin_WikiBlog
51 function getDescription()
53 return _("Handles threaded topics with comments/news and provide a input form.");
56 function getDefaultArguments()
58 return array('pagename' => '[pagename]',
59 'order' => 'normal', // oldest first
60 'mode' => 'show,add', // 'summary',
66 function run($dbi, $argstr, &$request, $basepage)
68 $args = $this->getArgs($argstr, $request);
69 if (!$args['pagename']) {
70 return $this->error(sprintf(_("A required argument ā%sā is missing."), 'pagename'));
74 $forum = $request->getArg('forum');
75 $request->setArg('forum', false);
77 if ($request->isPost() and !empty($forum['add'])) {
78 return $this->add($request, $forum, 'wikiforum');
81 // Now we display previous comments and/or provide entry box
84 foreach (explode(',', $args['mode']) as $show) {
85 if (!empty($seen[$show]))
90 case 'summary': // main page: list of all titles
91 $html->pushContent($this->showTopics($request, $args));
93 case 'show': // list of all contents
94 $html->pushContent($this->showAll($request, $args, 'wikiforum'));
96 case 'add': // add to or create a new thread
97 $html->pushContent($this->showForm($request, $args, 'forumadd'));
100 return $this->error(sprintf("Bad mode (ā%sā)", $show));
103 // FIXME: on empty showTopics() and mode!=add and mode!=summary provide a showForm() here.
107 // Table of titles(subpages) without content
108 // TODO: use $args['info']
109 function showTopics($request, $args)
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'),
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);
138 // c-hanging-comment-ender-p: nil
139 // indent-tabs-mode: nil