Fulgurite developer docs - Context and template tags

Contexte

Ce que contient le tableau $ctx

Cle	Type	Usage
`title`, `subtitle`	string	Titre et sous-titre de la page.
`active`	string	Entree de navigation active.
`actions`	string	Bloc HTML d actions pre-rendu par le core.
`flash`	array\|null	Message flash eventuel.
`user`	array\|null	Utilisateur courant.
`theme_id`	string	Identifiant du theme actif.
`app_name`, `app_logo_letter`	string	Identite de l instance.
`nav`	array	Navigation deja filtree par permissions.

Dans une page surchargee, vous pouvez aussi recevoir page_id et data. Pour le dashboard, data contient aujourd hui le resume charge par le core.

Navigation

Structure de $ctx['nav']

[
  'key' => 'dashboard',
  'label' => 'Dashboard',
  'href' => '/index.php',
  'active' => true,
  'section' => 'Vue d ensemble',
  'icon' => '<svg>...</svg>',
  'group_key' => 'monitoring',
  'group_label' => 'Suivi',
  'group_icon' => '<svg>...</svg>',
]

La navigation est deja filtree selon les permissions de l utilisateur. Un theme peut la reordonner ou la restyler, mais ne doit pas essayer de contourner ces controles.

API de theme

Template tags a privilegier

rui_current_user(), rui_can(), rui_can_restore()
rui_app_name(), rui_app_logo_letter(), rui_theme_id()
rui_nav(), rui_route(), rui_escape()
rui_part(), rui_slot(), rui_default_slot()
rui_dashboard_summary(), rui_list_repos(), rui_list_hosts(), rui_list_users()

Ces helpers sont exposes par src/ThemeTemplateTags.php. Ils constituent une surface plus stable que des appels directs a la base, a des managers internes ou a des objets non prevus pour les themes.

Bonnes pratiques

Composer un theme sans le rendre fragile

Favoriser une surcharge de part plutot qu une recopie complete de slot.
Utiliser rui_default_slot() pour enrober le rendu natif quand cela suffit.
Echapper les sorties dynamiques avec rui_escape() ou les helpers existants.
Eviter la logique metier et les acces directs a la couche interne depuis les templates du theme.

Traitez les classes internes comme une implementation du core, pas comme une API stable pour les themes. La meilleure defense contre les regressions reste de passer par le contexte et les template tags.