Le plugin Magusine

Le plugin magusine est un jeu de squelettes et un système plus vaste, permettant une personnalisation poussée par les administrateurs du site. Choix de thème pour tout le site ou par rubrique, configuration du contenu des pages de base (article, rubrique, sommaire,...), et comme on dit dans ces cas-là, « bien d’autres choses ».

Le plugin magusine est un jeu de squelettes et un système plus vaste, permettant une personnalisation poussée par les administrateurs du site. Choix de thème pour tout le site ou par rubrique, configuration du contenu des pages de base (article, rubrique, sommaire,...), et comme on dit dans ces cas-là, « bien d’autres choses ». Voir le site de démonstration.

Attention : Le plugin a maintenant été recodé pour être compatible avec la version 2. Voir le site de démonstration ou l’article « Portage de Magusine pour spip 2.0 » pour plus d’infos.

attention 2 : pour que le plugin soit fonctionnel chez free, il faut créer un dossier à la racine, appellé « sessions » pour que les sessions admin y soit stockées.

Le plugin est issu des 5 années d’expérience du projet « magusine ». Ce projet vise à mettre à créer un réseau d’association, en mettant à disposition d’associations travaillant avec un public un site web (spip + un jeu de squelettes adapté) et la formation pour son administration, ainsi qu’une attention à la production et une aide à la mise en relation des partenaires. Le projet est mené par l’asbl Les Corsaires.

Contenu du plugin


-  Un jeu de squelettes en xhtml 1.0, dans lesquels peuvent être disposées les informations habituelles de spip (titre, texte, pieces jointes, mots clé, etc) sous forme de blocs paramétrables via le système de gestion de gabarits : galerie en popup ou en thickbox, lecteur mp3 en flash ou liste simple, liste des articles par date ou par titre, etc. Ces contenus peuvent être indifféremment placés dans le corps principal de la page ou dans les « contextes » (magusine peut comporter jusqu’à 3 colonnes).

-  Un jeu de thèmes sélectionnables par simple clic depuis l’interface d’administration. Ces thèmes, plus de 20 pour le moment (css et javascript) prennent aussi en charge la personnalisation des vignettes de logo d’articles. Des thèmes différents peuvent être appliqués potentiellement à chaque rubrique et s’appliquent automatiquement à ses enfants.

La plupart des thèmes comportent des déclinaisons (changement mineurs sur des thèmes existants, directement écrit dans chaque thème).

-  Un système de constitution du menu à 1, 2 ou n niveaux, en automatique (rubrique racine et leurs sous-rubriques tels que définis dans l’interface privée), semi-automatique (liste des sous-rubriques ou des articles choisis dans l’arborescence disponible) ou manuel (dans ce cas aucune hierarchie entre les éléments, une rubrique peut être un sous-élément d’un article).

-  Un système de gestion de gabarit par drag and drop permettant d’organiser les contenus de chaque squelette (sommaire, article, rubrique) par simple drag’n drop : on choisit les blocs de contenus (titre, texte, mots-clés associés, pièces jointes, etc), et leur ordre dans la page. La plupart des blocs ont des paramètres additionnels, comme par exemple le nombre de brèves affichées, le type d’affichage pour les galeries images : en liste, popup, thickbox,...

Le plugin permet en outre de créer de nouveaux gabarits et les associer à des articles ou rubriques.

-  Un système de gestion de « blocs libres », des contenus volants pouvant être disposés dans les pages articles, rubrique et sommaire.

-  La possibilité d’associer des bandeaux (un bandeau est l’équivalent du logo de site) différents à chaque rubrique.

-  La gestion de différents éléments : message du footer, métas, message de la page 404, sélection d’un éditorial, rubrique et articles à la une, news, image et vidéo au hasard, insertion de google maps.

Architecture ouverte

Le plugin est en pleine évolution, c’est un système ouvert qui permet l’ajout de thèmes, de blocs de contenus, de gabarits.
Une personnalisation « à la volée », sans ajout direct dans le plugin, est aussi possible : il suffit de créer un dossier « pages-custom » à la racine du site, et y ajouter des pages type, des blocs dans les pages standard, réécrire des blocs existants. Ceci permet une ouverture maximale du plugin aux modifications avancées (boucles spip, html, css).
Voir le didactitiel sur l’ajout de blocs

