# Administration

## Verzeichnisstruktur

Das System ist größtenteils dateibasiert. Für die Benutzerverwaltung und für manche Module, muß der Server SQLite unterstützen.

- Das /admin Verzeichnis enthält die Editoren sowie die Bearbeitungs- und Speicherscripte.
- Im Verzeichnis /settings liegen die Konfigurationsdateien.
- Das Verzeichnis /content sowie alle Unterverzeichnisse und Dateien müssen beschreibbar sein, CHMOD 777. In /content befinden sich alle von der Administration aus bearbeitbaren Dateien.
- In /includes sind ein paar Basiserweiterungen abgelegt, die (mehr oder weniger) direkt mit der Administration zusammenarbeiten.
- Das Verzeichnis /modules ist der Platz für eigene Erweiterungen.

## Vorhandene HTML-Seiten integrieren

### Die Welt spricht UTF-8

Sowohl der Webutler als auch der CKEditor arbeiten mit dem Unicode-Zeichensatz. Damit es keine Probleme mit Umlauten oder anderen Sonderzeichen gibt müssen alle Dateien, die nicht mit dem Webutler erstellt wurden, in UTF-8 gespeichert werden. Zwei Dinge gilt es zu beachten:

1. Die Dateien selbst müssen als "UTF-8 ohne BOM" gespeichert werden. Dazu muß man natürlich einen Unicode-fähigen Editor benutzen, z.B. Notepad++ oder PSPad.
2. Die Charset Angabe im Header der Datei muß angepasst werden:
   <meta content="text/html; charset=utf-8" http-equiv="content-type" />

### Doctype XHTML Transitional

Der Webutler und die Editoren sind für den Darstellungsmodus XHTML Transitional voreingestellt.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
Wer Webseiten in HTML 4 oder im Quirks Mode (ohne Doctype) erstellt hat sollte sie erstmal auf XHTML Transitional umstellen, um plötzlichen Änderungen in der Darstellung aus dem Weg zu gehen. HTML 5 wird (noch) nicht unterstützt.

### Seiten anpassen/umstellen

Fertige HTML-Seiten lassen sich recht unproblematisch in den Webutler einfügen. Alle Vorbereitungen sollten lokal erfolgen. Daß sie in UTF-8 und XHTML sind wird an dieser Stelle mal vorrausgesetzt. Folgende Änderungen sind zwingend erforderlich:

1. kopieren Sie Ihre CSS-Dateien nach /content/style
2. kopieren Sie Ihre Javascripte nach /includes/javascript
3. kopieren Sie Bilder und andere eingebundene Medien in die vorgesehenen Unterverzeichnisse von /content/media
4. öffnen Sie Ihre HTML-Seiten
   - passen Sie die Pfade zu den CSS-, Javascript- und Mediendateien an
     (evtl. müssen auch Pfade in den Dateien selbst angepasst werden)
   - ersetzen Sie alle Links zu Ihren Seiten: aus DATEINAME.html wird index.php?page=DATEINAME
   - Dateinamen dürfen nur aus Buchstaben, Ziffern und dem Unterstrich bestehen (keine Umlaute)
     (Unterverzeichnisse in der URL werden nicht unterstützt)
   - speichern Sie alle Seiten ohne Dateiendung in /content/pages

Außerdem können noch folgende Änderungen, die die Pflege der Homepage wesentlich erleichtern, gemacht werden. Wer diese Möglichkeit nicht nutzen möchte, sollte die Einstellung $webutler_config['fullpageedit'] in der Datei "/settings/globalvars.php" auf "1" setzen.

1. Im HTML-Quellcode können Platzhalter für Menüs, Blöcke und bearbeitbare Bereiche gesetzt werden.
   - öffnen Sie Ihre Seiten aus /content/pages
   - schneiden Sie die Menüs aus Ihren Seiten und speichern Sie sie im Ordner /content/menus
   - Header- und/oder Footerzeilen können ebenfalls ausgeschnitten und in /content/blocks gespeichert werden
   - setzen Sie die Platzhalter (Kommentare) für die Menüs und Blöcke (Infos)
   - setzen Sie die Kommentare für bearbeitbare Bereiche (Infos)
   - setzen Sie die Klassen "block_border" und "content_border", wenn gewünscht (Infos)
2. alle Dateinamen in /menus, /blocks und /pages können/sollten ohne Endung gespeichert werden
3. kopieren Sie Seiten mit verschiedenen Layouts von /pages nach /layouts
   - entfernen Sie alle Inhalte zwischen den "begin_content_" und "end_content_" Kommentaren
   - speichern Sie die Seite als LAYOUTNAME.tpl

Das wars, jetzt noch alles auf den Webspace und die Seite sollte funktionieren. Wenn nicht, nochmal alle Punkte genau kontrollieren. Stimmen alle Pfade und Dateinamen? Dateinamen dürfen keine Leerzeichen, Bindestriche oder Umlaute enthalten.