lib/plugin/WikiAdminUtils.php

   1 <?php // -*-php-*-
   2 rcs_id('$Id: WikiAdminUtils.php,v 1.6 2004-03-12 13:31:43 rurban Exp $');
   3 /**
   4  Copyright 2003 $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 /**
  24  */
  25 class WikiPlugin_WikiAdminUtils
  26 extends WikiPlugin
  27 {
  28     function getName () {
  29         return _("WikiAdminUtils");
  30     }
  31
  32     function getDescription () {
  33         return _("Miscellaneous utility functions of use to the administrator.");
  34     }
  35
  36     function getVersion() {
  37         return preg_replace("/[Revision: $]/", '',
  38                             "\$Revision: 1.6 $");
  39     }
  40
  41     function getDefaultArguments() {
  42         return array('action'           => '',
  43                      'label'            => '',
  44                      );
  45     }
  46
  47     function run($dbi, $argstr, &$request, $basepage) {
  48         $args = $this->getArgs($argstr, $request);
  49         $args['action'] = strtolower($args['action']);
  50         extract($args);
  51
  52         if (!$action)
  53             $this->error("No action specified");
  54         if (!($default_label = $this->_getLabel($action)))
  55             $this->error("Bad action");
  56         if ($request->getArg('action') != 'browse')
  57             return $this->disabled("(action != 'browse')");
  58
  59         $posted = $request->getArg('wikiadminutils');
  60         $request->setArg('wikiadminutils', false);
  61
  62         if ($request->isPost()) {
  63             $user = $request->getUser();
  64             if (!$user->isAdmin()) {
  65                 $request->_notAuthorized(WIKIAUTH_ADMIN);
  66                 return $this->error(_("You must be an administrator to use this plugin."));
  67             }
  68             return $this->do_action($request, $posted);
  69         }
  70
  71         if (empty($label))
  72             $label = $default_label;
  73
  74         return $this->_makeButton($request, $args, $label);
  75     }
  76
  77     function _makeButton(&$request, $args, $label) {
  78         $args['return_url'] = $request->getURLtoSelf();
  79         return HTML::form(array('action' => $request->getPostURL(),
  80                                 'method' => 'post'),
  81                           HTML::p(Button('submit:', $label, 'wikiadmin')),
  82                           HiddenInputs($args, 'wikiadminutils'),
  83                           HiddenInputs(array('require_authority_for_post' =>
  84                                              WIKIAUTH_ADMIN)),
  85                           HiddenInputs($request->getArgs()));
  86     }
  87
  88     function do_action(&$request, $args) {
  89         $method = '_do_' . str_replace('-', '_', $args['action']);
  90         if (!method_exists($this, $method))
  91             return $this->error("Bad action");
  92
  93         $message = call_user_func(array(&$this, $method), $request, $args);
  94
  95         $alert = new Alert(_("WikiAdminUtils says:"),
  96                            $message,
  97                            array(_("Okay") => $args['return_url']));
  98
  99         $alert->show();         // noreturn
 100     }
 101
 102     function _getLabel($action) {
 103         $labels = array('purge-cache' => _("Purge Markup Cache"),
 104                         'purge-bad-pagenames' => _("Delete Pages With Invalid Names"));
 105         return @$labels[$action];
 106     }
 107
 108     function _do_purge_cache(&$request, $args) {
 109         $dbi = $request->getDbh();
 110         $pages = $dbi->getAllPages('include_empty'); // Do we really want the empty ones too?
 111         while (($page = $pages->next())) {
 112             $page->set('_cached_html', false);
 113         }
 114         return _("Markup cache purged!");
 115     }
 116
 117     function _do_purge_bad_pagenames(&$request, $args) {
 118         // FIXME: this should be moved into WikiDB::normalize() or something...
 119         $dbi = $request->getDbh();
 120         $pages = $dbi->getAllPages('include_empty'); // Do we really want the empty ones too?
 121         $badpages = array();
 122         while (($page = $pages->next())) {
 123             $pagename = $page->getName();
 124             $wpn = new WikiPageName($pagename);
 125             if (! $wpn->isValid())
 126                 $badpages[] = $pagename;
 127         }
 128
 129         if (!$badpages)
 130             return _("No pages with bad names were found.");
 131
 132         $list = HTML::ul();
 133         foreach ($badpages as $pagename) {
 134             $dbi->deletePage($pagename);
 135             $list->pushContent(HTML::li($pagename));
 136         }
 137
 138         return HTML(fmt("Deleted %s pages with invalid names:",
 139                         count($badpages)),
 140                     $list);
 141     }
 142 };
 143
 144 // For emacs users
 145 // Local Variables:
 146 // mode: php
 147 // tab-width: 8
 148 // c-basic-offset: 4
 149 // c-hanging-comment-ender-p: nil
 150 // indent-tabs-mode: nil
 151 // End:
 152 ?>