lib/plugin/AllPages.php

   1 <?php // -*-php-*-
   2 rcs_id('$Id: AllPages.php,v 1.35 2004-12-06 19:50:04 rurban Exp $');
   3 /**
   4  Copyright 1999, 2000, 2001, 2002, 2004 $ThePhpWikiProgrammingTeam
   5
   6  This file is part of PhpWiki.
   7
   8  PhpWiki is free software; you can redistribute it and/or modify
   9  it under the terms of the GNU General Public License as published by
  10  the Free Software Foundation; either version 2 of the License, or
  11  (at your option) any later version.
  12
  13  PhpWiki is distributed in the hope that it will be useful,
  14  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  GNU General Public License for more details.
  17
  18  You should have received a copy of the GNU General Public License
  19  along with PhpWiki; if not, write to the Free Software
  20  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  */
  22
  23 require_once('lib/PageList.php');
  24
  25 /**
  26  * DONE: support author=[] (current user) and owner, creator
  27  * to be able to have pages:
  28  * AllPagesCreatedByMe, AllPagesOwnedByMe, AllPagesLastAuthoredByMe
  29  */
  30 class WikiPlugin_AllPages
  31 extends WikiPlugin
  32 {
  33     function getName () {
  34         return _("AllPages");
  35     }
  36
  37     function getDescription () {
  38         return _("List all pages in this wiki.");
  39     }
  40
  41     function getVersion() {
  42         return preg_replace("/[Revision: $]/", '',
  43                             "\$Revision: 1.35 $");
  44     }
  45
  46     function getDefaultArguments() {
  47         return array_merge
  48             (
  49              PageList::supportedArgs(),
  50              array(
  51                    'noheader'      => false,
  52                    'include_empty' => false,
  53                    //'pages'         => false, // DONT, this would be ListPages then.
  54                    'info'          => '',
  55                    'debug'         => false
  56                    ));
  57     }
  58
  59     // info arg allows multiple columns
  60     // info=mtime,hits,summary,version,author,locked,minor,markup or all
  61     // exclude arg allows multiple pagenames exclude=HomePage,RecentChanges
  62     // sortby: [+|-] pagename|mtime|hits
  63
  64     // 2004-07-08 22:05:35 rurban: turned off &$request to prevent from strange bug below
  65     function run($dbi, $argstr, $request, $basepage) {
  66         $args = $this->getArgs($argstr, $request);
  67         $pages = false;
  68         // Todo: extend given _GET args
  69         if ($args['debug'])
  70             $timer = new DebugTimer;
  71         $caption = _("All pages in this wiki (%d total):");
  72
  73         if ( !empty($args['owner']) ) {
  74             $pages = PageList::allPagesByOwner($args['owner'],$args['include_empty'],$args['sortby'],$args['limit']);
  75             if ($args['owner'])
  76                 $caption = fmt("List of pages owned by [%s] (%d total):",
  77                                WikiLink($args['owner'], 'if_known'),
  78                                count($pages));
  79         } elseif ( !empty($args['author']) ) {
  80             $pages = PageList::allPagesByAuthor($args['author'],$args['include_empty'],$args['sortby'],$args['limit']);
  81             if ($args['author'])
  82                 $caption = fmt("List of pages last edited by [%s] (%d total):",
  83                                WikiLink($args['author'], 'if_known'),
  84                                count($pages));
  85         } elseif ( !empty($args['creator']) ) {
  86             $pages = PageList::allPagesByCreator($args['creator'],$args['include_empty'],$args['sortby'],$args['limit']);
  87             if ($args['creator'])
  88                 $caption = fmt("List of pages created by [%s] (%d total):",
  89                                WikiLink($args['creator'], 'if_known'),
  90                                count($pages));
  91         //} elseif ($pages) {
  92         //    $args['count'] = count($pages);
  93         } else {
  94             if (! $request->getArg('count'))  $args['count'] = $dbi->numPages($args['include_empty'],$args['exclude']);
  95             else $args['count'] = $request->getArg('count');
  96         }
  97         if (empty($args['count']) and !empty($pages))
  98             $args['count'] = count($pages);
  99         $pagelist = new PageList($args['info'], $args['exclude'], $args);
 100         if (!$args['noheader']) $pagelist->setCaption($caption);
 101
 102         // deleted pages show up as version 0.
 103         if ($args['include_empty'])
 104             $pagelist->_addColumn('version');
 105
 106         if ($pages !== false)
 107             $pagelist->addPageList($pages);
 108         else
 109             $pagelist->addPages( $dbi->getAllPages($args['include_empty'], $args['sortby'], $args['limit']) );
 110         if ($args['debug']) {
 111             return HTML($pagelist,
 112                         HTML::p(fmt("Elapsed time: %s s", $timer->getStats())));
 113         } else {
 114             return $pagelist;
 115         }
 116     }
 117
 118     function getmicrotime(){
 119         list($usec, $sec) = explode(" ",microtime());
 120         return (float)$usec + (float)$sec;
 121     }
 122 };
 123
 124 // $Log: not supported by cvs2svn $
 125 // Revision 1.34  2004/11/23 15:17:19  rurban
 126 // better support for case_exact search (not caseexact for consistency),
 127 // plugin args simplification:
 128 //   handle and explode exclude and pages argument in WikiPlugin::getArgs
 129 //     and exclude in advance (at the sql level if possible)
 130 //   handle sortby and limit from request override in WikiPlugin::getArgs
 131 // ListSubpages: renamed pages to maxpages
 132 //
 133 // Revision 1.33  2004/11/01 10:43:59  rurban
 134 // seperate PassUser methods into seperate dir (memory usage)
 135 // fix WikiUser (old) overlarge data session
 136 // remove wikidb arg from various page class methods, use global ->_dbi instead
 137 // ...
 138 //
 139 // Revision 1.32  2004/10/05 17:00:04  rurban
 140 // support paging for simple lists
 141 // fix RatingDb sql backend.
 142 // remove pages from AllPages (this is ListPages then)
 143 //
 144 // Revision 1.31  2004/09/17 14:25:45  rurban
 145 // update comments
 146 //
 147 // Revision 1.30  2004/07/09 10:06:50  rurban
 148 // Use backend specific sortby and sortable_columns method, to be able to
 149 // select between native (Db backend) and custom (PageList) sorting.
 150 // Fixed PageList::AddPageList (missed the first)
 151 // Added the author/creator.. name to AllPagesBy...
 152 //   display no pages if none matched.
 153 // Improved dba and file sortby().
 154 // Use &$request reference
 155 //
 156 // Revision 1.29  2004/07/08 21:32:36  rurban
 157 // Prevent from more warnings, minor db and sort optimizations
 158 //
 159 // Revision 1.28  2004/07/08 20:30:07  rurban
 160 // plugin->run consistency: request as reference, added basepage.
 161 // encountered strange bug in AllPages (and the test) which destroys ->_dbi
 162 //
 163 // Revision 1.27  2004/07/08 17:31:43  rurban
 164 // improve numPages for file (fixing AllPagesTest)
 165 //
 166 // Revision 1.26  2004/06/21 16:22:32  rurban
 167 // add DEFAULT_DUMP_DIR and HTML_DUMP_DIR constants, for easier cmdline dumps,
 168 // fixed dumping buttons locally (images/buttons/),
 169 // support pages arg for dumphtml,
 170 // optional directory arg for dumpserial + dumphtml,
 171 // fix a AllPages warning,
 172 // show dump warnings/errors on DEBUG,
 173 // don't warn just ignore on wikilens pagelist columns, if not loaded.
 174 // RateIt pagelist column is called "rating", not "ratingwidget" (Dan?)
 175 //
 176 // Revision 1.25  2004/06/14 11:31:38  rurban
 177 // renamed global $Theme to $WikiTheme (gforge nameclash)
 178 // inherit PageList default options from PageList
 179 //   default sortby=pagename
 180 // use options in PageList_Selectable (limit, sortby, ...)
 181 // added action revert, with button at action=diff
 182 // added option regex to WikiAdminSearchReplace
 183 //
 184 // Revision 1.24  2004/06/13 16:02:12  rurban
 185 // empty list of pages if user=[] and not authenticated.
 186 //
 187 // Revision 1.23  2004/06/13 15:51:37  rurban
 188 // Support pagelist filter for current author,owner,creator by []
 189 //
 190 // Revision 1.22  2004/06/13 15:33:20  rurban
 191 // new support for arguments owner, author, creator in most relevant
 192 // PageList plugins. in WikiAdmin* via preSelectS()
 193 //
 194 // Revision 1.21  2004/04/20 00:06:53  rurban
 195 // paging support
 196 //
 197 // Revision 1.20  2004/02/22 23:20:33  rurban
 198 // fixed DumpHtmlToDir,
 199 // enhanced sortby handling in PageList
 200 //   new button_heading th style (enabled),
 201 // added sortby and limit support to the db backends and plugins
 202 //   for paging support (<<prev, next>> links on long lists)
 203 //
 204 // Revision 1.19  2004/02/17 12:11:36  rurban
 205 // added missing 4th basepage arg at plugin->run() to almost all plugins. This caused no harm so far, because it was silently dropped on normal usage. However on plugin internal ->run invocations it failed. (InterWikiSearch, IncludeSiteMap, ...)
 206 //
 207 // Revision 1.18  2004/01/25 07:58:30  rurban
 208 // PageList sortby support in PearDB and ADODB backends
 209 //
 210 // Revision 1.17  2003/02/27 20:10:30  dairiki
 211 // Disable profiling output when DEBUG is defined but false.
 212 //
 213 // Revision 1.16  2003/02/21 04:08:26  dairiki
 214 // New class DebugTimer in prepend.php to help report timing.
 215 //
 216 // Revision 1.15  2003/01/18 21:19:25  carstenklapp
 217 // Code cleanup:
 218 // Reformatting; added copyleft, getVersion, getDescription
 219 //
 220
 221 // Local Variables:
 222 // mode: php
 223 // tab-width: 8
 224 // c-basic-offset: 4
 225 // c-hanging-comment-ender-p: nil
 226 // indent-tabs-mode: nil
 227 // End:
 228 ?>