Menus

Créez enfin vos menus facilement !

Introduction

Lorsqu’on ne se sert pas du plugin ’Menus’, on est obligé de définir tous ses menus dans les squelettes, ce qui fait que l’administration du site n’a pas directement la main dessus, lorsqu’un changement est nécessaire, il faut en faire la demande à la personne en charge des squelettes.

De plus, lorsqu’on veut des liens statiques (un lien vers un article précis, ou vers une page précise, ou vers un site externe) il faut les écrire en dur dans le squelette du menu.

Le but du plugin ’Menus’ est donc de permettre de facilement élaborer des menus au moyen d’une interface conviviale, directement dans la partie privée.

Attention ! Ce plugin ne s’occupe pas de la manière dont seront affichés les menus. Il permet de les créer facilement et d’en générer le HTML.

Pour l’affichage, voyez avec votre thème ou des plugins spécifiques tels que Menu animé déroulant, Menu Déroulant 2, Menu Accordéon 2 ou Menu jQuery Superfish.

Installation

Comme n’importe quel plugin.

Création d’un menu

Le plugin ajoute un lien dans le bandeau de SPIP :

Capture d'écran de l'ffichage du plugin menu dans le menu de l'espace privé de SPIP.

La page liste tous vos menus, et vous propose d’en créer un nouveau :

D’abord vous devez identifier votre menu. Il faut lui donner un titre, ainsi qu’un mot-clé qui vous permettra de l’appeler facilement. En effet, vous ne pouvez pas prévoir à l’avance dans vos squelettes le numéro du menu. Grâce à ce mot-clé identifiant, vous n’avez donc pas à modifier vos squelettes à chaque fois. Vous pouvez également saisir une classe qui sera ajoutée au premier élément ul du menu généré. Ceci peut permettre d’activer la gestion de l’affichage par un plugin tiers.

Vous pouvez alors commencer à construire le menu en ajoutant des entrées :

Les différents types d’entrées

Les Menus sont fournis pour l’instant avec plus de dix types d’entrées qui permettent déjà de construire la plupart des menus facilement.

N’hésitez pas à en proposer d’autres !

Voici la description de quelques uns des types d’entrées disponibles :

-  Lien arbitraire : vous pouvez créer des liens vers ce que vous voulez en donnant une adresse et un titre.

-  Objet de SPIP : crée un lien vers n’importe quel objet éditorial de SPIP. Ça peut être un article, une rubrique ou n’importe quoi venant d’un plugin.

-  Liste dynamique de rubriques et d’articles : vous pouvez afficher les rubriques de SPIP, y compris de manière arborescente. Pour cela, il suffit de définir la rubrique dans laquelle il faut commencer la liste, le niveau maximum de sous-rubriques, les exclusions éventuelles, le type de tri... Vous pouvez aussi inclure les articles dans l’arborescence, limiter leur nombre, en gérer le tri...

Détails des options d’une entrée de menu : Liste ou arborescence de rubriques et d’articles (avec beaucoup d’options)

Modification des entrées

Lorsque vous avez déjà ajouté des choses, vous obtenez alors la liste des entrées sous cette forme :

Vous pouvez alors déplacer les entrées pour modifier leur ordre, les supprimer, changer leurs paramètres et créer des sous-menus en-dessous des entrées qui le permettent.

Utiliser les menus dans votre site

Pour afficher un menu dans votre site, il vous suffit d’inclure un petit squelette où vous le désirez :

#INCLURE{fond=inclure/menu, env, identifiant=<votre_menu>}

Vous pouvez aussi tester votre menu facilement en cliquant sur le bouton « Voir en ligne » ou en allant sur la page : spip.php?menu<numero>

Exporter les menus vers un autre site

Imaginons que sur une version de votre site en local vous réorganisez tous les menus. Pour reporter ces changements en prod, il faut exporter les menus dans un fichier et les réimporter en prod.

S’assurer tout d’abord que le plugin Yaml est activé .

Lorsqu’il est activé une icône apparaît : exporter ce menu

Le sauvegarder sur votre ordinateur

Sur le site de destination, il suffit de créer un nouveau menu avec le même identifiant (penser à le supprimer avant s’il existe). Et à la création, si le plugin YAML est bien activé, la boite de choix de fichier est proposée.

