Admin Guide

An Otter Wiki can be configured by Admin users who can find Application Preferences, User management etc. in the sidebar menu of their Settings.

Branding

In the Application Preferences the Site Name, which is displayed in the navigation bar on the top of the site and in emails, can be configured.

The Site Logo is displayed next to the site name, while the Site Icon (or favicon) is displayed in the browser tab and in bookmarks. Both Site Logo and Site Icon can be attachments. An Otter Wikis logo is the default for both.

The Site Description is used in the <meta name="description"> tag.

User management

All users are listed in a table under User management. You can update the flags of the users by checking and unchecking the checkboxes, whereby means the flag is set and means the flag is not set. A set flag grants a privilege to a user.

Privileges granted per user add to the general permissions. For example, if in general only users with the Admin flag are allowed to upload attachments, the user@example.org can be allowed to Upload without being flagged as Admin.

A user with a in the Admin column has Admin permissions. The changes are applied with Update Privileges.

Edit a user

With you can open up a single user for editing. Here you can update Name and eMail of a user, and set flags and permissions. Changing a users name or email doesn't change the commit history and only affects future commits.

As in the User management table you can control the users flags using the checkboxes.

The changes will be applied with Update.

Delete a user

On the Edit user page you can remove the user from the wikis database. Check the box and hit Delete. Please note that this doesn't neither changes any edit history nor prevents the user from signing up again.

Access Permissions and Registration Preferences

What is necessary so that a user can Read/Write pages or upload and modify attachments is controlled in the Permissions and Registration Preferences.

• Read Access enables users to display pages and attachments. Including the history and every single commit.
• Write Access enables users to edit pages.
• Attachments Access enables users to upload and modify attachments.

Who can access what is defined via

• Anonymous - Everyone who can access the wiki without log in.
• Registered - Users need an account and have to be logged in.
• Approved - Users have to be logged and the Approved flag has to be set.
• Admin - Users have to be logged and the Admin flag has to be set.

Additionally you can configure privileges per user. The privileges granted per user add to the general permissions. See User Management above.

Registration requires email confirmation is supposed to prevent users to register using fake mail addresses.

If a user needs to be approved, an admin user has either set the flag manually or enable Auto approve of new registered users. When admins need to approve users, Notify admins on new user registration helps with that.

Mail Preferences

To enable An Otter Wiki to send mails to users registering, resetting their lost password and notify admins about new users, configure the Mail Preferences. See the flask-mail documentation for configuration details.

You can test the configuration using Send Test Mail. Per default the test mail is sent to yourself.