2 rcs_id('$Id: WikiUser.php,v 1.60 2004-06-15 09:15:52 rurban Exp $');
4 // It is anticipated that when userid support is added to phpwiki,
5 // this object will hold much more information (e-mail,
6 // home(wiki)page, etc.) about the user.
8 // There seems to be no clean way to "log out" a user when using HTTP
9 // authentication. So we'll hack around this by storing the currently
10 // logged in username and other state information in a cookie.
12 // 2002-09-08 11:44:04 rurban
13 // Todo: Fix prefs cookie/session handling:
14 // _userid and _homepage cookie/session vars still hold the
16 // If no homepage, fallback to prefs in cookie as in 1.3.3.
18 define('WIKIAUTH_FORBIDDEN', -1); // Completely not allowed.
19 define('WIKIAUTH_ANON', 0);
20 define('WIKIAUTH_BOGO', 1); // any valid WikiWord is enough
21 define('WIKIAUTH_USER', 2); // real auth from a database/file/server.
23 define('WIKIAUTH_ADMIN', 10); // Wiki Admin
24 define('WIKIAUTH_UNOBTAINABLE', 100); // Permissions that no user can achieve
26 if (!defined('COOKIE_EXPIRATION_DAYS')) define('COOKIE_EXPIRATION_DAYS', 365);
27 if (!defined('COOKIE_DOMAIN')) define('COOKIE_DOMAIN', '/');
29 $UserPreferences = array(
30 'userid' => new _UserPreference(''), // really store this also?
31 'passwd' => new _UserPreference(''),
32 'email' => new _UserPreference(''),
33 'emailVerified' => new _UserPreference_bool(),
34 'notifyPages' => new _UserPreference(''),
35 'theme' => new _UserPreference_theme(THEME),
36 'lang' => new _UserPreference_language(DEFAULT_LANGUAGE),
37 'editWidth' => new _UserPreference_int(80, 30, 150),
38 'noLinkIcons' => new _UserPreference_bool(),
39 'editHeight' => new _UserPreference_int(22, 5, 80),
40 'timeOffset' => new _UserPreference_numeric(0, -26, 26),
41 'relativeDates' => new _UserPreference_bool(),
42 'googleLink' => new _UserPreference_bool(), // 1.3.10
45 function WikiUserClassname() {
49 function UpgradeUser ($olduser, $user) {
50 if (isa($user,'WikiUser') and isa($olduser,'WikiUser')) {
51 // populate the upgraded class with the values from the old object
52 foreach (get_object_vars($olduser) as $k => $v) {
55 $GLOBALS['request']->_user = $user;
68 var $_request, $_dbi, $_authdbi, $_homepage;
69 var $_authmethod = '', $_authhow = '';
74 * Populates the instance variables and calls $this->_ok()
75 * to ensure that the parameters are valid.
76 * @param mixed $userid String of username or WikiUser object.
77 * @param integer $authlevel Authorization level.
79 function WikiUser (&$request, $userid = false, $authlevel = false) {
80 $this->_request = &$request;
81 $this->_dbi = &$this->_request->getDbh();
83 if (isa($userid, 'WikiUser')) {
84 $this->_userid = $userid->_userid;
85 $this->_level = $userid->_level;
88 $this->_userid = $userid;
89 $this->_level = $authlevel;
92 // Paranoia: if state is at all inconsistent, log out...
93 $this->_userid = false;
94 $this->_level = false;
95 $this->_homepage = false;
96 $this->_authhow .= ' paranoia logout';
99 $this->_homepage = $this->_dbi->getPage($this->_userid);
104 * Get the string indicating how the user was authenticated.
106 * Get the string indicating how the user was authenticated.
107 * Does not seem to be set - jbw
108 * @return string The method of authentication.
110 function auth_how() {
111 return $this->_authhow;
117 * If the WikiUser object has a valid authorization level and the
118 * userid is a string returns true, else false.
119 * @return boolean If valid level and username string true, else false
122 if ((in_array($this->_level, array(WIKIAUTH_BOGO,
126 (is_string($this->_userid)))) {
132 function UserName() {
133 return $this->_userid;
137 return ( $this->isSignedIn()
139 : $this->_request->get('REMOTE_ADDR') ); // FIXME: globals
142 function getAuthenticatedId() {
143 return ( $this->isAuthenticated()
145 : $this->_request->get('REMOTE_ADDR') ); // FIXME: globals
148 function isSignedIn () {
149 return $this->_level >= WIKIAUTH_BOGO;
152 function isAuthenticated () {
153 return $this->_level >= WIKIAUTH_BOGO;
156 function isAdmin () {
157 return $this->_level == WIKIAUTH_ADMIN;
160 function hasAuthority ($require_level) {
161 return $this->_level >= $require_level;
164 function isValidName ($userid = false) {
166 $userid = $this->_userid;
167 return preg_match("/^[\w\.@\-]+$/",$userid) and strlen($userid) < 32;
170 function AuthCheck ($postargs) {
171 // Normalize args, and extract.
172 $keys = array('userid', 'passwd', 'require_level', 'login', 'logout',
174 foreach ($keys as $key)
175 $args[$key] = isset($postargs[$key]) ? $postargs[$key] : false;
177 $require_level = max(0, min(WIKIAUTH_ADMIN, (int)$require_level));
180 return new WikiUser($this->_request); // Log out
182 return false; // User hit cancel button.
183 elseif (!$login && !$userid)
184 return false; // Nothing to do?
186 if (!$this->isValidName($userid))
187 return _("Invalid username.");
189 $authlevel = $this->_pwcheck($userid, $passwd);
191 return _("Invalid password or userid.");
192 elseif ($authlevel < $require_level)
193 return _("Insufficient permissions.");
196 $user = new WikiUser($this->_request,$userid,$authlevel);
200 function PrintLoginForm (&$request, $args, $fail_message = false,
201 $seperate_page = true) {
202 include_once('lib/Template.php');
203 // Call update_locale in case the system's default language is not 'en'.
204 // (We have no user pref for lang at this point yet, no one is logged in.)
205 update_locale(DEFAULT_LANGUAGE);
208 extract($args); // fixme
210 $require_level = max(0, min(WIKIAUTH_ADMIN, (int)$require_level));
212 $pagename = $request->getArg('pagename');
213 $login = new Template('login', $request,
214 compact('pagename', 'userid', 'require_level',
215 'fail_message', 'pass_required'));
216 if ($seperate_page) {
217 $page = $request->getPage($pagename);
218 $revision = $page->getCurrentRevision();
219 return GeneratePage($login,_("Sign In"),$revision);
228 function _pwcheck ($userid, $passwd) {
229 global $WikiNameRegexp;
231 if (!empty($userid) && $userid == ADMIN_USER) {
232 // $this->_authmethod = 'pagedata';
233 if (defined('ENCRYPTED_PASSWD') && ENCRYPTED_PASSWD)
235 && crypt($passwd, ADMIN_PASSWD) == ADMIN_PASSWD )
236 return WIKIAUTH_ADMIN;
239 if (!empty($passwd)) {
240 if ($passwd == ADMIN_PASSWD)
241 return WIKIAUTH_ADMIN;
243 // maybe we forgot to enable ENCRYPTED_PASSWD?
244 if ( function_exists('crypt')
245 && crypt($passwd, ADMIN_PASSWD) == ADMIN_PASSWD ) {
246 trigger_error(_("You forgot to set ENCRYPTED_PASSWD to true. Please update your config/config.ini"),
248 return WIKIAUTH_ADMIN;
254 // HTTP Authentication
255 elseif (ALLOW_HTTP_AUTH_LOGIN && !empty($PHP_AUTH_USER)) {
256 // if he ignored the password field, because he is already
257 // authenticated try the previously given password.
259 $passwd = $PHP_AUTH_PW;
262 // WikiDB_User DB/File Authentication from $DBAuthParams
263 // Check if we have the user. If not try other methods.
264 if (ALLOW_USER_LOGIN) { // && !empty($passwd)) {
265 if (!$this->isValidName($userid)) {
266 trigger_error(_("Invalid username."), E_USER_WARNING);
269 $request = $this->_request;
270 // first check if the user is known
271 if ($this->exists($userid)) {
272 $this->_authmethod = 'pagedata';
273 return ($this->checkPassword($passwd)) ? WIKIAUTH_USER : false;
275 // else try others such as LDAP authentication:
276 if (ALLOW_LDAP_LOGIN && defined(LDAP_AUTH_HOST) && !empty($passwd) && !strstr($userid,'*')) {
277 if ($ldap = ldap_connect(LDAP_AUTH_HOST)) { // must be a valid LDAP server!
278 $r = @ldap_bind($ldap); // this is an anonymous bind
279 $st_search = "uid=$userid";
280 // Need to set the right root search information. see ../index.php
281 $sr = ldap_search($ldap, LDAP_BASE_DN,
283 $info = ldap_get_entries($ldap, $sr); // there may be more hits with this userid. try every
284 for ($i = 0; $i < $info["count"]; $i++) {
285 $dn = $info[$i]["dn"];
286 // The password is still plain text.
287 if ($r = @ldap_bind($ldap, $dn, $passwd)) {
288 // ldap_bind will return TRUE if everything matches
290 $this->_authmethod = 'LDAP';
291 return WIKIAUTH_USER;
295 trigger_error("Unable to connect to LDAP server "
296 . LDAP_AUTH_HOST, E_USER_WARNING);
299 // imap authentication. added by limako
300 if (ALLOW_IMAP_LOGIN && !empty($passwd)) {
301 $mbox = @imap_open( "{" . IMAP_AUTH_HOST . "}INBOX",
302 $userid, $passwd, OP_HALFOPEN );
305 $this->_authmethod = 'IMAP';
306 return WIKIAUTH_USER;
311 if ( ALLOW_BOGO_LOGIN
312 && preg_match('/\A' . $WikiNameRegexp . '\z/', $userid) ) {
313 $this->_authmethod = 'BOGO';
314 return WIKIAUTH_BOGO;
319 // Todo: try our WikiDB backends.
320 function getPreferences() {
321 // Restore saved preferences.
323 // I'd rather prefer only to store the UserId in the cookie or
324 // session, and get the preferences from the db or page.
325 if (!($prefs = $this->_request->getCookieVar('WIKI_PREFS2')))
326 $prefs = $this->_request->getSessionVar('wiki_prefs');
328 //if (!$this->_userid && !empty($GLOBALS['HTTP_COOKIE_VARS']['WIKI_ID'])) {
329 // $this->_userid = $GLOBALS['HTTP_COOKIE_VARS']['WIKI_ID'];
332 // before we get his prefs we should check if he is signed in
333 if (USE_PREFS_IN_PAGE && $this->homePage()) { // in page metadata
335 if ($pref = $this->_homepage->get('pref')) {
336 //trigger_error("pref=".$pref);//debugging
337 $prefs = unserialize($pref);
340 return new UserPreferences($prefs);
343 // No cookies anymore for all prefs, only the userid. PHP creates
344 // a session cookie in memory, which is much more efficient,
345 // but not persistent. Get persistency with a homepage or DB Prefs
347 // Return the number of changed entries
348 function setPreferences($prefs, $id_only = false) {
349 if (!is_object($prefs)) {
350 $prefs = new UserPreferences($prefs);
352 // update the session and id
353 $this->_request->setSessionVar('wiki_prefs', $prefs);
354 // $this->_request->setCookieVar('WIKI_PREFS2', $this->_prefs, 365);
355 // simple unpacked cookie
356 if ($this->_userid) setcookie('WIKI_ID', $this->_userid, 365, '/');
358 // We must ensure that any password is encrypted.
359 // We don't need any plaintext password.
361 if ($this->isSignedIn()) {
362 if ($this->isAdmin())
363 $prefs->set('passwd', '');
364 // already stored in config/config.ini, and it might be
365 // plaintext! well oh well
366 if ($homepage = $this->homePage()) {
367 // check for page revision 0
368 if (! $this->_dbi->isWikiPage($this->_userid)) {
369 trigger_error(_("Your home page has not been created yet so your preferences cannot not be saved."),
373 if ($this->isAdmin() || !$homepage->get('locked')) {
374 $homepage->set('pref', serialize($prefs->_prefs));
375 return sizeof($prefs->_prefs);
378 // An "empty" page could still be
379 // intentionally locked by admin to
380 // prevent its creation.
382 // FIXME: This permission situation should
383 // probably be handled by the DB backend,
384 // once the new WikiUser code has been
386 trigger_error(_("Your home page is locked so your preferences cannot not be saved.")
387 . " " . _("Please contact your PhpWiki administrator for assistance."),
392 trigger_error("No homepage for user found. Creating one...",
394 $this->createHomepage($prefs);
395 //$homepage->set('pref', serialize($prefs->_prefs));
396 return sizeof($prefs->_prefs);
399 trigger_error("you must be signed in", E_USER_WARNING);
405 // check for homepage with user flag.
406 // can be overriden from the auth backends
408 $homepage = $this->homePage();
409 return ($this->_userid && $homepage && $homepage->get('pref'));
412 // doesn't check for existance!!! hmm.
413 // how to store metadata in not existing pages? how about versions?
414 function homePage() {
417 if (!empty($this->_homepage)) {
418 return $this->_homepage;
420 $this->_homepage = $this->_dbi->getPage($this->_userid);
421 return $this->_homepage;
425 function hasHomePage() {
426 return !$this->homePage();
429 // create user by checking his homepage
430 function createUser ($pref, $createDefaultHomepage = true) {
433 if ($createDefaultHomepage) {
434 $this->createHomepage($pref);
437 include "lib/loadsave.php";
438 $pageinfo = array('pagedata' => array('pref' => serialize($pref->_pref)),
439 'versiondata' => array('author' => $this->_userid),
440 'pagename' => $this->_userid,
441 'content' => _('CategoryHomepage'));
442 SavePage ($this->_request, $pageinfo, false, false);
444 $this->setPreferences($pref);
447 // create user and default user homepage
448 function createHomepage ($pref) {
449 $pagename = $this->_userid;
450 include "lib/loadsave.php";
452 // create default homepage:
453 // properly expanded template and the pref metadata
454 $template = Template('homepage.tmpl', $this->_request);
455 $text = $template->getExpansion();
456 $pageinfo = array('pagedata' => array('pref' => serialize($pref->_pref)),
457 'versiondata' => array('author' => $this->_userid),
458 'pagename' => $pagename,
460 SavePage ($this->_request, $pageinfo, false, false);
463 $pagename = $this->_userid . SUBPAGE_SEPARATOR . _('Preferences');
464 if (! isWikiPage($pagename)) {
465 $pageinfo = array('pagedata' => array(),
466 'versiondata' => array('author' => $this->_userid),
467 'pagename' => $pagename,
468 'content' => "<?plugin Calender ?>\n");
469 SavePage ($this->_request, $pageinfo, false, false);
472 // create Preferences
473 $pagename = $this->_userid . SUBPAGE_SEPARATOR . _('Preferences');
474 if (! isWikiPage($pagename)) {
475 $pageinfo = array('pagedata' => array(),
476 'versiondata' => array('author' => $this->_userid),
477 'pagename' => $pagename,
478 'content' => "<?plugin UserPreferences ?>\n");
479 SavePage ($this->_request, $pageinfo, false, false);
483 function tryAuthBackends() {
484 return ''; // crypt('') will never be ''
487 // Auth backends must store the crypted password where?
488 // Not in the preferences.
489 function checkPassword($passwd) {
490 $prefs = $this->getPreferences();
491 $stored_passwd = $prefs->get('passwd'); // crypted
492 if (empty($prefs->_prefs['passwd'])) // not stored in the page
493 // allow empty passwords? At least store a '*' then.
494 // try other backend. hmm.
495 $stored_passwd = $this->tryAuthBackends($this->_userid);
496 if (empty($stored_passwd)) {
497 trigger_error(sprintf(_("Old UserPage %s without stored password updated with empty password. Set a password in your UserPreferences."),
498 $this->_userid), E_USER_NOTICE);
499 $prefs->set('passwd','*');
502 if ($stored_passwd == '*')
505 && crypt($passwd, $stored_passwd) == $stored_passwd )
511 function changePassword($newpasswd, $passwd2 = false) {
512 if (! $this->mayChangePass() ) {
513 trigger_error(sprintf("Attempt to change an external password for '%s'. Not allowed!",
514 $this->_userid), E_USER_ERROR);
517 if ($passwd2 && $passwd2 != $newpasswd) {
518 trigger_error("The second password must be the same as the first to change it",
522 $prefs = $this->getPreferences();
523 //$oldpasswd = $prefs->get('passwd');
524 $prefs->set('passwd', crypt($newpasswd));
525 $this->setPreferences($prefs);
529 function mayChangePass() {
530 // on external DBAuth maybe. on IMAP or LDAP not
531 // on internal DBAuth yes
532 if (in_array($this->_authmethod, array('IMAP', 'LDAP')))
534 if ($this->isAdmin())
536 if ($this->_authmethod == 'pagedata')
538 if ($this->_authmethod == 'authdb')
543 // create user and default user homepage
544 // FIXME: delete this, not used?
546 function createUser ($userid, $pref) {
548 $user = new WikiUser ($request, $userid);
549 $user->createUser($pref);
553 class _UserPreference
555 function _UserPreference ($default_value) {
556 $this->default_value = $default_value;
559 function sanify ($value) {
560 return (string)$value;
563 function update ($value) {
567 class _UserPreference_numeric
568 extends _UserPreference
570 function _UserPreference_numeric ($default, $minval = false,
572 $this->_UserPreference((double)$default);
573 $this->_minval = (double)$minval;
574 $this->_maxval = (double)$maxval;
577 function sanify ($value) {
578 $value = (double)$value;
579 if ($this->_minval !== false && $value < $this->_minval)
580 $value = $this->_minval;
581 if ($this->_maxval !== false && $value > $this->_maxval)
582 $value = $this->_maxval;
587 class _UserPreference_int
588 extends _UserPreference_numeric
590 function _UserPreference_int ($default, $minval = false, $maxval = false) {
591 $this->_UserPreference_numeric((int)$default, (int)$minval,
595 function sanify ($value) {
596 return (int)parent::sanify((int)$value);
600 class _UserPreference_bool
601 extends _UserPreference
603 function _UserPreference_bool ($default = false) {
604 $this->_UserPreference((bool)$default);
607 function sanify ($value) {
608 if (is_array($value)) {
609 /* This allows for constructs like:
611 * <input type="hidden" name="pref[boolPref][]" value="0" />
612 * <input type="checkbox" name="pref[boolPref][]" value="1" />
614 * (If the checkbox is not checked, only the hidden input
615 * gets sent. If the checkbox is sent, both inputs get
618 foreach ($value as $val) {
624 return (bool) $value;
628 class _UserPreference_language
629 extends _UserPreference
631 function _UserPreference_language ($default = DEFAULT_LANGUAGE) {
632 $this->_UserPreference($default);
635 // FIXME: check for valid locale
636 function sanify ($value) {
637 // Revert to DEFAULT_LANGUAGE if user does not specify
638 // language in UserPreferences or chooses <system language>.
639 if ($value == '' or empty($value))
640 $value = DEFAULT_LANGUAGE;
642 return (string) $value;
646 class _UserPreference_theme
647 extends _UserPreference
649 function _UserPreference_theme ($default = THEME) {
650 $this->_UserPreference($default);
653 function sanify ($value) {
654 if (findFile($this->_themefile($value), true))
656 return $this->default_value;
659 function update ($newvalue) {
661 include_once($this->_themefile($newvalue));
662 if (empty($WikiTheme))
663 include_once($this->_themefile(THEME));
666 function _themefile ($theme) {
667 return "themes/$theme/themeinfo.php";
671 // don't save default preferences for efficiency.
672 class UserPreferences {
673 function UserPreferences ($saved_prefs = false) {
674 $this->_prefs = array();
676 if (isa($saved_prefs, 'UserPreferences') && $saved_prefs->_prefs) {
677 foreach ($saved_prefs->_prefs as $name => $value)
678 $this->set($name, $value);
679 } elseif (is_array($saved_prefs)) {
680 foreach ($saved_prefs as $name => $value)
681 $this->set($name, $value);
685 function _getPref ($name) {
686 global $UserPreferences;
687 if (!isset($UserPreferences[$name])) {
688 if ($name == 'passwd2') return false;
689 trigger_error("$name: unknown preference", E_USER_NOTICE);
692 return $UserPreferences[$name];
695 function get ($name) {
696 if (isset($this->_prefs[$name]))
697 return $this->_prefs[$name];
698 if (!($pref = $this->_getPref($name)))
700 return $pref->default_value;
703 function set ($name, $value) {
704 if (!($pref = $this->_getPref($name)))
707 $newvalue = $pref->sanify($value);
708 $oldvalue = $this->get($name);
711 if ($newvalue != $oldvalue)
712 $pref->update($newvalue);
714 // don't set default values to save space (in cookies, db and
716 if ($value == $pref->default_value)
717 unset($this->_prefs[$name]);
719 $this->_prefs[$name] = $newvalue;
722 function pack ($nonpacked) {
723 return serialize($nonpacked);
725 function unpack ($packed) {
728 if (substr($packed,0,2) == "O:") {
729 // Looks like a serialized object
730 return unserialize($packed);
732 //trigger_error("DEBUG: Can't unpack bad UserPreferences",
738 return hash($this->_prefs);
742 // $Log: not supported by cvs2svn $
743 // Revision 1.59 2004/06/14 11:31:36 rurban
744 // renamed global $Theme to $WikiTheme (gforge nameclash)
745 // inherit PageList default options from PageList
746 // default sortby=pagename
747 // use options in PageList_Selectable (limit, sortby, ...)
748 // added action revert, with button at action=diff
749 // added option regex to WikiAdminSearchReplace
751 // Revision 1.58 2004/06/04 20:32:53 rurban
752 // Several locale related improvements suggested by Pierrick Meignen
753 // LDAP fix by John Cole
754 // reanable admin check without ENABLE_PAGEPERM in the admin plugins
756 // Revision 1.57 2004/06/04 12:40:21 rurban
757 // Restrict valid usernames to prevent from attacks against external auth or compromise
759 // Fix various WikiUser old issues with default IMAP,LDAP,POP3 configs. Removed these.
760 // Fxied more warnings
762 // Revision 1.56 2004/06/03 12:36:03 rurban
763 // fix eval warning on signin
765 // Revision 1.55 2004/06/03 09:39:51 rurban
766 // fix LDAP injection (wildcard in username) detected by Steve Christey, MITRE
768 // Revision 1.54 2004/04/29 17:18:19 zorloc
769 // Fixes permission failure issues. With PagePermissions and Disabled Actions when user did not have permission WIKIAUTH_FORBIDDEN was returned. In WikiUser this was ok because WIKIAUTH_FORBIDDEN had a value of 11 -- thus no user could perform that action. But WikiUserNew has a WIKIAUTH_FORBIDDEN value of -1 -- thus a user without sufficent permission to do anything. The solution is a new high value permission level (WIKIAUTH_UNOBTAINABLE) to be the default level for access failure.
771 // Revision 1.53 2004/04/10 05:34:35 rurban
774 // Revision 1.52 2004/04/10 02:55:48 rurban
775 // fixed old WikiUser
777 // Revision 1.51 2004/04/06 20:00:10 rurban
778 // Cleanup of special PageList column types
779 // Added support of plugin and theme specific Pagelist Types
780 // Added support for theme specific UserPreferences
781 // Added session support for ip-based throttling
782 // sql table schema change: ALTER TABLE session ADD sess_ip CHAR(15);
783 // Enhanced postgres schema
784 // Added DB_Session_dba support
786 // Revision 1.50 2004/02/26 01:32:03 rurban
787 // fixed session login with old WikiUser object. strangely, the errormask gets corruoted to 1, Pear???
789 // Revision 1.49 2004/02/15 21:34:37 rurban
790 // PageList enhanced and improved.
791 // fixed new WikiAdmin... plugins
792 // editpage, Theme with exp. htmlarea framework
793 // (htmlarea yet committed, this is really questionable)
794 // WikiUser... code with better session handling for prefs
795 // enhanced UserPreferences (again)
796 // RecentChanges for show_deleted: how should pages be deleted then?
798 // Revision 1.48 2004/02/01 09:14:11 rurban
799 // Started with Group_Ldap (not yet ready)
800 // added new _AuthInfo plugin to help in auth problems (warning: may display passwords)
801 // fixed some configurator vars
802 // renamed LDAP_AUTH_SEARCH to LDAP_BASE_DN
803 // changed PHPWIKI_VERSION from 1.3.8a to 1.3.8pre
804 // USE_DB_SESSION defaults to true on SQL
805 // changed GROUP_METHOD definition to string, not constants
806 // changed sample user DBAuthParams from UPDATE to REPLACE to be able to
807 // create users. (Not to be used with external databases generally, but
808 // with the default internal user table)
810 // fixed the IndexAsConfigProblem logic. this was flawed:
811 // scripts which are the same virtual path defined their own lib/main call
812 // (hmm, have to test this better, phpwiki.sf.net/demo works again)
814 // Revision 1.47 2004/01/27 23:23:39 rurban
815 // renamed ->Username => _userid for consistency
816 // renamed mayCheckPassword => mayCheckPass
817 // fixed recursion problem in WikiUserNew
818 // fixed bogo login (but not quite 100% ready yet, password storage)
820 // Revision 1.46 2004/01/26 09:17:48 rurban
821 // * changed stored pref representation as before.
822 // the array of objects is 1) bigger and 2)
823 // less portable. If we would import packed pref
824 // objects and the object definition was changed, PHP would fail.
825 // This doesn't happen with an simple array of non-default values.
826 // * use $prefs->retrieve and $prefs->store methods, where retrieve
827 // understands the interim format of array of objects also.
828 // * simplified $prefs->get() and fixed $prefs->set()
829 // * added $user->_userid and class '_WikiUser' portability functions
830 // * fixed $user object ->_level upgrading, mostly using sessions.
831 // this fixes yesterdays problems with loosing authorization level.
832 // * fixed WikiUserNew::checkPass to return the _level
833 // * fixed WikiUserNew::isSignedIn
834 // * added explodePageList to class PageList, support sortby arg
835 // * fixed UserPreferences for WikiUserNew
836 // * fixed WikiPlugin for empty defaults array
837 // * UnfoldSubpages: added pagename arg, renamed pages arg,
838 // removed sort arg, support sortby arg
840 // Revision 1.45 2003/12/09 20:00:43 carstenklapp
841 // Bugfix: The last BogoUserPrefs-bugfix prevented the admin from saving
842 // prefs into his own homepage, fixed broken logic. Tightened up BogoUser
843 // prefs saving ability by checking for true existance of homepage
844 // (previously a page revision of 0 also counted as valid, again due to
845 // somewhat flawed logic).
847 // Revision 1.44 2003/12/06 04:56:23 carstenklapp
848 // Security bugfix (minor): Prevent BogoUser~s from saving extraneous
849 // _pref object meta-data within locked pages.
851 // Previously, BogoUser~s who signed in with a (valid) WikiWord such as
852 // "HomePage" could actually save preferences into that page, even though
853 // it was already locked by the administrator. Thus, any subsequent
854 // WikiLink~s to that page would become prefixed with "that nice little"
855 // UserIcon, as if that page represented a valid user.
857 // Note that the admin can lock (even) non-existant pages as desired or
858 // necessary (i.e. any DB page whose revision==0), to prevent the
859 // arbitrary BogoUser from saving preference metadata into such a page;
860 // for example, the silly WikiName "@qmgi`Vcft_x|" (that is the
861 // \$examplechars presented in login.tmpl, in case it is not visible here
862 // in the CVS comments).
864 // http://phpwiki.sourceforge.net/phpwiki/
865 // %C0%F1%ED%E7%E9%E0%D6%E3%E6%F4%DF%F8%FC?action=lock
867 // To remove the prefs metadata from a page, the admin can use the
868 // EditMetaData plugin, enter pref as the key, leave the value box empty
869 // and then submit the change. For example:
871 // http://phpwiki.sourceforge.net/phpwiki/
872 // _EditMetaData?page=%C0%F1%ED%E7%E9%E0%D6%E3%E6%F4%DF%F8%FC
874 // (It seems a rethinking of WikiUserNew.php with its WikiUser and
875 // UserPreferences classes is in order. Ideally the WikiDB would
876 // transparently handle such a situation, perhaps BogoUser~s should
877 // simply be restricted to saving preferences into a cookie until his/her
878 // e-mail address has been verified.)
880 // Revision 1.43 2003/12/04 19:33:30 carstenklapp
881 // Bugfix: Under certain PhpWiki installations (such as the PhpWiki at
882 // SF), the user was unable to select a theme other than the server's
883 // default. (Use the more robust Theme::findFile instead of PHP's
884 // file_exists function to detect installed themes).
886 // Revision 1.42 2003/11/30 18:18:13 carstenklapp
887 // Minor code optimization: use include_once instead of require_once
888 // inside functions that might not always called.
890 // Revision 1.41 2003/11/21 21:32:39 carstenklapp
891 // Bugfix: When DEFAULT_LANGUAGE was not 'en', a user's language prefs
892 // would revert to 'en' when the default <system language> was selected
893 // in UserPreferences and the user saved his preferences. (Check for
894 // empty or blank language pref in sanify function of class
895 // _UserPreference_language and return DEFAULT_LANGUAGE if nothing or
896 // default selected in UserPreferences.)
898 // Revision 1.40 2003/11/21 16:54:58 carstenklapp
899 // Bugfix: login.tmpl was always displayed in English despite
900 // DEFAULT_LANGUAGE set in index.php. (Added call to
901 // update_locale(DEFAULT_LANGUAGE) before printing login form).
903 // Revision 1.39 2003/10/28 21:13:46 carstenklapp
904 // Security bug fix for admin password, submitted by Julien Charbon.
906 // Revision 1.38 2003/09/13 22:25:38 carstenklapp
907 // Hook for new user preference 'noLinkIcons'.
909 // Revision 1.37 2003/02/22 20:49:55 dairiki
910 // Fixes for "Call-time pass by reference has been deprecated" errors.
912 // Revision 1.36 2003/02/21 22:50:51 dairiki
913 // Ensure that language preference is a string.
915 // Revision 1.35 2003/02/16 20:04:47 dairiki
916 // Refactor the HTTP validator generation/checking code.
918 // This also fixes a number of bugs with yesterdays validator mods.
920 // Revision 1.34 2003/02/15 02:21:54 dairiki
921 // API Change! Explicit $request argument added to contructor for WikiUser.
923 // This seemed the best way to fix a problem whereby the WikiDB
924 // was being opened twice. (Which while being merely inefficient
925 // when using an SQL backend causes hangage when using a dba backend.)
927 // Revision 1.33 2003/01/22 03:21:40 zorloc
928 // Modified WikiUser constructor to move the DB request for the homepage to
929 // the end of the logic to prevent it from being requested and then dropped.
930 // Added more phpdoc comments.
932 // Revision 1.32 2003/01/21 07:40:50 zorloc
933 // Modified WikiUser::_ok() -- Inverted the logic so the default is to return
934 // false and to return true only in the desired condition. Added phpdoc
937 // Revision 1.31 2003/01/15 05:37:20 carstenklapp
940 // Revision 1.30 2003/01/15 04:59:27 carstenklapp
941 // Bugfix: Previously stored preferences were not loading when user
942 // signed in. (Fixed... I hope.)
949 // c-hanging-comment-ender-p: nil
950 // indent-tabs-mode: nil