Welcome, Registration, and other StartingPoints; TWiki history & Wiki style; All the docs...

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 undef if success, error message otherwise

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.



Webs Webs

r3 - 16 Jan 2007 - 04:12:03 - TWikiContributor
This site is powered by the TWiki collaboration platform.
All material on this collaboration platform is the property of the contributing authors.
All material marked as authored by Eben Moglen is available under the license terms CC-BY-SA version 4.
Syndicate this site RSSATOM