InhaltsverzeichnisAnleitung für FortgeschritteneInstallation, Konfiguration

# Für Fortgeschrittene

Hinweis: Sollten Sie Probleme haben, lesen Sie bitte zuerst den Abschnitt für Anfänger.

## Installation (Kurzfassung)

Die Installation erfolgt in mehreren Schritten:

1. Dekomprimierung der bereitgestellten Archivdatei. Zu beachten ist, dass Groß- und Kleinschreibung berücksichtigt wird und die gespeicherten Dateipfade ebenfalls wiederhergestellt werden.
2. Übertragung der dekomprimierten Daten unter Berücksichtigung der Pfadstruktur in das HTDOCS-Verzeichnis des Apache Webservers. Verwenden Sie dazu eine geeignete Software Ihrer Wahl. Sollten Sie direkt am Server arbeiten können, ist dies in der Regel entweder Kommandozeile oder ein Dateimanager. Andernfalls in der Regel ein FTP-Client. Die erforderlichen Einstellungen für die FTP-Verbindung erfragen Sie bitte bei Bedarf bei Ihrem zuständigen Administrator.
3. Beachten Sie unter Unix- beziehungsweise unter Linux-Betriebssystemen, dass die Zugriffsrechte für die Software korrekt konfiguriert sind. Diese Software benötigt Leserechte für alle mitgelieferten Dateien und Verzeichnisse. Alle Dateien mit der Endung "php" müssen ausführbar sein. Darüber hinaus benötigt die Software Schreibrechte für die Verzeichnisse "config/", "cache/" und alle darin enthaltenen Dateien und Unterverzeichnisse.

Die folgenden Schritte sind nur erforderlich, falls ein Datenbankplugin verwendet werden soll.

1. Einrichten einer neuen Datenbank, sofern keine bereits existierende Datenbank verwendet werden soll. Dies kann zum Beispiel über eine geeignete grafische Oberfläche wie PHP MyAdmin erfolgen. Falls dies nicht zur Verfügung steht ist die Bereitstellung über die Kommandozeile von MySQL möglich verwenden Sie dazu folgende Zeile: "CREATE DATABASE guestbook". Die Datenbank kann eine andere Bezeichnung als die hier verwendete erhalten. Beachten Sie jedoch bitte Groß- und Kleinschreibung. Für weitere Details zur MySQL Syntax empfehle ich die Lektüre des kostenlos verfügbaren MySQL-Handbuchs. (siehe Literaturempfehlungen)
2. Sofern kein geeigneter Nutzer für die betreffende Datenbank zur Verfügung steht, legen Sie bitte zu diesem Zweck einen neuen Nutzer an. Dieser Nutzer benötigt Zugriff auf die eben erstellte Datenbank sowie folgende Rechte: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER. Verwenden Sie dazu die nachstehende SQL-Anweisung: "GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER ON '<Datenbankname>' . * TO "<Nutzername>"@"<Host>" IDENTIFIED BY '<Passwort>';". Passen Sie diese Anweisung an, sofern notwendig. Ersetzen Sie insbesondere den Namen der Datenbank den Nutzernamen, das Passwort und die Adresse des Datenbankservers ("Host") falls erforderlich entsprechend Ihrer aktuellen Konfiguration. Notieren Sie sich diese Daten für den späteren Gebrauch. Anmerkung: Sie können, falls dies gewünscht ist, dem Nutzer die Rechte "CREATE" und "ALTER" nach erfolgreicher Installation der Datenbank wieder entziehen.

Hinweis: Diese Anleitung richtet sich an erfahrene Benutzer, welche bereits über Erfahrung im Umgang mit PHP und HTML, sowie der Einrichtung von Skripten auf Unix-Systemen verfügen. Falls Sie sich nicht zu dieser Gruppe zählen, lesen bitte zuerst den Abschnitt für Anfänger.

## Konfiguration

Die wichtigsten Schritte zur Konfiguration der Anwendung:

