fluid ist ein REDAXO-6-Projekt für komplette Websites, die du direkt auf der Seite bearbeitest. Du klickst auf einen Text und tippst, fügst Blöcke ein, verschiebst sie und änderst das Design, genau dort, wo Besucher die Seite sehen. Unter der Haube bleibt alles REDAXO: Jeder Block ist ein echter Slice, mit Arbeitsversion, Rechten und Historie des Cores.
Möglichst ohne weitere AddOns: fluid bringt fast alles selbst mit. Das einzige externe AddOn ist derzeit YForm, für Formulare, Datenlisten und das Postfach. Auch ohne YForm läuft fluid, dann fehlen nur diese Teile. Alles andere ist eingebaut:
| Eingebaut in fluid | statt eines eigenen AddOns für |
|---|---|
| Schöne Adressen, Domains und Landingpages, Weiterleitungen, Sitemap, robots.txt, canonical/hreflang | URL-Verwaltung und SEO |
| Suche mit Tippfehler-Toleranz (Loupe, per Composer) | Volltextsuche |
| Blog/News mit Schlagworten und RSS | News und Blog |
| Design-Vorlagen, Farben, Schriften (selbst gehostet) | Theme-Verwaltung |
| Karten ohne Einwilligung (Proxy), Videos mit Vorschaubild und Untertiteln | Karten und Medien |
| Mehrsprachigkeit für Inhalte und Website-Texte | Sprach-Werkzeuge |
| Entwurf, Versionen mit Vorschau und Vergleich, Aktivität | Versionierung |
| Formular-Baukasten, Datenlisten, Postfach (auf Basis von YForm) | Formulare |
| MCP-Server für KI-Werkzeuge | Schnittstellen |
Optional dazu gibt es image_editor, ebenfalls von FriendsOfREDAXO, zum Zuschneiden und Drehen von Bildern direkt auf der Website, mit Fokuspunkt und eigenem Ausschnitt je Bildformat. fluid läuft auch ohne.
Status: Prototyp. fluid baut auf REDAXO 6 auf, das noch in Entwicklung ist (
redaxo/coreBranch 6.x). Zum Ausprobieren, Mitmachen und für eigene Experimente – noch nicht für Kundenseiten.
- Was fluid kann
- Schnellstart: in fünf Minuten zur eigenen Demo-Website
- Erste Schritte auf der Website
- Was in der Demo steckt
- fluid in ein bestehendes REDAXO-6-Projekt einbauen
- Webserver: schöne Adressen
- KI-Werkzeuge anbinden (MCP)
- Häufige Probleme
- Für Entwickler
- Lizenz und Danke
Für Redakteure – alles auf der Website, über eine Leiste oben:
- Texte direkt auf der Seite ändern, mit Formatierungsleiste; alle Felder eines Blocks in der Seitenleiste
- Blöcke einfügen, verschieben (ziehen oder ↑ ↓), verdoppeln, kopieren, online/offline – 24 Blöcke im Kit, vom Einstieg über Text + Bild, Zahlen, Fragen & Antworten, Preise und Karten bis zum Video
- Layout und Greifer: Spalten, Abstände, Textbreite und Aufteilung Bild/Text mit der Maus ziehen
- Entwurf und Veröffentlichen: Änderungen erst im Entwurf, dann „Veröffentlichen“; ältere Stände wiederherstellen
- Wer arbeitet gerade wo: In der Leiste und im Seitenbaum steht, wer eine Seite gerade bearbeitet. Hat jemand anderes inzwischen gespeichert, fragt fluid vor dem Speichern nach.
- Seiten: Seitenbaum mit Ziehen, neue Seiten (leer, als Kopie, aus einer Vorlage), Adresse und SEO-Angaben
- Design: fertige Design-Vorlagen (u. a. „REDAXO · Blau“) oder Farben, Schriften und Formen einzeln – mit Kontrastprüfung, live auf der Seite
- Mehrsprachig: Sprachwahl in der Leiste, Inhalte einer Sprache übernehmen und übersetzen, Sprachwahl für Besucher
- Blog / News mit Schlagworten, RSS und „Neuer Beitrag“ direkt in der Übersicht
- Formulare zum Zusammenklicken – auch mehrstufig, speichern und/oder per E-Mail, mit Bestätigung (YForm)
- Daten aus YForm als Karten oder Liste mit eigener Adresse je Eintrag – und Blöcke auch in Datensätzen
- Demo zum Ausprobieren (eigenes AddOn
fluid_demo, getrennt zu installieren): Besucher starten per Knopf eine Demo und bearbeiten die Website – gespeichert wird nichts - Videos mit automatischem Vorschaubild und Untertiteln, Karten ohne Einwilligung, Suche mit Tippfehler-Toleranz und Treffern beim Tippen – findet nur, was öffentlich auf der Website steht
Für Besucher: schnelle, barrierearme Seiten, Blättern, Filtern und Suchen ohne Seitenwechsel, schöne Adressen, Sitemap, strukturierte Daten, keine Cookies für Karten.
Für Entwickler: Blöcke sind kleine PHP-Klassen mit Feldschema und View, Extension Points an allen wichtigen Stellen, YForm-Tabellen und -Formulare als Klassen – mehr in der Entwickler-Referenz.
| Formular in Schritten | Blöcke in einem YForm-Datensatz |
|---|---|
 |
 |
