phase oen updates

2026-07-27 08:19:38 +01:00
parent 09cad63280
commit 3a93d4eaea
35 changed files with 512 additions and 73 deletions
@@ -0,0 +1,33 @@
+# Content composition module
+
+This module separates public pages into reusable typed content documents placed in named regions.
+
+## Install the baseline composition
+
+```bash
+php artisan migrate
+php artisan content:install-saasland
+```
+
+Use `--force` to replace the existing `home` placements while retaining reusable documents.
+
+```bash
+php artisan content:install-saasland --force
+```
+
+## Administration
+
+After signing in, open:
+
+- `/admin/content` for reusable content documents.
+- `/admin/content/pages/home` for the homepage header/body/footer composition.
+
+Documents contain structured JSON data and can be shared by several page placements. Placements own ordering, enabled state, scheduling, visibility and presentation metadata. The Saasland frontend falls back to its original hard-coded homepage until the migration and installer command have been run.
+
+## Theme renderers
+
+Saasland renderers are stored under:
+
+`resources/themes/saasland/views/documents`
+
+The renderer name is defined by each `content_types.renderer` value. Missing renderers fail safely through `content::documents.unsupported`.