Wiedenmann Vacation

Web Front-End to Manage vacation(1) Settings

Author:	Wolfgang Scherer

Inhalt

Installation
User Management
Configuration

Installation

Copy the program anywhere on your harddrive.
Change alias /vacation in lib/ws-vacation.conf.in, if desired.
Execute the following commands (as user) to create the run-time files:
```
>>> make clean
>>> make
```
This substitutes the installation directory in the necessary places.
Copy lib/ws-vacation.conf to /etc/apache2/conf.d/.
Reload the Apache server:
```
>>> rcapache2 reload.
```
The sudo(1) setup allows the apache server to execute vacation(1) as any user (except root) without a password. This is activated by copying the file lib/ws-vacation-sudo into the directory /etc/sudoers.d (ubuntu):
```
>>> cp lib/ws-vacation-sudo /etc/sudoers.d/ws-vacation-sudo
>>> chmod 0440 /etc/sudoers.d/ws-vacation-sudo
```
or by appending it to the file /etc/sudoers (older SuSE):
```
>>> cat lib/ws-vacation-sudo >>/etc/sudoers
```

User Management

The file lib/.htpasswd can be created by the regular means.

An automated script is available that creates the password database from the system shadow(8) database. Just change into directory lib and execute (as root):

>>> php gen_htpasswd.php

Bemerkung

If new users are created in the system, this step must be repeated to update the .htpasswd file.

Configuration

The file lib/config.php contains the basic configuration data.

It is possible to fine-tune the standard user selection with:

$ALLOWED_USERS: users who are always accepted (if present in /etc/passwd).
$INVALID_USERS: invalid users, which are always ignored.
$ADMIN_USERS: administrators.

The file lib/language.php contains language specific translation and also the default vacation(1) message text.

The HTML header and footer can be modified in lib/templates.php.

Copyright

See section GNU Free Documentation License for license conditions for the documentation.

See section GNU General Public License for license conditions for the program.