1. Rufen Sie die Startseite "index.php?action=index" mithilfe javascriptfähigen Webbrowser auf. Wir empfohlen dazu die Verwendung von Firefox 1.5 oder höher. Dieser steht für verschiedene Plattformen zur Verfügung. Sie können selbstverständlich einen anderen Browser verwenden. Dieser sollte jedoch mindestens folgende Anforderungen erfüllen: Unterstützung von HTML 4.1, JavaScript 1.5, DOM Level 2 sowie CSS 2.1 oder höher.
2. Anmelden am System. Klicken Sie den Knopf mit der Aufschrift "Login" und melden Sie sich unter der Verwendung des Nutzernamen "Administrator" an. Lassen Sie das Feld "Passwort" bitte frei. (Zu Anfang ist noch kein Passwort festgelegt)
3. Das Hauptmenü kennt zwei Einstellungen: Anfänger- und Expertenmodus. Sie sollten nun in den Expertenmodus wechseln. Nutzen Sie dazu den Schalter am Kopf der Tabelle.
4. Oberhalb des Hauptmenüs finden Sie eine Menüleiste für die Profilverwaltung. Diese erlaubt das Anlegen von neuen Profilen, sowie das Auswählen von bestehenden Profilen. Außerdem finden Sie hier den Schalter zum Leeren des Template-Caches. Dieser bewirkt, dass alle im Verzeichis "cache/" gespeicherten Dateien gelöscht werden. Dieser Schalter kann gelegentlich nützlich sein, falls das Programm sich nach einer Änderung der Einstellungen nicht wie erwartet verhält. Das Hauptmenü selbst untergliedert sich in 2 Spalten. In der rechten Spalte finden Sie eine Liste aller installierten Komponenten. Diese sind nach 3 Kategorien geordnet: Plugins, Skins und Sprachdateien. In der linken Spalte finden Sie alle Konfigurationseinstellungen der installierten Plugins. Der Inhalt dieser Spalte ändert sich dynamisch je nachdem welche Plugins bzw. Anwendungskomponenten installiert worden sind.

Die folgenden Schritte sind nur erforderlich, falls ein Datenbankplugin verwendet werden soll.

1. Wählen Sie aus der Profilleiste die "Basiseinstellungen" und klicken Sie anschliessend in der linken Spalte auf den Schalter "Datenbank Setup".
2. Geben Sie die erforderlichen Daten für die Verbindung zu Ihrem Datenbankserver ein. Diese Daten erhalten Sie bei Bedarf bei Ihrem Administrator. Beachten Sie die Hinweise der Online-Hilfe. (Dies ist der grau gedruckte Text oberhalb des Eingabeformulars.) Speichern Sie anschließend die vorgenommenen Änderungen.
3. Jede Datenbankanwendung hat Ihren eigenen Installer. Wählen Sie in der linken Spalte den Eintrag "Datenbank installieren" um die automatische Installation zu starten. (Der Schalter kann je nachdem welche Datenbankanwendung Sie installieren möchten unterschiedlich benannt sein.) Der Installer verwendet eine vorbereitete SQL-Datei, um alle notwendigen Tabellen einzurichten. Sollten Sie Änderungen daran vornehmen wollen, finden Sie diese Datei im Verzeichnis im Stammverzeichnis des jeweiligen Plugins. Sie hat die Dateiendung "sql". Das Editieren der SQL-Datei wird nur Experten empfohlen. Änderungen können dazu führen, dass die Software nicht mehr korrekt funktioniert. (Sie tun dies auf eigene Gefahr)

5. Abschließend empfiehlt es sich für das Nutzerkonto "Administrator" ein Passwort zu vergeben. Wählen Sie zu diesem Zweck aus dem Menü "Optionen" den Eintrag "Passwort ändern". Geben Sie ein neues Passwort ein und speichern Sie die Änderungen. Anschließend müssen Sie sich mit dem neuen Passwort erneut am System anmelden.
6. Optional empfiehlt es sich, individuelle Einstellungen für das Layout der Software vorzunehmen. Diese beeinflussen Aussehen und Verhalten der GUI. Die Optionen zum Editieren dieser Einstellungen finden Sie in der linken Spalte des Administrationsmenüs. Achten Sie auf die bereitgestellte Online-Hilfe der Software.
7. Sollten Sie mit Ihren Einstellungen zufrieden sein, sollten Sie sich aus Sicherheitsgründen durch Klicken auf den Knopf "Logout" vom System abmelden. Dadurch wird Ihre aktive Session terminiert. Dies verhindert potentielle Angriffe durch Dritte unter Verwendung Ihrer Session-ID. ("Session Riding")

