Les squelettes

Les squelettes sont un ensemble de fichiers qui permettent de modéliser l'apparence du site web selon ses préférences et besoins.

La syntaxe utilisée dans les squelettes s'appelle Brindille.

La documentation complète est intégrée à Paheko depuis la version 1.2.8, cliquer sur le menu Site web, l'onglet Configuration, puis sur le lien Documentation en haut à droite.

Sinon il est aussi possible de lire en ligne la documentation du langage Brindille de la version stable actuelle de Paheko.

Il est aussi possible de lire la documentation de la version de développement.

Exemples de sites réalisés avec Paheko

Modifications dans la version 1.1

La version 1.1 passe de la syntaxe des squelettes SPIP à la nouvelle syntaxe Brindille. Les anciens squelettes du répertoire squelettes ne seront plus utilisés, vous devrez re-créer vos squelettes à la main dans l'interface de Paheko. Malheureusement après 9 ans d'utilisation les squelettes SPIP n'étaient plus suffisants et ne pourront plus être utilisés. Cependant la logique reste très similaire, mais la syntaxe se rapproche de celle de Smarty et PHP pour faciliter l'utilisation par les personnes ayant déjà une expérience en programmation.

Exemple d'ancienne boucle de type SPIP :

<BOUCLE_enfants(PAGES){parent}{par date_creation}{inverse}{0,20}>
<h1>#TITRE</h1>
<h5>Posté : [(#DATE_MODIFICATION|date_intelligente)]</h5>

Avec Brindille cela devient :

{{#articles parent=$parent_id order="published DESC" begin=0 limit=20}}
<h1>{{ $title }}</h1>
<h5>Posté : {{ $created|relative_date }}
{{/articles}}

Le fichier www/squelettes/mes_filtres.php n'est plus utilisé. Un nouvel événement usertemplate.init est lancé à l'initialisation d'un squelette, au moment d'enregistrer les filtres et sections. Utilisez une extension (plugin) pour enregistrer filtres et sections personnalisés. Vous pouvez utiliser le paramètre template pour accéder à l'objet UserTemplate du squelette et y enregistrer vos filtres et sections à l'aide des méthodes ->registerModifier($name, $callback); et ->registerSection($name, $callback);. Voir le fichier include/lib/Garradin/UserTemplate.php pour des exemples.

Changements divers :

  • Le squelette par défaut pour la page d'accueil n'est plus sommaire.html mais index.html
  • Tout squelette dont le nom de fichier existe sera appelé directement
  • Les rubriques ont été renommées catégories
  • Il est désormais possible de faire une requête SQL arbitraire sur n'importe quelle table via le type de section sql

L'ancienne syntaxe, proche de SPIP, n'est plus utilisée, mais la documentation peut toujours être [consultée].