.: Le Compositeur :.

Qu'est ce que c'est ?

Le Compositeur apparait depuis la version 5.4.2 de Concrete5, il s'agit du'une interface vous permettant de préconfigurer des pages selon vos besions. En effet vous pouvez choisir un type de page, y intégrer les blocs désirés à l'endroit désiré, et choisir où ce tpye de page peut être publié sur votre site.

C'est un outils bien pratique si vous avez sur votre site une équipe d'éditeurs devant respecter une charte de publication bien précise, et n'ayant pas l'habitude de cliquer sur chaque zone à chaque fois pour respecter le modèle.

Ce n'est pas parceque votre page est publiée via le compositeur, que vous ne pouvez pas par la suite l'éditer en contexte comme tout le reste devotre site :) vous le pouvez sans soucis.

Comment ça marche ?

Il vous faut aller sur votre tableau de bord en premier lieu pour trouver cette fonctionalité. Puis dans le menu de gauche vous cliquez sur Compositeur et obtenez cette fenêtre:

Ce message vous indique qu'il vous faut paramétrer vos types de pages. Vu que vous avez le choix des types de pages autorisés, il vous faut les configurer.

Configurer les types de pages autorisés

Allez sur le menu Pages et Thèmes puis cliquez sur l'onglet Types de pages, vous obtenez:

Prenons par exemple le typ colonne à gauche, cliquez alors sur le bouton Compositeur situé à droite de la ligne du type de page Left Sidebar. Un tableau apparait, le seul choix possible à l'origine est la validation ou non de l'inclusion de ce type de page dans le compositeur. Lorsque vous cochez la case la suite du tableau devient paramétrable:

Vous avez alors deux catégories de paramètres.

Paramètres de publication du compositeur

1. Choisir depuis toutes les pages en publiant.
2. Choisir depuis certains types de pages en publiant.
3. Toujours publier sous cette page.

1 Ce réglage vous permet de sélectionner n'importe quelle endroit de l'arborescence de votre site à l'enregistrement de la page. C'est le choix non restrictif de ce menu.

2 Ceci vous restreint à enregistrer votre page sous un certain type de page uniquement. Par exemple, si vous paramétrer une composition de page spécifique devant se trouver en tant que sous page (page enfant) d'un type particulier, vous devez choisir ce type de page. Ainsi l'éditeur n'aura pas le choix de l'endroit où sauvegarder son édition.

3 Ici nous sommes encore plus restrictif, le principe est le même que précédemment, mais l'éditeur n'a pas le choix de l'emplacement de publication dans l'arborescence. La page sera automatiquement enregistrée à un endroit bien précis de votre plan de site.

Attributs à afficher dans le compositeur

Cette catégorie vous permet de sélectionner les attributs de page automatiquement affichés dans les propriété de votre page. Exactement de la même façon que si vous régliez les paramètres de votre type de page.

Adméttons que nous ayons donc choisir le type Left Sidebar, et paramétré celle-ci de la façon suivante:

Une fois votre paramétrage teriné cliquez sur Enregistrer les réglages du compositeur.

Paramétrer un type de page

Le Compositeur deviens utile à partir du moment où vou avez une idée bien précise de l'agencement de vos pages. Il nous faut donc paramétrer les blocs contenu par défaut dans celle-ci. Nous affinerons cela plus tard dans le compositeur. Celui-ci nous permettra alors de réaliser des déclinaisons de notre type par défaut.

Paramétrer un type de page par défaut

Etant certain que vous ne anquerez pas de tester bon nombre de combinaisons possibles, nous allons simplement reprendre notre exemple avec le type left side bar.

Allez sur la page Tableau de bord → Pages et thèmes → Types de pages puis cliquez sur le bouton Par défaut situé sur le ligne Left Sidebar.

Vous obtenez une fenêtre avec l'apperçu de votre type de page vide, ne contenant que les blocs par défaut déjà paramétrés sur celle-ci. Vous avez un petit encart éggalement vous informant également de là où vous êtes, pour éviter toute confusion.

Editer les blocs par défaut du type de page

Passons la page en mode édition, et ajoutons par exemple:

• un fil d'ariane dans le header, sous le diaporama existant.
• Deux blocs de contenu vides dans la zone main.
• Un bloc de liste de page dans la zone sidebar, sous le menu existant.

Une fois les blocs ajoutés par défaut cliquez sur l'un d'eux et vous remarquez une option supplémentaire: Paramètres du compositeur.

Lorsque vous cliquez dessus vous obtenez la fenêtre de dialogue suivante:

Vous pouvez choisir d'inclure ce bloc dans votre compositeur ou non, et lui donner un nom. Concernant le nom essayez d'extre explicite pour vous y retrouver plus tard, surtout si au final vous obtenez X pages composées de Y blocs.