## allgemeine Hinweise

Das Programm verfügt über eine Profilverwaltung, welche es gestattet, mehrere Sätze von Einstellungen (Profile) konkurrierend zu speichern und zu betreiben. Zunächst sollten Sie das Default-Profil auswählen und dieses Ihren Bedürfnissen anpassen. Wählen Sie nacheinander die "Setup" Einträge aus dem Menü "Optionen" um Einstellungen zu editieren, welche mit den Funktionen des Programms zusammenhängen. Das Administrationsmenü offeriert Ihnen eine Reihe von verschiedenen Optionen.

Tipp für Communities: Falls Sie zum Beispiel mehrere Gästebücher besitzen und möchten, dass eines Ihrer Gästebücher ganz besondere Einstellungen verwendet, welche von den Defaultwerten abweichen, dann benutzen Sie das Feld "neues Profil anlegen", um für dieses eine Gästebuch ein eigenes Profil zu erzeugen. Geben Sie die ID des Gästebuches ein und klicken Sie auf "und los". Die Einstellungsmöglichkeiten sind die gleichen, wie bei den Basiseinstellungen. Nachdem die Einstellungen gespeichert sind, taucht der Name des neuen Profils im Auswahlmenü der verfügbaren Profile auf. Sie können auf diese Weise alle gespeicherten Profile jederzeit abrufen und editieren.

Dieses Programm kann beliebig vielen Nutzern gleichzeitig jeweils eigene Instanzen der Anwendung zur Verfügung stellen. Es ist ein "Multiusersystem". Falls Sie zum Beispiel das Gästebuch-Plugin benutzen, dann könnten Sie somit jedem Nutzer ein eigenes Gästebuch zuordnen.
Damit all diese Gästebucher unterschieden werden können, hat jedes Gästebuch eine eindeutige ID welche diesem Gästebuch quasi "einen Namen" gibt und es eindeutig identifiziert. Diese id finden Sie auch in der URL des Browsers, als optionalen Parameter "id".
Sie können mehrere Profile anlegen. Ein Profil ist eine Menge von Einstellungen, welche für das Gästebuch gelten. Es gilt immer 1 Profil für genau 1 Gästebuch.
Falls ein Gästebuch kein eigenes Profil besitzt, dann werden Defaultwerte verwendet. Diese Defaultwerte sind in einem eigenen Profil mit dem Namen "Basiseinstellungen" gespeichert.

Im Administrationsmenü Ihrer Anwendung finden Sie eine Auflistung aller Profile, die bis jetzt angelegt worden sind. Sie können diese Option verwenden um Ihre verschiedenen Profile zu editieren, falls mehr als 1 Profil existiert. Ein Profil gilt jeweils nur für das Gästebuch mit der passenden ID.
Über die Option "neues Profil anlegen" können Sie neue Profile erzeugen. Um neue Profile erzeugen zu können, müssen Sie über Administratorrechte verfügen.

Die Nutzerverwaltung für Communities ist standardmäßig deaktiviert. Um diese Option zu aktivieren, wählen Sie (als Administrator) im Hauptmenü aus der rechten Spalte, im Menü "Plugins", für den Eintrag "Nutzerverwaltung, Konfiguration" die Option "an". (Dies ist der linke der beiden Schalter) Klicken Sie anschließend auf "Änderungen speichern". In der linken Spalte des Hauptmenüs wird anschließend automatisch ein neues Menü "Nutzerverwaltung" erscheinen, welches es Ihnen erlaubt, neue Nutzer anzulegen, sowie Passwörter und Zugriffsrechte zu vergeben.

## weiterführende Literatur

1. MySQL Online Dokumentation, http://dev.mysql.com/doc/
2. Self-PHP, http://www.selfphp.info
3. Offizielle PHP Webseite, http://www.php.net
4. PHP Security - Manual http://www.php.net/manual/en/security.php

© 2001, 2002, 2003, 2004, 2005, 2006Thomas Meyer, www.all-community.de/pub