Website-Integration
Übersicht
- Sitecake kann sowohl HTML- als auch PHP-Websites verwalten
- Sie müssen eine Indexseite haben (index.html oder index.htm oder index.php oder index.php5)
- Um einen Abschnitt einer Seite bearbeitbar zu machen, fügen Sie die CSS-Klasse sc-content zu einem Wrapper-HTML-Element hinzu
- Verschachtelung von sc-content-Elementen wird nicht unterstützt
Website-Struktur
Nachdem Sie den Inhalt des Sitecake-Archivs heruntergeladen und entpackt haben, sieht es so aus:
sitecake/
sitecake.php
Der Ordner sitecake/ enthält den Sitecake-Code und die Konfiguration. sitecake.php wird als Einstiegspunkt für die Bearbeitung verwendet. Sitecake allein ist nicht funktionsfähig. Sie müssen mindestens eine Indexseite mit mindestens einem bearbeitbaren div haben, um mit der Bearbeitung zu beginnen. Das Minimum ist also:
sitecake/
sitecake.php
index.html
Mit einer Indexdatei und einem bearbeitbaren div darin können Sie neue Inhalte hinzufügen: Überschriften, Text, Listen, Videos...
<!DOCTYPE html>
<html>
<head></head>
<body>
<div class="sc-content"></div>
</body>
</html>
Melden Sie sich bei http://ihredomain.com/sitecake.php an, fügen Sie Inhalte hinzu und klicken Sie auf Veröffentlichen. Ihre Dateien auf dem Server sollten dann so aussehen:
files/
images/
sitecake-backup/
sitecake-temp/
sitecake/
sitecake.php
index.html
Sitecake hat neue Ordner erstellt, um mögliche Inhalte zu speichern.
- files/ zum Speichern hochgeladener Dateien (z.B. PDFs)
- images/ zum Speichern hochgeladener Bilder
- sitecake-backup/ zum Erstellen von Backups. Nach jeder Veröffentlichung erstellt Sitecake einen Snapshot aller Dateien und speichert Kopien in einem mit Datumsstempel benannten Ordner. So ist es möglich, zu jeder Bearbeitung zurückzukehren. Die maximale Anzahl an Backups ist konfigurierbar.
- sitecake-temp/ für Entwurfsseiten und andere Dinge
Bestimmte Dateien von der Bearbeitung ausschließen
Wenn Ihre Website Verzeichnisse oder Dateien enthält, die nicht von Sitecake verwaltet werden sollen, erstellen Sie eine .scignore-Datei im Stammverzeichnis Ihrer Website und listen Sie alle Dateien und Verzeichnisse auf. Jedes in einer neuen Zeile.
Beachten Sie, dass Sitecake standardmäßig nur html-, htm-, php- und php5-Dateien prüft (dies kann über die Konfiguration geändert werden), sodass Dateien mit anderen Erweiterungen (z.B. .htaccess) nicht aufgelistet werden müssen.
.scignore-Datei Beispiel:
framework-dir/
wordpress/
some-file-not-managed-by-sitecake.php
some-file-not-managed-by-sitecake.html
subfolder/some-file-not-managed-by-sitecake.html
Nun gehen wir weiter zur Seitenstruktur.
Seitenstruktur
Die CSS-Klasse sc-content, die einem HTML-Tag hinzugefügt wird, macht dieses Tag zu einem Wrapper für bearbeitbare Inhalte. Vorhandener Code innerhalb des sc-content-Wrappers wird zum Anfangsinhalt, sobald Sitecake geladen wird. Alle von Sitecake unterstützten Tags sind bearbeitbar. Andere Inhalte sind nur verschiebbar – sie können per Drag-and-Drop auf der Website verschoben werden, sind aber nicht bearbeitbar.
Derzeit unterstützt Sitecake diese Inhaltstypen:
- h1-h6 Überschriften
- p Absatz
- ul ungeordnete Liste
- img Bild
- a Links (aber nur innerhalb von p, h1-h6 oder ul), können Textlinks, Bildlinks oder E-Mail-Links sein
- sc-photoset Sitecake-CSS-Klasse für Masonry-Galerien, die durch Drag-and-Drop mehrerer Bilder erstellt werden
- sc-map Sitecake-CSS-Klasse für eingebettete Google Maps
HINWEIS: Die Liste der unterstützten Inhaltstypen wird nach Veröffentlichung von Sitecake v3 erweitert, das Unterstützung für Drittanbieter-Plugins bringt.
Es gibt zwei Arten von sc-content-Containern:
- Basis-Container sc-content
- Repeater, Container für wiederholte Inhalte sc-content-something
Basis-Container sind einfach bearbeitbare Teile einer Webseite.
Repeater-Container haben einen angehängten Namen und fungieren als Inhalts-Repeater. Wenn mehrere Seiten denselben Repeater-Container haben, kopiert Sitecake nach der Bearbeitung eines davon den bearbeiteten Inhalt auf alle Seiten. Typische Anwendungen für Repeater sind Seitenspalten und Fußzeilen.
Das folgende HTML ist ein Beispiel für eine Webseite mit einem Repeater (sc-content-footer) und zwei Basis-Containern (markiert mit sc-content).
<html>
<body>
<div class="row">
<div class="col sc-content">
<h1>Linke Spalte</h1>
<p>Text der linken Spalte</p>
</div>
<div class="col sc-content">
<h1>Rechte Spalte</h1>
<p>Text der rechten Spalte</p>
</div>
</div>
<div class="footer sc-content-footer">
<p>Dies ist die Website-Fußzeile auf allen Seiten</p>
</div>
</body>
</html>
sc-content-Elemente nicht verschachteln
Sitecake unterstützt kein verschachteltes sc-content-Element innerhalb eines anderen sc-content-Elements. Wie im folgenden Beispiel:
<div class="sc-content">
<p>Dies ist korrekter Inhalt.</p>
<div class="sc-content">
<p>Dies ist verschachtelter Inhalt. Erwarten Sie nicht, dass er funktioniert.</p>
</div>
</div>