Le plugin Magusine

Publié le : 31 mars 2008 – Dernière modification le 21 décembre 2021 – par stephane – 270 commentaires

Español, français
1
2
3
4
5
26 votes
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

5 ans 1 an 3 mois Sans limite
par date
Filtrer

122 discussions

  • 2

    Bonjour,

    j’ai un souci avec mon image au hasard, elle ne s’affiche pas... les paramètres sont les mêmes que pour la vidéo qui elle marche. Elles sont toutes 2 placées dans le même contexte.
    Si quelqu’un a déjà eu ce problème et la solution qui va avec...

    merci

    • Stéphane

      Est ce que vous avez spécifié les articles et/ou rubriques dans laquelle les choisir dans la partie « configuration de base » ? Si oui, il faut vérifier qu’il s’agit bien de documents images attachés à ces rubriques/articles et non pas des images dans le texte...

    • step

      Si oui, il faut vérifier qu’il s’agit bien de documents images attachés à ces rubriques/articles

      Le mot important ici étant « Documents ». J’ai longtemps essayé en insérant les images comme des images en utilisant « AJOUTER UNE IMAGE » et c’est en passant par « AJOUTER UN DOCUMENT » que ça fonctionne !

    Répondre à ce message

  • willybob

    Juste un soucis de gabarit à associer.. j’ai créé un nouveau gabarit à partir de « groupe de mots ». Le seul soucis c’est quand je veux l’associer à un groupe de mots clés, aucun gabarit n’apparaît sur la liste. Comment contourner ce problème ? où spécifier dans le code (puisque ce n’est pas possible depuis l’interface spip) que ce gabarit doit être associé à ce groupe de mots clés ?
    si quelqu’un pouvait m’aider..
    merci d’avance !!

    ps : merci beaucoup pour ce plugin très pratique !

    Répondre à ce message

  • 1
    hyaka

    Encore une demande :
    -  Je suis dans le gabarit mot-clé, je voudrais ajouter des choses qui sont dans le gabarit sommaire, comment je fais ?
    Avec le système de gabarit dérivé, cela ne fonctionne pas. Merci.
    ACP

    • Stéphane

      Il faut créer le dossier « pages-custom » à la racine du site, et y créer un dossier « gabarits ». Là, créer un fichier « ajout-mot.xml ».
      dans ce fichier, simplement écrire un truc du genre

      <?xml version="1.0" encoding="utf-8"?>
<gabarit type="defaut">
<bloc statut="2" param="1,3,5,10" paramdefaut="3" paramdescr="nombre_liens_affiches">derniers-liens</bloc>
<bloc statut="2" param="1,3,5,10" paramdefaut="3" paramdescr="nombre_forums_affiches">derniers-forums</bloc>
</gabarit>

      Les noms de ces blocs et leurs parametres peuvent être trouvés dans le fichier « definitions-gabarits/sommaire.xml » où sont listés tous les blocs de la page sommaire.

      Ensuite aller dans la page « gabarits » du plugin, disposer les blocs au bon endroit et sauver. C’est fait.

    Répondre à ce message

  • 1

    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 ?

    • Stéphane

      L’enfer de free. Je n’avais pas encore vu celui-là. Heu, dans un premier temps, je ré-uploaderais le plugin, il se peut que ce soit aussi simple que ça...

    Répondre à ce message

  • 1
    joseluis

    Bonjour, il serait possible creer squelettes du type article-3 pour tous les articles d’une rubrique, ou rubrique-3, rubrique=3,... avec les fonctionalités de magusine ?

    salut !

    • Stéphane

      oui, c’est possible. Il faut créer un gabarit associé à ces rubriques. La méthode est la suivante et tout se passe dans le dossier « pages-custom » :
      -  Créer le fichier article-3.html (par exemple)
      -  créer un dossier « gabarits » (dans pages-custom),
      -  y créer un fichier xml en lui donnant un nom distinct, par exemple « article3.xml »
      Dans ce fichier, il va falloir lister les blocs que vous voulez utiliser, je recommande ici de recopier le fichier article.xml qui se trouve dans le dossier « definitions-gabarits » du plugin, et de le modifier pour y ajouter ce que l’on veut.
      -  ajouter des blocs « non magusine » dans « pages-custom » au besoin
      -  dans l’interface d’administration des gabarits, le gabarit « article3 » devrait apparaitre, mettez les blocs dans le bon ordre et validez
      -  le gabarit devrait maintenant s’appliquer aux articles de la rubrique 3 comme prévu.

    Répondre à ce message

  • 1
    Gargu

    Il semblerait qu’il n’y ait personne pour nous prêter main forte... Autant de questions sans réponse, va falloir se rabattre sur d’autres plugins en attendant que le très prometteur Maguzine évolue...

    • Stéphane

      Bonjour à tous,
      Je suis Stéphane, le développeur du projet magusine. Professeur dans une école d’art, je rentre en ce moment dans le vif de mes cours et suis moins disponible. La plupart des bugs listés ici sont facilement corrigeables/contournables avec un peu de code, mais là le manque de temps me serre la gorge. Un peu de patience donc. Par ailleurs, tout ceci est open source, et j’ai vu qu’une entraide s’organisait. Le passage du plugin pour la version 2 va me demander un peu de travail aussi, et à ce moment vos aides me seront utiles.

    Répondre à ce message

  • gilhem

    Bonjour

    Un petit soucis avec le Plugin Magusine et l’accès restreint.

    Autant je ne rencontre pas de soucis pour un accès restreint sur l’ensemble du site, autant je ne parviens pas à restreindre certain rubrique, voire sous-rubrique. Le soucis ? Avec indentification du visiteur, pas de menu !

    Mauvaise manip ? Mauvaise utilisation ou mauvais paramétrage des plugins ? Pouvez-vous m’aider, d’autant qu’il n’y a pas de documentation à ce jor.

    Merci de votre aide.

    Gilles

    Répondre à ce message

  • hyaka

    Dans le bloc « derniers articles » du sommaire, j’aimerais avoir une liste avec les articles suivants (comme ici). J’ai essayé l’opération, mais cela ne fonctionne pas.

    Dans un bloc libre, j’aimerais avoir deux liens et deux images, est-ce possible ?

    Merci. ACP

    Répondre à ce message

  • Denis chatiron

    Bonjour,

    Le plugin magusine ne fonctionne que lorsqu’on a conservé le préfixe « spip » sur les tables de la bdd.

    Exist-t-il une méthode permettant de l’utiliser en ayant modifié ce préfixe dans le but de plusieurs installations sur une seule base de données ?

    Merci beaucoup et bravo pour ce plugin étonnant .

    Répondre à ce message

  • Denis chatiron

    Bonjour, j’aimerai utiliser Magusine. Malheureusement, mon serveur n’a pas la librairie gd2. Les images ne s’affichent pas.

    Quelqu’un a-t-il une méthode pour contourner ce problème ?

    Cette absence de gd2 engendre-t-elle d’autres soucis d’affichage (je n’ai testé que les images)

    Merci d’avance

    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