]> CyberLeo.Net >> Repos - SourceForge/phpwiki.git/blob - lib/plugin/WikiForum.php
version of plugins no longer makes sense with Subversion global version number
[SourceForge/phpwiki.git] / lib / plugin / WikiForum.php
1 <?php // -*-php-*-
2 rcs_id('$Id$');
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
19  * along with PhpWiki; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  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  *   <?plugin WikiForum ?>
29  *
30  * To provide information for the MainForum page (CategoryForum)
31  * summary output mode is possible.
32  *
33  *   <?plugin WikiForum page=SubTopic1 mode=summary info=title,numposts,ctime,author ?>
34  *   <?plugin 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         return _("WikiForum");
53     }
54
55     function getDescription () {
56         return _("Handles threaded topics with comments/news and provide a input form");
57     }
58
59     function getDefaultArguments() {
60         return array('pagename'   => '[pagename]',
61                      'order'      => 'normal',   // oldest first
62                      'mode'       => 'show,add', // 'summary',
63                      'info'       => '',
64                      'noheader'   => false
65                     );
66     }
67
68     function run($dbi, $argstr, &$request, $basepage) {
69         $args = $this->getArgs($argstr, $request);
70         if (!$args['pagename'])
71             return $this->error(_("No pagename specified"));
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         global $WikiTheme;
111
112         $dbi = $request->getDbh();
113         $topics = $this->findBlogs($dbi, $args['pagename'], 'wikiforum');
114         $html = HTML::table(array('border'=>0));
115         $row = HTML::tr(HTML::th('title'),
116                         HTML::th('last post'),
117                         HTML::th('author'));
118         $html->pushContent($row);
119         foreach ($topics as $rev) {
120             //TODO: get numposts, number of replies
121             $meta = $rev->get('wikiforum');
122             // format as list, not as wikiforum content
123             $page = new WikiPageName($rev,$args['pagename']);
124             $row = HTML::tr(HTML::td(WikiLink($page,'if_known',$rev->get('summary'))),
125                             HTML::td($WikiTheme->formatDateTime($meta['ctime'])),
126                             HTML::td(WikiLink($meta['creator'],'if_known')));
127             $html->pushContent($row);
128         }
129         return $html;
130     }
131 };
132
133 // For emacs users
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:
141 ?>