create new tag
, view all tags
ALERT! NOTE: This is a DistributionDocument. This document is generated, please do not change it. Put questions, error notes, and suggestions concerning the documentation of this topic in the comments section below. Use the Support web for problems you are having using TWiki.

Package TWiki::User

A User object is an internal representation of a user in the real world. The object knows about users having login names, wiki names, personal topics, and email addresses.

Groups are also handled here. A group is really a subclass of a user, in that it is a user with a set of users within it.

The User package also provides methods for managing the passwords of the user.

ClassMethod new ($session,$loginname,$wikiname)

Construct a new user object for the given login name, wiki name.

The wiki name can either be a wiki word or it can be a web- qualified wiki word. If the wiki name is not web qualified, the user is assumed to have their home topic in the $TWiki::cfg{UsersWebName} web.

ObjectMethod wikiName () -> $wikiName

Return the wikiname of the user (without the web!)

ObjectMethod webDotWikiName () -> $webDotWiki

Return the fully qualified wikiname of the user

ObjectMethod login () -> $loginName

Return the login name of the user

ObjectMethod web () -> $webName

Return the registration web of the user

ObjectMethod equals () -> $boolean

Test is this is the same user as another user object

ObjectMethod stringify () -> $string

Generate a string representation of this object, suitable for debugging

ObjectMethod passwordExists () -> $boolean

Checks to see if there is an entry in the password system Return '1' if true, '' if not

ObjectMethod checkPassword ($password) -> $boolean

used to check the user's password

$password unencrypted password

$success '1' if success

TODO: need to improve the error mechanism so TWikiAdmins know what failed

ObjectMethod removePassword () -> $boolean

Used to remove the user and password from the password system. Returns true if success

ObjectMethod changePassword ($user,$oldUserPassword,$newUserPassword) -> $boolean

used to change the user's password $oldUserPassword unencrypted password $newUserPassword unencrypted password '1' if success

ObjectMethod addPassword ($newPassword) -> $boolean

creates a password entry $newUserPassword unencrypted password '1' if success TODO: need to improve the error mechanism so TWikiAdmins know what failed

ObjectMethod resetPassword () -> $newPassword

Reset the users password, returning the new generated password.

ObjectMethod emails () -> @emailAddress

If this is a user, return their email addresses. If it is a group, return the addresses of everyone in the group.

ObjectMethod setEmails ($user,@emails)

Fetch the email address(es) for the given username

ObjectMethod isAdmin () -> $boolean

True if the user is an admin (is a member of the $TWiki::cfg{SuperAdminGroup})

ObjectMethod getGroups () -> @groups

Get a list of user objects for the groups a user is in

ObjectMethod isInList ($list) -> $boolean

Return true we are in the list of user objects passed.

$list is a string representation of a user list.

ObjectMethod isGroup () -> $boolean

Test if this is a group user or not

ObjectMethod groupMembers () -> @members

Return a list of user objects that are members of this group. Should only be called on groups.

Comments & Questions about this Distribution Document Topic

Please use the Support forum if you have questions about TWiki features. This comment section is about the documentation of this topic.
Edit | Attach | Watch | Print version | History: r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r2 - 2006-05-01 - PeterThoeny
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2016 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.