xref: /plugin/discussion/helper.php (revision 5fc512fb4e57f6c46a139cbe38495abc4108b731)

<?php
/**
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Esther Brunner <wikidesign@gmail.com>
 */

// must be run within Dokuwiki
if (!defined('DOKU_INC')) die();

if (!defined('DOKU_LF')) define('DOKU_LF', "\n");
if (!defined('DOKU_TAB')) define('DOKU_TAB', "\t");

class helper_plugin_discussion extends DokuWiki_Plugin {

  function getInfo(){
    return array(
      'author' => 'Esther Brunner',
      'email'  => 'wikidesign@gmail.com',
      'date'   => '2006-12-10',
      'name'   => 'Discussion Plugin (helper class)',
      'desc'   => 'Functions to get info about comments to a wiki page',
      'url'    => 'http://www.wikidesign/en/plugin/discussion/start',
    );
  }

  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
   */
  function th(){
    return $this->getLang('discussion');
  }

  /**
   * Returns the link to the discussion section of a page
   */
  function td($id, $num = NULL){
    $discuss = $id.'#'.cleanID($this->getLang('discussion'));

    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('comments');
    elseif ($num == 1) $comment = '1 '.$this->getLang('comment');
    else $comment = $num.' '.$this->getLang('comments');

    return '<a href="'.wl($discuss).'" class="wikilink1" title="'.$discuss.'">'.
      $comment.'</a>';
  }

  /**
   * Returns an array of pages with discussion sections, sorted by recent comments
   */
  function getThreads($ns, $num = NULL){
    global $conf;

    require_once(DOKU_INC.'inc/search.php');

    $dir = $conf['datadir'].($ns ? '/'.str_replace(':', '/', $ns): '');

    // returns the list of pages in the given namespace and it's subspaces
    $items = array();
    search($items, $dir, 'search_allpages', '');

    // 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));
      $num = $data['number']; // skip if comments are off or closed without comments
      if ((!$data['status']) || (($data['status'] == 2) && (!$num))) continue;

      $date = filemtime($file);
      $meta = p_get_metadata($id);
      $result[$date] = array(
        'id'       => $id,
        'title'    => $meta['title'],
        'date'     => $date,
        'user'     => $meta['creator'],
        'desc'     => $meta['description']['abstract'],
        'num'      => $num,
        'comments' => $this->td($id, $num),
        'perm'     => $perm,
        'exists'   => true,
      );
    }

    // 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
   */
  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');

    // handle lines
    for ($i = count($lines)-1; $i >= 0; $i--){
      $rec = _handleRecentComment($lines[$i], $ns);
      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 <andi@splitbrain.org>
   * @author Ben Coburn <btcoburn@silicodon.net>
   * @author Esther Brunner <wikidesign@gmail.com>
   */
  function _handleRecentComment($line, $ns){
    static $seen  = array();         //caches seen pages and skip them
    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($ID, '.comments'), false));

    // check if discussion is turned off
    if ($data['status'] === 0) return false;

    // okay, then add some additional info
    $recent['name'] = $data['comments'][$cid]['name'];
    $recent['desc'] = strip_tags($data['comments'][$cid]['xhtml']);

    return $recent;
  }

}

//Setup VIM: ex: et ts=4 enc=utf-8 :