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

354 discussions

  • merci pour tout je vais regarder ca !
    Ari

    Répondre à ce message

  • 1

    Merci pour ta réponse, j’ai eu une table spip_menus_entrees mais pas de table spip_menus.

    Pour ce qui est du fichier log, j’ai ca :

    Too big column length for column ’identifiant’ (max = 255). Use BLOB instead - CREATE TABLE IF NOT EXISTS addmwhlo.spip_menus (
    id_menu bigint(21) NOT NULL auto_increment,
    id_menus_entree bigint(21) DEFAULT ’0’ NOT NULL,
    titre text DEFAULT ’’ NOT NULL,
    identifiant varchar(500) not null,
    PRIMARY KEY (id_menu),
    KEY id_menus_entree (id_menus_entree))

    et...

    SELECT menus.titre, menus.id_menu, menus.identifiant
    FROM addmwhlo.spip_menus AS menus
    WHERE (menus.id_menus_entree = 0)
    ORDER BY menus.titre

    Table ’addmwhlo.spip_menus’ doesn’t exist -
    SELECT menus.titre, menus.id_menu, menus.identifiant
    FROM spip_menus AS menus
    WHERE (menus.id_menus_entree = 0)
    ORDER BY menus.titre

    Table ’addmwhlo.spip_menus’ doesn’t exist -
    SELECT menus.titre
    FROM addmwhlo.spip_menus AS menus
    WHERE (menus.id_menu = 0)

    Table ’addmwhlo.spip_menus’ doesn’t exist -
    SELECT menus.titre
    FROM spip_menus AS menus
    WHERE (menus.id_menu = 0)

    Voila tout, je sais pas si ca peut t’aider...
    En tout ca merci.

    Ari

    • RastaPopoulos

      Ben c’est clair : la table n’a pas été créée, donc ça va être difficile d’aller plus loin. :) J’ai mis à jour le plugin pour corriger.

      Si tu as pris le plugin par le ZIP, il faut attendre que le paquet se régénère. Ensuite il faut que tu désinstalles le plugin (le bouton « carton » dans l’admin des plugins). Et que tu mettes à jour le dossier du plugin. Puis que tu le réactives.

      Mais vu que c’est une toute petite modif, tu peux juste désinstaller le plugin, et modifier le fichier « menus/base/menus_tables.php » en changeant "identifiant" => "varchar(500) not null" par "identifiant" => "varchar(255) not null".

      En suite tu l’actives et la table devrait bien être là.

    Répondre à ce message

  • 1

    Bonjour,
    Un message pour vous faire part de mon problème. Je n’arrive pas à créer un menu et suis bloqué par le message : « Une erreur s’est produite pendant la mise à jour de la base de donnée. » au moment ou j’enregistre le titre et l’identifiant du menu.
    Je vous remercie pour votre aide.
    Ari

    • RastaPopoulos

      Aucune autre erreur ? Il faudrait regarder dans le fichier « tmp/mysql_prive.log » pour voir quelle erreur il y a eu dans la base de données.

      À part ça il y a bien une table « spip_menus » dans la base oui ?

    Répondre à ce message

  • 1

    et si...

    et si je fais un modèle (squelettes/modeles/inc_menu.html) avec juste la ligne :

    [(#INCLURE{fond=#CHEMIN{menus/inclure/menu.html}|replace{.html$}, env, identifiant=#ENV{identifiant}})]

    alors je peux appeler, depuis le texte de mon article en cours de rédaction :

    <inc_menu|identifiant=liste_liens_01>

    et cela m’affichera bien le menu liste_liens_01 dans le corps de mon article.


    certes.
    mais à quoi ça sert ?

    imaginons que je prépare des menus catégoriels rassemblant des liens liés aux grands sujets de mes rubriques.
    je peux ainsi insérer, si je veux, où je veux, ce (ces) menu(s) directement lors de la rédaction de mes articles (en fonction du sujet abordé par exemple...)

    • RastaPopoulos

      Je ne vois pas du tout à quoi sert ton #CHEMIN.

      Déjà #CHEMIN va chercher avec find_in_path(), donc normalement c’est plutôt #CHEMIN{inclure/menu}, pas avec le nom du dossier plugin devant.

      Et ensuite, vu que ce n’est pas dynamique, à quoi ça sert ? Le paramètre « fond » d’un #INCLURE va AUSSI faire un find_in_path() en plus !

      C’est juste #INCLURE{fond=inclure/menu, env, identifiant=#ENV{identifiant}}.

    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