Surcharge des fichiers menus/<type>.html

Si pour des besoins particuliers, on doit surcharger un fichier du répertoire menus/, il ne faut pas oublier de copier le fichier XML de description qui va avec.

En effet, le plugin cherche le fichier XML au même endroit que le fichier HTML.

Discussion

5 discussions

  • 1

    Bonjour
    J’ai un squelette avec un fil d’Ariane qui donne l’arborescence correspondant aux rubriques de spip
    Es-til possible d’avoir un fil d’Ariane correspondant à l’arborescence du menu ?
    Cordialement

    • Je ne vois pas trop comment ça serait possible simplement, car une page n’est pas à UN endroit précis d’un menu. Le menu constitue une liste (et sous-listes en cascade) totalement arbitraire, et une même page (tel article, telle rubrique, etc), peut parfaitement se trouver à 4 endroits différents du menu suivant les entrées qu’on décide d’y mettre. Donc il n’y a pas du tout de notion de « chemin » (et encore moins unique) dans les menus.

    Répondre à ce message

  • 4

    Bonjour Rasta,
    Une autre petite chose qui pourrait aider, c’est de pouvoir éventuellement afficher TOUS les éléments (même ceux n’ayant pas d’article) lorsqu’on sélectionne l’option « Liste ou arborescence de rubriques et d’articles », assurément utile durant le développement, et dans certains cas pour des rubriques n’ayant pas d’articles mais un autre type de contenu (albums par ex).

    • Par défaut les rubriques ne sont pas publiées si elles ne contiennent rien, et ça ne s’affiche que si on force le critère {tout}. Mais c’est pas juste pour les menus : si ensuite ça t’amène dans l’URL finale de cette rubrique, par défaut ça va faire une 404 vide (si ya pas le critère {tout} aussi dans la boucle englobante de la page finale).

      Spécifiquement pour le cas des autres contenus : si une rubrique contient d’autres contenus que des articles, elles est censées AUSSI être publiée. Si ce n’est pas le cas, alors c’est un bug qu’il faudrait rapporter dans le plugin qui ajoute cet autre contenu (les albums par exemple ou autre).

      En revanche pour le cas où on voudrait juste afficher une rubrique totalement seule (sans rien dedans), là effectivement c’est le seul cas où ça pourrait être utile. Cependant c’est très compliqué techniquement actuellement, car ça oblige à doublonner TOUTES les boucles. Je viens de faire un ticket du coup pour simplifier un jour le fait de rendre ça optionnel : https://git.spip.net/spip/spip/issues/5618

    • Oui, tu as raison, les albums ajoutés à une rubrique la rendent visible. Par contre, s’il y a que des mots-clés, elle ne s’affichera pas... Mais je suis tombé par hasard sur une lame du Couteau Suisse (Affiche tout) qui permet de forcer les rubriques vides notamment dans le menu, donc tutti va bene !

      Si je peux me permettre, je voudrais suggérer une autre option (dans « Liste ou arborescence de rubriques et d’articles »), celle de n’afficher que les articles à plat des rubriques et leurs sous-rubriques (les sous-rubriques n’apparaîtraient donc alors pas).

      Merci encore pour ta réponse précédente d’une rapidité flashgordonnienne !

    • Tu voudrais une option branche quoi ?
      Mais si c’est pour sortir que des articles, je verrais plutôt ça dans l’entrée « articles » uniquement (que tu mets en sous menu d’une entrée objet de chaque secteur à priori).

    • Oui, c’est exactement ça, une option branche.
      Maintenant, ce que tu suggères me convient très bien, merci pour le tip !

    Répondre à ce message

  • Bonjour Rasta,
    juste pour signaler un tout petit bug : si on commence à ajouter une entrée et qu’on se ravise en annulant, « annuler » et « enregistrer » ne fonctionnent pas...

    Répondre à ce message

  • 2

    Bonjour,
    existe-t-il un moyen de mettre sur « pause » un menu ou un sous-menu ?

    Répondre à ce message

  • Bonjour,
    juste pour dire que lorsqu’on utilise Champs Extra, il manque la petite icône pour l’option « Entrées des menus du site » (voir ecrire/ ?exec=champs_extras)

    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