DLRG Wachplan (C) Markus Kniehl (kniehl@dlrg.de)
################################################

Inhalt:

1. Installation
2. CRON-Jobs
3. Kontakt

aktuelle Version : 1.4 vom 31.03.2007

################################################

1. Installation

Der Wachplan funktioniert nur auf dem DLRG-Server,
dort sind die notwendigen Scripte zentral hinterlegt.

Herunterladen des Installationspakets

http://bittenfeld.dlrg.de/Wachplan-Programm.13269.0.html

Entpacken der Dateien in einen Ordner auf der Lokalen
Festplatte und anpassen folgender Datei:

config.xml:

Die Datei ist im XML-Format. Bitte nur die Werte 
innerhalb der eckigen Klammer ndern !!!

################################################

Global-Bereich:

	<global>
		<titel>Bz. Testingen</titel>
		<url>bez-testingen.dlrg.de</url>
		<uri>http://bez-testingen.dlrg.de/wachplan</uri>
		<from>webmaster@bez-testingen.dlrg.de</from>
		<ident>Landesverband Test - Bezirk Testingen e.V.</ident>
		<aspname>Ansprechpartner</aspname>
		<aspmail>name@dlrg.de</aspmail>
		<backurl>http://bez-testingen.dlrg.de</backurl>
		<logoutOnNoPlan>true</logoutOnNoPlan>
		<userNotifyDays>4</userNotifyDays>
                <tblPrefix>prefix</tblPrefix>
	</global>
	
Hier kann man die Beschriftungen innerhalb des Templates ndern.
Z.B. Titel und URL der Seite.

titel : Titel der Im Browserfenster angezeigt wird
url   : URL der Gleiderung ohne http://
uri   : URL des Wachplans mit http:// und Verzeichnis
from  : Absender, der bei E-Mails angezeigt werden soll
ident : String der im Template verwendet wird.
aspname: Name des Ansprechpartners (wird in der Fuzeile angezeigt)
aspmail: E-Mail adresse des Ansprechpartners
backurl: Auf welchen Link der Zurck-Link im Men Zeigen soll 
	 (falls der Wachplan auf einem anderen Server luft)
logoutOnNoPlan: Restriktive Sicherheitseinstellung. Benutzer kann zwar einen
	        Account anlegen, kann sich jedoch erst einloggen, wenn er einem Plan
	        zugeordnet ist. Dies muss durch einen Verwalter erfolgen.
	        Der Admin-Benutzer kann sich unabhngig davon einloggen
userNotifyDays: Wieviel Tage vorher wird die Benachrichtigung geschickt
tblPrefix     : Tabellen-Prefix... so knnen mehrere Wachplne auf 
                einem Account eingerichtet werden.

################################################

Anpassen der ffentlichen PDF-Adressliste
 Mit folgenden Einstellungen kann die PDF-Adressliste angepasst werden

         <pdf_addr_public>
             <nachname>Nachname</nachname>
             <vorname>Vorname</vorname>
             <tel_priv>Telefon</tel_priv>
             <mobil>Handy</mobil>
             <email>E-Mail</email>
             <og>Ortsgruppe</og>
         </pdf_addr_public>

Diesen Bereich innerhalb von <global> einfgen, dann werden statt der
Standard-Felder die Felder aus der config.xml benutzt.

Der Aufbau einer Spalte ist folgendermaen
    <datenbank-feld-name>Spaltenberschrift</datenbank-feld-name>

################################################

Debug: Nur fr die Entwicklung - Zur Aktivierung der Entwicklungsmodule
folgendes in die Datei einfgen.

                <mods>
                    <Beta>enabled</Beta>
                </mods>

################################################
 
	 
Form-Require-Abschnitt

	<formrequire>
		<vorname>Bitte deinen Vorname eingeben</vorname>
		<nachname>Bitte deinen Nachnamen eingeben</nachname>
		<strasse>Bitte deinen Strasse eingeben</strasse>
		<plz>Bitte PLZ eingeben</plz>
		<ort>Bitte Ort eingeben</ort>
		<handy>Bitte Mobil-Nr. eingeben</handy>
		<tel_priv>Bitte Telefonnummer eingeben</tel_priv>
		<og>Bitte Ortsgruppe eingeben</og>
	</formrequire>	

