Les squelettes de monde-solidaire.org

Cet article décrit comment installer monde-solidaire.org à partir de zéro et donne quelques indications sur l’organisation du code.

Si vous avez des questions, vous pouvez les poser à webmestres@monde-solidaire.org.

Pour télécharger les squelettes

 skel-monde-solidaire.zip (795 Ko) : contient les fichiers spécifiques à monde-solidaire.org

NB : les squelettes contiennent entre autres un système de navigation géographique ; les cartes et les drapeaux des pays sont lourds, donc téléchargeables à part :
 flags-15.zip (218 Ko) : drapeaux en 15 pixels ;
 flags-27.zip (291 Ko) : drapeaux en 27 pixels
 maps-continents.zip (104 Ko) : cartes des continents.
 maps-countries.zip (3027 Ko) : cartes des pays
Pour être inclus dans les squelettes du site, ces fichiers sont à dézipper dans le répertoire _siteFiles/data/geo.

Par ailleurs, les images de certains anciens artices et rubriques sont dans l’archive contents.zip (attention, c’est lourd : 16,8 Mo...), à dézipper dans le répertoire _siteFiles/contents ; leur absence ne nuit en rien à la navigation.

Et le fichier www.txt contient des indications sur la provenance des données géographiques.

Si vous voulez installer le site chez vous, vous pouvez toujours télécharger le fichier dump.xml.gz (plus de 8 Mo) et faire un import de la base mysql dans spip.

Installation

Ces indications sont valables pour spip 1.8.2g

Dans ce qui suit, les chemins des fichiers sont relatifs à la racine du site (ex : si le site est sous /home/sites/monSite, le fichier mes_fonctions.php3 représente /home/sites/monSite/mes_fonctions.php3).

• Dézippez un spip sur votre disque.
• Suivez la procédure habituelle d'installation (Faites pointer votre Apache sur la racine du site, et allez sur le répertoire http://monChemin/monSite/ecrire, et suivez les instructions).


Puis intégrez les squelettes de monde-solidaire :
• Supprimer de la racine :
  • Tous les fichiers *-dist.html
  • article.php3
  • backend-breves.php3
  • breve.php3
  • distrib.php3
  • habillage.css
  • ical.php3
  • impression.css
  • mot.php3
  • nouveautes.php3
  • resume.php3
  • site.php3
  • sommaire_texte.php3
  • spip_style.css
  • typographie.css
• Décompressez l'archive skel-monde-solidaire.zip à la racine du site ; cela doit avoir pour effet de rajouter les fichiers suivants :
  • agenda.php
  • archives.php3
  • article.php3
  • guiComponents.php3
  • imprimer.php3
  • menu.php3
  • menuGeo.php3
  • mes_fonctions.php3
  • plan-agenda.php3
  • puce2.gif
  • sinscrire.php3
  • sitesReferences.php3
  • spip_admin.css
  • spip_style.css
  • le répertoire _siteFiles, qui contient les squelettes de monde-solidaire.org.
  • le fichier ecrire/mes_options.php3
• Changez ensuite les valeurs des variables pour mySql dans _siteFiles/meta/php/globals.php.

A propos du code des squelettes

La plupart des fichiers spécifiques au site sont dans le dossier _siteFiles. Ce dossier contient les squelettes, ainsi que plusieurs dossiers :

• Le dossier meta, qui contient tous les fichiers annexes (css, javascript, images, php, bibliothèques (lib))
• Le dossier contents, qui contient des images ou documents qui sont utilisés dans différents articles ou rubriques ; ils ne sont pas inclus dans skel-monde-solidaire1.zip, car trop lourds.
• Le dossier cache, qui est utilisé pour les fichiers cachés gérés par les squelettes (tels que menuGeo.js).
• CSS : les feuilles de style sont dans _siteFiles/meta/css sauf spip_style.css, laissée à la racine car utilisée par les formulaires de spip.
• Organisation des includes (utilisation de require()) : Chaque squelette appelle require("_siteFiles/meta/globals.php") ; toutes les autres inclusions sont paramétrées par la valeur de certaines constantes, variables ou fonctions de globals.php.
  Ainsi, on n'a que ce fichier à changer lorsqu'on change de serveur.
• Liens vers les images : le dossier _siteFiles/meta/images contient les images utilisées dans toutes les pages de l'interface publique. Ayant eu à gérer des problèmes de nombre de hits, le chemin vers ces images (attributs SRC des tags IMG) sont effectués par un appel PHP. Le chemin est affiché par la fonction mip() ; comme ça, on peut changer les images de serveur en n'ayant que mip() à modifier.
  Même chose pour l'appel aux fichiers CSS (sauf spip_style.css), par mcp().
  ATTENTION : cela empêche toute utilisation de url() dans les fichiers CSS. Ces appels ont été déportés vers les squelettes utilisateurs (cas de rt_list).

Adaptation des menus DHTML

récupéré à : http://www.uzine.net/spip_contrib/article.php3?id_article=90

• Rajouté menu.php3 et _siteFiles/menu.html
• Rajouté rep _siteFiles/meta/lib/coolMenus

Dans _siteFiles/menu.html :

• modifié onlineRoot
• mis le contenu du rep 'fonctions' de la distrib dans le rep '_siteFiles/meta/lib/coolMenus'
• fait un find and replace de "fonctions" par "_siteFiles/meta/lib/coolMenus"
• modifié l'image fill2.gif
• changé valeurs de :
  • oCMenu.level[0].width,
  • oCMenu.level[1].width en fonction de la taille des titres des rubriques et sous-rubriques.
  • oCMenu.fromLeft
  • oCMenu.fromTop
  • oCMenu.useBar (passé de 1 à 0)

Modifs dans la boucle d'affichage :

• Renommé les noms des boucles pour plus de clarté.
• A chaque niveau de boucle sur les rubriques, un lien vers la rubrique mère est écrit (ex : "--- Titre de la rub mère ---")
• Pour chaque rubrique affichée, un test est effectué pour tester si la rubrique est archivée.
• Remplacé partout #TITRE par [(#TITRE|supprimer_numero|texte_script)]

Notes aux administrateurs

• Lorsqu'une rubrique ou sous-rubrique est ajoutée, vérifier que les menus sont assez long pour contenir le nom de cette rubrique. Si ce n'est pas le cas, modifier la valeur de oCMenu.level[0].width (ou oCMenu.level[1].width etc... suivant le niveau de la rubrique) dans menu.html.
• Si un secteur (rubrique de plus haut niveau) est ajouté, rajouter des
<BR> dans guiComponents.html, en fin du cas "display = mainTableLeft", afin que le reste du contenu de la colonne de gauche s'affiche plus bas.
  Si cela fait changer la taille de oCMenu.level[0].width, changer :
  • _siteFiles/meta/images/design/top_page.jpg
  • _siteFiles/meta/images/design/lt_bg.jpg,
  • dans guiComponents.html l'attribut WIDTH dans display = mainTableLeft
  • dans guiComponents.html l'attribut width dans display = searchForm
  • dans guiComponents.html l'attribut width dans display = mailingList
  • dans guiComponents.html l'attribut width dans display = spip
  • dans _siteFiles.css, lt_participateTable : la valeur de width
Thierry, 8 septembre 2003