Note de version
Depuis la version 2 du plugin Compositions, il est possible de définir des héritages par branche.
La fonctionnalité Article d’accueil a été extraite dans un plugin dédié.
Compositions nécessite le plugin Bonux.
Objectif
Ce plugin a pour but de fournir un mécanisme et une interface pour faire varier le type de composition de chaque objet en fonction des besoins.
Par exemple, vous pouvez avoir besoin de composer certains articles sous une forme d’article de journal, et certains autres comme des albums photos.
Ou vous pouvez vouloir composer certaines rubriques comme des blogs, et d’autres de façon plus classique...
Configuration
Le plugin ne nécessite pas CFG, mais si celui-ci est installé vous pourrez modifier certaines options de fonctionnement. Dans le cas contraire, les réglages par défaut seront appliqués.
Sous SPIP 3, le formulaire de configuration est directement accessible, sans CFG, via le menu Configuration > Compositions.
Utiliser les compositions sur les objets
Sous SPIP 3 uniquement, vous pouvez définir les objets pouvant recevoir des compositions.
Dossier des compositions
Ce réglage vous permet de choisir le sous-dossier qui contiendra les différentes compositions. Par défaut le nom de dossier compositions/ est utilisé, contenu/ si vous utilisez Zpip, content si vous utiliser Zcore. C’est-à-dire que les compositions seront recherchées dans squelettes/compositions/, puis dans les sous dossiers compositions/ des plugins, etc.
Sélection des squelettes
Par défaut, le squelette de la composition est sélectionné automatiquement par SPIP. Mais ce mécanisme est désactivable pour des besoins précis.
Masquer le formulaire
Vous pouvez masquer le formulaire de Compositions aux utilisateurs n’ayant pas les droits de modifier la composition d’un objet donné afin d’alléger l’interface.
Tout verrouiller
Compositions possède un mécanisme permettant à la personne qui gère le site avec le statut webmaster de verrouiller une composition et/ou les compositions d’une branche. En activant cette option, toutes les compositions seront verrouillées et uniquement la ou le webmaster pourra les modifier.
Définir des compositions
Une composition est constituée par une paire de fichiers : un squelette et un fichier XML qui l’accompagne et porte le même nom. Leur nom est composé du type de l’objet (article, rubrique ou autre) suivi du nom de la composition séparée par un tiret. Par exemple : article-edito.html et article-edito.xml ou encore rubrique-chronologique.html et rubrique-chronologique.xml.
Les compositions doivent être rangées dans un sous-répertoire de votre dossier squelettes, appelé compositions/ (le nom de ce sous-répertoire est configurable).
Il est possible de définir une composition par défaut pour chaque type d’objet, en la nommant simplement article, rubrique, etc. sans la suffixer.
Pour définir une composition de type portfolio d’un article on va par exemple :
- créer un squelette compositions/article-portfolio.html,
- créer à côté un fichier compositions/article-portfolio.xml.
Le squelette sera constitué classiquement de boucles et balises pour réaliser l’affichage de l’article selon le mode de composition qui vous convient. Le fichier XML pourra contenir la description de cette composition :
<composition>
<nom>Article Portfolio</nom>
<description>Composition adaptée aux galeries d'images</description>
<icon>images/article-portfolio.png</icon>
</composition>Lorsqu’aucune composition n’est définie pour un type d’objet donné, aucune interface n’apparait dans l’espace privé.
Mais lorsque vous avez défini au moins une composition, une interface apparaît et permet aux administrateurs de choisir sur chaque objet la composition qui lui convient parmi celles qui sont définies.
Définir des compositions héritées
Dans le fichier XML d’une composition de rubrique, vous pouvez définir une composition qui s’appliquera par défaut aux objets de la branche (articles, sous-rubriques, brèves...). Il vous suffit d’ajouter dans le XML de la composition une tag de la forme <branche type="objet" composition="nom_composition" />. Par exemple, vous pouvez faire une composition rubrique-agenda avec le XML suivant :
<composition>
<nom>Rubrique Agenda</nom>
<description>Composition pour les rubriques gérant un agenda</description>
<icon>images/objet-liste-contenus-dates.png</icon>
<branche type="article" composition="agenda" />
<branche type="rubrique" composition="agenda" />
</composition>Les articles de cette rubrique et de ses sous-rubriques hériteront alors de la composition article-agenda.html. Attention : il doit s’agir d’une composition valable et doit donc disposer d’une description dans un fichier article-agenda.xml.
La composition héritée par un objet n’est pas forcément homonyme de la composition de la rubrique. Vous pouvez donc avoir une composition rubrique-machin avec <branche type="article" composition="truc" />. Dans le cas présent, truc fait référence au suffixe de article-truc.html. Le tag <nom></nom> de article-truc.xml reste libre de recevoir le texte de votre choix.
Par ailleurs, il vous est toujours possible de modifier au cas par cas la composition d’un objet donné. Si l’objet hérite d’une composition, l’interface vous proposera donc de lui appliquer la composition héritée ou bien de lui appliquer une autre composition de votre choix.
La composition par défaut d’un objet n’ayant pas de nom (puisqu’il s’agit du squelette correspondant au nom de l’objet sans suffixe), on pourra l’indiquer dans le tag <branche /> à l’aide d’un tiret (composition="-").
Si les rubriques parentes d’un objet définissent plusieurs compositions héritées, c’est la composition définit par la rubrique la plus proche qui s’appliquera.
Prenons un exemple concret. Supposons un secteur A ayant trois sous-rubriques A1, A2 et A3. La composition appliquée au secteur A attribue aux articles de ce secteur la composition truc (<branche type="article" composition="truc" />). Par ailleurs, on a appliqué à la sous-rubrique A3 une composition attribuant aux articles de sa branche la composition par défaut (<branche type="article" composition="-" />). Les articles des rubriques A, A1 et A2 seront alors affichés avec le squelette article-truc.html alors que ce sera article.html qui sera utilisé pour les articles de la rubrique A3 [1].
Verrouiller les compositions
Par défaut, les individus ayant le droit de modifier le contenu d’un objet ont le droit de modifier sa composition. Cependant, si vous êtes webmaster, vous pouvez verrouiller une composition. Cette dernière ne sera alors plus modifiable que par un webmaster.
Si vous êtes dans une rubrique, vous pouvez verrouiller la composition de tous les objets de cette branche (sous-rubriques, articles, brèves, sites, etc.).
Enfin, dans la configuration de Compositions, vous pouvez également verrouiller toutes les compositions.
Interface
Lorsque des compositions ont été mises en place par le webmestre, un formulaire de sélection apparait automatiquement dans l’espace privé sur chaque objet de ce type.
L’interface peut différer selon vos réglages afin de n’afficher que les options s’appliquant à votre situation.
Utilisation avec les squelettes de type Z comme Zpip
Utilisé avec un squelette Z comme le squelette Zpip (version 1.7.10 minimum), le fonctionnement par défaut des compositions s’applique au cœur de page (le contenu). Le dossier par défaut pour mettre les compositions est alors contenu/ pour zpip et content/ pour zcore..
Une composition contenu/article-portfolio.html sera alors utilisée à la place de contenu/article.html, le reste de la page étant alors inchangé. Pour plus d’information sur la construction des pages dans le squelette Zpip, voir sa documentation.
N.B. : pour que la composition bloc/article-portfolio.html soit prise en compte, il doit obligatoirement y avoir un squelette bloc/article.html dans le même dossier.
ll n’y a donc aucun réglage à faire pour utiliser le plugin Compositions avec Zpip : il suffit de déclarer des compositions dans un dossier contenu/ (dans le dossier squelettes/ par exemple) pour pouvoir les utiliser pour faire varier la présentation du contenu des objets de SPIP.
Utilisation avec Zcore
Si vous créez vos propres jeux de squelettes avec Zcore, n’oubliez pas de passer la composition dans votre fichier objet.html de base. Exemple avec article.html.
<BOUCLE_principale_article (ARTICLES) {id_article}>
<INCLURE{fond=structure, env, id_rubrique=#ENV{id_rubrique,#ID_RUBRIQUE}, id_secteur=#ID_SECTEUR, type-page=article, composition=#COMPOSITION} />
</BOUCLE_principale_article>Utilisation avec le noiZetier
Si vous utilisez Compositions avec le plugin noiZetier, vous pouvez créer des compositions directement dans l’interface de SPIP. Une fois créées, il vous reste seulement à modifier les noisettes de votre composition pour disposer d’un affichage alternatif pour vos objets.
Pour plus d’informations, voir Les compositions du noiZetier.
Utilisation personnalisée dans les squelettes
En dehors des squelettes Z, le fonctionnement du plugin par défaut est de sélectionner automatiquement un squelette, dans son intégralité. Ce mode de fonctionnement oblige donc à définir le squelette en entier pour chaque composition.
Pour une utilisation différente du plugin dans le cadre d’un squelette personnel, et pour utiliser les compositions pour faire varier une partie de la page uniquement, le mécanisme automatique peut être désactivé.
Dans ce cas, la balise #COMPOSITION peut être utilisée dans les squelettes pour inclure la bonne variante de composition dans la partie de la page que le webmestre souhaite faire varier.
La balise #COMPOSITION tient compte des héritages éventuels s’appliquant à un objet. Il est donc impératif de s’appuyer sur cette dernière et non sur la valeur du champ composition des tables SQL pour connaître la composition s’appliquant à un objet. Elle doit être appelée au sein d’une boucle.
Le plugin laisse donc la liberté au webmestre d’utiliser le mécanisme de compositions en fonction de son besoin propre.
Si par exemple, vous souhaitez que le cœur des pages articles change en fonction de la composition choisie (mais les colonnes latérales, l’en-tête et le pied de page seront inchangés), vous remplacerez la partie concernée de article.html par <INCLURE{fond=#COMPOSITION|compositions_selectionner{article}}{env}>.
Cette inclusion doit se trouver dans une boucle article dans ce cas.
Des icones pour vos compositions
Le plugin intègre dans le sous dossier images/ plusieurs icones simples que vous pouvez utiliser et décliner pour identifier vos compositions. N’hésitez pas à proposer vos variantes pour enrichir le plugin !
| Image | Code à utiliser |
|---|---|
|
<icon>images/objet-simple.png</icon> |
|
<icon>images/objet-liste-contenus.png</icon> |
|
<icon>images/objet-liste-contenus-dates.png</icon> |
|
<icon>images/composition-cours.png</icon> |
|
<icon>images/composition-tableau.png</icon> |
|
<icon>images/composition-test.png</icon> |
Discussions par date d’activité
71 discussions
Bonjour
j’ai un souci nouveau. Dans la partie config du plugin composition, le champ « Dossier des compositions » est grisé. Il renvoie à un dossier /content/ qui n’existe pas. Donc forcément j’ai un peu souci au niveau des compositions que j’ulilise. Je suis bien connecté à /ecrire en tant que webmestre. Merci pour votre soutien, vos réponses et ce très beau plugin
C.
Quels sont les autres plugins installés ?
Si le plugin zcore est utilisé, alors le chemin des compositions est fixé via la configuration de zcore.
Cdlt
Merci.
En effet zCore est activé sur notre site. Mais je ne vois pas de lien vers la configuration de zcore...
Merci.
J’ai en effet le plugin zcore d’activé sur notre site mais je ne vois pas de page de configuration de ce dernier.
Christophe
Lorsque que compositions est utilisé avec Zcore, les compositions doivent impérativement être déclarées dans le bloc principal, c’est-à-dire le premier bloc listés dans
$GLOBALS['z_blocs']. C’est ici que doit être déposé le XML de la composition et le squelette HTML de la composition pour ce bloc.Pour les autres blocs, il est possible de proposer un squelette de la composition mais pas obligatoire.
Cdlt
Encore merci.
Dans mon squelette article-core.html, j’ai cela
Donc je crois bien avoir déclaré ce qu’il faut au bon endroit.
Pourtant j’ai pas le résultat escompté sur la page https://www.infogm.org/6893 a le mot clé « soja » du groupe de mot « plante » mais la colonne de droite est désespérément vide.
Je vais continuer à creuser... Si des idées vous viennent, n’hésitez pas.
Merci encore
Christophe
Pour définir une nouvelle composition (par exemple toto) sur les articles, il vous faut a minima :
Optionnellement, si le bloc extra est différent, il vous faut aussi un fichier article-toto.html dans extra/
Bien sur, pensez à vider le cache puis à appliquer la composition toto aux articles de votre choix
Répondre à ce message
J’aimerais savoir comment récupérer le message d’erreur après une page blanche ?
Je mets une image-ecran pour illustrer que c’est seulement une page blanche ???
J’ai mis #FORMULAIRE_EDITER_COMPOSITION_OBJETid_rubrique,#ID_RUBRIQUE,#SELF
Je vois le formulaire en public, je change la composition, j’enregistre et HOP ! une page blanche
Peut etre https://www.spip.net/fr_article4453.html#Obtenir-encore-plus-d-informations-pour-le-debuggage
Merci je ne connaissais pas ces possibilités.
Voici le message d’erreur pour la page blanche
Fatal error : Uncaught Error : Call to undefined function autoriser() in /Applications/MAMP/htdocs/renee_sitememoires/plugins/auto/compositions/v3.7.3/formulaires/editer_composition_objet.php:88 Stack trace : #0 /Applications/MAMP/htdocs/renee_sitememoires/ecrire/public/aiguiller.php(245) : formulaires_editer_composition_objet_traiter(’id_rubrique’, ’2’, ’spip.php ?rubriq...’) #1 /Applications/MAMP/htdocs/renee_sitememoires/ecrire/public.php(105) : traiter_formulaires_dynamiques() #2 /Applications/MAMP/htdocs/renee_sitememoires/spip.php(26) : include(’/Applications/M...’) #3 main thrown in /Applications/MAMP/htdocs/renee_sitememoires/plugins/auto/compositions/v3.7.3/formulaires/editer_composition_objet.php on line 88
Ba oui un visiteur peut pas éditer une rubrique ... faut etre admin.
Certes, Pierre. Mais en l’occurence le message indiquait simplement que même le test d’autorisation faisait planter spip.
Normalement la version 3.7.4 devrait éviter ce problème d’erreur fatale (disponible bientot en zip).
En fait j’ai mis
Le formulaire servira aux administrateurs restreints.
J’ai hâte de tester la 3.7.4 MERCI
Par ailleurs le premier argument attendu est le
typede l’objet, soitrubrique,article…Ce devrait donc être
Merci. C’est changé. J’espère que cela fonctionnera avec 3.7.4
Y’a de l’espoir !!!
Pour faire fonctionner les formulaires en espace public, j’ai lu et relu :
https://contrib.spip.net/odt2spip-v3-creation-d-articles-a-partir-de-fichiers
et j’ai fouillé sur la liste, google ....
J’ai beaucoup de difficulté à comprendre.
Pour créer un nouvel objet on met « id_nom de l’objet »
Pour ajouter (un logo) ( une couleur) à un objet on met le type.
Pour modifier un objet (compositions) on met le type.
Pour un événement c’est new et id_article
Y a-t-il un endroit dans la galaxie SPIP qui explique les façons d’écrire un appel de formulaire, autre que rubrique, article, breve, ..?
Un glossaire de formulaires ?
Après la mise à jour du plugin, #FORMULAIRE_EDITER_COMPOSITION_OBJETrubrique,#ID_RUBRIQUE fonctionne. Merci beaucoup.
Répondre à ce message
Bonjour,
J’utilise SPIP 3.2.1 et j’utilise les formulaires CVT de la partie privée dans l’espace public comme
#FORMULAIRE_EDITER_ARTICLEetc.Dans une boucle « article » j’ai placé :
#FORMULAIRE_EDITER_COMPOSITION_OBJET{id_article,#ID_ARTICLE}.J’obtiens bien le formulaire mais après validation, j’ai une page blanche et ma modification n’est pas prise en compte.
Si vous aviez quelques lumières ?
Merci.
J’ai le même besoin avec
#FORMULAIRE_EDITER_COMPOSITION_OBJET{id_rubrique,#ID_RUBRIQUE}Je vois moi aussi le formulaire mais dès que je confirme j’ai une page blanche. As-tu trouvé une solution ? MerciBonjour,
Non malheureusement, pas du tout ! L’auteur de ce plugin ne se donne même pas la peine de répondre à une question pertinente et correctement formulée.(D’ailleurs nous ne sommes pas les seuls).
C’est quand même la moindre de choses.
Sinon, à quoi bon permettre d’ajouter des commentaires ici ?
C’est assez scandaleux ces gens qui partagent leur travail gratuitement, qu’on peut utiliser comme on veut (y compris en bidouillant pour utiliser des fonctionnalités non documentées) et qui n’assurent même pas un service après vente digne de ce nom.
Remboursez !
Tiens là , vous me répondez ! et au quart de tour.
Vexé ?
@jpcrea : l’ensemble des membres de la communauté SPIP sont bénévoles. Il n’y a donc aucun dû sur aucun plugins. Ce n’est pas en posant des exigeances que vous donnerez envie de fournir des réponses.
Comme pour tous les problèmes de page blanche, il faudrai à minimum afficher les messages d’erreurs pour savoir d’où cela vient.
Bonjour Maïeul,
On a déjà échangé tous les 2 plusieurs fois sur vos différents plugins en toute courtoisie et sans exigence, aucune et vous m’avez aidé. Bien sûr bénévole ! Je le fais moi-même quand je peux le faire(regardez mes interventions plus bas, dans ce fil et dans d’autres).
Mais là on est dans le relationnel : vous ne pouvez pas savoir à quel point, c’est frustrant de ne pas avoir de réponse du tout surtout dans un système non marchand comme ici.
Merci pour votre intervention.
Bien sûr que c’est frustrant de ne pas avoir de réponse. Mais c’est précisement parce que le site est non marchant, qu’on est tous bénévole, qu’on ne peut pas attendre de tout le monde qu’il fournisse systématiquement des réponses.
Ben oui mais ça fait partie du jeu. Les contributeurs sont disponibles pour répondre, ou pas, en fonction de tout ce qui passe dans leur vie personnelle et du temps qu’il leur reste.
Et quand il y a plus de questions posées qu’il n’est possible d’y répondre dans le temps disponible il y a forcément des utilisateurs frustrés (si tu veux je te forward mes mails pendant 1 semaine et tu verras…)
Quand on est vraiment bloqué on peut essayer de relancer la question, parce que parfois le contributeur ne l’a simplement pas vue passer, ou de la reposer sur un autre canal (les listes, le forum, irc…)
Mais en tout cas se scandaliser que le contributeur bénévole n’est pas assez disponible ce n’est jamais une méthode qui marche, et c’est également pénible :)
Je comprends tout cela, Cerdic.
Je suis patient :-) ça fait un an que j’ai posé ma question et je n’attend pas
un long développement, seulement une piste, un indice...je suis dur à la tâche.
Merci à toi pour ton implication ici.
Répondre à ce message
bonjour,
merci pour ce plugin qui simplifie grandement l’écriture des squelettes.
Les traductions de l’objet ne devraient-elles pas hériter de la même composition ?
je teste ça sur un site si ça intéresse...++
Répondre à ce message
Bonjour
je dois être complètement débile, pourtant pas débutante en spip, mais même après avoir lu à peu près tous les commentaires, je n’arrive même pas à démarrer !
Je suis sous spip 3.2.1 avec zpip
J’ai modifié un squelette d’article et l’ai renommé en « article-recap.html », et créé un fichier article-recap.xml avec ce code :
et j’ai placé le tout dans plugins/z/v1.7.31/contenu (puisque c’est là que sont mes squelettes zpip)
Et aucune composition ne s’affiche dans l’espace privé.
Qu’est-ce que j’ai loupé ? Il faut un appel à la composition dans article-recap.html ?
merci de votre aide
(tout ça c’est pour pouvoir assigner une variable dynamique à un champ de formulaire formidable...)
As-tu activé la composition sur les articles dans la configuration du plugin ?
La balise
<branche.../>dans le XML n’est en effet pas utile du tout et plutôt contre productive ici.Par ailleurs c’est pas génial du tout de mettre tes squelettes personnalisés dans le dossier du plugin
plugins/z/v1.7.31/car si tu fais une mise à jour du plugin tu vas tout perdre.Je te conseille plutôt de mettre dans le dossier
squelettes/à la racine de SPIP, qui est fait pour ça, et ça te permet de bien différencier ce qui est fourni par défaut dans les plugins et ce qui est propre à ton site.Ouah ! Quelle réactivité !
Oui, les cases articles et rubriques sont activés. A noter que quand je manipule les rubriques, le champ composition apparaît, mais pas pour les articles.
Effectivement je me doute que branche ne sert à rien mais ce n’était pas mieux sans.
En ce qui concerne l’emplacement du plugin, ça s’est fait tout seul quand je l’ai installé, je n’ai pas osé le bouger... J’ai mis à jour spip récemment et quand j’ai réinstallé zpip, il s’est remis là.
zpip fonctionnera si je mets mes squelettes perso ailleurs ?
Répondre à ce message
Salut,
Impossible de changer le « dossier des compositions » en grisé dans le formulaire de config, figé sur le dossier « content/ » !
est-ce normal ? ou le modifier si possible ?
merci
Répondre à ce message
Bonjour, mon site comporte des secteurs personnalisés et header personnalisés. Comment faire pour avoir un body différent pour appeler un header différent en fonction de la rubrique choisie ?
Ok, j’ai finalement trouvé... Il suffit de copier le fichier structure.html dans le dossier squelette et de modifier la ligne suivante :
<INCLURE{fond=body#ENV{composition},env}>Et ensuite créer un fichier bodytruc.html dans le squelette.
:-D
Répondre à ce message
Bonjour,
Mon environnement : SPIP 3.2.0, SarkaSpip 4.5.10, Z-core 2.6.6 et Compositions 3.7.1
Je teste pour la première fois les compositions.
J’ai créé une composition article-test.html (squelettes/content et squelettes/aside) qui s’applique correctement sur un article sélectionné.
Par contre, je souhaite aussi modifier la structure globale de la page. J’ai donc créé un body-article-test.html à la racine de mon squelette, mais il n’est pas pris en compte, c’est celui de SarkaSpip qui est pris en compte (plugins/auto/sarkaspipr/v4.5.10/body.html)
Toutefois, si j’applique la méthode « le code magique » décrite dans cet article, pas de soucis, mon body modifié est bien pris en compte. Le structure.html que j’utilise pour ce dernier test est une copie de celui de zcore, Sarkaspip n’en proposant pas.
Une idée de ce qui peut bloquer ?
Répondre à ce message
Bonjour,
Est-il possible d’utiliser Compositions sur un objet mot-clef ? J’ai essayé avec la syntaxe suivante, mot-XX.xml et mot-XX.html mais le menu de choix n’apparait pas sur la page des mot-clefs.
Bonjour,
Dans la configuration du plugin, on peut choisir le type d’objet avec lequel on veut l’utiliser...
CDLT
Bonjour,
C’est ce que j’ai fait dans la configuration du plugin.
Le sous-menu « Composition » n’apparait pas dans la page mot-clef. Autrement dit pour les articles, j’ai bien le sous-menu mais pas pour les mots-clefs.
Bonjour,
Effectivement, je viens de m’en rendre compte.
Je suis un gros consommateur de compositions et je n’en avais, jusqu’à ce jour, jamais eu besoin avec les mots-clés.
Avez-vous depuis tout ce temps résolu la question ?
Merci.
Répondre à ce message
Bonjour, et merci pour ce joli plug-in.
D’abord voici la configuration dans laquelle je travaille : spipr + menus + compositions (récemment).
J’ai une question concernant les fonctionnalités et l’histoire de ce module :
Il est indiqué que « compositions 1 » contenait la fonctionnalité « d’article d’acceuil ». Cette fonctionnalité a-t-elle disparue de « compositions 2 et 3 » ? Cela signifie-t-il que si la fonctionnalité d’article d’acceuil doit être utilisée aussi, il faut aussi installer de plug-in ? (par exemple, compositions 2 ou 3 peut-il être paramétré pour remplir les fonctions de l’article d’acceuil aussi ?).
En vous remerciant,
Mike
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires :
|