Dieser Abschnitt ist nur fr Experten. Damit ist es mglich, 
bei der Anmeldung mehr Daten vom Benutzer anzufragen. Es ist dann
aber auch eine nderung an der Datenbank notwendig.
nderungen hier bitte nur mit Rcksprache!

################################################

Datenbank-Abschnitt:

	<datenbank type="mysql">
		<host>mysql.dlrg.de</host>
		<user>Gliederungsnummer</user>
		<pass>Passwort</pass>
		<name>Gliederungsnummer</name>
	</datenbank>

Hier werden die Datenbank-Connect-Daten eingtragen
Sollte die Gliderung noch keine MySQL-Datenbank besitzen, so
kann diese in der VO beantragt werden.

################################################

Jetzt ist die Datei angepasst und die Daten knnen auf
den Server geladen werden. Am besten erstellt man fr den Wachplan
ein extra Verzeichnis. (z.B. /wachplan/)

################################################

Jetzt kann man den Wachplan schon aufrufen.

Es wird vermutlich eine Fehlermeldung kommen, das keine Tabellen
angelegt sind. Jetzt kann man durch einen einfachen klick, alle
Tabellen automatisch anlgegen lassen.

Dannach sollte man sich sofort anmelden, da der 1. Benutzer der
Hauptadministrator ist, der neue Plne anlegen und verwalten darf.

Um einen Plan anzulegen, muss unter "Admin-Funktionen" der Punkt "Plne"
angeklickt werden. Dort knnen die Plne angelegt und gelscht werden.

Jetzt mssen noch unter dem Punkt Verwalter, jedem Plan, einen oder mehrere 
Verwalter zugeordnet werden. Die Verwalter mssen vorher als normale Benutzer
angelegt sein.

Anschlieend muss der Verwalter die einzelnen Spalten des Planes anlegen.
Damit legt er fest, wie sich die einzelnen Spalten verhalten. Wer sich eintragen
darf oder wer Text ndern darf. Dies erfolgt beim dem entsprechenden Plan beim
Menpunkt "Plandetails".

Jetzt mssen noch beim Menpunkt "Termin" die Termine eingetragen werden, 
die verfgbar sein sollen und wo sich die Benutzer eintragen knnen.

Der Verwalter kann bei Punkt "Eintragen" einzelne Benutzer eintragen oder den 
Termin sperren, so dass sich niemand mehr selbst eintragen kann. Nur noch der
Verwalter kann an den gesperrten Terminen jemanden eintragen.

Seit dem neuesten Update ist es fr die Benutzer mglich Urlaub zu planen.
Dies hat die Auswirkung, das der Verwalter die Benutzer die im Urlaub sind,
nicht eintragen kann.


################################################

2. CRON-Jobs

Fr Cronjobs zur automatischen Benachrichtigung wendet euch bitte an mich,
ich muss fr jede Gliederung einen CRON-Job einrichten.

Alternativ kann der Cron-Job auch von euch selbst aufesetzt werden.
Ihr msst einfach dafr sorgen das die folgenden URLS abgerufen werden.

<wachplanURL>/?action=service&do=cron	

Hier werden alle E-Mails geschickt, die der Benachrichtigung dienen. 
Normalerweise wird das Script gegen 14 Uhr aufgerufen-

<wachplanURL>/?action=service&do=cron_change

Hier werden an die Verwalter die E-Mails geschickt, wenn sich etwas an 
Ihren Plnen gendert hat. Aufrufzeit ca. 19 Uhr.


################################################


3. Kontakt

Kontaktmglichkeiten bei Fragen, Anregungen oder Fehlern

Markus Kniehl
kniehl@dlrg.de
ICQ: 38250278


################################################


