Administration
Verzeichnisstruktur
Das System ist größtenteils dateibasiert. Für die Benutzerverwaltung und für manche Module, muß der Server SQLite3 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 setzen laut den Angaben des Providers. 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
HTML5 Doctype
Der Webutler und die Editoren bauen auf dem Darstellungsmodus von HTML5 auf.
<!DOCTYPE html>
Wer Webseiten im Quirks Mode (ohne Doctype), in HTML 4 oder XHTML erstellt hat sollte sie erstmal auf HTML5 umstellen, um plötzlichen Änderungen in der Darstellung aus dem Weg zu gehen.
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:
- 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.
- Die Charset Angabe im Header der Datei muß angepasst werden:
<meta charset="utf-8" />
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 HTML5 sind wird an dieser Stelle vorrausgesetzt. Folgende Anpassungen sind zwingend erforderlich:
- kopieren Sie Ihre CSS-Dateien nach /content/style
- kopieren Sie Ihre Javascripte nach /includes/javascript
- kopieren Sie Bilder und andere eingebundene Medien in die vorgesehenen Unterverzeichnisse von /content/media
- ö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 oder Slashs)
- speichern Sie alle Seiten ohne Dateiendung in /content/pages
- Unterverzeichnisse können mit den Kategorien simuliert werden (Infos)
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.
- 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 "wb_menuelement", "wb_blockelement", "wb_contentelement" und ggf. "wb_gridelement" (Infos)
- alle Dateinamen in /menus, /blocks und /pages müssen ohne Endung gespeichert werden
- kopieren Sie Seiten mit verschiedenen Layouts von /pages nach /layouts
- entfernen Sie alle Inhalte zwischen <!-- begin_content --> und <!-- end_content -->
- 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.