# <a name="Package &lt;code&gt;TWiki::Users="></a> Package =TWiki::Users

Singleton object that handles mapping of users to wikinames and vice versa, and user authentication checking.

<div>
  <ul>
    <li><a href="#Package =TWiki::Users="> Package TWiki::Users</a><ul>
        <li><a href="#ClassMethod <strong>new</strong> ($session,$imp"> ClassMethod new <tt>($session,$impl)</tt></a></li>
        <li><a href="#ObjectMethod *finish*"> ObjectMethod finish <tt></tt></a></li>
        <li><a href="#ObjectMethod <strong>findUser</strong> ($name[,"> ObjectMethod findUser <tt>($name[,$wikiname][,$nocreate]) -&gt; $userObject</tt></a></li>
        <li><a href="#ObjectMethod *find_UserByEmail*"> ObjectMethod findUserByEmail <tt>($email) -&gt; \@users</tt></a></li>
        <li><a href="#ObjectMethod <strong>createUser</strong> ($logi"> ObjectMethod createUser <tt>($login,$wikiname) -&gt; $userobject</tt></a></li>
        <li><a href="#ObjectMethod *add_UserToMapping*"> ObjectMethod addUserToMapping <tt>($user) -&gt; $topicName</tt></a></li>
      </ul>
    </li>
  </ul>
</div>

## <a name="ClassMethod &lt;strong&gt;new&lt;/strong&gt; ($session,$imp"></a> [[ClassMethod]] **new** `($session,$impl)`

Construct the user management object

## <a name="ObjectMethod &lt;strong&gt;finish*"></a><a name="ObjectMethod *finish&lt;/strong&gt; "></a> [[ObjectMethod]] **finish** ``

Complete processing after the client's HTTP request has been responded to.

1. breaking circular references to allow garbage collection in persistent environments

## <a name="ObjectMethod &lt;strong&gt;findUser&lt;/strong&gt; ($name[,"></a> [[ObjectMethod]] **findUser** `($name[,$wikiname][,$nocreate]) -> $userObject`

- `$name` - login name or wiki name
- `$wikiname` - optional, wikiname for created user
- `$nocreate` - optional, disable creation of user object for user not found

Find the user object corresponding to `$name`, which may be either a login name or a wiki name. If `$name` is found (either in the list of login names or the list of wiki names) the corresponding user object is returned. In this case `$wikiname` is ignored.

If they are not found, and `$nocreate` is true, then return undef.

If `$nocreate` is false, then a user object is returned even if the user is not known.

If `$nocreate` is false, and no `$wikiname` is given, then the `$name` is used for both login name and wiki name.

If nocreate is off, then a default user will be created with their wikiname set the same as their login name. This user/wiki name pair can be overridden by a later createUser call when the correct wikiname is known, if necessary.

## <a name="ObjectMethod &lt;strong&gt;find_UserByEmail*"></a><a name="ObjectMethod *find_UserByEmail&lt;/strong&gt; "></a> [[ObjectMethod]] **findUserByEmail** `($email) -> \@users`

- `$email` - email address to look up

Return a list of user objects for the users that have this email registered with the password manager.

## <a name="ObjectMethod &lt;strong&gt;createUser&lt;/strong&gt; ($logi"></a> [[ObjectMethod]] **createUser** `($login,$wikiname) -> $userobject`

Create a user, and insert them in the maps (overwriting any current entry). Use this instead of findUser when you want to be sure you are not going to pick up any default user created by findUser. All parameters are required.

## <a name="ObjectMethod &lt;strong&gt;add_UserToMapping*"></a> [[ObjectMethod]] \*addUserToMapping `($user) -> $topicName`

Add a user to the persistant mapping that maps from usernames to wikinames and vice-versa.