SPIP - Contrib

SPIP - Contrib

[ar] [en] [es] [fr] [it]

63 visiteurs en ce moment

fontsizeup fontsizedown
Accueil du site > Contribs > Squelettes complets > Squelettes pour blog > Lebanon > Lebanon : Ajouter un menu (programmation SPIP)
[6 commentaires]

Lebanon : Ajouter un menu (programmation SPIP)

vendredi 2 novembre 2007, par erational

  • Digg
  • Del.icio.us
  • Facebook
  • Google
  • Technorati

Apprendre à modifier un squelette SPIP pour ajouter un élément tel qu’un menu. Pour ce tutoriel, nous allons modifier le squelette Lebanon conçu par romy.tetue.net

Nous allons maintenant modifier le squelette pour l’adapter à nos besoins.

Avant tout, n’oubliez de sauvegarder régulièrement vos modifications pour pouvoir revenir en arrière si besoin.

Objectifs

Nous allons reprendre le squelette pour le transformer en portail. Actuellement on a une présentation de type Blog : les articles sont listés les uns après les autres.

Sur les sites portails, on a souvent les grandes catégories auxquels on peut accéder directement. Nous allons donc ajouter sous l’entête, une barre de navigation horizontale qui reprend les rubriques principales du site.

Ajouter la barre de navigation en HTML

La première étape est d’analyser le squelette pour savoir où nous allons ajouter le code HTML de cette barre de navigation. Cette barre doit être présente sur toutes les pages sur site et donc sur le squelette de toutes les pages : article.html, rubrique.html, recherche.html ....

D’après notre analyse de la feuille de style, l’endroit le plus logique pour placer ce menu est sous le bloc #entete. Nous allons donc y créer un nouveau bloc #menu.

Si on analyse la page article.html, on remarque que l’on ajoute le bloc #entete est ajouté avec l’instruction SPIP INCLURE qui permet d’inclure des bouts de squelettes.

Nous avons donc le choix ici pour ajouter notre nouveau bloc #menu :
- soit on ajoute le code HTML du menu dans le fichier inc/inc-entete.html
- soit on crée un nouveau fichier pour placer le code HTML du menu.

On préfère la deuxième solution plus modulaire, on créé donc un fichier inc/inc-menu.html avec le code HTML du menu. Pour l’instant le code est dit statique c’est à dire que on place à le code à la main (il faudra ensuite que SPIP le calcule automatiquement)

Fichier inc/inc-entete.html :

Remarque :

Comme il s’agit d’un bout de code placé à l’intérieur d’une page, nous n’avons pas besoin de tags habituels <html><body> ..... Pour le menu, nous avons choisi les tags <ul><li> car du point de vue sémantique, il s’agit d’une liste de liens

Nous faut maintenant inclure ce bout de code dans toutes les pages du squelette, par exemple dans article.html

Cette opération sera à répéter ensuite sur les fichiers rubrique.html, recherche.html, sommaire.html ...

Dans l’espace public du site, nous allons recalculer la page pour voir le résultat :

C’est bon, la liste apparait ! Il faut maintenant l’habiller ...

Habiller la barre de navigation avec la feuille de style

Comme nous avons un nouveau bloc, rien de plus de facile de l’habiller. Nous allons ajouter sur habillage.css

Et voilà le résultat :


Remarque : comme nous avons utilisé un float:right, il faudra lister les liens à l’envers ....

Programmer une boucle pour avoir un menu dynamique

Notre menu marche maintenant très bien. Le problème est que si nos administrateurs ajoutent une nouvelle rubrique à la racine du site, notre menu ne se mettra pas jour. Nous avons besoin d’un menu dynamique. Nous allons le programmer grâce aux boucles SPIP

On regarde alors la documentation, on veut lister une série de rubriques, on va utiliser la boucle RUBRIQUES dont la syntaxe est

Nous avons utilisé deux critères :

  • {racine} pour lister uniquement les rubriques à la racine du site
  • {par titre} : critère de tri pour lister les rubriques par ordre alphabétique

Le code est donc pour le fichier inc/inc-entete.html

Ce qui donne, lorsqu’on recalcule une page du site :

Youpi ! On obtient le résultat escompté quelque soit le nombre de rubriques à la racine du site.

Résumé

Il s’agit d’un exemple pédagogique. On peut bien sur compléter et affiner ce menu :

  • Mettre en valeur la rubrique courante
  • Utiliser un autre ordre de tri
  • Lister les sous-rubriques ....

Nous vous rappelons la méthode :

  1. Repérer la partie dans lequel vous voulez injecter votre code HTML (une page, un inclure, un nouveau bloc...)
  2. Tester votre HTML d’une façon statique
  3. Eventuellement mettre à jour la CSS pour habiller le nouveau code HTML
  4. Ecrire une boucle SPIP pour rendre votre HTML dynamique
  5. Tester

Nous vous conseillons d’effectuer ce tutorial étape par étape « à la main »

Pour les plus paresseux voici les fichiers du corrigé

Zip - 69.8 ko
Corrigé du tutoriel
ajout d’un menu horizontal sur lebanon

P.-S.

Article préalablement publié sur le site GenerationCyb

Retour en haut de la page

6 Messages de forum

Voir toute la discussion

  • Répondre à ce message

    31 mars 01:04 , par benzine

    bonjour

    je n’arrive pas à faire tenir le menu dans l’entete. le probleme se pose au niveau de la ligne : #menu ul li a display:block ; float:left ; background : #666 ; color :#fff ; text-decoration:none ; font-size:0.9em ; padding:4px 12px ;border:1px solid #efefef ; border-top:0 solid #333 ;. Cette ligne place le menu sous l’entete alors que je voudrais qu’elle se trouve à l’interieur (en bas a gauche)

    Merci pour votre aide

  • Répondre à ce message

    10 novembre 2007 15:22 , par Loiseau2nuit

    Hypothèse n°1 : Est ce que tes sous rubriques contiennent au moins 1 article ou 1 site ou 1 élément publié quelqu’il soit ?

    Hypothèse n°2 : Il doit y avoir un problème au niveau de tes boucles qui ne doivent scanner que le premier niveau ( {parent} ou {racine} ) de ton arborescence, qu’obtiens tu si tu changes ce critère ?

    Hypothèse n°3 : Peux tu poster ta boucle histoire que l’on voit comment elle est faite ?

  • Répondre à ce message

    10 novembre 2007 15:18 , par Loiseau2nuit

    Excuse moi je ne saisis pas bien ta question là ?

    Pourrais tu détailler un peu plus STP ?

  • Répondre à ce message

    5 novembre 2007 12:15 , par marcel

    Bonjour à toutes et tous, je dois avoir un problème, mes sous rubriques n’apparaissent ni dans le menu vertical, ni par la suite dans l’affichage de la feuille principale ? Merci de votre aide A bientôt

  • Répondre à ce message

    5 novembre 2007 01:33 , par hubert

    bonjour, juste une précision pour un débutant concernant la syntaxe de inc/inc-menu.html le signe : / qui est refusé à l’ecriture du nom de fichier ?

    [(#REM) barre menu horizontal ] inc-entete}>

  • Répondre à ce message

    2 novembre 2007 20:01 , par Loiseau2nuit

    Bien joué :)

    surtout le petit récapitulatif de l’architecture css du squelette. C’est Romy qui va être heureuse :D

Répondre à cet article

Retour en haut de la page

Ça discute par ici

SPIP | Squelette | | Plan du site | Suivre la vie du site RSS 2.0