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
    Joseph Tux

    Bonjour,

    ce Magusine est bien tentant !

    L’incompatibilité avec le plugin « accès restreint » est-il compensé par une fonctionnalité équivalente ( je souhaite que certaines rubriques de l’espace dit « public » de SPIP ne soit accessible qu’à des visiteurs autorisés par le webmestre, ce que réalise « acces restreint » )

    Quelqu’un a-t-il déjà réalisé ( très simplement ) une telle fonction ?

    Merci à tous

    • Relisez la phrase (mal dormi ? ;) ) :

      Il est compatible avec des plugin comme spip-listes, formulaires, accès resteint, crayons.

      En passant ce plugin est vraiment génial, dommage que l’inclusion d’objet libre dans les gabarits soit un peu compliqué par contre...

    Répondre à ce message

  • hebus le troll

    Bonjour à tous,

    je suis en train de « customiser » certaines pages de magusine et je bute sur un point, celui de rajouter une image à la suite du nom de la rubrique dans le bloc navigation. :s

    Merci de votre aide.

    Répondre à ce message

  • Gérald

    J’ai deux petits soucis avec ce superbe plugin (thème Emilio large) :

    -  à partir des options Magusine j’ai installé un bandeau, maintenant il m’est impossible de le supprimer, le bouton [Supprimer] est inactif.

    -  j’ai défini un éditorial, éditorial qui s’affiche bien mais qui chevauche le filet au-dessus du menu.

    Comment pourrais-je remédier à ces petits désagréments ?

    Merci !

    Répondre à ce message

  • J’ai un problème d’espace entre le chapeau et le début de l’article : http://www.dictionnairedufutur.fr/spip.php?article87. Est-ce que vous avez une idée de la manière dont on peut régler le problème. Merci

    Répondre à ce message

  • François Daniel Giezendanner

    Bonjour,

    Merci pour ce lien ..., mais mais on ne trouve aucune info sur cette page d’accueil concernant spip2 ou SPIP 2 ...

    Par contre, à la page :

    Version 2 en marche

    Le 4 mars 2009

    Grâce à Emmanuel Mathot, une version compatible spip 2 sera prochainement distribuée.
    D’autre part, la version 2 du plugin, avec une refonte du code (mais une compatibilité avec les thème et la db de la version 1) est en cours.

    A suivre donc !

    FDG

    Répondre à ce message

  • 1
    François Daniel Giezendanner

    Bonjour,

    Excellent squelette, quand pensez-vous pouvoir l’adapter pour SPIP 2 ?

    Meilleurs messages

    FDG

    • Excellent squelette, quand pensez-vous pouvoir l’adapter pour SPIP 2 ?

      Excellente question. La réponse figure tout simplement sur la page d’accueil du portail Magusine : www.magunews.net

      pilaf

    Répondre à ce message

  • katmandou

    Bonjour,

    J’ai testé magusine sous spip 2.04, et j’ai une erreur dans le base de données.
    Savez-vous si une version mise à jour pour spip 2 sortira bientôt ?

    Merci, et bravo pour ce plugin qui a l’ait intéressant, mais que je ne peux pas utiliser pour le moment.

    Répondre à ce message

  • Peter Din

    Bonjour,

    Je n’arrive pas à comprendre comment installer un agenda sur mes pages publiques.
    Je possède les plugins agenda et widget-agenda.
    Mais lorsque j’essaie d’utiliser le gabari agenda rien ne s’affiche.

    Pouvez vous m’aider,

    J’aimerai avoir une sorte de calendrier mensuel avec les évènements.

    Merci

    Répondre à ce message

  • 3

    Bonjour,

    je découvre SPIP et notamment le plugin Magusine.
    J’ai tout installé et j’ai une erreur lorsque j’active le plugin :
    « Fatal error : Call to undefined function : spip_abstract_showtable() in /mnt/167/sdb/b/d/sophie5737/plugins/magusine/base/arty_init.php on line 9 »
    Et mon site ne fonctionne plus, j’ai le message suivent :
    « Warning : fopen(plugins/magusine/themes//theme.xml) [function.fopen] : failed to open stream : No such file or directory in /mnt/167/sdb/b/d/sophie5737/plugins/magusine/inc/xml-parser.php on line 17
    Cannot open XML data file : plugins/magusine/themes//theme.xml »
    Merci de m’éclairer sur cette erreur.

    • As-tu vérifié lors de la décompression des fichiers ou lors de l’installation sur le serveur les droits d’accès des fichiers ? (je pense par exemple à un CHMOD 777 sur le répertoire ou un truc dans ce goût-la quoi...)

    • Merci, mais le pb c’est que je suis hébergé chez Free, donc pas de chmod possible.
      Tant pis, j’utilise un autre plugin, je reviendrai sur Magusine une autre fois peut être.
      Merci quand même.

    • rzawutang44

      Je suis chez free et je n’ai pas ce probleme
      guillaume.delafond.free.fr

      Visiblement le serveur ne trouve pas le fichier :
      /plugins/magusine/themes//theme.xml
      Peut-etre un probleme lors de l’upload. Réinstalle le plugin.

    Répondre à ce message

  • 1
    Frédéric

    Bonjour et merci pour ce superbe outil ;-)
    Je l’ai installé sur SPIP1.92 en mise à jour d’une V1.6.

    Tout baigne,ou presque, je commence à le prendre en main et à comprendre les subtilités du gabarit et autres fonctions.

    J’ai plusieurs petits problèmes auxquelles je n’ai pas de trouvé de réponse dans les tutoriaux.

    1 Je n’arrive pas à afficher les article et rubriques sur la page d’accueil. Les derniers forums et les les colonnes fonctionnent bien par ailleurs.

    2 J’essaie de télécharger des bandeaux et j’ai le message « impossible de télécharger le bandeau »

    Quelqu’un sait il me donner une réponse ?

    Merci

    • Bonjour
      Je ne sais pas si cela pourra t’aider, mais moi, pour afficher des articles, je me sers de la page articles-une.html (squelettes/blocs/sommaire) et dans l’espace privé configuration de base (magusine), je vais « chercher » mes articles dans Rubrique et articles à la une

    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