xref: /plugin/discussion/helper.php (revision 402011e1d1fde96d1460b1ea9e669ca324b66924) 
1<?php
2/**
3 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
4 * @author     Esther Brunner <wikidesign@gmail.com>
5 */
6
7// must be run within Dokuwiki
8if (!defined('DOKU_INC')) die();
9
10if (!defined('DOKU_LF')) define('DOKU_LF', "\n");
11if (!defined('DOKU_TAB')) define('DOKU_TAB', "\t");
12
13class helper_plugin_discussion extends DokuWiki_Plugin {
14
15  function getInfo(){
16    return array(
17      'author' => 'Gina Häußge, Michael Klier, Esther Brunner',
18      'email'  => 'dokuwiki@chimeric.de',
19      'date'   => '2008-04-20',
20      'name'   => 'Discussion Plugin (helper class)',
21      'desc'   => 'Functions to get info about comments to a wiki page',
22      'url'    => 'http://wiki.splitbrain.org/plugin:discussion',
23    );
24  }
25
26  function getMethods(){
27    $result = array();
28    $result[] = array(
29      'name'   => 'th',
30      'desc'   => 'returns the header of the comments column for pagelist',
31      'return' => array('header' => 'string'),
32    );
33    $result[] = array(
34      'name'   => 'td',
35      'desc'   => 'returns the link to the discussion section with number of comments',
36      'params' => array(
37        'id' => 'string',
38        'number of comments (optional)' => 'integer'),
39      'return' => array('link' => 'string'),
40    );
41    $result[] = array(
42      'name'   => 'getThreads',
43      'desc'   => 'returns pages with discussion sections, sorted by recent comments',
44      'params' => array(
45        'namespace' => 'string',
46        'number (optional)' => 'integer'),
47      'return' => array('pages' => 'array'),
48    );
49    $result[] = array(
50      'name'   => 'getComments',
51      'desc'   => 'returns recently added or edited comments individually',
52      'params' => array(
53        'namespace' => 'string',
54        'number (optional)' => 'integer'),
55      'return' => array('pages' => 'array'),
56    );
57    return $result;
58  }
59
60  /**
61   * Returns the column header for the Pagelist Plugin
62   */
63  function th(){
64    return $this->getLang('discussion');
65  }
66
67  /**
68   * Returns the link to the discussion section of a page
69   */
70  function td($id, $num = NULL){
71    $section = '#discussion__section';
72
73    if (!isset($num)){
74      $cfile = metaFN($id, '.comments');
75      $comments = unserialize(io_readFile($cfile, false));
76
77      $num = $comments['number'];
78      if ((!$comments['status']) || (($comments['status'] == 2) && (!$num))) return '';
79    }
80
81    if ($num == 0) $comment = '0&nbsp;'.$this->getLang('comments');
82    elseif ($num == 1) $comment = '1&nbsp;'.$this->getLang('comment');
83    else $comment = $num.'&nbsp;'.$this->getLang('comments');
84
85    return '<a href="'.wl($id).$section.'" class="wikilink1" title="'.$id.$section.'">'.
86      $comment.'</a>';
87  }
88
89  /**
90   * Returns an array of pages with discussion sections, sorted by recent comments
91   */
92  function getThreads($ns, $num = NULL){
93    global $conf;
94
95    require_once(DOKU_INC.'inc/search.php');
96
97    $dir = $conf['datadir'].($ns ? '/'.str_replace(':', '/', $ns): '');
98
99    // returns the list of pages in the given namespace and it's subspaces
100    $items = array();
101    search($items, $dir, 'search_allpages', '');
102
103    // add pages with comments to result
104    $result = array();
105    foreach ($items as $item){
106      $id   = ($ns ? $ns.':' : '').$item['id'];
107
108      // some checks
109      $perm = auth_quickaclcheck($id);
110      if ($perm < AUTH_READ) continue;    // skip if no permission
111      $file = metaFN($id, '.comments');
112      if (!@file_exists($file)) continue; // skip if no comments file
113      $data = unserialize(io_readFile($file, false));
114      $status = $data['status'];
115      $number = $data['number']; // skip if comments are off or closed without comments
116      if (!$status || (($status == 2) && (!$number))) continue;
117
118      $date = filemtime($file);
119      $meta = p_get_metadata($id);
120      $result[$date] = array(
121        'id'       => $id,
122        'file'     => $file,
123        'title'    => $meta['title'],
124        'date'     => $date,
125        'user'     => $meta['creator'],
126        'desc'     => $meta['description']['abstract'],
127        'num'      => $number,
128        'comments' => $this->td($id, $number),
129        'status'   => $status,
130        'perm'     => $perm,
131        'exists'   => true,
132        'anchor'   => 'discussion__section',
133      );
134    }
135
136    // finally sort by time of last comment
137    krsort($result);
138
139    if (is_numeric($num)) $result = array_slice($result, 0, $num);
140
141    return $result;
142  }
143
144  /**
145   * Returns an array of recently added comments to a given page or namespace
146   */
147  function getComments($ns, $num = NULL){
148    global $conf;
149
150    $first  = $_REQUEST['first'];
151    if (!is_numeric($first)) $first = 0;
152
153    if ((!$num) || (!is_numeric($num))) $num = $conf['recent'];
154
155    $result = array();
156    $count  = 0;
157
158    if (!@file_exists($conf['metadir'].'/_comments.changes')) return $result;
159
160    // read all recent changes. (kept short)
161    $lines = file($conf['metadir'].'/_comments.changes');
162
163    // handle lines
164    for ($i = count($lines)-1; $i >= 0; $i--){
165      $rec = $this->_handleRecentComment($lines[$i], $ns);
166      if ($rec !== false) {
167        if (--$first >= 0) continue; // skip first entries
168        $result[$rec['date']] = $rec;
169        $count++;
170        // break when we have enough entries
171        if ($count >= $num) break;
172      }
173    }
174
175    // finally sort by time of last comment
176    krsort($result);
177
178    return $result;
179  }
180
181/* ---------- Changelog function adapted for the Discussion Plugin ---------- */
182
183  /**
184   * Internal function used by $this->getComments()
185   *
186   * don't call directly
187   *
188   * @see getRecentComments()
189   * @author Andreas Gohr <andi@splitbrain.org>
190   * @author Ben Coburn <btcoburn@silicodon.net>
191   * @author Esther Brunner <wikidesign@gmail.com>
192   */
193  function _handleRecentComment($line, $ns){
194    static $seen  = array();         //caches seen pages and skip them
195    if (empty($line)) return false;  //skip empty lines
196
197    // split the line into parts
198    $recent = parseChangelogLine($line);
199    if ($recent === false) return false;
200
201    $cid     = $recent['extra'];
202    $fullcid = $recent['id'].'#'.$recent['extra'];
203
204    // skip seen ones
205    if (isset($seen[$fullcid])) return false;
206
207    // skip 'show comment' log entries
208    if ($recent['type'] === 'sc') return false;
209
210    // remember in seen to skip additional sights
211    $seen[$fullcid] = 1;
212
213    // check if it's a hidden page or comment
214    if (isHiddenPage($recent['id'])) return false;
215    if ($recent['type'] === 'hc') return false;
216
217    // filter namespace or id
218    if (($ns) && (strpos($recent['id'].':', $ns.':') !== 0)) return false;
219
220    // check ACL
221    $recent['perm'] = auth_quickaclcheck($recent['id']);
222    if ($recent['perm'] < AUTH_READ) return false;
223
224    // check existance
225    $recent['file'] = wikiFN($recent['id']);
226    $recent['exists'] = @file_exists($recent['file']);
227    if (!$recent['exists']) return false;
228    if ($recent['type'] === 'dc') return false;
229
230    // get discussion meta file name
231    $data = unserialize(io_readFile(metaFN($recent['id'], '.comments'), false));
232
233    // check if discussion is turned off
234    if ($data['status'] === 0) return false;
235
236    // okay, then add some additional info
237    if (is_array($data['comments'][$cid]['user']))
238      $recent['name'] = $data['comments'][$cid]['user']['name'];
239    else $recent['name'] = $data['comments'][$cid]['name'];
240    $recent['desc'] = strip_tags($data['comments'][$cid]['xhtml']);
241    $recent['anchor'] = 'comment__'.$cid;
242
243    return $recent;
244  }
245
246}
247
248//Setup VIM: ex: et ts=4 enc=utf-8 :
249