Notre exemple sera donc : ajouter un bloc dans le gabarit sommaire permettant de lister les auteurs du site. Cela se passe en trois étapes : créer le bloc, l’ajouter dans la liste des blocs disponibles du gabarit sommaire, puis le disposer dans la page de gabarit à l’endroit où on veut l’afficher.
1) Créer le dossier "pages-custom"
Un dossier du nom de "pages-custom" doit être créé à la racine de votre sie (pas à la racine du plugin). Ceci permet d’ajouter ses blocs, pages et gabarits sans intervenir directement dans le plugin et donc de pouvoir continuer à mettre à jour le plugin sans risquer de perdre ses contenus personnels.
Dans ce dossier vous pouvez ajouter vos pages "autres", comme par exemple "rubrique-25.html" pour la rubrique 25 et ses enfants, conformément à la documentation spip.
2) Créer le bloc
Notre exemple est simple, mais il requiert une boucle spip. Il est à noter que du code html pur (sans spip) ou n’importe quel code acceptable dans une page web (javascript, css par exemple) peuvent être utilisés. Le code du bloc sera celui-ci :
<B_listeauteurs>
<div id="liste-auteurs" class="listagebloc">
<h2>Liste des auteurs</h2>
<ul class="listageconteneur">
<BOUCLE_listeauteurs(AUTEURS){tout}>
<li>
<h4 class="listagetitre"><a href="mailto:#EMAIL">[(#NOM|supprimer_numero)]</a></h4>
[<p class="listagetexte">(#BIO|couper{200}|supprimer_tags)</p>]
</li>
</BOUCLE_listeauteurs>
</ul>
</div>
</B_listeauteurs>
Ce code html respecte la mise en page css et html globale, de telle manière qu’il reçoit le formatage de base des blocs. Une documentation générale sur la structure html et css des pages magusine est en cours.
Enregistrez ce fichier dans le dossier "pages-custom" sous un nom precis genre liste_auteurs.html. Ce nom doit être unique dans le plugin, sinon le fichier sera inclus à la place d’un autre du même nom dans la plugin. Un fichier nommé "article.html" sera chargé à la place du fichier pour les articles de tout le site !
3) Injecter dans un gabarit
Il faut maintenant rendre disponible ce bloc dans le gabarit "sommaire" de magusine.
- Créer un dossier "gabarits" dans le dossier "pages-custom"
A l’intérieur de ce doosier, on va placer un fichier du nom de "ajout-sommaire.xml". Le contenu de ce fichier est celui-ci :
<?xml version="1.0" encoding="utf-8"?>
<gabarit type="defaut">
<bloc statut="3">liste_auteurs</bloc>
</gabarit>
Si on veut ajouter un autre bloc dans le sommaire, on ajoute une ligne dans le fichier ajout-sommaire.xml avec On peut ajouter des parametres dans les blocs (menu déroulant ou champ à remplir), voir dans le dossier "definitions-gabarit" du plugin.
On peut ajouter des blocs dans les articles (ajout-article.xml), rubrique (ajout-rubrique.xml) et tous les gabarits existants (ajout-le nom du gabarit.xml).
Il est possible évidemment de rajouter un même bloc dans plusieurs gabarits, du moment que les arguments nécessaires (id_article, id_rubrique par exemple) soient adaptés au gabarit.
4. Disposer le bloc dans la page
Aller maintenant dans l’administration du plugin magusine. Si tout a été bien codé et disposé, le bloc doit apparaitre dans le corps car dans le xml, son statut est "3". Si statut est égal à 0, ce sera dans la réserve, 1 et 2 étant les contextes.
Placez-le par drag’n drop à l’endroit de votre choix, ici dans un des contextes par exemple. Enregistrez et recalculez la page sommaire.
5. Appréciez
Le bloc est maintenant disposé. A vous de vérifier son code et de le modifier, éventuellement ajouter un comportement css particulier, etc. L’ajout d’autres blocs suit la même logique.
6. Plus loin
Il est possible de créer des pages spéciales avec leur propre gabarit et leur propres blocs. C’est l’objet d’un autre didactitiel, pas encore écrit à ce stade.
