lib/plugin/UserPreferences.php

   1 <?php // -*-php-*-
   2 rcs_id('$Id: UserPreferences.php,v 1.18 2004-02-24 15:20:06 rurban Exp $');
   3 /**
   4  Copyright 2001, 2002, 2003, 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 /**
  24  * Plugin to allow any user to adjust his own preferences.
  25  * This must be used in the page "UserPreferences".
  26  * Prefs are stored in metadata within the user's home page or in a cookie.
  27  */
  28 class WikiPlugin_UserPreferences
  29 extends WikiPlugin
  30 {
  31     var $bool_args;
  32
  33     function getName () {
  34         return _("UserPreferences");
  35     }
  36
  37     function getVersion() {
  38         return preg_replace("/[Revision: $]/", '',
  39                             "\$Revision: 1.18 $");
  40     }
  41
  42     function getDefaultArguments() {
  43         global $request;
  44         $pagename = $request->getArg('pagename');
  45         $user = $request->getUser();
  46         //we need a hash of pref => default_value
  47         $pref = $user->getPreferences();
  48         $prefs = array();
  49         foreach ($pref->_prefs as $name => $obj) {
  50             $prefs[$name] = $obj->default_value;
  51         }
  52         return $prefs;
  53     }
  54
  55     function run($dbi, $argstr, &$request, $basepage) {
  56         $args = $this->getArgs($argstr, $request);
  57         $user = &$request->getUser();
  58         if (! $request->isActionPage($request->getArg('pagename'))) {
  59             $no_args = $this->getDefaultArguments();
  60 // ?
  61 //            foreach ($no_args as $key => $value) {
  62 //                $no_args[$value] = false;
  63 //            }
  64             $no_args['errmsg'] = HTML(HTML::h2(_("Error: The user HomePage must be a valid WikiWord. Sorry, UserPreferences cannot be saved."),HTML::hr()));
  65             $no_args['isForm'] = false;
  66             return Template('userprefs', $no_args);
  67         }
  68         $userid = $user->UserName();
  69         if (((defined('ALLOW_BOGO_LOGIN') && ALLOW_BOGO_LOGIN && $user->isSignedIn())
  70              || $user->isAuthenticated())
  71             && !empty($userid)) {
  72             $pref = $user->getPreferences();
  73             //trigger_error("DEBUG: reading prefs from getPreferences".print_r($pref));
  74
  75             if ($request->isPost()) {
  76                 if ($rp = $request->getArg('pref')) {
  77                     // replace only changed prefs in $pref with those from request
  78                     if (!empty($rp['passwd']) and ($rp['passwd2'] != $rp['passwd'])) {
  79                         $errmsg = _("Wrong password. Try again.");
  80                     } else {
  81                         //trigger_error("DEBUG: reading prefs from request".print_r($rp));
  82                         //trigger_error("DEBUG: writing prefs with setPreferences".print_r($pref));
  83                         $num = $user->setPreferences($rp);
  84                         if (!$num) {
  85                             $errmsg = _("No changes.");
  86                         }
  87                         else {
  88                             $pref = $user->_prefs;
  89                             $errmsg = fmt("%d UserPreferences fields successfully updated.", $num);
  90                         }
  91                     }
  92                     $args['errmsg'] = HTML(HTML::h2($errmsg), HTML::hr());
  93                 }
  94             }
  95             $available_themes = array();
  96             $dir_root = 'themes/';
  97             if (defined('PHPWIKI_DIR'))
  98                 $dir_root = PHPWIKI_DIR . "/$dir_root";
  99             $dir = dir($dir_root);
 100             if ($dir) {
 101                 while($entry = $dir->read()) {
 102                     if (is_dir($dir_root.$entry)
 103                         && (substr($entry,0,1) != '.')
 104                         && $entry != 'CVS') {
 105                         array_push($available_themes, $entry);
 106                     }
 107                 }
 108                 $dir->close();
 109             }
 110             $args['available_themes'] = $available_themes;
 111
 112             $available_languages = array('en');
 113             $dir_root = 'locale/';
 114             if (defined('PHPWIKI_DIR'))
 115                 $dir_root = PHPWIKI_DIR . "/$dir_root";
 116             $dir = dir($dir_root);
 117             if ($dir) {
 118                 while($entry = $dir->read()) {
 119                     if (is_dir($dir_root.$entry)
 120                         && (substr($entry,0,1) != '.')
 121                         && $entry != 'po'
 122                         && $entry != 'CVS') {
 123                         array_push($available_languages, $entry);
 124                     }
 125                 }
 126                 $dir->close();
 127             }
 128             $args['available_languages'] = $available_languages;
 129
 130             return Template('userprefs', $args);
 131         }
 132         else {
 133             // wrong or unauthenticated user
 134             return $user->PrintLoginForm ($request, $args, false, false);
 135         }
 136     }
 137 };
 138
 139 // $Log: not supported by cvs2svn $
 140 // Revision 1.17  2004/02/17 12:11:36  rurban
 141 // 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, ...)
 142 //
 143 // Revision 1.16  2004/02/15 21:34:37  rurban
 144 // PageList enhanced and improved.
 145 // fixed new WikiAdmin... plugins
 146 // editpage, Theme with exp. htmlarea framework
 147 //   (htmlarea yet committed, this is really questionable)
 148 // WikiUser... code with better session handling for prefs
 149 // enhanced UserPreferences (again)
 150 // RecentChanges for show_deleted: how should pages be deleted then?
 151 //
 152 // Revision 1.15  2004/01/27 22:37:50  rurban
 153 // fixed default args: no objects
 154 //
 155 // Revision 1.14  2004/01/26 09:18:00  rurban
 156 // * changed stored pref representation as before.
 157 //   the array of objects is 1) bigger and 2)
 158 //   less portable. If we would import packed pref
 159 //   objects and the object definition was changed, PHP would fail.
 160 //   This doesn't happen with an simple array of non-default values.
 161 // * use $prefs->retrieve and $prefs->store methods, where retrieve
 162 //   understands the interim format of array of objects also.
 163 // * simplified $prefs->get() and fixed $prefs->set()
 164 // * added $user->_userid and class '_WikiUser' portability functions
 165 // * fixed $user object ->_level upgrading, mostly using sessions.
 166 //   this fixes yesterdays problems with loosing authorization level.
 167 // * fixed WikiUserNew::checkPass to return the _level
 168 // * fixed WikiUserNew::isSignedIn
 169 // * added explodePageList to class PageList, support sortby arg
 170 // * fixed UserPreferences for WikiUserNew
 171 // * fixed WikiPlugin for empty defaults array
 172 // * UnfoldSubpages: added pagename arg, renamed pages arg,
 173 //   removed sort arg, support sortby arg
 174 //
 175 // Revision 1.13  2003/12/04 20:27:00  carstenklapp
 176 // Use the API.
 177 //
 178 // Revision 1.12  2003/12/01 22:21:33  carstenklapp
 179 // Bugfix: UserPreferences are no longer clobbered when signing in after
 180 // the previous session has ended (i.e. user closed browser then signed
 181 // in again). This is still a bit of a mess, and the preferences do not
 182 // take effect until the next page browse/link has been clicked.
 183 //
 184 // Revision 1.11  2003/09/19 22:01:19  carstenklapp
 185 // BOGO users allowed preferences too when ALLOW_BOGO_LOGIN == true.
 186 //
 187 // Revision 1.10  2003/09/13 21:57:26  carstenklapp
 188 // Reformatting only.
 189 //
 190 // Revision 1.9  2003/09/13 21:53:41  carstenklapp
 191 // Added lang and theme arguments, getVersion(), copyright and cvs log.
 192 //
 193
 194 // For emacs users
 195 // Local Variables:
 196 // mode: php
 197 // tab-width: 8
 198 // c-basic-offset: 4
 199 // c-hanging-comment-ender-p: nil
 200 // indent-tabs-mode: nil
 201 // End:
 202 ?>