DOTLAN Intranet
===============

| (c) 2002-2015 by DOTLAN Webservices Daniel Hoffend
| http://www.dotlan.net | info@dotlan.net

Vorwort
-------

Das DOTLAN Intranet hatte seinen Ursprünge zur Hoch-Zeit der LANparties Szene
zwischen 2002 und 2006 inkl. der PHP Steinzeit Versionen 4.x und den Anfängen
von PHP 5. Da seither die Anforderungen nicht weiter gestiegen sind ist die
CodeBasis und der CodeStil natürlich auf einem sehr alten Stand und kann nicht
mit modernen Projekten und Best Practices mithalten.

Ein komplettes Rewrite / Refactoring auf der aktuellen Code Basis um sehe ich
daher im Moment eher Problematisch und würde vermutlich nur mehr Arbeit
erzeugen und Problem bei der Migration und Kompatibilität zu bestehenden
Installation.

Wer hier ein modernes System erwartet wird leider enttäuscht.

Die Hauptaugenmerkt aktuell liegt darauf die alte CodeBasis weiter am Leben zu
erhalten, kompatibel zu aktuellen PHP Installation des 5.x Zweiges zu halten
und auftretende Problem für die verblienen LANparties zu beheben.

Wer am (veralteten) Codestil etwas auszusetzen hat möge bitte mit der der Zeit-
maschine über 10+ Jahre zurückfliegen und mich damals darauf aufmerksam machen.

Wer wirklich lernen möchte wie man "sauber" PHP programmiert schaut besser auch
folgende Webseite: http://www.phptherightway.com

--
gruß
Daniel Hoffend

Credits und Lizenz
------------------

Das DOTLAN Intranet wurde seit 2002 durch Daniel Hoffend entwickelt und
vertrieben.

Der volle Lizenztext kann der Datei _LICENSE.md_ entnommen werden.

Danke an die unzähligen LANparty oder Turnier Event Organisatoren die in den
vergangenen 10 Jahren tatkräftig mit Ideen oder Bug Reports dazu beigetragen
haben das dass DOTLAN Intranet heute immer noch zu den meist genutzten LANparty
Intranet Systemen gehört. Trotz des Alters und veralteten Code Stiles, nicht
vorhandenen Template Systemes, etc.

Systemvorraussetungen
---------------------

* Apache oder Nginx als Webserver
* PHP 5.3+
* MySQL 5.1+
* empfohlene PHP Erweiterungen: json, gd, mysql, gettext, mcrypt, zip (pecl)

Upgrade
-------

**WICHTIG**

Wer von einer alten Version (1.2.8a oder älter) auf die neue offene
Version aktualisiert der sollte unbegingt die UFT-8 Migrations Dokumentation
durchlesen! **doc/utf8-migration.md**

SQL Updates werden absofort nicht mehr per Version ausgegeben sondern
als Datum versioniert. So sind kontinuierliche Updates einfacher zu handhaben.

Installation
------------

Damit ihr auch in Zukunft sauber das System auf dem aktuellen Stand halten
könnt und Änderungen und Fixes sauber einpflegen könnt empfehle ich euch die
Arbeitweise mit GIT näher anzuschauen.

Eine detaillierte Anleitung liegt im _doc_ ordner. **doc/git.md**. Für die
Installation des lokalen Intranet Servers liegt eine seperate Dokumentation
vor: **doc/intranet-server.md**

1.  Eigenes GIT Repo vorbereiten

        cd /srv/www
        mkdir meinelan
        cd meinelan
        git init

2.  DOTLAN Intranet aus dem GIT Repo auschecken

        git remote add intranet git@git.dotlan.net:dotlan/intranet.git
        git fetch intranet
        git merge intranet/stable-1.5 -m "import intranet/stable-1.5"

3.  Konfiguration anlegen und anpassen.

        cp www/config.example.php www/config.php

4.  Das Document Root des Webserver (apache oder nginx) sollte jetzt auf den
    folgenden Ordner zeigen.

        /srv/www/meinelan/www

    Für Details zur Einrichtung des NGINX Webservers oder mod_rewrite für
    Apache stehen folgende Dokus bereit.

        addons/nginx-php-fpm/
        addons/mod_rewrite/

    Für den lokalen Intranet Server gibt es eine gesonderte Installations
    Anleitung. Das hier gezeigte Setup wird unter anderem auf der Junien
    LANparty so eingesetzt.

        doc/intranet-server.md

4.  MySQL Daten importieren. Hierzu gibt es verschiedene Möglichkeiten.

    a)  Entweder über **phpMyAdmin**

    b)  die integrierten DOTLAN Support Tools:

            http://<url>/admin/support

    c)  Via Commandline:

            mysql -u <user> -p -D db_meinelan < sql/db_intranet.sql
            mysql -u <user> -p -D db_meinelan < sql/addons/ip2country.sql
            mysql -u <user> -p -D db_meinelan < sql/addons/geodata.sql

5.  Sicherstellen das folgende Order für den Webserver beschreibbar sind:

        /images/avatar        // Uploadordner für die Useravatare
        /images/turnier_team  // Uploadordner für die Turnier Teamlogos *NEU*
        /html/media           // Uploadordner für Dateien i.d. MediaDB
        /html/cache           // Ordner fürs Caching von Inhalten.
        /html/turnier         // Uploadordner für Turnierdateien
        /html/forum           // Uploadordner für Dateianhänge im Forum
        /gallery/archive      // hochgeladene Bilder
        /gallery/temp         // Tempordner wo die Zip-Archive entpackt werden
        /gallery/zip          // für die hochgeladenen Zip-Archive

    Je nach Einrichtung des Webservers muss ggf. der Order mit entsprechenden
    Berechtigungen versehen werden (_chmod_)A

6.  Layout Anpassungen. Hier kann ich nur jedem Raten. Erzeugt ein eigenes
    Theme auf Basis des 'dotlan-net3' Themes. So werden bei Updates eure
    Änderunge nicht direkt überschrieben. Details zu anpassungen findet ihr
    in der Dokumentation: **doc/customize.md**

7.  Einloggen mit dem Standart Admin Account:

        USER:  admin
        EMAIL: admin@localhost
        PASS:  admin

    Nach dem ersten einloggen bitte das Passwort und ggf. den Benutzernamen
    ändern!

Weitere Hinweise zum DOTLAN Intranet
------------------------------------

sind im **doc/** Ordner, bzw. der **FAQ** zu finden. Ergänzungen sind
herzlich willkommen.