Nous reviendrons sur le thème plus tard ;)

Ajouter les blocs désirés dans le compositeur en les nommants. Pour notre exemple je les ai tous ajouté dans le compisteur avec des noms bateau.

Sorter ensuite du mode édition de votre type de page par défaut.

Composer votre première page

Retournons dans le menu Compositeur du Tableau de bord, vous obtenez alors une fenêtre permetant d'éditer directement tous les blocs paramétrés par défaut sur votre type de page. Dans cet exemple j'ai créer des blocs de contenu vide, mais vous pouvez très bien y ajouter par défaut un conenu explicatif de leur usage par exemple.

Quelques petits détails

Les pages du compositeur s'enregistrent automatiquement dans les brouillons, dès que vous cliquez sur écrire, avec le nom (Page sans titre). Si vous sortez du compositeur sans enregistrer avec son nom, puis revenez éditer votre page, elle sera à nouveau enregistrée sous son nom. Vous obtiendrez alors une page vierge et une page éditée.

Si vous sauvegardez votre page nommé avant de sortir vou n'aurez que votre sauvegarde.

Ici nous obtenons directement l'édition des blocs car nous n'avons créer qu'un type de page dans le compositeur., lorsque vous en créez plusieurs, le choix vous est donné en premier lieu:

Organiser les blocs dans le compositeur

Reprenons notre exemple de page Left Sidebar, et retournons sur Tableau de bord → Pages et thèmes → Types de Pages.

Nous obtenons le même table qu'à l'origine, mais complété des blocs inscrits dans votre compositeur. Vous pouvez ordonner l'édition de ceux-ci en cliquant dessus et les faisant glisser comme bon vous semble:

Décliner les type de page dans le compositeur

A l'heure où j'écris cette fonction est encore en version Béta, bien que fonctionnelle, il manque encore quelques petites choses.

En effet à l'heure actuelle, sans modifiations autres de votre par, vous ne pouvez assigner votre type de page qu'une seule fois dans le compisteur. Le moyen de réaliser cela à ces avantages et inconvénients.

Comment faire:

Il suffit de copier/dupliquer vos types de pages dans votre thème en les renommant en fonction de leur utilité par exemple.

Prenons un exemple avec le thème par défaut de concrete5, copiez le dossier /concrete/themes/default dans le dossier /themes/defaut/ à la racine de votre site. ensuite dupliquez les fichiers left_sidebar.php, full.php, et blog_entry.php, autant de fois que nécessaire, en les renommant selon vos besoins.

Purger le cache de votre site, puis allez dans Pages et Thèmes, et cliquez sur le bouton Inspecter du thème Plain Yogurt, puis sur le bouton Activer les fichiers.

Vous obtenez ainsi autant de types de pages que désiré, que vous n'avez plus qu'a composer selon la méthode précédemment vue.

Avantages:

Aucune ligne de code à écrire, ce n'est que du copié coller de fichiers

Vous pouvez nommer vos type de façon compréhensible

Vous pouvez Composer autant de type de pages que souhaité.

Inconvénient:

Si vous ajoutez des pages en contexte, vous allez vous retrouver avec beaucoup de types de pages différentes précomposées.

Editions des pages

Comme nous l'avons mentionné au tout début, les pages crées depuis le compositieur sont éditables non seulement depuis celui-ci, mais également en mode édition standard.

Il faut toutefois noter que l'édition de page, via le compositeur, est également possible depuis le plan du site. Ce qui peut être pratique.

Notez que seul les pages composées depuis le compositeur, ne contenant que les blocs inscrits dans celui-ci sont pleinement éditables.Les autres ne vous permettrons d'étier que les blocs inscrits, et vous indiqueront la mention:

Bloc non trouvé. Impossible de l'éditer dans le compositeur.

pour les autres.

Les modèles de blocs pour le compositeurs

C'est ici que cela se corse un petit peu, en effet soit le bloc dispose d'un modèle existant pour le compositeur, soit il vous faut mettre les mains dans le cambouis comme on dit.

Créer un modèle pour le compositeur

Si pour votre site vous avez besoins de créer un modèle personnalisé pour les blocs, deux solutions:

• Créer votre modèle et l'uploader dans le répertoire du bloc sous le nom composer.php si un seul modèle vous suffit.
• Créer un répertoire dans celui de votre bloc nommé composer puis uploader vos modèles dans ce répertoire.

Assigner un modèle de bloc pour le compositeur

Lors de l'édition du contenu par défaut de votre type de page, éditer un bloc et choisissez Paramétrage du compositeur. Vous aurez alors le choix du modèle de bloc à assigner à celui-ci.