Pagelist Plugin

The Pagelist Plugin does – as its name says – list wiki pages in a nice way. Besides its function as a stand-alone syntax plugin, it serves as helper plugin for the Blog, Discussion, Editor, Tag, Task and Dir plugins.

Just wrap a regular unordered list of internal links with the <pagelist> tag:

<pagelist&[flags]>
  * [[..:blog:|Blog Plugin]]
  * [[..:discussion:|Discussion Plugin]]
  * [[..:editor:|Editor Plugin]]
  * [[..:tag:|Tag Plugin]]
</pagelist>

<pagelist&header&comments>
...
</pagelist>

This will show a list of pages with a header line and a comments column (if the Discussion Plugin is installed).

The plugin can be configured using the DokuWiki configuration manager available in the admin menu. The settings also apply to plugins which use the helper component of the pagelist plugin, like for example the archive component of the blog plugin.

You can easily use the functionality of the Pagelist Plugin in your own plugins. Here is a basic code snippet:

  $pages = array(
    array('id' => 'wiki:dokuwiki'),
    array('id' => 'wiki:syntax'),
  );
  $pagelist =& plugin_load('helper', 'pagelist');
  if (!$pagelist) return false; // failed to load plugin
  $pagelist->startList();
  foreach ($pages as $page){
    $pagelist->addPage($page);
  }
  $renderer->doc .= $pagelist->finishList();

You can try this plugin here.

Please report bugs at the Bug tracker.

• Darcs Repository
• Bug tracker
• Source code

• 05 Jan 15:30 - fix for FS#81
• 08 Aug 17:05 - fixed typo in helper.php
• 08 Aug 16:58 - TAG 2008-08-08 release
• 08 Aug 16:58 - added showfirsthl flag
• 28 Jun 18:44 - fixed vim modeline
• 07 Jun 21:07 - fixed code style
• 07 Jun 17:17 - fixed indentation and code style
• 12 Apr 18:35 - TAG release 2008-04-12

Here are some minor CSS enhancements (use fullwidth and avoid justification of pagenames like “Minutes 2008-05-05”). I'm too lazy to submit a bug report.

--- style.css	2008-04-12 20:36:37.000000000 +0200
+++ style.css.neu	2008-05-21 20:03:49.000000000 +0200
@@ -5,6 +5,8 @@
   border-spacing: 0;
   margin-bottom: 1em;
   border-collapse: collapse;
+  text-align: left;
+  width: 100%;
 }
 
 div.dokuwiki table.pagelist tr {
@@ -14,7 +16,7 @@
 
 div.dokuwiki table.pagelist th,
 div.dokuwiki table.pagelist td {
-  padding: 1px 1em 1px 0;
+  padding: 1px 1em 1px 10px;
 }
 
 div.dokuwiki table.ul th,
@@ -50,4 +52,4 @@
 
 div.dokuwiki td.date {
   text-align: right;
-}
\ Kein Zeilenumbruch am Dateiende.
+}

Do'h, what if I am to lazy to add this patch, huh? — Michael Klier 2008/05/24 18:03

Is it correct that I need to comment out the renderer if I want to prevent a “create this page” under the commentlist? ¹⁾

            // show form to start a new discussion thread?
            if ($perm_create && ($this->getConf('threads_formposition') == 'bottom'))
//                $renderer->doc .= $this->_newThreadForm($ns);
            return true;

I have the discussion plugin installed, and want to show a page with available discussions, so

{{threads>*}}
~~DISCUSSION:off~~

should do the trick, but I get both the “create this page” and a discussion form below. The “create new page” can be suppressed in this very un-gently way shown above, but there is no way yet for disabling the discussion form.

Suggestions for “nicer fixes” are welcome, since I don't like hacking like this.

I've never used the pagelist flags until today, but I just ran into this error when using the 'tags' flag:

Call to a member function td() on a non-object in /var/www/wiki/lib/plugins/pagelist/helper.php on line 330

I do have the tags plugin… Juice 2008-08-15

Please submit a bug report at the bug tracker listed on this page! Thanks! — Michael Klier 2008/08/15 20:37

Hi, I have tried to install this plugin via both plugin manager and manually but, when I try to write a Pagelist in a page using the default view, I cannot see any line between each entry and, in Firefox, it even screws the layout of the section where the pagalist is, inserting a TAB-like space before each entry (this layout screwing part does not occur using Internet Explorer). I can provide an example page on my site if necessary. I am using the sidebar template. Thanks.

Example please . — Michael Klier 2008/10/08 13:04

Thanks for the reply. I have corrected my question. The lines suddenly appeared after cleaning the cache, so I think this was the cause of the first problem. Now I am stuck with the other problem which I re-report: in Firefox it screws the layout of the section where the pagalist is, inserting a TAB-like space before each entry (this layout screwing part does not occur using Internet Explorer). Here is an example page: http://universiruler.altervista.org/wiki/doku.php?id=test_page