Mit einem Befehl entsteht eine komplette Website: REDAXO 6, YForm 6, fluid, die Bildbearbeitung image_editor und – wenn du möchtest – die Demo mit allen Seiten, Beispieldaten, Bildern und dem Design „REDAXO · Blau“.
| Version | So bekommst du es | |
|---|---|---|
| PHP | 8.5 mit pdo_mysql, pdo_sqlite, intl, mbstring, fileinfo, gd oder imagick |
Mac: Herd oder brew install php · Windows: Laragon · Linux: Paketverwaltung |
| MySQL oder MariaDB | MySQL 8.4 / MariaDB 10.11 oder neuer | in Herd/Laragon/MAMP enthalten, sonst DBngin (Mac) |
| git | beliebig | meist schon da: git --version |
| Composer | 2.9 oder neuer | lädt das Skript selbst, wenn deins fehlt oder älter ist |
| ffmpeg | optional | nur für automatische Video-Vorschaubilder |
Prüfen kannst du PHP mit php -v – dort sollte 8.5 stehen.
Im Terminal in den Ordner wechseln, in dem die Website entstehen soll, dann:
curl -fsSLO https://raw.githubusercontent.com/FriendsOfREDAXO/fluid/main/install-dev.sh
bash install-dev.sh meine-seiteDas Skript fragt nach der Datenbank, falls es sich nicht mit root ohne Passwort verbinden kann. Du kannst sie auch
gleich mitgeben:
bash install-dev.sh meine-seite --db mysql://root:geheim@127.0.0.1:3306/meine_seiteDie Datenbank legt das Skript selbst an. Nach etwa einer Minute erscheint:
Website: http://127.0.0.1:8000/
Backend: http://127.0.0.1:8000/redaxo/
Anmelden: admin / (Passwort)
Notier dir das Passwort – es wird nirgends gespeichert. Der Server läuft dann schon; beenden mit Strg + C.
| Befehl | Ergebnis |
|---|---|
bash install-dev.sh meine-seite |
mit Demo: alle Beispielseiten, Blog, Presse, Projekte, Formular, Bilder, Design „REDAXO · Blau“ |
bash install-dev.sh meine-seite --empty |
ohne Inhalte: die Website zeigt „Erste Schritte“ – dort legst du mit einem Klick eine leere Startseite oder doch die Beispielseiten an |
Weitere Optionen: --port 8080 (anderer Port), --admin name (anderer Benutzername), --no-start (Server nicht
starten). Alle Optionen: bash install-dev.sh --help.
cd meine-seite
php -S 127.0.0.1:8000 -t public dev-router.phpDann im Browser http://127.0.0.1:8000/ öffnen. Nutzt du Herd, Laragon, MAMP oder Apache, kannst du auch dort einen
Host auf den Ordner public zeigen lassen (siehe Webserver).
- Anmelden: http://127.0.0.1:8000/redaxo/ öffnen und mit
adminund deinem Passwort anmelden. - Zur Website: Oben im Backend auf den Namen der Website klicken – oder http://127.0.0.1:8000/ öffnen. Weil du angemeldet bist, siehst du oben die Leiste von fluid.
- Bearbeiten: In der Leiste auf „Bearbeiten“. Jetzt kannst du in jeden Text klicken und tippen. Über einem Block erscheint seine Leiste: Bearbeiten öffnet alle Felder in der Seitenleiste, ↑ ↓ verschiebt, ⋯ verdoppelt oder kopiert.
- Block einfügen: Mit der Maus über einen Block fahren, unten auf das runde + klicken und einen Block wählen.
- Speichern und veröffentlichen: „Speichern“ legt die Änderungen im Entwurf ab – Besucher sehen noch die alte Fassung. „Veröffentlichen“ bringt alles live.
- Design: „Design“ öffnet die Vorlagen und alle Einstellungen. Ein Klick auf eine Vorlage zeigt sie sofort; „Speichern“ übernimmt sie für die ganze Website.
- Mehr im Menü ⋯: Seiten (Seitenbaum), Neue Seite, Seiteneinstellungen, Website (Name, Logo, Kontakt, Sprachen, Domains), Verlauf, Anfragen.
- Versionen: Menü ⋯ → Verlauf & Entwürfe → „Zeitleiste mit Vorschau öffnen“. Die Ansicht zeigt dir:
- links jeden gespeicherten Stand der Seite, nach Tagen sortiert,
- rechts die Seite so, wie sie damals aussah, am Desktop oder am Handy.
- „Änderungen hervorheben“ markiert neue und geänderte Blöcke.
- „Gegenüberstellen“ zeigt die Live-Fassung daneben; beide scrollen gemeinsam.
- „Wiederherstellen“ holt einen Stand in den Entwurf. Live ändert sich erst mit „Veröffentlichen“, und der bisherige Entwurf bleibt als Version erhalten.
Im Backend findest du unter AddOns → fluid eine Statusseite, die prüft, ob alles richtig eingerichtet ist.
| Seite | Zeigt |
|---|---|
| Start | Einstieg, Merkmale, Zahlen, Layout mit Text und Zitat in Spalten, Handlungsaufruf |
| Technik, Was sich ändert, Bearbeiten | Schritte, Fließtext, Fragen & Antworten, Merkmale, Zitat, Spalten |
| Bausteine | weitere Blöcke des Kits: Logos, Bento, Reiter, Preise |
| Daten | YForm: Termine als Datenliste, Kontaktformular mit Postfach |
| Presse | Kurzmeldungen aus YForm – nach Datum, mit Blättern und eigener Adresse je Meldung |
| Projekte | Fallstudien: YForm-Einträge, deren Inhalt aus Blöcken besteht – direkt auf der Website bearbeitbar |
| Neuigkeiten | Blog mit Beiträgen, Schlagworten und RSS |
| Anmeldung | Formular-Baukasten mit drei Schritten (nicht im Menü: /anmeldung) |
| Suche | Suche über alle Seiten |
Die Beispiel-Tabellen (Termine, Anfragen, Meldungen, Projekte) liegen als YForm-Klassen in src/YForm/ deines Projekts –
du kannst sie ändern oder löschen. Im Backend stehen sie unter „Daten“.
Neu anfangen: Willst du die Demo-Inhalte wieder loswerden, lösch die Seiten im Seitenbaum – oder setz die ganze Installation neu auf (Ordner und Datenbank löschen, Skript erneut starten).
Du hast schon ein REDAXO-6-Projekt (composer create-project redaxo/project:6.x-dev)? Dann reichen drei Schritte.
Solange fluid und YForm 6 noch nicht auf Packagist stehen, holt Composer sie direkt von GitHub:
composer config repositories.yform '{"type": "vcs", "url": "https://github.com/yakamara/yform", "no-api": true}'
composer config repositories.fluid '{"type": "vcs", "url": "https://github.com/FriendsOfREDAXO/fluid", "no-api": true}'
composer require yakamara/yform:6.x-dev@dev friendsofredaxo/fluid:*@dev
php bin/console migrateYForm ist das einzige externe AddOn, das fluid nutzt, und auch das ist optional: Ohne YForm fehlen nur Formulare, Datenlisten und das Postfach. Für die Bildbearbeitung auf der Website gibt es das AddOn image_editor (optional, das Installationsskript nimmt es mit):
composer config repositories.image_editor '{"type": "vcs", "url": "https://github.com/FriendsOfREDAXO/image_editor", "no-api": true}'
composer require friendsofredaxo/image_editor:*@dev && php bin/console migrateDanach entweder auf der Website „Erste Schritte“ nutzen oder in der Konsole:
# Beispiel-Tabellen der Demo (optional, für Daten/Presse/Projekte)
mkdir -p src/YForm && cp vendor/friendsofredaxo/fluid/examples/yform/*.php src/YForm/ && php bin/console migrate
# komplette Demo mit Bildern und Design „REDAXO · Blau“
php bin/console fluid:demo --set=redaxo6 --media --design=redaxofluid:demo legt Inhalte nur in einer leeren Installation an. In der Konsole kannst du mit --page=projekte
einzelne Demo-Seiten anhängen.
Mail: Formulare und Benachrichtigungen nutzen den Mailer des Cores – MAILER_DSN und REX_MAILER_FROM in
.env.local (das Installationsskript setzt null://null: Mails werden dann nicht verschickt).
Nach Updates (composer update): immer php bin/console migrate – das aktualisiert Tabellen und kopiert die
Assets neu.
fluid löst Adressen wie /projekte/stadtwerke-musterstadt-1 selbst auf. Der Webserver muss deshalb alle Anfragen, zu
denen es keine Datei gibt, an public/index.php geben. Die Wurzel des Webservers ist immer der Ordner public.
Eingebauter PHP-Server (Entwicklung): php -S 127.0.0.1:8000 -t public dev-router.php – dev-router.php legt das
Installationsskript an.
Apache (public/.htaccess – das Skript ergänzt die Regeln):
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]nginx:
root /pfad/zum/projekt/public;
location / {
try_files $uri $uri/ /index.php?$query_string;
}Herd / Valet / Laragon: einen Host auf den Ordner public zeigen lassen – Rewrites sind dort schon eingerichtet.
fluid bringt einen MCP-Server mit (Model Context Protocol). Damit können KI-Werkzeuge wie Claude, ChatGPT oder Cursor deine Website lesen und, wenn du es erlaubst, Inhalte bearbeiten. Alles ist zunächst aus.
- Im Backend AddOns → fluid → MCP öffnen und „MCP-Server einschalten“.
- Unter Zugangsschlüssel einen Schlüssel erzeugen:
- Handelt als Benutzer: Dessen Rechte gelten (Struktur, Module, Veröffentlichen). Am besten legst du dafür einen eigenen REDAXO-Benutzer mit passender Rolle an.
- Darf: „nur lesen“ oder „lesen und ändern“. Änderungen landen immer im Entwurf. Live geht erst „Veröffentlichen“, entweder durch dich auf der Website oder durch einen Schlüssel mit „darf veröffentlichen“.
- Der Schlüssel erscheint nur einmal, zusammen mit dem fertigen Befehl für Claude Code
(
claude mcp add --transport http fluid https://…/fluid-mcp --header "Authorization: Bearer …") und einer JSON-Vorlage für andere Programme.
- Datentabellen (YForm) gibst du einzeln frei: kein Zugriff, lesen, oder lesen und ändern.
- Öffentlicher Zugang (optional, ohne Schlüssel): Du entscheidest, was jeder lesen darf:
- veröffentlichte Seiten,
- die Suche,
- den Blog,
- einzelne Tabellen. Entwürfe und Schreiben gibt es dort nie, und je IP sind höchstens 60 Anfragen in 5 Minuten möglich.
Werkzeuge:
| Werkzeug | Was es tut | Wer |
|---|---|---|
site_overview |
Name, Adresse, Sprachen, Blogs, Tabellen, Rechte des Zugangs | alle |
list_pages · get_page |
Seitenbaum · Seite mit Blöcken (Entwurf oder live) | alle (öffentlich: nur online/live) |
search · list_posts |
Suche · Blog-Beiträge | alle, wenn freigegeben |
list_block_types |
Blocktypen mit Feldern | Schlüssel |
list_entries · get_entry |
Einträge freigegebener Tabellen | Schlüssel, öffentlich nur freigegebene Tabellen |
update_block · add_block · move_block · set_block_online · delete_block |
Blöcke bearbeiten (im Entwurf) | Schlüssel „lesen und ändern“ |
create_page · save_entry |
Seite anlegen (offline) · Eintrag anlegen/ändern | Schlüssel „lesen und ändern“ |
publish_page |
Entwurf veröffentlichen | Schlüssel mit „darf veröffentlichen“ |
Jede Änderung erscheint im Verlauf (Aktivität und Versionen) wie eine Änderung auf der Website. Rich-Text läuft durch denselben Filter wie die Ausgabe, Bilder im Fließtext gibt es nicht.
„PHP … ist zu alt“ – REDAXO 6 braucht PHP 8.5. Hast du mehrere PHP-Versionen, gib die richtige an:
PHP=/pfad/zu/php8.5 bash install-dev.sh meine-seite.
„Keine Verbindung zur Datenbank“ – Läuft MySQL/MariaDB? Stimmen Benutzer, Passwort und Port? MAMP nutzt z. B.
Port 8889 und root/root: --db mysql://root:root@127.0.0.1:8889/meine_seite.
Die Website hat keine Farben/Schriften – Der Webserver zeigt nicht auf public. Beim PHP-Server -t public
nicht vergessen.
Unterseiten liefern „404“, die Startseite geht – Die Rewrite-Regeln fehlen (siehe Webserver).
„Could not authenticate against github.com“ – Composer fragt GitHub über die API ab. Das Skript nutzt deshalb
"no-api": true; trägst du die Repositories selbst ein, nimm dieselbe Schreibweise wie oben.
„This is an invalid domain“ in der Browser-Konsole – kommt von der Passkey-Anmeldung im Backend auf einer
IP-Adresse und ist harmlos. Mit http://localhost:8000/ verschwindet die Meldung.
Nach composer update sieht etwas alt aus – php bin/console migrate ausführen (kopiert die Assets neu).
Passwort vergessen – php bin/console user:set-password admin.
Alles Technische steht in der Entwickler-Referenz:
- eigene Blöcke als Modulklasse + View, alle Feldtypen und Block-Optionen
- Extension Points (
FLUID_BLOCK_DEFINITION,FLUID_BLOCK_VIEW,FLUID_SETTINGS_SCHEMA…) - YForm: Formular-Baukasten, Datenliste, YForm-Feld „Fluid-Blöcke“, Postfach
- Routing, Domains, SEO, Sprachen, Videos, Blog, Karten, Rechte, Konsole
- Suche (was in den Index kommt,
'search' => false), Live-Aktualisierung per SSE, „Neu laden auf Aktion“ (Live::region,data-live-nav), Präsenz der Redaktion – Live und Präsenz wie in KLXM Studio
Ein eigener Block in Kürze:
// src/Block/Teaser.php
#[AsModule('fluid.teaser', 'Teaser')]
final class Teaser extends FluidBlock
{
protected function define(): array
{
return ['label' => 'Teaser', 'group' => 'Inhalt', 'fields' => [
['name' => 'title', 'label' => 'Überschrift', 'type' => 'text', 'required' => true],
['name' => 'text', 'label' => 'Text', 'type' => 'textarea'],
]];
}
}<?php // src/Block/Teaser.view.php ?>
<div class="wrap">
<h2<?= $b->edit('title') ?>><?= e($d['title']) ?></h2>
<p<?= $b->edit('text', 'lines') ?>><?= nl2br(e($d['text']), false) ?></p>
</div>$b->edit('feld') macht das Feld direkt auf der Website bearbeitbar – fertig ist der Block, mit Seitenleiste,
Entwurf, Rechten und Historie.
Mitmachen: Fehler und Ideen gern als Issue, Pull Requests
willkommen. Zum Entwickeln: Repo klonen und FLUID_SOURCE=$PWD/fluid bash fluid/install-dev.sh fluid-dev
(siehe Mitentwickeln).
MIT – siehe LICENSE.
- Konzept und Teile des Codes aus KLXM Studio (MIT)
- REDAXO und YForm von Yakamara und der REDAXO-Community
- Symbole: Phosphor Icons (MIT) · Schriften: SIL Open Font License (Lizenzen in
assets/fonts/) - Karten: MapLibre GL JS (BSD-3), OpenFreeMap, Daten © OpenStreetMap-Mitwirkende (ODbL)
- Suche: Loupe (MIT)
- Das REDAXO-Logo in der Demo gehört dem REDAXO-Projekt; es kommt aus dem Core und wird nur in der Demo verwendet.