Administration

Verzeichnisstruktur

Das System ist größtenteils dateibasiert. Für die Benutzerverwaltung und für manche Module, muss 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 muss man natürlich einen Unicode-fähigen Editor benutzen, z.B. Notepad++ oder PSPad.
Die Charset Angabe im Header der Datei muss 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. Dass 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 /content/javascript
kopieren Sie Bilder und andere eingebundene Medien in die vorgesehenen Unterverzeichnisse von /content/media
öffnen Sie Ihre HTML-Seiten
- entfernen Sie CSS- und Javascriptdateien aus dem Quelltext
- tragen Sie die Dateien in /settings/compress.php ein
- passen Sie die Pfade zu den Mediendateien an
- ersetzen Sie alle Links zu Ihren Seiten: aus DATEINAME.html wird index.php?wbpagefile=DATEINAME
- Dateinamen dürfen nur aus Buchstaben, Ziffern und dem Unterstrich bestehen, Sonderzeichen müssen URL-codiert werden
- 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_baseelement", "wb_frameelement" und "wb_columnselement" (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  und 
- 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 Sonderzeichen enthalten.