deutsch · english
LOGO SportONLINE: Sportkursverwaltung für Hochschulen & Fitness-Center
   

Dokumentation

Installationseinleitung
Benutzereinleitung
Entwicklereinleitung

Installationseinleitung

* Schritt 1: Umgebung vorbereiten

Sie benötigen einen Webserver mit PHP >=4 und MySQL >= 4.0 (Bei einer Neuinstallation, empfielt sich die Integrierte APACHE-PHP-MySQL-Lösung XAMPP von ApacheFriends

  1. Für die Dauer der Installation benötigen Sie den superuser-Zugang für den Webserver
  2. Für die Einrichtung der Datenbank benötigen Sie den root-Zugang für die MySQL-Datenbank

* Schritt 2: Installieren

Nach dem Download einfach zur Installation folgende Schritte ausführen:

  1. Eine Linux-Shell aufrufen, zum Order wechseln, in dem sich die heruntergeladene Datei befindet, z.B. tmp:

    cd /tmp
    
  2. Dann das heruntergeladene Archiv auspacken, und zum ausgepackten Verzeichnis SportONLINE-1_0_b wechseln:

    tar xvfz SportONLINE-1_0_b.tar.gz
    cd SportONLINE-1_0_b
    
  3. Um die Datenbank zu erzeugen, müssen Sie das SQL-Skript sport_db.sql ausführen. Per default, ein mysql-User sp_admin mit Passwort FIXME! wird angelegt. Aus Sicherheitsgründen sollen Sie das Passwort (oder auch den Usernamen) ändern, am besten sofort. Ersetzen Sie alle Vorkommen von sp_admin und FIXME! durch den gewünschten Usernamen und Passwort in der Datei sport_db.sql. Anschließend sollen sie das Vorkommen von sp_admin und FIXME! in der Datei conf/conf.php entsprechend ändern. Nun können Sie die Datei sport_db.sql ausführen:

    mysql -u root -p < sport_db.sql --default-character-set=utf8 
    
    Alternativ, können Sie die Datei sport_db.sql über einen grafischen MySQL-Client importieren.

    Vorsicht: Beim Importieren der Datenbank können Kodierungsfehler auftretten. Wenn Sie über eine grafische Schnittstelle importieren, stellen Sie sicher, UTF-8 als die Zeichenkodierung für die Datenübertragung zu setzen.

  4. Der Unterordner hsp muss in das DocumentRoot des Webservers (z.B. /srv/www/htdocs) kopiert werden. Werden Sie Superuser und führen das Kopieren durch:

    su -
    cp -R hsp /srv/www/htdocs/
    cd /srv/www/htdocs/hsp
    
  5. Zugriffsberechtigungen müssen nun gesetz werden. Informieren Sie sich wie der Benutzer und die Gruppe des Webserverusers heißen (z.B. in der Konfigurationsdatei httpd.conf). Für das Beispiel des Webserverusers www und -gruppe www-run sieht es so aus:

    chown -R www:www-run .
    chmod -R 550 .
    chmod -R 770 conf/ images/
    

Das war's. Nun dürfen Sie das Quellverzeichnis der Installation tmp/SportONLINE-1_0_b löschen.

* Schritt 3: Testen

In der Adress-(URL-)Zeile des Web-Browsers tippen Sie die URL des Webservers, wo Sie SportONLINE installiert haben, ein, z.B,: http://www.myserver.de und hängen Sie den Pfad der Installation (d.h., hsp) dran:

http://www.myserver.de/hsp

Die Administratorsicht erreichen Sie nun unter

http://www.myserver.de/hsp/login.php
wo Sie sich mit den von Ihnen im Schritt 2.3 definierten Usernamen und Passwort einloggen können.

Und? War das einfach?? Falls irgendwas nicht geklappt hat, überprüfen Sie ob

  1. Der Webserver und die MySQL-Datenbank laufen
  2. Der Webserver ist übers Netzwerk erreichbar
  3. Das hsp-Verzeichnis im DokumentRoot des Webservers liegt
  4. Der User des Webserverprozesses die Leseberechtigung auf die gesammten Dateien in hsp und die Schreibberechtigung (rekursiv!) für die Unterordner conf und images hat.

Benutzereinleitung

* Datenbankzugriff

* Termineverwaltung

Wenn Sie keine Termine verwalten bzw.angezeigt haben wollen, de-selektieven sie die Option Termine in der Kursbeschrebung anzeigen im Menü Einstellungen. Die bereits eingetragenen Termine werden dabei nicht gelöscht sondern nur ausgeblendet.

* Kostenverwaltung

Wenn Sie keine Kosten verwalten bzw.angezeigt haben wollen, de-selektieven sie die Option Kurskosten anzeigen im Menü Einstellungen. Die bereits vorhandenen Kostendaten werden dabei nicht gelöscht sondern nur ausgeblendet. Bei der aktivierten Kostenanzeige besteht es zwei Optionen (zu finden im Menü Einstellungen):
  1. Kosten pro Kurs: die Gebühr wird für den gesamten Kurs (i.e., alle Termine) definiert.
  2. Kosten pro Termin: die Gebühr wird für jeden Termin des Kurses einzeln festgelegt.
Falls die Kosten nicht über die Gebühr definiert sind, benutzen Sie das Feld Kommentar in der Kostenanzeige.
Die Währung für die Kostengebühren (Default Euro) kann über das Menü Einstellungen, Option Währung für die Kostenanzeige geändert werden.

* Einstellungen

Über das Menü Einstellungen kann man die Anzeigeoptionen definieren. Nach dem Speichern geänderter Enstellungen werden diese sofort aktiv.

Entwicklereinleitung

* Konfiguration

In der Datei conf.php befinden sich die Variablen, die die Einstellungen des Systems definieren. Sie werden als Elemente des arrays $config gespechert. Diese ändern sich nur dann, wenn über das Menü Einstellungen im Backend die entsprechenden Optionen geändert werden.

Autor: Svetlana Mansmann
Letzte Änderung: 16 Aug, 2006
© 2006 SportONLINE
SourceForge Logo