Blocs
Les blocs
Manipuler les blocs dans le contenu de la page
Il est possible d’exclure des blocs du contenu d’une page, ce qui permet notamment de les replacer ailleurs, pour les besoins du design.
Exclusion
Pour ne pas afficher un ou plusieurs blocs en particulier, il faut leur ajouter une class supplémentaire dans le back-office, par exemple in-hero (qui devient dans le fichier statique block-class-in-hero), puis ajouter à la configuration du site (ou du sous-thème) ceci :
blocks:
ignored:
- block-class-in-heroTous les blocs avec cette classe ne s’afficheront plus dans le contenu des pages grâce à un filtre dans la liste des blocs de chaque page :
{{ if and (eq .kind "block") (not (in site.Params.hero.blocks .html_class) )}}Déplacement
Cela permet d’afficher ces blocs ailleurs : organisations ou appel à action dans un hero, après la navigation dans une actualité, etc.
Dans le cas de la Gaîté Lyrique, nous avons besoin d’afficher certains types de blocs dans le hero de certaines pages.
Dans un premier temps, on vérifie la présence de blocs dans la page, dans un hook ou dans un override du hero :
{{ with .Params.contents }}
{{ partial "blocks/ignored" . }}
{{ end }}NB : dans le cas d’un override, c’est .context.Params.contents qui contient les données recherchées.
Dans partials/blocks/ignored.html, un fichier créé spécifiquement sur un site et non sur le thème Osuny, on fait ensuite l’inverse de l’exclusion, en cherchant les blocs dont le paramètre html_class correspond à la liste indiquée en configuration. On peut cibler un certain type de blocs uniquement, afin d’éviter les mauvaises surprises, comme une galerie dans le hero :
<div class="blocks">
{{ range $index, $content := . }}
{{ if in site.Params.blocks.ignored .html_class }}
{{ if or (eq .template "chapter") (eq .template "call_to_action") (eq .template "organizations") (eq .template "image") }}
{{ $template := printf "blocks/templates/%s.html" .template }}
{{ if templates.Exists ( printf "partials/%s" $template ) }}
{{ partial $template (dict
"block" $content
"index" $index
)}}
{{ end }}
{{ end }}
{{ end }}
{{ end }}
</div>Personnalisation et surcouche du bloc selon sa classe
Il est possible de remplacer le partiel d’un bloc spécifique par un partiel propre au site. Le thème détecte la classe ajoutée au bloc dans l’espace d’administration osuny et charge en surcouche le fichier correspondant, s’il existe.
Principe
- Dans l’espace d’administration, ajouter une classe supplémentaire au bloc, par exemple
alphabetsur un bloc Organisations. - Dans le site (ou le sous-thème), créer le partiel correspondant :
layouts/_partials/custom/blocks/organizations--alphabet.html
Le nom du fichier suit la convention <type-de-bloc>--<classe>.html.
Si le fichier existe, le thème l’utilise pour afficher le bloc. Sinon, le bloc s’affiche normalement : aucune configuration n’est nécessaire.
Exemple
Un site souhaite afficher la liste des organisations par ordre alphabétique, avec une présentation différente du rendu par défaut :
- Ajouter la classe
alphabetau bloc Organisations de la page. - Créer le fichier
layouts/_partials/custom/blocks/organizations--alphabet.htmlavec le code HTML de la présentation souhaitée.
Tous les blocs Organisations portant la classe alphabet utiliseront ce rendu. Les autres blocs Organisations ne sont pas modifiés.
Différence avec l’exclusion
- Exclusion : le bloc n’est plus affiché dans le contenu de la page, ce qui permet de l’afficher ailleurs (par exemple dans un hero).
- Surcouche par classe : le bloc reste à sa place dans le contenu, mais avec un rendu spécifique au site.