You use pagelist for listing a list of pages. You need an array which has rows with at least the 'id' entry set.

You can add your own column(s) as well. Below two manners are explained.

(Prefered approach) You can use pagelist plugin in your plugin. With addColumn() you can (optional) add your own column as well. The data for that column is here provided via addPage() and setHeader().

example/syntax/component.php

...
$flags = ['header']; //show table header
$header = [
    'yourcolumn' => 'Your Column'
];
$pages = [
    ['id' => 'firstpage', 'yourcolumn' => 'Text 1'],
    ['id' => 'secondpage', 'yourcolumn' => 'Text 2'],
    ['id' => '3rd', 'yourcolumn' => '<em>3&amp;4</em> with user input escaping'],
];
if($pagelist = $this->loadHelper('pagelist')) {
    $pagelist->addColumn('example', 'yourcolumn');
    $pagelist->setHeader($header); //available since 2022-10-17
    $pagelist->setFlags($flags);
    $pagelist->startList('plugin_example_class');
    foreach($pages as $page) {
        $pagelist->addPage($page);
    }
    $renderer->doc .= $pagelist->finishList();
}
...

(Alternative approach) If data for the extra column is not provided before, the pagelist will request it from the th() and td() provided in helper.php of your plugin. Often this approach needs temporary storing of the data, which makes it less performant.

example/helper.php

<?php
class helper_plugin_example extends DokuWiki_Plugin {
    /**
     * Returns the column header text for the Pagelist Plugin
     * 
     * @param string $column column name as set in addColumn()
     * @param string $class by reference, class set to td of the table. Replaces that default the column name is set as class 
     * @return string text, escaped by Pagelist plugin
     */
    public function th($column=null, &$class = null) {
        if($column == 'yourcolumn') {
            $content = 'Your Column';
        } else {
            $content = $this->getLang('othercolumn');
        }
    }
    //eventually also possible, if you have only one column and not a css class per cell:
    public function th() {
        return $this->getLang('yourcolumn');
    }
 
    /**
     * Returns the cell data for the Pagelist Plugin
     *
     * @param string $id page id
     * @param string $column column name as set in addColumn()
     * @param string $class by reference, class set to td of the table. Replaces that default the column name is set as class 
     * @return string escaped html content for cell of table
     */
    public function td($id, $column=null, &$class = null) {
        $class .= 'special';
        if($column == 'yourcolumn') {
            $content = '...';
        } else {
            $content = '...';
        }
        return hsc($content);
    }
    //eventually also possible, if you have only one column and not a class per cell::
    public function td($id) {
        $content = '...';
        return hsc($content);
    }
}

• (optional) addColumn($plugin, $column) add $column to the table.
  Gets data via addPage()/setHeader() or uses helper from plugin name $plugin for displaying:
  • cells of the page row with td($id, $column=null, &$class = null)
  • cells of the header row with th($column=null, &$class = null).
• (optional) modifyColumn($column, $value) overwrites $column value, set to false to disable.
• (optional) setFlags($flags) with $flags an array with flags as strings. Call this function after addColumn().
  • Next to the default flags, the extra flag defaultsortby=<property> can be used to set a sortby-preference without already enabling the sort.
• (optional) setHeader($header) with $header having html entries per column, if not given default pagelist values or plugin->th() are used. You have to escape user input with hsc().
• (required) startList($class = null) starts a list or table, if enabled it prints also the header. $class can add a table class.
• (required), per row addPage($page) with associated array $page with per column an entry. For your own columns you must provide the html, you have to escape user input.
  • 'id' ⇒ string page id (required)
  • 'title' ⇒ string First headline, otherwise page id; exception: if titleimage is used this is used for the image title&alt attribute
  • 'titleimage' ⇒ string media id
  • 'date' ⇒ int timestamp of creation date, otherwise modification date (e.g. sometimes needed for plugin)
  • 'user' ⇒ string $meta['creator']
  • 'desc' ⇒ string $meta['description']['abstract']
  • 'description' ⇒ string description set via pagelist syntax
  • 'symmary' ⇒ string summary of the last change of the page $meta['last_change']['sum']
  • 'exists' ⇒ bool page_exists($id)
  • 'perm' ⇒ int auth_quickaclcheck($id)
  • 'draft' ⇒ string $meta['type'] set by blog plugin
  • 'priority' ⇒ string priority of task: 'low', 'medium', 'high', 'critical'
  • 'class' ⇒ string class set for each row
  • 'file' ⇒ string wikiFN($id)
  • 'section' ⇒ string id of section, added as #ancher to page url
• (required) finishList() closes a list or table, returns the html

If you add you own column for your plugin, it is recommended to add via addPage() the html for each cell of the column. Alternatively, you must implement a helper.php with th() and td().

• for each row, the $column is filled with td($id, $column=null, &$class = null) (escape user input with hsc())
• in the header the $column is filled with th($column=null, &$class = null) (escaping done by pagelist).

For further documentation of the arguments see PHPDocs of the source code.

Some notes used for the cleanup of the Pagelist plugin (September 2022).