Nous projetons d’utiliser svn pour gérer les mises à jour de ce plugin, mais son évolution rapide ne le permet pas actuellement.

Documentation et démonstration

Un site de démonstration pour la partie publique est accessible sur http://demo.magusine.net.
Le site de documentation utilisateur sur http://www.magusine.net.
Une documentation pour la création de thème, l’ajout de blocs et la programmation du plugin lui-même sont en cours.
Une page en construction sur la structure html des page est disponible ici.

Wishlist

Le plugin magusine est le fruit d’un développeur à mi-temps, pas entièrement dédié à cette tâche. Les évolutions possible du code sont nombreuses.

Des thèmes peuvent être facilement développés par les codeurs css, un fichier xml de thème permet de définir certains comportements supplémentaire (taille maximale des images dans le texte, masque pour les logos, couleurs des lecteurs flash, disposition du menu dans l’arbre html, etc.).

Le plugin existe en français, en espagnol (merci à Jose) et partiellement en néerlandais (magusine est un projet belge), une traduction dans d’autres langues est la bienvenue.

Compatibilité

Magusine étant un plugin comportant un jeu de squelettes (articles, rubrique, sommaire), il est incompatible avec les plugin engageant des jeux de squelette. Il est compatible avec des plugin comme spip-listes, formulaires, accès resteint, crayons.
Il semble que les titres et quelques éléments s’affichent mal sous spip 1.9.3, et plusieurs fonctions spip ont été modifiées. Le passage en 1.9.3 du plugin fait partie des tâches à venir pour lesquelles un peu d’aide serait la bienvenue.

Téléchargement

Comme mentionné précédemment, le plugin sera placé sur la zone dès que j’en maitriserais les aspects techniques. Pour le moment, le plugin est téléchargeable dans le dossier « download » du site de demo magusine : http://www.demo.magusine.net/download.

Installation

Le plugin s’installe de manière classique, déposé dans le dossier plugins. Il crée ses tables et ajoute un bouton dans la partie administration et un bouton dans les onglets admin, qui permettent de joindre son administration. Selon les pages d’administration, certains blocs de configuration s’ajoutent (ajout de bandeau, assignement de gabarit et de thème, etc.).

Le plugin est utilisé par le partenariat magusine, soit une vingtaine de sites, et est donc assez éprouvé. De l’aide, pour trouver les bugs inévitables vu la taille du projet, est là encore la bienvenue.

Discussion

