Choisir entre theme variables et theme advanced
Le moteur supporte deux formats de theme. Le premier se limite a un manifeste JSON avec des variables CSS. Le second ajoute un dossier complet, un style.css et des overrides PHP pour le layout ou certaines pages.
| Format | Contenu | Quand le choisir |
|---|---|---|
| variables | Un fichier JSON avec theme.json ou <id>.json selon le mode d installation. | Pour changer la palette, les polices, les rayons et les ombres sans toucher au markup. |
| advanced | Un dossier avec theme.json, style.css, slots/, parts/ et pages/. | Pour reorganiser le layout, remplacer des zones de rendu ou personnaliser le dashboard. |
Commencer simple, complexifier seulement si necessaire
- Fixer d abord la palette et la typographie avec un theme
variables. - Passer ensuite a un theme
advancedsi le layout doit vraiment changer. - Surcharger une part ciblee avant de recopier un slot complet.
- Reserver les pages custom au cas ou le core expose deja un point d extension pour cet ecran.
dashboard est effectivement branchee par le core. Les autres noms de page sont reserves par le moteur, mais pas encore tous appeles.Ou regarder dans le projet
Le shell principal est rendu par public/layout_top.php et public/layout_bottom.php. Le moteur de themes se trouve dans src/ThemeManager.php, src/ThemeRenderer.php, src/ThemeTemplateTags.php et src/ThemePackage.php.
Pour des exemples concrets, partez de src/themes_builtin/dark.json, src/themes_builtin/light.json et surtout src/themes_builtin/horizon/, qui montre un theme advanced complet.
Ce que cette doc vous aide a sortir
Le but n est pas seulement de documenter le format, mais de donner un cadre de travail complet: structure de dossier, variables valides, slots supportes, template tags a privilegier, contraintes de securite du ZIP, checks de debug et checklist de livraison.