# RELEASE_CONTENTS.md – ITSWEBER CMS v3.3.0

## Zweck

Dokumentation des aktuellen Release-Stands v3.3.0 für Endnutzer und Betreiber des ITSWEBER CMS.

---

## Release-Dateien

| Artefakt | Datei | Pfad |
|---|---|---|
| **Voll-Release 3.3.0** | `ITSWEBER_CMS_v3.3.0.zip` | `artifacts/releases/` |
| **Update 3.2.0 → 3.3.0** | `itsweber-cms-update-3.3.0.zip` | `artifacts/updates/` |

### Installationspfad

**Frische Neuinstallation:** `ITSWEBER_CMS_v3.3.0.zip` entpacken, Document Root auf `public/` setzen, `/installer` im Browser aufrufen. Der Installer führt durch 7 Schritte (Systemcheck, Datenbank, Tabellen, Admin-Benutzer, Site-Setup, Mail-Konfiguration, Abschluss). Nach der Installation: Themes und Plugins über den Admin-Bereich nachinstallieren.

**Update von 3.2.0:** `itsweber-cms-update-3.3.0.zip` über Admin → CMS-Update einspielen. Preflight-Check, Migrations-Ausführung und Datei-Update laufen automatisch.

---

## Enthaltene Hauptgruppen (Core-Release-Basis)

| Pfad | Beschreibung |
|---|---|
| `app/` | Core-Logik, Models, Services, HTTP-Layer, Config, Helpers |
| `admin/` | Admin-Backend (Controller, Views, Assets) |
| `installer/` | Web-Installer (Views, Assets) |
| `public/` | Document Root – einziger per Webserver erreichbarer Bereich |
| `themes/` | Core-Themes: default (3.3.0), business (3.3.0), creative (3.3.0) |
| `database/migrations/` | PHP-Migrationen (001–034) |
| `storage/` | Laufzeit-Verzeichnisstruktur (Cache, Logs, Sessions, Temp) |
| `database/seeds/` | Default-Daten und Starter-Content-Seeds |
| `README.md` | Installations- und Betriebsdokumentation |

---

## Bewusst ausgeschlossene Inhalte

| Ausgeschlossen | Grund |
|---|---|
| `themes/itsweber/` | Premium-Theme, separat bereitgestellt (in `projects/itsweber.de/artifacts/themes/`) |
| `themes/roterkaul/` | Premium-Theme, separat bereitgestellt (in `projects/roterkaul.de/artifacts/themes/`) |
| `themes/lackhexe/` | Premium-Theme, separat bereitgestellt (in `projects/lackhexe.com/artifacts/themes/`) |
| `themes/reifenservice-kuhn/` | Premium-Theme, separat bereitgestellt (in `projects/reifenservice-kuhn.de/artifacts/themes/`) |
| `public/themes/itsweber/` | Public-Asset-Spiegel des ITSWEBER-Themes – separat |
| `public/themes/roterkaul/` | Public-Asset-Spiegel des Roterkaul-Themes – separat |
| `public/themes/lackhexe/` | Public-Asset-Spiegel des Lackhexe-Themes – separat |
| `public/themes/reifenservice-kuhn/` | Public-Asset-Spiegel des ReifenService-Kuhn-Themes – separat |
| `plugins/` | Plugins sind separate Artefakte, nicht vorinstalliert |
| `public/plugins/` | Plugin-Assets – separat ausgeliefert |
| `artifacts/` | Entwicklungs- und Release-Artefakte, kein Betriebsinhalt |
| `docs/` | Kompletter Ordner – interne Architektur-/Entwicklungsdoku |
| `_archive/` | Interne Entwicklungsarchive |
| `CLAUDE.md` | Interne Arbeitsanweisung |
| `tools/` | Entwicklerwerkzeuge – kein Betriebsinhalt |
| `projects/` | Aktive Kundenprojekte – kein Betriebsinhalt |
| `.git/` | Versionskontrollverzeichnis |
| OS-Artefakte (`.DS_Store`, `Thumbs.db`) | Werden beim Packen übersprungen |
| Cache-, Session- und Log-Inhalte | Nur leere Verzeichnisstruktur wird ausgeliefert |

---

## Laufzeit- und Schreibverzeichnisse (vorbereitet, leer)

`storage/cache/`, `storage/logs/`, `storage/sessions/`, `storage/temp/`,
`public/uploads/`, `public/uploads/blog/`, `public/uploads/gallery/`,
`public/uploads/downloads/`, `public/uploads/brand/`, `public/uploads/brand/thumbs/`

---

## Separat verfügbare Artefakte

