*/
/**
* Class helper_plugin_discussion
*/
class helper_plugin_discussion extends DokuWiki_Plugin {
/**
* @return array
*/
function getMethods() {
$result = array();
$result[] = array(
'name' => 'th',
'desc' => 'returns the header of the comments column for pagelist',
'return' => array('header' => 'string'),
);
$result[] = array(
'name' => 'td',
'desc' => 'returns the link to the discussion section with number of comments',
'params' => array(
'id' => 'string',
'number of comments (optional)' => 'integer'),
'return' => array('link' => 'string'),
);
$result[] = array(
'name' => 'getThreads',
'desc' => 'returns pages with discussion sections, sorted by recent comments',
'params' => array(
'namespace' => 'string',
'number (optional)' => 'integer'),
'return' => array('pages' => 'array'),
);
$result[] = array(
'name' => 'getComments',
'desc' => 'returns recently added or edited comments individually',
'params' => array(
'namespace' => 'string',
'number (optional)' => 'integer'),
'return' => array('pages' => 'array'),
);
return $result;
}
/**
* Returns the column header for the Pagelist Plugin
*
* @return string
*/
function th() {
return $this->getLang('discussion');
}
/**
* Returns the link to the discussion section of a page
*
* @param string $id
* @param null|int $num
* @return string
*/
function td($id, $num = null) {
$section = '#discussion__section';
if (!isset($num)) {
$cfile = metaFN($id, '.comments');
$comments = unserialize(io_readFile($cfile, false));
$num = $comments['number'];
if ((!$comments['status']) || (($comments['status'] == 2) && (!$num))) return '';
}
if ($num == 0) {
$comment = '0 '.$this->getLang('nocomments');
} elseif ($num == 1) {
$comment = '1 '.$this->getLang('comment');
} else {
$comment = $num.' '.$this->getLang('comments');
}
return ''.
$comment.'';
}
/**
* Returns an array of pages with discussion sections, sorted by recent comments
* Note: also used for content by Feed Plugin
*
* @param string $ns
* @param null|int $num
* @param string|bool $skipEmpty
* @return array
*/
function getThreads($ns, $num = null, $skipEmpty = false) {
global $conf;
require_once(DOKU_INC.'inc/search.php');
$dir = $conf['datadir'].utf8_encodeFN(($ns ? '/'.str_replace(':', '/', $ns): ''));
// returns the list of pages in the given namespace and it's subspaces
$items = array();
search($items, $dir, 'search_allpages', array());
// add pages with comments to result
$result = array();
foreach ($items as $item) {
$id = ($ns ? $ns.':' : '').$item['id'];
// some checks
$perm = auth_quickaclcheck($id);
if ($perm < AUTH_READ) continue; // skip if no permission
$file = metaFN($id, '.comments');
if (!@file_exists($file)) continue; // skip if no comments file
$data = unserialize(io_readFile($file, false));
$status = $data['status'];
$number = $data['number'];
if (!$status || (($status == 2) && (!$number))) continue; // skip if comments are off or closed without comments
if($skipEmpty == 'y' && $number == 0) continue; // skip if discussion is empty and flag is set
$date = filemtime($file);
$meta = p_get_metadata($id);
$result[$date.'_'.$id] = array(
'id' => $id,
'file' => $file,
'title' => $meta['title'],
'date' => $date,
'user' => $meta['creator'],
'desc' => $meta['description']['abstract'],
'num' => $number,
'comments' => $this->td($id, $number),
'status' => $status,
'perm' => $perm,
'exists' => true,
'anchor' => 'discussion__section',
);
}
// finally sort by time of last comment
krsort($result);
if (is_numeric($num)) $result = array_slice($result, 0, $num);
return $result;
}
/**
* Returns an array of recently added comments to a given page or namespace
* Note: also used for content by Feed Plugin
*
* @param string $ns
* @param int|null $num
* @return array
*/
function getComments($ns, $num = NULL) {
global $conf;
$first = $_REQUEST['first'];
if (!is_numeric($first)) $first = 0;
if ((!$num) || (!is_numeric($num))) $num = $conf['recent'];
$result = array();
$count = 0;
if (!@file_exists($conf['metadir'].'/_comments.changes')) return $result;
// read all recent changes. (kept short)
$lines = file($conf['metadir'].'/_comments.changes');
$seen = array(); //caches seen pages in order to skip them
// handle lines
$line_num = count($lines);
for ($i = ($line_num - 1); $i >= 0; $i--) {
$rec = $this->_handleRecentComment($lines[$i], $ns, $seen);
if ($rec !== false) {
if (--$first >= 0) continue; // skip first entries
$result[$rec['date']] = $rec;
$count++;
// break when we have enough entries
if ($count >= $num) break;
}
}
// finally sort by time of last comment
krsort($result);
return $result;
}
/* ---------- Changelog function adapted for the Discussion Plugin ---------- */
/**
* Internal function used by $this->getComments()
*
* don't call directly
*
* @see getRecentComments()
* @author Andreas Gohr
* @author Ben Coburn
* @author Esther Brunner
*
* @param string $line
* @param string $ns
* @param array $seen
* @return array|bool
*/
function _handleRecentComment($line, $ns, &$seen) {
if (empty($line)) return false; //skip empty lines
// split the line into parts
$recent = parseChangelogLine($line);
if ($recent === false) return false;
$cid = $recent['extra'];
$fullcid = $recent['id'].'#'.$recent['extra'];
// skip seen ones
if (isset($seen[$fullcid])) return false;
// skip 'show comment' log entries
if ($recent['type'] === 'sc') return false;
// remember in seen to skip additional sights
$seen[$fullcid] = 1;
// check if it's a hidden page or comment
if (isHiddenPage($recent['id'])) return false;
if ($recent['type'] === 'hc') return false;
// filter namespace or id
if (($ns) && (strpos($recent['id'].':', $ns.':') !== 0)) return false;
// check ACL
$recent['perm'] = auth_quickaclcheck($recent['id']);
if ($recent['perm'] < AUTH_READ) return false;
// check existance
$recent['file'] = wikiFN($recent['id']);
$recent['exists'] = @file_exists($recent['file']);
if (!$recent['exists']) return false;
if ($recent['type'] === 'dc') return false;
// get discussion meta file name
$data = unserialize(io_readFile(metaFN($recent['id'], '.comments'), false));
// check if discussion is turned off
if ($data['status'] === 0) return false;
$parent_id = $cid;
// Check for the comment and all parents if they exist and are visible.
do {
$tcid = $parent_id;
// check if the comment still exists
if (!isset($data['comments'][$tcid])) return false;
// check if the comment is visible
if ($data['comments'][$tcid]['show'] != 1) return false;
$parent_id = $data['comments'][$tcid]['parent'];
} while ($parent_id && $parent_id != $tcid);
// okay, then add some additional info
if (is_array($data['comments'][$cid]['user'])) {
$recent['name'] = $data['comments'][$cid]['user']['name'];
} else {
$recent['name'] = $data['comments'][$cid]['name'];
}
$recent['desc'] = strip_tags($data['comments'][$cid]['xhtml']);
$recent['anchor'] = 'comment_'.$cid;
return $recent;
}
/**
* @return bool
*/
function isDiscussionMod() {
global $USERINFO;
$groups = trim($this->getConf('moderatorgroups'));
if(auth_ismanager()) return true;
// Check if user is member of the moderator groups
if(!empty($groups) && auth_isMember($groups, $_SERVER['REMOTE_USER'], (array)$USERINFO['grps'])) return true;
return false;
}
}
// vim:ts=4:sw=4:et:enc=utf-8: