BiblioViva Documentation
SearchCtrl K
ITEN
Step-by-step guide

Manage the staff accounts

This guide explains how to create, edit, deactivate and delete the accounts the staff use to enter BiblioViva. It is for whoever administers BiblioViva and wants, for example, an extra account for a second desk or an account with fewer permissions.

BiblioViva uses shared accounts, normally one per role, created by the first run:

AccountUsernameUsed for
Administration (admin)admineverything: settings, backups, imports, accounts
Loan management (prestiti)prestitithe circulation desk: loans and returns
Cataloguing (catalogo)catalogothe catalogue: books, copies, labels
Cards and photos (tessere)tesserethe patrons and the cards
Reports (report)reportthe reports and the statistics

Each account has one or more roles, and each role is a set of permissions. An account can do only what the permissions of its roles allow. There are no personal accounts, one per person.

Procedure

See the accounts

  1. Log in to BiblioViva as admin.
  2. Open Administration.
  3. Open Staff accounts. Each account has a card with the username, the status (Active or Deactivated), the Roles, the Permissions and the Last login.
The Staff accounts page with the account cards and the Roles and permissions panel
Figure 1. The Staff accounts page with the account cards and the Roles and permissions panel

Create an account

  1. Press New account. A window opens.
  2. Type in the Username field the name used to log in: 2 to 32 characters, only lowercase letters, digits, dot, hyphen and underscore.
  3. Type in the Name shown field the name that appears in the pages, for example "Desk 2". The field is optional.
  4. Tick at least one role under Roles.
  5. Leave the Active account (can sign in) box ticked.
  6. Type the password in the Password (at least 8 characters) field and again in the Repeat the password field.
  7. Press Save. The message "Account created" appears.

Important. The password cannot be seen again: BiblioViva keeps only a protected form of it. Note it down before pressing Save and hand it over in person to whoever uses the account.

Edit an account

  1. On the account card press Edit.
  2. Change the Username, the Name shown, the Roles or the status of the account.
  3. Press Save. The message "Account saved" appears.

To change an account's password see Change a password.

Deactivate and delete an account

A deactivated account can no longer log in, but stays in the list and can be reactivated. An account is deleted only after it has been deactivated.

  1. On the account card press Edit.
  2. Untick the Active account (can sign in) box and press Save. The card shows Deactivated.
  3. To delete it, press Delete on the card. The button appears only on deactivated accounts.
  4. At the question "Delete ?" press Delete. The message "Account deleted" appears.

The operations done by the account stay in the log under its name. The deletion can be undone from the configuration history.

Change the roles and the permissions

The Roles and permissions panel, below the cards, lists the roles and, for each, the permissions: Everything, Loans, Patrons, Import patrons, Catalogue, Import catalogue, Reports, Anonymize and Administration.

  1. In a role's row tick or untick the permissions. The Everything permission includes every permission, even those BiblioViva may add in the future.
  2. To add a role, press Add a role and type the name in the Role field: letters, digits, hyphens and underscores, at most 32.
  3. Press Save. The message "Roles saved" appears.

Renaming a role updates the accounts that use it. Under each role's name the accounts that use it are listed, or "no account".

Result

  • The new account logs in from the Log in page with its username and password.
  • Each account sees only the pages its permissions allow.
  • Deactivated or deleted accounts can no longer log in.

Possible problems

A–Z index