konfiguration

Die Sitecake-Konfigurationsdateien befinden sich im Ordner sitecake/. Es gibt drei Hauptkonfigurationsdateien, die Sie eventuell bearbeiten müssen.

Die Ordnerstruktur sieht so aus:

sitecake/
  <version>/
    client/
    config/
      ...
      config.php
  credentials.php.default
  credentials.php
  editor.cnf

Die drei Konfigurationsdateien sind:

• sitecake/credentials.php — enthält das CMS-Admin-Passwort
• sitecake/editor.cnf — Editor- und Symbolleisten-Konfiguration
• sitecake/<version>/config/config.php — allgemeine CMS-Konfiguration

Admin-Passwort

Die Datei credentials.php enthält das Admin-Passwort als bcrypt-Hash:

<?php $credentials = "$2y$12$XXXXXXXXXXXXXXXXXXXXXXeXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; ?>

Das Standardpasswort ist admin. Ändern Sie es über die Option Passwort ändern im Login-Dialog — bearbeiten Sie den Hash nicht von Hand.

Wenn Sie das Passwort vergessen haben, ersetzen Sie credentials.php durch credentials.php.default, um es auf admin zurückzusetzen. Siehe die Anleitung zum Zurücksetzen des Passworts.

Editor-Konfiguration

Die Datei editor.cnf steuert das Verhalten von Symbolleiste und Editor:

# Toolbar.components - die Liste der Inhaltstypen in der Symbolleiste
# Möglich: HEADING1..6, TEXT, TEXTLIST, IMAGE, FLASH, VIDEO, MAP, HTML, FILE, SEP
Toolbar.components = HEADING1,HEADING2,HEADING3,TEXTLIST,TEXT,SEP,IMAGE,VIDEO,SEP,FLASH,MAP,HTML,FILE

# Upload-Größenlimit in KB
FileUploaderItem.uploadSizeLimit = 20000

# Oberflächensprache (en, sl, sr, es, de, fr, dk, it, jp, ru, cs, sk, pt, pt-br, nl, auto)
Locale.code = auto

Toolbar.components listet die zur Bearbeitung verfügbaren Elemente auf. Standardmäßig werden nur die Überschriften H1–H3 angezeigt. Die Liste kann neu geordnet und mit SEP (einem Trenner) unterteilt werden.

FileUploaderItem.uploadSizeLimit legt die maximale Upload-Größe für Bilder/Dateien in KB fest. Der Standard von 20000 KB (~19,5 MB) kann bei Bedarf erhöht werden.

Locale.code legt die Oberflächensprache fest. Der Standard auto erkennt die Sprache anhand der IP-Adresse des Editors. Siehe Mehrsprachigkeit für weitere Details.

Allgemeine Konfiguration

Die Datei config.php (in sitecake/<version>/config/) legt allgemeine CMS-Optionen fest:

• debug — ob sich Sitecake im Debug-Modus befindet. Beeinflusst Fehleranzeige und Logging.
• entry_point_file_name — die Einstiegspunkt-Datei (sitecake.php). Kann aus Sicherheitsgründen umbenannt werden.
• session.save_handler — Session-Handler: files, memcache, memcached oder redis.
• session.options — Optionen für die Session-Speicherung. ini_set muss auf dem Server aktiviert sein.
• log.size — maximale Log-Dateigröße vor der Archivierung (Standard: 2 MB).
• log.archive_size — Anzahl der aufbewahrten archivierten Log-Dateien (Standard: 5).
• error.level — PHP-Fehlerstufe.
• site.default_pages — Array der Standard-Indexseiten-Erweiterungen, nach denen Sitecake sucht (z. B. index.html, index.php).
• site.number_of_backups — wie viele Veröffentlichungs-Backups aufbewahrt werden (Standard: 2).
• site.images_directory_name — Ordner für hochgeladene Bilder (Standard: images).
• image.valid_extensions — akzeptierte Bildformate (Standard: jpg, jpeg, png, gif, webp).
• image.srcset_widths — Breiten (in px), die für responsive srcset-Bilder generiert werden (Standard: 1280, 960, 640, 320).
• image.srcset_qualities — JPEG-Qualität (0–100), die beim Generieren von srcset-Bildern verwendet wird (Standard: 75).
• upload.directory_name — Ordner für hochgeladene Dateien (Standard: files).
• upload.allowed_extensions — Positivliste der akzeptierten Dateierweiterungen für Nicht-Bild-Uploads (PDFs, Dokumente, Archive usw.).
• pages.prioritize_manual_changes — wenn eine Seite sowohl über Sitecake (unveröffentlicht) als auch manuell hochgeladen bearbeitet wird, gewinnt bei true (Standard) die manuell hochgeladene Version.
• pages.use_document_relative_paths — verwendet dokumentrelative statt site-relative Pfade in generierten Navigationslinks.

Dateisystem-Adapter

Standardmäßig schreibt Sitecake direkt auf die Website-Dateien auf der Festplatte (local-Adapter). Falls der PHP-Prozess nicht in das Site-Root schreiben kann — üblich bei manchen Shared-Hosting-Anbietern — wechseln Sie stattdessen zum ftp-Adapter:

$config['filesystem.adapter'] = 'ftp';
$config['filesystem.adapter.config'] = [
    'host' => 'ftp.example.com',
    'username' => 'username',
    'password' => 'password',
    'root' => '/path/to/root',
    'passive' => true,
    'ssl' => true,
    'timeout' => 30,
    'port' => 21,
];