02 — Voraussetzungen
Server
| Komponente | Version | Anmerkung |
|---|---|---|
| TYPO3 | 14.0 – 14.99 | In ext_emconf.php deklariert; unter v13 lässt sich die Extension nicht installieren. |
| PHP | 8.4 empfohlen | Es gilt das Minimum von TYPO3 v14 selbst. |
| Bootstrap Package | 16.0 – 16.99 | Harte Abhängigkeit. Composer löst sie über Packagist auf, im Classic Mode kommt sie aus dem TER. |
| Datenbank | MySQL 8 / MariaDB 10.6+ | Was immer TYPO3 v14 unterstützt. |
| Composer | 2.x | Für den empfohlenen Installationsweg. |
PHP-Erweiterungen: die Vorgaben von TYPO3 v14, dazu gd. Die Bildverarbeitung selbst erledigen die Kommandozeilenwerkzeuge von ImageMagick oder GraphicsMagick, die TYPO3 aufruft — die PHP-Erweiterungen ersetzen sie nicht. Nichts, was über eine normale TYPO3-Installation hinausgeht.
Für das ausgelieferte Projekt
Das ZIP aus dem Kundenportal ist ein fertiges DDEV-Projekt. Eine Erstinstallation braucht deshalb nichts weiter auf dem Rechner:
| Komponente | Anmerkung |
|---|---|
| Docker | DDEV betreibt die Container darauf. |
| DDEV | Wird als installiert und lauffähig vorausgesetzt; siehe ddev.readthedocs.io. PHP, Composer und MariaDB liegen im Container. |
Docker und DDEV einzurichten ist nicht Teil dieser Dokumentation.
Die mitgelieferte .ddev/config.yaml legt PHP 8.4, nginx-fpm und MariaDB 10.11 fest. Siehe 03 — Installation mit DDEV.
Wie die Extensions ausgeliefert werden
yavi_core und das Theme liegen nicht auf Packagist, und es gibt keine private Composer-Registry, die einzutragen wäre. Beide kommen als ZIP aus dem Kundenlogin auf licence.yavithemes.com (Konto → Downloads); Updates kommen von derselben Seite, solange das Update-Fenster der Lizenz läuft.
Was nicht nötig ist
- Kein Node.js, npm oder yarn. SCSS wird serverseitig von scssphp kompiliert, das Bootstrap Package mitbringt. Es gibt keine Asset-Pipeline auszuführen und kein
dist/-Verzeichnis einzuchecken. - Kein Build-Schritt im Deployment. Dateien ausrollen, Cache leeren, fertig.
Fremdpakete, die mitkommen
| Paket | Wozu |
|---|---|
bk2k/bootstrap-package | Basis-Inhaltselemente, SCSS-Kompilierung, Bildvarianten. |
Optional, falls die Site sie nutzt: b13/container (die mehrspaltigen Container-Elemente bringen die Konfiguration dafür mit).
Lizenz
Jedes Theme verlangt einen Lizenzschlüssel. Ohne gültige Lizenz arbeitet die Extension nicht. yavi_core allein braucht keinen Schlüssel — allein ist es aber auch kein Design. Siehe 11 — Lizenz.
Schreibbare Pfade
Der installierende Benutzer braucht Schreibrechte auf:
| Pfad | Wozu |
|---|---|
config/sites/<id>/settings.yaml | Hierhin schreibt das Backend-Modul jede Einstellung. |
var/cache/ | Kompiliertes SCSS, DI-Cache, Page-Cache. |
typo3temp/assets/ | Hier landet das kompilierte theme-<hash>.css. |
fileadmin/ | Selbst gehostete Google-Schriften werden hier bei Bedarf abgelegt. |
Ist config/sites/<id>/settings.yaml schreibgeschützt — ein häufiger Zustand bei Deployments, die die Konfiguration als unveränderliches Artefakt ausliefern —, zeigt das Modul zwar das Formular, kann aber nicht speichern. Das ist mit Abstand die häufigste Meldung „das Backend-Modul tut nichts“.
Browser-Unterstützung (Frontend)
Das Theme setzt bewusst auf modernes CSS: :has(), color-mix(), overflow: clip, durchgehend Custom Properties, container-type. In der Praxis heißt das: die jeweils letzten beiden Versionen von Chrome, Edge, Firefox und Safari. Ältere Browser bekommen eine lesbare, aber schlichtere Seite — genau dafür gibt es die SCSS-Skalare $color-* als statischen Rückfall.