| Artefakt | Pfad |
|---|---|
| ITSWEBER Premium-Theme 3.3.0 | `projects/itsweber.de/artifacts/themes/itsweber-theme-3.3.0.zip` |
| Roterkaul Premium-Theme 3.3.0 | `projects/roterkaul.de/artifacts/themes/roterkaul-theme-3.3.0.zip` |
| Lackhexe Premium-Theme 3.3.0 | `projects/lackhexe.com/artifacts/themes/lackhexe-theme-3.3.0.zip` |
| ReifenService-Kuhn Premium-Theme 3.3.0 | `projects/reifenservice-kuhn.de/artifacts/themes/reifenservice-kuhn-theme-3.3.0.zip` |
| animated-counter Plugin 1.0.0 | `artifacts/plugins/animated-counter-plugin-1.0.0.zip` |
| aurora-background Plugin 1.0.0 | `artifacts/plugins/aurora-background-plugin-1.0.0.zip` |
| faq-accordion Plugin 1.0.0 | `artifacts/plugins/faq-accordion-plugin-1.0.0.zip` |
| image-sphere Plugin 1.0.0 | `artifacts/plugins/image-sphere-plugin-1.0.0.zip` |
| image-swiper Plugin 1.0.0 | `artifacts/plugins/image-swiper-plugin-1.0.0.zip` |
| magnifier-lens Plugin 1.0.0 | `artifacts/plugins/magnifier-lens-plugin-1.0.0.zip` |
| pricing-table Plugin 1.0.0 | `artifacts/plugins/pricing-table-plugin-1.0.0.zip` |
| testimonial-slider Plugin 1.0.0 | `artifacts/plugins/testimonial-slider-plugin-1.0.0.zip` |
| web-tools Plugin 1.0.0 | `artifacts/plugins/web-tools-plugin-1.0.0.zip` |

---

## Neu in Version 3.3.0 (gegenüber 3.2.0)

### Page Builder & Section-System (3.3.0)

**Page Builder:**
- Neu: Visueller Page Builder im Admin für alle Seiten
- Drag-and-Drop-Reihenfolge für Sections
- Live-Vorschau direkt im Admin-Backend

**Section-Templates:**
- Alle 7 Themes haben jetzt vollständige Section-Template-Abdeckung (19 Core-Sections)
- Core-Themes (business, creative): alle 19 Section-Templates kopiert aus default
- Premium-Themes (itsweber, roterkaul, lackhexe, reifenservice-kuhn): fehlende Templates ergänzt

**Menu-System:**
- Neu: Flexibles Menüsystem (Hauptmenü, Footer-Menü) im Admin verwaltbar
- Drag-and-Drop-Reihenfolge, Nested-Menus

**Mail-Templates:**
- Neu: Editierbare Mail-Templates im Admin
- Kontaktformular, Passwort-Reset und benutzerdefinierte Templates

**Neue Section-Typen:**
- Alle 9 neuen Plugins mit Section-Typen einsatzbereit

### Theme-Verbesserungen (3.3.0)

**ReifenService-Kuhn:**
- Neu: Scroll-to-Top Button (HTML, CSS, JS)
- 14 fehlende Section-Templates ergänzt

**Lackhexe:**
- Neu: event-single.php Template (lh- CSS-Prefix-Konvention)
- 11 fehlende Section-Templates ergänzt

**Creative:**
- Dark Mode bewusst nicht implementiert (Theme ist bereits dunkel – design decision, dokumentiert in `docs/design-decisions-v330.md`)

**Alle 7 Themes:**
- `theme.json` Version auf 3.3.0 aktualisiert
- `min_cms_version: "3.2.0"` Feld hinzugefügt

### Deployment & Build (3.3.0)

- `.gitattributes` mit `* text=auto eol=lf` für Windows/Linux-Kompatibilität
- Build-Tools: `tools/build-release.php`, `build-update.php`, `build-theme.php`, `build-plugin.php`
- Validierung via `tools/validate-package.php`

---

## Neu in Version 3.2.0 (gegenüber 3.1.3)

### Section-System-Grundlage (3.2.0)
- Einführung des Section-Systems als Core-Feature
- `AbstractSection`, `SectionRegistry`, 20 Core-Section-Klassen
- 3-stufiges Fallback: Theme → Default → Plugin
- Plugin-Section-API stabilisiert (REGEL 22: DB-Registrierung via `iw_section_types`)

---

## Neu in Version 3.1.3 (gegenüber 3.1.2)

### Qualitäts- und Vollständigkeitsrelease (3.1.3)

**Admin JS Internationalisierung:**
- Neu: `window.iwT` Translations-System für admin.js
- 17 neue JS-Translation-Keys in DE/EN (`admin.js.*`)
- Alle 30 hardcodierten Strings in admin.js durch Translation-Lookups ersetzt

**Installer CSRF-Schutz:**
- Fix: Alle 5 Installer-POST-Formulare haben jetzt CSRF-Token-Felder

**Migrations-Tracking:**
- Neu: `iw_migrations` Tabelle wird automatisch erstellt
- Migrator überspringt bereits ausgeführte Migrationen

**Dashboard Performance:**
- Fix: 10 separate COUNT-Queries konsolidiert in 1 SQL-Query

**XML Sitemap:**
- Neu: `/sitemap.xml` Endpoint mit automatischer Sitemap-Generierung

---

## Release-Erstellung

Erstellt: 2026-04-05
Version: 3.3.0

© Benjamin Weber / ITSWEBER – www.itsweber.de – info@itsweber.de
