Installation und Grundlagen
Ordnerstruktur
Was wo liegt und welche Ordner ein Update ersetzt.
Grundregel: /bloqy ist das Programm, alles andere gehört zur Website. Ein Update tauscht nur /bloqy aus.
| Ordner | Inhalt | Beim Update |
|---|---|---|
/bloqy | Programm, Admin, Editor, mitgelieferte Blöcke; darin cache/ und logs/ | ersetzt (außer cache/, logs/) |
/config | Einstellungen (site.json), Geheimnisse (secrets.php), Benutzer, Rollen, Lizenz, Blöcke und Designs (modules/), Effekte, Stile, Komponenten, Seitenlayouts, Vorlagen, Snippets, Automationen, Statistik, Backups | nie |
/theme | Tailwind-Basis, custom.scss, SCSS-Teildateien, Schriften, JavaScript, HTML-Vorlagen, Favicon | nie |
/media | Mediathek; _variants/ enthält die erzeugten Bildgrößen | nie |
/docs | Entwickler-Dokumentation (nicht öffentlich) | nur bei der Installation angelegt |
/de, /en … | Sprachprojekte mit den Seiten | nie |
Ein Sprachprojekt
Jede Seite besteht aus zwei Dateien: <name>.php mit dem Inhalt (Verweise auf Blöcke) und .bloqy/<name>.json mit Titel, Status, SEO und weiteren Eigenschaften. Der Dateipfad ist die Adresse, z. B. /de/produkte/uebersicht.php.
Im Ordner .bloqy des Projekts liegen außerdem Entwürfe, Versionen, Menüs, Seitenteile (Header, Footer), globale Blöcke, Formulareingänge, Weiterleitungen und die Projekt-Einstellungen.
Reservierte Projektnamen sind bloqy, config, docs, media, theme und .bloqy.
Gesperrte Bereiche
Von außen gesperrt sind /config, /docs, alle versteckten Ordner (insbesondere .bloqy) und alles unter /bloqy außer dem Admin-Einstieg und /bloqy/assets. Skripte unter /media und /theme werden nie ausgeführt.
Ändere Live-Dateien von Seiten nicht per FTP oder Git. Neue Dateien, die so hinzukommen, zeigt der Dateimanager grau und fragt, ob sie übernommen werden sollen.
Eine ausführliche Übersicht steht in docs/ordnerstruktur.md deiner Installation.