Gratogel Online Tool

****************************
*   Gratogel Online Tool   *
****************************

Inhalt:
========

    1.) Verzeichnisstruktur / CVS Tree
    2.) Vorworte des Programmierers
    3.) Anforderungen
    4.) PHP Secure Pages
    5.) ...



1.) Verzeichnisstruktur / CVS Tree
===================================

+-- src
     |
     +--> classes	    		Klassen für Objekte wie Spieler, Mail etc
     |	  
     +--> grafik	    		Verzeichnis für alle Grafiken
     |     |
     |     +--> face	    	Avatare für die Spielerportraits
     |     |
     |     +--> icons	    	Kleine Grafiken für alle Zwecke
     |     |
     |     +--> table	    	Grafiken für die Tabellen (GUI)
     |
     +--> phpsecurepages	siehe Punkt 4.) 
     |
     +--> includes		Funktionen 
     |
     ~

2.) Vorworte des Programmierers
================================

Das Gratogel Online Tool entstand zu Beginn 2001 nach meinem Ausstieg
aus dem Play by Email Rollenspiel Gratogel (www.gratogel.de)
Seither wurde die Version 2 des Tools weiterentwickelt und den
individuellen Bedürfnissen der Spieler und der Spielleitung
angepasst. Die Bitte von Kollegen anderer PBeM`s und die mittlerweile
komplexe Struktur der Version 2 bewegten mich dieses Projekt zu
gründen, und von Grund auf ein Tool zu entwickeln, dass einerseits die
Bedürfnisse von Gratogel bietet, andererseits jedoch so frei editier-
und anpassbar wie möglich.

Ich übernehme keine Garantie für eventuelle Probleme mit meinem Code
und verspreche keinen uneingeschränkten Support. Ebenso möchte ich
keine Mails zu dem Thema "Dein Code ist aber schlecht formatiert" oder
gar "Wie wärs mal mit ein paar Kommentaren ?" Ich versuche den Code
möglichst verständlich zu schreiben, setze aber gewisse Kenntnisse in
PHP voraus. Außerdem verstehe ich dieses Projekt nicht als PHP
Tutorial, in dem jede Zeile kommentiert und dokumentiert werden muss. 
Das soll jetzt aber nicht bedeuten, dass konstruktive Kritik generell
unerwünscht ist, ganz im Gegenteil freue ich mich immer über
Vorschläge, Tips und FeatureRequests,

Dieser Code ist zwar frei nutzbar und editierbar, trotzdm würde ich 
mich über einen Link zu dieser Projektseite 
(http://sourceforge.net/projects/onlinetool) oder über eine kurze Info 
zu den Einsatzgebieten freuen. (mail@exceptionfault.de)

Viel Spass
Andreas Habel, 69257 Wiesenbach @ Heidelberg
28.05.2002


3.) Anforderungen
==================

... an den Server: 

    Das Tool wurde bisher nur auf Apache Servern getestet. Infos zu
    anderen HTTP Servern (z.B. Microsoft IIS) ist nicht bekannt.
    Auch die Funktion auf dem neuen Apache 2.x ist nicht bekannt.
    Daher: HTTP Server = Apache 1.3.x

    Unbedingt Notwendig ist das PHP 4.x Modul. Der Server sollte 
    ausserdem die Index.php als Startdatei akzeptieren.

    Zur Datenbank: Verwendet wurde eine mySQL Datenbank in der Version
    3.23.49, wobei keine exotischen SQL Queries verwendet wurden, was
    eine Auf- und Abwärtskompatibilität gewährleisten sollte.
    Andere Datenbanken sind im Rahmen der von PHP unterstützen
    Funktionen möglich, dies erfordert aber eine umfassende Anpassung
    des Codes!!!

... an den Admin:

    Es wird versucht, die Konfiguration des Tools und die Handhabung
    so einfach wie möglich zu gestalten, wobei gerade zu Beginn auf
    Installationshilfen verzichtet wird. 
    Viele Einstellungen sind in Textfiles zu konfigurieren, später
    sollen Webformulare dies weiter vereinfachen. Umfassendere
    Änderungen erfordern gute HTML, PHP und mySQL Kenntnisse.
    

4.) PhpSecurePages
===================

Das Gratogel Onlinetool verwendet PHP Scripts des Projekts: 
"htttp://www.PhpSecurePages.com". Vielen Dank an die Entwickler für
dieses hervorragende Sicherheitskonzept. Mehr Infos dazu auf der
Projektseite. Alle Scripts sind im Unterverzeichnis /phpsecurepages
zu finden. Diese Scripts wurden minimal für das Gratogel Online Tool
angepasst. Bitte beachten Sie bei jeglicher Verwendung dieser Scripts
die Hinweise und den Disclaimer !!!


5.) ...
========


Andreas Habel
mail@exceptionfault.de
http://sourceforge.net/pojects/onlinetool

Danke an:
SourceForge Logo