Blocks¶
Les Blocks sont ce que vous voyez dans la sidebar (region ‘right’ dans le theme default) en boites. Ils appartiennent à une region particulière.
Elements¶
Tous les blocks sont rendus via l’element block.ctp (trouvé dans app/Plugin/Blocks/View/Elements/block.ctp). Vous pouvez aussi utiliser votre propre element pour vos blocks en modifiant le champ ‘element’ lors de l’ajout d’un block.
Tip: Si c’est un element de plugin, entrez ‘PluginName.element_name’.
Comment afficher un THIS et THAT dans un block?¶
Vous êtes capable de montrer un element, menu, vocabulary (une liste imbriquée de termes), ou une liste de noeuds en entrant un texte spécialement formaté dans le corps de votre block.
Element¶
Pour un element avec un nom de fichier my_element.ctp:
[element:my_element] OR [e:my_element]
Passer des variables à votre element:
[element:my_element myVar=”value here” anotherVar=”value here”]
Pour les elements de plugin:
[element:my_element plugin=”my_plugin”]
Vocabulary¶
Pour un Vocabulary avec l’alias categories:
[vocabulary:categories] OR [v:categories]
Avancé
Ces options peuvent changer drastiquement la façon dont votre site web fonctionne, à manier avec précaution
Variables supportées :
- link=”true” : si à true, cela crée un lien pour chaque vocabulary trouvé, il va créer le lien en utilisant les arguments fournis pour le plugin, controller, action et le type.
- plugin=”nameOfPlugin” : nom du plugin fourni pour créer un lien
- controller=”controller” : nom du controller fourni pour créer un lien
- action=”action” : nom de l’action fourni pour créer un lien
- type=”type” : type de node fourni pour créer un lien
- tag=”htmlTag” : tag to wrap content output
- tagAttributes=”className” : className for wrapping tag
- element=”Taxonomy.vocabulary” : Element à utiliser comme template
Nodes¶
Par exemple, vous voulez montrer une liste des 5 posts les plus récents dans un block:
[node:recent_posts conditions=”Node.type:blog;Node.status:1” order=”Node.id DESC” limit=”5”]
Avancé
Ces options peuvent changer drastiquement la façon dont votre site web fonctionne, à manier avec précaution
Variables supportées :
- link=”true” : si à true, cela crée un lien pour chaque vocabulary trouvé, il va créer le lien en utilisant les arguments fournis pour le plugin, controller, action et le type.
- plugin=”nodes” : nom du plugin fourni pour créer un lien
- controller=”nodes” : nom du controller fourni pour créer un lien
- action=”view” : nom de l’action fourni pour créer un lien
- element=”Nodes.node_list” : Element à utiliser comme template