Basics | Plugins | Howtos

users : Managing users

What it does

• Adds ways for signing in and out at different places.

• Adds the Configure ‣ System ‣ Users menu command to View all user accounts

• Adds concepts like User types and user roles, permissions, user settings, user preferences, authorities,

View all user accounts

As a site manager you can add new users and edit existing users via the Configure ‣ System ‣ Users menu command.

The detail of a user account

This window opens when you click on My preferences or when you double-click on a row in the Configure ‣ System ‣ Users data window.

For a description of the fields, see lino.modlib.users.User.

User accounts

The site manager never needs to specify the current password when setting a new password for any user account.

You can optionally specify a date when a user started or stopped to be active.

End users can set their password themselves: How to change your password.

User types and user roles

You can see the user types available on your Lino site via Explorer ‣ System ‣ User Types. Here is a typical list of user types:

value	name	text
000	anonymous	Anonymous
100		User
900	admin	Administrator

Another menu command might be interesting: Explorer ‣ System ‣ User roles. This table shows the user roles defined on your site and for each user type whether it has them or not. Lino consults this table when deciding whether to give permission (or not) to see certain menu commands.

Name	000	100	900
comments.CommentsStaff			☑
comments.CommentsUser		☑	☑
contacts.ContactsStaff			☑
contacts.ContactsUser		☑	☑
excerpts.ExcerptsStaff			☑
excerpts.ExcerptsUser		☑	☑
office.OfficeStaff			☑
office.OfficeUser		☑	☑
xl.SiteAdmin			☑
xl.SiteUser		☑

You cannot edit these tables. They have been designed by the application developer. If you think that something is missing with these tables, then talk about it with your site expert. They are visible so that you have a chance to understand what every user type does.

Online registration

Your Lino site may have social authentication channels enabled.

TODO: write more explanations.

Third party authentication

The third_party_authentication feature can be enabled by the site maintainer. When this is enabled, you must also create “applications” on some third-party auth provider (Google, Facebook).

Glossary

This documentation page introduces the following concepts.

user account

A database row with information about a given site user.

user preferences

The database fields of a user account that can be edited by the user themself.

For a description of user preferences, see lino.modlib.users.User.

My preferences

A quick link and an entry in the user menu that opens a detail window where you can edit your own user preferences.

user type

The type of a user account, which mainly defines the user’s permissions, i.e. what functionalities and data they can access. See User types and user roles below.

authority

The fact that one user gives another user the right to “represent” them, i.e. to act in their name.

online registration

A feature of a Lino site that allows new end users to register online, i.e. to create a user account without (or with little) interaction of the site manager. See Online registration.

sign in

The action of telling a Lino site who you are. See Authentication.

Authentication

Authentication is the process that happens when an end user signs in. It includes:

• Ask for user credentials (username and password)

• Look up the user account from the database.

• Verify whether password is valid

• Optionally use other authentication methods

• Store the users.User instance in the Session instance.