TBWiki can be configured to grant different privileges to users based
on user accounts.

{{TableOfContents}}

Users [edit section]

= Users =
TBwiki allows users to create accounts, which allow for customizing the settings for a user, or granting special privileges on the site.

Creating an account [edit section]

== Creating an account ==
A user account can be created by selecting "Login", then clicking
on the link "Create user account".

This will present a form for creating a new user.

If the wiki is not configured for user account creation, there will be
a message indicating to contact the wiki administrator by email to have the
administrator create the account for you.

Editing your account information [edit section]

== Editing your account information ==
To edit your account information, login using your account.
Your account name should show as a link in the upper right of the page.
Click on your account name, and you will be taken to a form
for editing the values of your account.

Edit the values you wish to change, then click "Save"

Account privileges [edit section]

= Account privileges =
The wiki can be configured with different permission settings.

The three basic permissions are:
 * read
 * write
 * admin

For now, permissions apply to the entire wiki, and not to individual
pages.

The 'admin' privilege is set in the accounts of those users who should
have administration rights to the wiki.  This right allows a user to
administer user accounts (and delete pages).

The wiki may be configured to require that a user be logged in to have
write access.  The write privilege allows for creating pages, editing
pages, and editing database entries.

The wiki may be configured to require that a user be logged in to have
read access.  The read privilege allows for reading pages on the site,
but does not allow a site visitor to change any information on the site.

Administrators [edit section]

= Administrators =
== Creating an account ==
If config.user_creation_allowed is set to 0, then users cannot create
accounts themselves.  No link is provided on the user login page for users
to create accounts.

Usually, this means that users will need to send an email to the wiki administrator in order to create an account for them.

To do this as administrator, you need to temporarily enable
the 'user_creation_allowed' variable, by directly editing the cgi wrapper.
Find the line with 'config.user_creation_allowed = 0' and change the 0 to 1.
The cgi wrapper for the wiki is often found in /usr/lib/cgi-bin/<wiki-name>.cgi

Then create the account, by going through the link on the login page.
Then disable the user_creation_allowed variable by setting it back to 0.

Administering accounts [edit section]

== Administering accounts ==
To see the list of user accounts, go to the [[Admin_Users]] page on
the wiki where you wish to administer users.

This will show a list of user accounts, in table format.

You can delete accounts, or edit the values for an account.

Note that you must be an administer to access the list of users or
to edit a user account besides your own.

Note that this uses the 'User' processor plugin.