Read Me

-------------------------------------------------------------------------------
ReadMe gSalesEA

1. Allgemeine Hinweise

Das System ist immer noch in der Entwicklung hat lediglich noch den Alpha-
Status und ist deshalb noch nicht produktiv einsetzbar. Für weitere Hilfen und 
Infos bitte unter Sourceforge https://sourceforge.net/p/gsales-ea/ nachsehen.
Dort werden alle Infos zum System, Versions-Status sowie weitere Infos und 
Hilfen zum System gSalesEA angeboten. 

Das System unterliegt der Lizenz GPL v3 und ist OpenSource. Die Lizenz kann 
unter http://www.gnu.de/documents/gpl-3.0.de.html eingesehen werden.


2. System-Voraussetzungen

Das System wurde auf einem Windows-7 mit Zend_Server-5.5 unter PHP-5.3.x und 
MySQL-5.1 entwickelt und auf einem Ubuntu 10.04 mit Apache-Webserver unter 
PHP-5.3.x und MySQL-5.1 getestet. Für andere Systeme und Versionen wird keine 
Garantie übernommen.

Benötigt wird auf jeden Fall PHP > 5.2 sowie ein MySQL-Datenbank-Server Version 
> 5. Das ZendFramework sowie eigene Framework-Erweiterungen werden im 
Verzeichnis /library mitgeliefert.



3. Installation

3.1 Zunächst bitte mittels phpMyAdmin (oder anderes Verwaltungstool) die 
    Datenbank für das System erzeugen und die Datei /data/creates.sql mit den 
    Tabellen in diese Datenbank importieren.

3.2 Die Verzeichnis-Struktur sollte nicht geändert werden! Die Verzeichnisse 
    /application und /library sollten unterhalb des Webservers-Document-Roots 
    aus Sicherheitsgründen liegen. Das Verzechnis /htdocs ist der Document-
    Root des Webservers und somit öffentlich erreichbar.
    
    Die Verzeichnisse /data und /docs müssen nicht auf den Server geladen 
    werden!
    
    Die Verzeichnisse /invoices und /temp im Verzeichnis /application benötigen 
    Schreibrechte (chmod 775 bzw. chmod 777).
 
3.3 In der Datei /application/configs/application.ini Zeilen 73 bis 77 müssen 
    die Datenbank-Zugangs-Daten eingetragen werden.
    
    In der Datei /application/configs/system.ini sollten ebenfalls die 
    entsprechenden Daten von der gSales-API hinterlegt werden.

3.4 Startet man das System und erhält direkt eine Fehlermeldung, dass ein 
    Controller nicht gefunden werden kann (bzw. weiße Seite), in der Datei
    /htdocs/.htaccess die Zeilen 2 bis 7 mit einer Raute am Anfang kommentieren
    und die Rauten in den Zeilen 13 und 14 entfernen. Sollten immer noch 
    Fehlermeldungen erscheinen (bzw. eine weiße Seite), mich bitte kontakten 
    oder ans Forum (https://sourceforge.net/p/gsales-ea/discussion/hilfe/)
    wenden.
    
3.5 Es sollte zum Start ein Login-Formular erscheinen. Hat man in der Datei 
    /data/creates.sql nicht die Zugangsdaten zum Admin geändert (Zeile 86), 
    kann man sich mit dem Benutzernamen admin und dem Passwort admin nun 
    einloggen und kommt zum Dashboard des Systems.