Un squelette par secteur (gestion par dossier)

This is an « educational contribution » which shows, with concrete example, how to develop a new functionality for SPIP.

Il existe plusieurs méthodes permettant de squelettiser chaque secteur, vous les trouverez facilement sur le web.

Avant de se lancer sur cette démarche de gestion arborescente, il est nécéssaire de connaître quelques fondamentaux alternatifs à cette méthode :

Le besoin ?

Considérons un portail web, permettant l’accès à plusieurs vitrines.
Le portail sera représenté par la page sommaire.html et chaque vitrine, correspondra à un secteur du site spip.

Difficultés à prendre en compte

Une personnalisation poussée des secteurs peut rapidement provoquer une amoncellement de fichiers “en vrac”. Chaque modification pouvant malencontreusement avoir des incidences/régressions non prévues sur une autre vitrine/secteur.

Afin de pallier à cette problématique, la séparation complète des ressources peut être la solution.

Dans la méthode proposée ci-dessous, nous partons du principe que nous séparons totalement les environnements en isolant les ressources css, img, js, includes... par secteurs.

Organisation

Considérons nos vitrines :

  • Un site commercial = id_secteur 1
  • Un site de support = id_secteur 2
  • Un blog = id_secteur 3

Arborescence :

  1. A la racine de notre répertoire squelettes vide nous créons les répertoires :
  • siteCommercial
  • siteSupport
  • siteBlog
  1. A la racine du répertoire squelettes, vous y déposerez vos fichier HTML vides (sommaire, article, rubrique...).
  2. Dans chacun de ces répertoires, vous y déposerez vos squelettes dédiés à chaque vitrine, avec vos fichiers (html, css ,js ,img) spécifiques au squelette du secteur.

Nous obtenons donc ceci :

./squelettes/siteCommercial/sommaire.html
./squelettes/siteCommercial/article.html
./squelettes/siteCommercial/rubrique.html
./squelettes/siteCommercial/css/...
./squelettes/siteCommercial/js/...
./squelettes/siteCommercial/img/...

./squelettes/siteSupport/sommaire.html
./squelettes/siteSupport/article.html
./squelettes/siteSupport/rubrique.html
./squelettes/siteSupport/css/...
./squelettes/siteSupport/js/...
./squelettes/siteSupport/img/...

./squelettes/siteBlog/sommaire.html
./squelettes/siteBlog/article.html
./squelettes/siteBlog/rubrique.html
./squelettes/siteBlog/css/...
./squelettes/siteBlog/js/...
./squelettes/siteBlog/img/...

Comment faire nos appels vers les bons fichiers de squelettes ?

Le principe est très simple.
Pour accéder à chacune des vitrines, il suffira que sur le sommaire.html principale, vous fassiez des liens vers les sommaire.html des vitrines (sous-dossiers/sommaire.html).

Ensuite, considérons l’affichage d’un article sur l’une de nos vitrines. Cet article appartient forcément à un secteur unique. Nous allons donc tester son appartenance à un secteur et lui faire afficher le squelette article.html du sous-dossiers concerné.

Code HTML de ./squelettes/article.html

<BOUCLE_article(ARTICLES){id_article}>
[(#ID_SECTEUR|=={1}|oui)<INCLURE{fond=siteCommercial/article,id_article,env}/>]
[(#ID_SECTEUR|=={2}|oui)<INCLURE{fond=siteSupport/article,id_article,env}/>]
[(#ID_SECTEUR|=={3}|oui)<INCLURE{fond=siteBlog/article,id_article,env}/>]
</BOUCLE_article>

Bilan

Cet article ne se veut pas exhaustif, mais il a pour but de présenter une méthode simple et facile à gérer.

Discussion

No discussion

Add a comment

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 / PostgreSQL
  • 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 apparait.

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.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom