Admin Guide
An Otter Wiki can be configured by Admin users who can find , etc. in the sidebar menu of their .
Branding
In the the , which is displayed in the navigation bar on the top of the site and in emails, can be configured.
The is displayed next to the site name, while the (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 is used in the <meta name="description"> tag.
User management
All users are listed in a table under . You can update the flags of the users by checking and unchecking the checkboxes, where 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 and of a user, and set flags and permissions. Changing a users name or email does not change the commit history and only affects future commits.
Like 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 a user from the wiki's database. Check the box and hit Delete. Note that this will not change any edit history or prevent the user from signing up again.
Sidebar Preferences
The Sidebar can be configured to display the Page Index in different modes. You can display pages and directories either alphabetical, or with directories first, or only the directories. Alternatively you choose to not display the Page Index at all.
Content and Editing Preferences
Per default An Otter Wiki requires users to add commit messages when updating a page. You can configure this with the setting. Setting this to optional will allow empty commit messages.
An Otter Wiki stores pages in files with names of all lowercase names. To retain the upper and lower case of the filenames, check .
With allow users with the permission to READ to clone and pull the wiki content via git and users with UPLOAD/Attachment management permissions to push content. HTTP Basic authentication is used for non anonymous access. There is no option for using git via ssh.
Access Permissions and Registration Preferences
What is necessary for a user to be able to Read/Write pages or upload and modify attachments is controlled in the .
Read Accessenables users to display pages and attachments. Including the history and every single commit.Write Accessenables users to edit pages.Attachments Accessenables users to upload and modify attachments.
Who can access what is defined via
Anonymous- Everyone can access the wiki without being logged in.Registered- Users need an account and have to be logged in.Approved- Users have to be logged in and the flag has to be set.Admin- Users have to be logged in and the 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.
, which is supposed to prevent users to register using fake mail addresses.
If a user needs to be approved, an admin user either needs to set the flag manually or enable . When admins need to approve users, helps with that. For more convenience, enable so that users are notified automatically and there is no need to notify them yourself.
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 . See the flask-mail documentation for configuration details.
You can test the configuration using . Per default the test mail is sent to yourself.