122 discussions

  • 1

    J’ai créé une rubrique-liens et ajouté à cette rubrique un certain nombre de sous-rubriques (=mes catégories de liens) afin de les faire apparaître en tant que pages contenant des liens, par catégorie.
    J’obtiens bien la liste de ces sous-rubriques , sur la droite, sous forme de liens classés selon les titres des sous-rubriques et souss le titre « index des rubriques ».
    Mais d’une part les liens n’aboutissent à rien ( le lien semble pourtant juste monsite.com/spip.php ?rubrique18#rub27) et d’autre part, dans la rubrique principale, celle qui est définie comme rubrique-liens, rien n’appraît. Les liens qui devraient être classés n’existent pas.

    Cependant si je clique sur les liens pages, depuis la navigation principale du site, elles apparaissent normalement.

    (J’utilise Firefox 2 et Safari 3, sous Mac OSX.)

    Merci pour vos lumières.

    • Stéphane

      Bonjour,

      est-ce que le gabarit rubique-liens a été appliqué ? Si oui, est-ce que ce gabarit est correctement réglé ? Il faut aller dans le plugin dans les gabarits et visualiser le gabarit rubrique-liens, vérifier que les blocs que l’on désire voir figurer sont au bon endroit puis enregistrer. Généralement le problème vient de là.

      Les liens de la rubrique et des sous-rubriques doivent alors apparaitre...

    Répondre à ce message

  • 1

    bonjour,
    est-il possible d’utiliser seulement la galerie thickbox sans le reste du plugin ?
    merci d’avance.

    • Stéphane

      Heu, pas vraiment. Mais il doit exister un plugin pour thickbox. J’en ai vu je crois.

    Répondre à ce message

  • Bonjour, j’ai installé spip avec magusine pour un site hébergé sur free, pour spip pas de soucis, mais quand dans « configuration »=>« gestion des plugins » je coche la case « magusine » pour activer le plugin quoi, et bien quand je valide j’obtient un message :

    Warning : opendir(../plugins/0/definitions-gabarits) [function.opendir] : failed to open dir : No such file or directory in /mnt/163/sda/6/8/enebe/plugins/base/arty_init.php on line 39

    Warning : readdir() : supplied argument is not a valid Directory resource in /mnt/163/sda/6/8/enebe/plugins/base/arty_init.php on line 40

    Quelqu’un a-t-il une explication ? Comment je peux m’en sortir ?

    Merci - fred

    Répondre à ce message

  • Comme nombre d’entre vous, je pense, j’ai été confronté au problème de créer une rubrique (ou sous-rubrique) et de ne pas pouvoir la voir s’afficher sur le site parce qu’aucun article n’y était associé ... .
    La rubrique s’affiche bien en mode prévisualisation, mais c’est tout. Rien n’y fait, ni même le fait de déterminer manuellement les rubriques (et le reste de l’arborescence).

    Mais j’ai par contre trouvé une solution qui ne demande aucun (!) remaniement du code.
    En effet il suffit tout simplement d’ajouter une image à la rubrique en question. Et nul besoin de l’insérer réellement dans la page, juste l’ajouter.
    Et le tour est joué.

    Si cela peut vous servir aussi, tant mieux :-)

    Répondre à ce message

  • 1
    Christian Thomas

    Bonjour

    Je suis nouvel utilisateur de « magusine » et comme je l’ai dit sur le site des créateurs c’est vraiment du super boulot bravo !
    J’ai quand même un petit problème et après avoir parcouru tous les messages je ne l’ai vu nulle part j’ai ceci qui s’affiche en bas de page : (DOCUMENTS)id_articleextension==gif|png|jpgmode=document>
    je n’arrive pas à faire fonctionner de diaporama ou slideshow
    ni thickbox que se soit avec firefox ou ie vous pouvez le voir à cette adresse http://martine-patchwork.fr/patch/spip.php?article3

    • Christian Thomas

      C’est toujours Christian thomas il semblerait qu’il manque un tag fermant à la BOUCLE_recup mais où elle se trouve je l’ai vu dans plusieurs fichiers laquelle est-ce ?

    Répondre à ce message

  • 1
    Wazabeille

    Bonjour et aussi, bravo pour ce plugin !!!! Même moi qui suis très très dilettante, je suis arrivée à l’installer (chez mon hébergeur perso)et à le « customiser » !
    Par contre, lorsque je suis allée le mettre en ligne chez l’autre hébergeur (celui de notre site communautaire), les caractères accentués ont disparu pour laisser place à d’autres caractère comme ceci : « Accès à l’espace privé ». J’ai déjà lu et entendu parler de problèmes de codage mais je ne vois pas comment résoudre ça, avec mon petit cerveau... Est-ce dû à l’hébergeur ? J’ai réinstallé Spip comme il fallait, puis le Magusine customisé. Voyant qu’il y avait un souci, j’ai réinstallé un Magusine d’origine, tout propre, mais ça n’a rien donné....
    Je n’sais pu quoi faire...
    Merci de votre réponse.
    A.

    • Wazabeille

      Euh, en butinant sur les forums de Spip, j’ai trouvé la solution.... J’ai converti tout en UTF-8 et ça a marché...
      Vous êtes tous trop fort !!!
      Merci,
      A.

    Répondre à ce message

  • 5

    Bonjour,

    Tout d’abord, merci pour ce plugin. Je l’utilise pour mettre en œuvre un site annonçant un congrès. J’apprécie particulièrement la fonction Gabarits pour « modeler » simplement et rapidement les pages en toute liberté !

    Au premier chargement de la page d’accueil, j’ai le message d’avertissement suivant :

    Warning : ob_start() [ref.outcontrol] : output handler ’ob_gzhandler’ cannot be used after ’URL-Rewriter’ in /[mon_chemin]/ecrire/inc_version.php on line 403

    Le message disparaît après un rafraîchissement de la page et le site fonctionne correctement, en apparence.

    Hégergement : OVH / 90plan

    J’ai jeté un œil au fichier en question, mais ne comprends pas d’où peut provenir le souci.

    Avez-vous rencontré ce problème ? Comment le résoudre ?

    D’avance merci pour vos indications.

    • J’ai rencontré ce problème chez OVH, le message réapparait régulièrement et disparait en refresh. Je ne sais pas si quelqu’un a une solution propre, celle que j’ai utilisé sur un site OVH par le passé a été de cacher le warning avec un @ devant la fonction en question, je dirais d’aller voir cette ligne 403 de inc_version.php et de faire ça pour voir. C’est un warning, et en effet il semble sans conséquence.

    • J’ai rencontré ce problème chez OVH

      Jamais chez d’autres hébergeurs ?

      je dirais d’aller voir cette ligne 403 de inc_version.php et de faire ça pour voir.

      Je vais poursuivre qlq recherches pour tenter de débusquer le pb. En cas d’échec, j’utiliserai cette solution. Mais tout de même, bloquer un message d’avertissement, c’est un peu limite, non ;-)

      Quoiqu’il en soit, merci pour tes indications.

    • Stéphane

      Non, je n’ai jamais rencontré ce problème ailleurs. Les corsaires ont un serveur dédié chez all2all, qui est mon principal site de test, et free ne pose pas ce problème (il en posait d’autres mais c’est apparemment fini). J’ai installé un seul site en ovh. Il faudrait demander à leur maigre helpdesk s’il connaissent la raison de ce warning, je veux bien me pencher sur la source plutôt que d’agir sur le symptôme à ce moment là.

    • Bonjour,

      Après qlq recherches, j’ai une piste pour solutionner ce pb qui
      serait provoqué par la compression gzip. Cela dépasse de loin mes compétences, je préfère lister quelques adresses :

      -  il y a un message sur le forum Spip :
      http://forum.spip.org/fr_187659.html

      -  la description de la fonction ob_gzhandler dans la doc php :
      http://fr3.php.net/ob_gzhandler

      -  une proposition de patch pour supprimer le message d’avertissement :
      http://trac.wordpress.org/ticket/4342

      J’ai appliqué cette solution en remplaçant

      ob_start('ob_gzhandler');

      par

      ob_end_clean();
      ob_start('ob_gzhandler');

      dans ecrire/inc_version.php.

      Toutefois, deux ligne plus haut dans ce fichier, il y a le commentaire suivant « # bug avec le debugueur qui appelle ob_end_clean() ».

      Cela semble fonctionner mais le doute m’habite ;-)

    • bonjour,

      j’ai le même problème chez OVH sur un 90 plan
      mais la solution de pilaf n’a pas marché
      seule la solution de Stéphane de mettre un @ devant la ligne à supprimé le message d’erreur

    Répondre à ce message

  • 1

    bonjour. Ce plugin est génial dans ce qu’il permet. Merci beaucoup. J’ai tenté de l’installer sur un serveur mutualisé d’OVH et voici ce qu’il m’affiche en première page : Warning : ob_start() [ref.outcontrol] : output handler ’ob_gzhandler’ cannot be used after ’URL-Rewriter’ in /home/espacein/www/rave/ecrire/inc_version.php on line 403

    cf http://espace-independance.org/rave

    je l’ai installé ailleurs, sur d’autres serveurs,(je ne peux pas changer dans ce cas d’hébergeur) et je n’ai pas eu ce problème. quelqu’un peut il m’aider à le résoudre ?
    Merci d’avance.
    Pierre

    Répondre à ce message

  • Philippe Cadaugade

    Super : votre plugin est ce que je cherche vainement depuis 6 mois pour faire le site de mon club de plongée : Toutes les fonctionnalités voulues sans avoir à comprendre précisément le fonctionnement du spip au point d’en être capable de modifier à la main les boucles...

    J’ai vu dans la doc que l’article concernant l’utilisation conjointe du plugin « accès restreint » était en cours de rédaction, je m’y suis donc attaqué comme décrit dans la doc d’accès restreint... Aucun problème (jusqu’ici)

    Bref, c’est le bonheur !!

    Répondre à ce message

  • 1

    bonjour
    tout d’abord bravo pour ce super plugin

    je n’arrive pas à faire fonctionner correctement le multilinguisme
    j’ai bien créé un mot clé menu-langues mais aucune zone n’apparait pour basculer d’une langue vers l’autre
    en revanche si je force manuellement l’url pour afficher la langue c’est ok mais je ne ne peut plus revenir au francais après
    j’ai oublié quelques choses ?
    merci

    • bon je me réponds
      j’ai trouvé il suffisait d’afficher le bloc menu des langues
      ce plugin est vraiment génial encore merci

    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 :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom