Le Pic

Images du forum des Associations Ramonvilloises du 4 septembre 2010

Philippe — 2010-09-05T09:25:20Z

Le 4 septembre 2010 s'est tenu le 9^ème Forum des Associations de Ramonville Saint-Agne, auquel cette fois le PIC a participé. C'était l'occasion de rencontrer les associations de Ramonville et de faire connaissance avec celles qui ne connaissaient pas le PIC.

Cet article a simplement pour objectif de garder trace de l'événement.

Notez que les vidéos soient de piètre qualité car réalisés avec un appareil photo et non un caméscope...l'encodage pour la mise en ligne a été effectué en recourant exclusivement à des logiciels libres [1].

Les débuts des démonstrations de l'UCR Judo de Ramonville :

IMG/flv/demo_judo_1.flv

IMG/flv/demo_judo_2.flv

Démonstration de judo au sol avec des tous petits :

IMG/flv/demo_judo_4-judo_au_sol.flv

L'animation musicale réalisée par l'Association Ali Alaoui (extrait) :

IMG/flv/Association_Ali_Alaoui_2010_09_04.flv

Sur ce dernier Vidéo on aperçoit Jean-Louis qui nous a gentiment prêté sa rallonge tout au long du forum (merci Jean-Louis !).

Les photos jointes à cet article ainsi que les extraits vidéo sont © 2010 "Projet Internet et Citoyenneté" librement redistribuables et exploitables, car couverts par la licence Creative Commons BY version 2.0

Pour récupérer les vidéos, installez sur le navigateur Mozilla Firefox ou un ses dérivés (Iceweasel, Camino, SeaMonkey) le module Download Helper

Si votre association souhaite récupérer certains de ces documents au format de la prise de vue, n'hésitez pas à nous contacter.

[1] Avidemux pour la réduction, ffmpeg pour la conversion en .flv

Handi-social

Philippe — 2010-08-01T12:06:47Z

L'association Handi-social défend les droits des personnes en situation de handicap ou de maladies invalidantes.

Son site est en cours de mise en place sur le serveur du PIC ; les contenus peuvent y demeurer encore incomplets ; en attendant, vous pouvez toujours accéder à l'ancien site d'handi-social ici.

Voir en ligne : Handi-social

09. Mise à niveau de son SPIP

Philippe — 2010-07-31T07:06:00Z

Cet article est publié dans cette section car il est toujours recommandé d'effectuer un test sur une copie locale avant de procéder à la mise-à-niveau de votre site de production (au public).

Ainsi les anicroches et éventuelles adaptations ne profitent pas à tout le monde (!), et vous vous garantissez un accès constant du public à vos contenus, et un minimum de pertubation lors de ces opérations, lorsqu'au final vous mettez votre site de production à jour à son tour. [1]

RAPPEL ! Effectuez toujours une sauvegarde de toutes vos données et plus généralement de tout votre site avant d'intervenir sur les fichiers sources de votre système de publication, vous assurant en cas de problème de pouvoir remettre tout en place !

Tout d'abord, doit-on mettre à jour systématiquement son SPIP ?

La réponse à cette question est OUI.

En mettant régulièrement à jour votre CMS, vous vous assurez que les failles de sécurité débusquées par les développeurs de SPIP soient au maximum colmatées ;

En mettant régulièrement à jour votre CMS, vous vous épargnez la masse travail et de souci que peut occasionner le passage d'une version très dépassée de votre système de publication vers la version sa plus récente.

C'est quoi le principe ?

C'est très simple, la mise à jour consiste à écraser les fichiers de l'ancien spip avec ceux du nouveau. En somme vous copiez les nouveaux fichiers et répertoires dans le répertoire où se trouve vos fichiers de SPIP.

Mais bien sûr typiquement, puisque nous parlons d'un SPIP existant, différent répertoires gagnent à rester tels quels sans qu'on ait à les remplacer :

config, qui contient le paramétrage de connexion à la base de données
/IMG, qui contient tous les fichiers attachés à votre site
/local, qu'il suffira éventuellement de purger [2]
/tmp, qu'on gagnera à simplement purger lui aussi

Garder ces répertoires tels quels n'a aucune incidence sur la mise à niveau.

Donc, typiquement, à l'heure de la la mise-à-niveau vers SPIP 2.1.2, vous allez sélectionner dans l'archive décompactée du dernier spip récupérée ( un conseil : une fois décompactée, renommez le répertoire spip en la complétant d'une indication de version ; typiquement spip_2_1_2) puis copier et coller dans le répertoire du site :

Les répertoires :

ecrire
extensions
prive
squelettes-dist

Et les fichiers :

CHANGELOG.txt
COPYING.txt
htaccess.txt
INSTALL.txt
index.php
rien.gif
spip.php
svn.revision

Suite à quoi, suivant les passages de version à version, SPIP à votre première connexion dans l'interface privée, pourra vous demander (ou pas) de patienter durant la mise-niveau de votre base de données.

Si tout se passe bien : vous n'obtenez aucune erreur, et votre site fonctionne à votre gré, affichant fièrement en bas des pages de l'espace privé sa version nouvellement mise-à-jour, votre site est alors à niveau !

Passer de SPIP 1.9.x à une version de génération 2.x ?

Un conseil : commencez par mettre votre spip à niveau avec la toute dernière version de spip de génération 1.9.x, puis alors procédez à la mise à niveau vers la génération 2.x

Si tout s'est bien passé, vous pourrez alors éliminer les répertoires suivant qui n'auront plus aucune utilité :

dist
oo

Mise à jour des plugins et squelettes ?

génération 1.9.x à génération 2.x

Si vous passez d'une génération 1.9.x à une génération 2.x, et vous utilisez des plugins, il y a incompatibilité totale de vos plugins avec la génération 2.x

Le conseil dans ce cas là, c'est de commencer, avant la mise à niveau, par supprimer les plugins et vérifier que votre site se comporte normalement après cette suppression.

Après la mise à niveau, utilisez le sytème automatisé d'installation offert par la génération 2.x de SPIP, pour ajouter des plugins.

Si vous avez des squelettes personnalisés, prévoyez de devoir les réviser lors d'une mise à niveau de cet ordre, et consultez en préalable les articles se rapportant aux évolutions des différentes mises-à-jour de spip sur spip.net

Mise à niveau ordinaire des plugins

Si vous utilisez l'installation automatique des plugins, vérifiez d'abord que vos sources de récupération coincident avec la version en cours.

Si vous voulez "actualiser" vos plugins en service, téléchargez-les tout simplement depuis le section "gestion des plugins" comme s'ils n'étaient pas installés. Celà fera correspondre leur version installée avec le plus récente écrite et corrigée par leurs développeurs. [3]

Voir en ligne : Effectuer une mise à jour - l'article de SPIP.NET

[1] En cas de problème ou de difficulté particulière, n'hésitez pas à nous solliciter, bénévoles du PIC, pour vous aider à réaliser ces opérations !

[2] Bien sûr si on purge /tmp on perd ses donnéés de session et doit s'authentifier à nouveau ensuite pour accéder à l'interface privée du CMS

[3] Si vous rencontrez des erreurs lors de manipulations de vos plugins, qu'il s'agisse d'installation, d'activation, désactivation ou désinstallation, essayez de purger votre votre répertoire /tmp avant de vous alarmer ; celà règle souvent le problème.

05. Mettre en ligne des documents supérieurs à 2Mo avec SPIP

Philippe — 2010-07-23T04:49:55Z

Quoique leur poids contrarient les visites des personnes disposant de liaisons Internet à bas débit, il peut se révéler nécessaire d'uploader dans SPIP des fichiers d'une taille supérieure à 2 Mo, par exemple pour mettre en ligne des sons .mp3 ou des vidéos .flv à destination du plugin Lecteur Multimédia.

Spip propose un mécanisme simple pour y parvenir. C'est ce que décrit cet article.

La méthode consiste à transférer en préalable en FTP vos fichiers volumineux dans le répertoire /tmp/upload de votre SPIP.

Lorsqu'un fichier s'y trouve, il est possible de l'attacher directement à un article en déployant la petite flèche gauche de la boite de dialogue d'ajout de documents accessible en bas de page d'édition de l'article.

Le choix de fichier effectué, ce dernier est alors dupliqué dans le sous-répertoire de /IMG correspondant à son format. Il peut alors être exploité comme n'importe quel autre fichier attaché à SPIP.

La copie dans /tmp/upload n'a alors plus d'utilité et on gagnera à l'effacer en ftp afin de limiter les charges inutiles en octet sur le serveur d'hébergement.

03. Utiliser Zpip pour "relooker" rapidement son SPIP

Philippe — 2010-07-22T12:23:58Z

Le couplage des plugin Zpip et Zen Garden vous permet de rapidement doter votre SPIP d'un thème esthétique, au moins provisoirement.

Cette solution rapide peut se révéler adaptée si vous n'aimez pas l'aspect spartiate des squelettes basiques et n'avez pas le temps de fabriquer votre propre habillage et attendez d'en avoir.

Afin que cette solution soit opérationnelle, vous devrez installer les plugins Zpip [1] et Zen Garden ainsi que créer un répertoire themes à la racine de votre SPIP.

C'est dans ce répertoire que vous installerez les répertoires de thèmes une fois ceux-ci décompactés.

Pour en savoir plus sur Zpip c'est ici

Pour en savoir plus sur Zen Garden, le gestionnaire de thèmes, c'est ici

Vous trouverez les différents thèmes disponibles compatibles avec Zpip à l'url http://www.spip-contrib.net/Themes

Voir en ligne : L'installation détaillée de Zpip sur Spip-contrib

[1] Zpip requiert l'installation des plugins Spip-bonux, Menu, et éventuellement Slogan

01. Conseils méthodologiques préalables à la conception de vos squelettes spip

Philippe — 2010-07-18T15:24:07Z

Une documentation imposante existe sur Internet et qui vous permettra d'acquérir progressivement les savoirs-faire pour développer votre site SPIP.

La touffeur de ces documentations est représentative de l'étendue des domaines techniques mis en jeu. C'est pourquoi vous gagnerez à ne pas oublier la possibilité pour vous d'échanger avec d'autres personnes adhérentes au PIC sur vos projets et les difficultés éventuelles que pourrez rencontrer. Le PIC est là pour ça.

C'est pourquoi aussi il est indispensable que le projet de communication que recouvre la construction de votre portail SPIP soit suffisament mature et formulé, que des contenus rédactionnels soient prêts à être publiés et que les finalités de votre site soient bien cernées avant de vous atteler à l'écriture de codes ; faute de quoi le risque est que vous obteniez un résultat qu'il vous faille modifier en profondeur dès sa mise en service, et qu'en terme d'acquisition de savoirs-faire vous consacriez énormément de temps à acquerir énormément de connaissances, sans forcément qu'elles soient utiles à votre projet proprement dit.

Établir un cahier des charges

Avec le plus d'adhérents possibles de votre association, organisez une table-ronde pour laisser s'exprimer le plus de regards et de propositions possibles à propos du projet et de ses étapes antérieures s'il en a. N'hésitez pas avant cette rencontre, à inciter un maximum de participants à lire l'excellent document décrivant la conduite de projet Internet sur SELFHTML

Listez avec exhaustivité tous les points remarqués et concertez-vous pour en définir les plus significatifs. Cette étape est fondammentale pour l'appropriation de votre futur outil par un maximum de bénévoles parmi vos adhérents.

Ne considérez pas les assertions en cours de débat se rapportant à la conduite du projet et l'organisation de votre association comme des hors-sujets ou des points marginaux : a contrario, la mise en oeuvre d'un projet de communication sur Internet est une opportunité pour mieux appréhender ces questions dans la durée, car ce sont les réalités de votre structure qui déterminent l'avenir de votre site Internet et pas le contraire.

C'est seulement après avoir ainsi listé vos souhaits, besoins et critiques, que vous disposerez du matériau utile pour concevoir une ergonomie adaptée aux besoins de votre association. Contrairement à l'idée reçue, un responsable de projet s'il en existe, fait d'autant plus un bon travail qu'il a l'impression de l'effectuer en exécutant plutôt qu'en concepteur.

N'attendez pas d'avoir développé le projet pour mettre un SPIP en ligne et en service

Si votre choix s'est porté vers SPIP, ce dont témoigne votre projet de le personnaliser, alors n'hésitez pas à un en mettre une version en service pour vos adhérents, afin de leur permettre de s'approprier et de prendre en main cet outil, et l'enrichir le plus possible de leurs contenus. Même si ce site SPIP public utilise les squelettes par défaut plutôt austères du CMS, ce n'est pas bien grave et bien plus fécond que pas de site dutout ou des pages en html qu'il faudra ré-écrire plus tard une fois vos squelettes terminés.

Disssociez au départ l'esthétique du fonctionnel, et donnez ce dernier la première des priorités suivant celle des contenus

Comme une mise en forme prématurée nuit à la rédaction sur le fond d'un texte, le mélange entre développement des fonctionnalités et élaboration de l'esthétique du résultat nuira considérablement au développement efficace de vos squelettes.

Aussi interrogez-vous en priorité quant aux contenus qui seront appelés dans vos différentes pages et quant aux méthodes que vous utiliserez pour en faciliter la consultation par vos visiteurs. Car si cette partie est insuffisamment anticipée, vous devrez forcément remettre à plat des schémas de présentation inadaptés à l'affichage des résultats complets de vos squelettes en fonctionnement.

Donnez-vous du temps à vous-mêmes ainsi qu'à votre équipe, pour peser et tester l'évolution de votre projet

Élaborer ses squelettes est un travail de longue haleine qui pour un bénévole, pourra prendre plusieurs semaines voire plusieurs mois.

Le PIC peut vous fournir un espace de tests en ligne pour y publier votre SPIP pendant son développement, indépendamment du fonctionnement de la version en service pour votre association. N'hésitez pas à nous demander une telle mise-en-service sitôt que votre premier jeu de squelette est fonctionnel.

Vous aurez dans ce cas une préacaution à prendre : il vous faudra modifier le fichier inc-head du site de développement pour empêcher son indexation concurrente au site en service par les moteurs de recherche ;

02. Base d'un premier squelette tout nu

Philippe — 2010-07-18T15:23:57Z

Dans cette suite d'articles nous n'irons pas très loin

Ces articles ne se veulent pas exhaustifs : ils visent à vous permettre de comprendre le mécanisme par lequel vous pourrez adapter votre CMS à vos stricts besoins.

En créant un répertoire "squelettes"

En créant une rubrique quelconque et un article encore plus quelconque dans cette rubrique

En jouant avec un unique squelette qui sera propre à cette rubrique

SPIP a déjà des squelettes à l'installation : ses squelettes par défaut qui sont contenus dans le répertoire "squelettes-dist" ; ouvrir les objets qu'ils contiennent et en particulier les fichiers .html vous donnera un aperçu de ce à quoi ressemble un "squelette" de page : un assemblage de code html, de "balises" et de "boucles" SPIP.

Nous allons simplement ici créer un source html valide, et le compléter par quelques éléments correspondant à chaque type, sans nous occuper de questions esthétiques mais uniquement de syntaxe. Pour disposer d'une documentation de base sur la syntaxe propre à SPIP, ne manquez pas les ressources du site même de SPIP, à savoir le manuel du bidouilleur et le glossaire.

Ensuite nous attribuerons quelques styles aux éléments considérés, uniquement en vue de comprendre le mécanisme par lequel la construction graphique s'opère toujours par dessus la construction logique du squelette. Si vous débutez, ne manquez pas de vous rapporter au manuel html/css en pdf construit par Jean-Pierre Sclafer qui l'a publié sur ce site.

Pourquoi utiliser un squelette de rubrique pour commencer et pas la page d'accueil, par exemple ? Il y a plusieurs raisons à ce choix. La première c'est le particularisme de la page sommaire.html qui constitue le squelette de l'accueil par défaut dans SPIP. Ses éléments pour beaucoup sont spécifiques à cette page et ils sont très nombreux. Il est donc plus intéressant de découvrir comment une unique page du site peut être modifiée sans bousculer de prime abord l'entrée même du site.

une page rubrique pose d'entrée la question de la navigation interne dans votre portail

en étudier la conception va vous permettre de déterminer les éléments que vous souhaiterez voir figurer dans l'ensemble du site, et pas seulement à sa page d'accueil

Structure de base

Voici à quoi ressemble la structure basique de tout squelette de page dans SPIP :

Télécharger

Celà veut dire que toute page complète qui se veuille complètement conforme au standard xhtml doive impérativemement comporter TOUS ces éléments :

déclaration de type de document : ici du XHTML 1.0 Transitional

l'ouverture du document html proprement dit, avec la mention de l'espace de nom xml (xmlns=xml name space) utilisé par les objets qui le constituent, la déclaration de langue xml et la déclaration de langue du document, et la déclaration de direction typographique correspondante ; ici ces dernières sont appelées par des balises spip, appelant les valeurs de langue choisies dans la configuration linguistique du CMS. :

Télécharger

l'entête du document qui contiendra tout ce qui servira à l'identifier, le pré-programmer, l'associer à des documents tiers et à l'indexer, bref, toute l'information importante qui ne s'affichera pas dans la page mais qui devra impérativement être là. :

Télécharger

le titre du document, toujours dans l'entête, s'affiche en général dans la barre supérieure du navigateur mais n'est en aucun cas un objet secondaire : les documents dépourvus de titre ne seront jamais indexés !

<title>
C'est ici qu'il faudra titrer tout document
</title>

Télécharger

le corps du document, qui caractérise la partie contenus proprements dits du document :

Télécharger

une division au moins, qui caractérise la partie visible du document : de nombreux objets l'exigent pour que le document soit reconnu pour du xhtml valide.

Télécharger

Vous remarquez que dans le source de synthèse tous ces éléments sont imbriqués les uns dans les autres sans qu'aucun n'en chevauche un autre. Cette règle est l'impératif primaire à respecter lorsque vous concevrez vos squelettes. Si celà vous ennuie, préférez peindre à la gouache sur votre écran plat, ce sera plus souple que le code de spip pour épanouir votre créativité.

Nous venons de voir une première balise SPIP :

#LANG

Les balises de SPIP appellent des valeurs inscrites dans la base données de votre système de publication. Vous avez entré sans le savoir la valeur "fr" dans le champs LANG de la table de configuration de spip, au moment où, lorsqu'au tout début de votre installation la langue "français" vous a été proposée comme choix par défaut déduit du paramétrage de votre navigateur ; c'est en validant ce choix en cliquant sur le bouton "suivant" que SPIP a retenu cette valeur comme choisie !

à la page suivante, nous parlerons plus des balises...

03. Le squelette en slip : avec des balises

Philippe — 2010-07-18T15:23:42Z

Nous restons dans le contexte d'un fichier sans fioriture, que nous allons nommer plus loin pour voir son effet, au moment de le sauver en tant que fichier.

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="#LANG" lang="#LANG" dir="#LANG_DIR">
<head>
<title>
[(#TITRE|textebrut) - ][(#NOM_SITE_SPIP|textebrut)]
</title>
</head>
<body>
<div>
</div>
</body>
</html>

Télécharger

Maintenant que nous avons observés qu'une balise spip était un machin écrit en majuscule avec dièze devant (#MACHIN), qui appelle un autre truc qui est rangé dans la colonne (champs) du tableau (table) bidule de la base de donnée de son spip. Pour voir on va sauver ce fichier sous le nom sommaire.html et voir quel est son effet si on le met dans un squelette vide pour la vieille base de données du PIC. Celà donne ça :

Mais y'a rien ! Mais si mais si, regardez bien, on lit "Mon site SPIP" dans la barre du navigateur. On n'est donc pas dans une page inexistante ou vide. On remarque par contre que bien qu'il y ait deux balises titres dans la sources, on n'en lise qu'une seule. Nous verrons plus loin pouquoi c'est normal ; en réalité la seule information qu'on lise c'est celle que renvoit la balise

[(#NOM_SITE_SPIP|textebrut)]

Cette balise interroge la table de SPIP appelée la table des Métas. Cette table contient des information de configuration générales au site comme son titre, sa description, sa langue, les plugins activés, etc. J'ai modifié le titre pour qu'il soit explicite et écrit un descriptif dans le champs approprié de la configuration.Cette fois on va mettre des balises appelant des propriétés de la base spip_meta dans le corps affichable de la page.

Télécharger

Cette fois j'obtiens ça :

Une première remarque : pour obtenir un affichage correct du retour de la balise #NOM_SITE_SPIP comme de la balise #LANG, j'ai du avoir recours à ce qui s'appelle un filtre. Un filtre, c'est une fonction qui précise la méthode dans laquelle on veut afficher une variable dans spip. La syntaxe des filtres de balises dans spip c'est :

(#NOM_DE_LA_BALISE|nomdufiltre)

Dans SPIP il n'y a pas que les balises de la table spip_meta qui marchent toutes seules, toutes les balises correspondant aux variables globales php fonctionnent aussi. Par exemple la balise

#DATE

Si j'enlève mes trois balises précédentes et ne met qu'elle dans le 'body' de ma page j'obtiens ceci :

C'est la date au sens php et informatique du terme c'est-à-dire écrite à la seconde près, (année-mois-jour, etc). Pour l'afficher de manière plus 'humaine' spip propose de nombreux filtres dont celui-ci :

[(#DATE|affdate)]

qui donnera :

7 avril 2010

Mais rien de tout ça n'explique pourquoi, dans le premier exemple de cette page, la première balise #TITRE ne renvoyait rien.

En réalité elle ne pouvait rien renvoyer parce qu'aucune propriété 'titre' n'existe ni comme variable globale php ni comme champs de la table spip_meta. Cela ne veut pas dire qu'il n'existe pas de propriétés 'titre' dans SPIP, c'est même le contraire, il en existe plusieurs mais dans différentes tables.

Les tables d'où l'on peut extraire des propriétés titres dans SPIP sont :

ARTICLES, RUBRIQUES, BREVES.

Donc pour que SPIP sache quel #TITRE renvoyer, la moindre des choses serait de lui dire dans quelle table aller chercher ce titre.

Voyons comment faire en mettant un chapeau et des chaussettes à notre squelette...

04. Squelette en slip avec chapeau et chaussettes : BOUCLE_principale

Philippe — 2010-07-18T15:23:28Z

On l'appelle principale mais ça pourraît être maurice ou paulette. Celà n'a pas d'importance. Le nom des boucles spip sert à les identifier pour ne pas que spip se mélange les pinceaux. Essayez un jour de mettre le même nom à deux boucles dans un même squelette et vous l'entendrez ronfler !

Les balises html fonctionnent deux par deux, et pour les boucles de spip c'est pareil [1] :

(CREVETTES)>
</BOUCLE_maurice>

Télécharger

Elles s'ouvrent et se ferment. Ici la boucle 'maurice' va chercher des valeurs dans la table des CREVETTES. Bon, il n'y a pas de CREVETTES dans SPIP aussi revenons à notre source de base et mettons lui comme dans le titre de cette page, un chapeau et des chaussettes. Tiens, reprenons notre exemple de départ. On enlève la balise titre du titre pour afficher ses résultats directement dans notre squelette.

(RUBRIQUES)>

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="#LANG" lang="#LANG" dir="#LANG_DIR">
<head>
<title>
[(#NOM_SITE_SPIP|textebrut)]
</title>
</head>
<body>
<div>
[(#TITRE|textebrut)]
</div>
</body>
</html>
</BOUCLE_paulette>

Télécharger

Voici ce que nous retourne l'ajout de notre boucle paulette :

Autrement dit elle a été chercher tous les titres de notre table de RUBRIQUES et nous les a retournés. Et à présent que cette boucle "principale" définit un contexte de recherche, la balise #TITRE sachant où il faut aller chercher des valeurs, nous renvoit quelque chose.

En dépit de sa simplicité, cette particularité est très significative de ce qu'il vous arrivera de rencontrer dans votre travail pour créer des squelettes ; déjà parce qu'elle renforce la nécessité de disposer d'une base contenant des données réelles pour parvenir à développer ; et d'autre part parce que c'est très fréquemment faute d'assigner une information de contexte compréhensible à l'automate de publication qu'est spip, qu'on peut tourner en rond en cherchant pourquoi une boucle ou une balise ne vous retourne rien.

Restreindre le contexte d'une boucle spip

Dans l'exemple précédent, nous avons vu qu'une boucle à laquelle on ne fournit qu'une adresse de table renvoit pour chaque balise toutes les valeurs contenues dans la table.

C'est très rare qu'on souhaite obtenir un tel résultat ; imaginez que sur un site un peu étoffé on aille chercher le #TEXTE dans la table ARTICLES sans restreindre le champs de la recherche : obtiendrait alors une page énorme récapitulant tous les textes de tous les articles !

Dans le squelette par défaut des rubriques de SPIP, la "BOUCLE_principale" comporte un paramètre inscrit entre parenthèses dans sa partie ouvrante :

(RUBRIQUES){id_rubrique}>
</BOUCLE_principale>

Télécharger

Mais si on remplace dans notre exemple de sommaire.html la boucle paulette par cette boucle spécifique - vous pouvez le vérifier - elle ne retournera absolument rien !

Ceci parce qu'elle n'a pas idée (!) de l'id de rubrique à laquelle on fait référence.

Comme les balises supposent de connaître dans quelles tables il faut aller chercher des valeurs, les boucles critériées sans que ne soit précisée la valeur du critère impliquent pour fonctionner que cette valeur de critère leur soit fournie d'une manière ou d'une autre.

(RUBRIQUES){id_rubrique=12}>
</BOUCLE_gaston>

Télécharger

La boucle 'gaston' ci-dessus fonctionnera si la rubrique 12 existe parce que cette valeur d'id_rubrique lui est directement déclarée dans sa syntaxe.

Pourquoi le squelette rubrique.html par défaut fonctionne lui aussi sans valeur spécifique déclarée ? parce que cette valeur est adressée par la requête conduisant à la rubrique ! Expliquons : vous êtes dans le sommaire par défaut ou n'importe où de votre spip où figure un lien vers une rubrique : si vous survolez ce lien, vous constatez qu'il se termine systématiquement par l'expression :

.../spip.php?id_rubrique=N

C'est le lien d'origine et la requête qu'on adresse au serveur web en cliquant dessus qui contient l'id contextuelle utilisée par le squelette appelé.

La compréhension de ce mecanisme de requêtes est essentielle pour créer des squelettes navigables. Boucles et balises n'ont rien de magique et sont des commandes qui pour correspondre à vos besoins devront recevoir d'une manière ou d'une autre l'information qui leur est nécessaire.

[1] Les boucles écrites ainsi ne retournent évidemment rien, étant donné qu'aucune balise interrogeant une valeur dans la table correspondante n'y est disposée.

05. Squelette en chapeau, slip et chaussettes et équipé d'un lance-pierre : les appels dans SPIP

Philippe — 2010-07-18T15:23:04Z

Nous avons vu dans l'article précédent que les boucles extérieures définissant le contexte des pages rubrique.html, article.html, breves.html, etc récupéraient l'id de l'objet précis qu'elles étaient sensées afficher dans l'appel du client (le navigateur du visiteur) vers cet objet.

Le même mécanisme est à l'oeuvre dans les boucles imbriquées permettant dans un squelette déterminé de calculer des résultats.

On comprend bien qu'à partir du moment où l'id_rubrique d'une boucle RUBRIQUES est déterminée, tout objet qui est inclus dans cette boucle va se référer à cette valeur sans qu'on ait besoin de le lui spécifier !

Et bien ce n'est pas le cas ! C'est vrai pour les balises #TITRE et autres renvoyant au propriétés de la rubrique en cours inscrites la table RUBRIQUES elle-même, mais si par exemple on veut afficher quelque part les titres des articles de la rubrique, il faut au minimum indiquer qu'on se rapporte au contexte [1] :

(RUBRIQUES){id_rubrique=12}>

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="#LANG" lang="#LANG" dir="#LANG_DIR">
<head>
<title>
[(#NOM_SITE_SPIP|textebrut)]
</title>
</head>
<body>
<div>
[(#TITRE|textebrut)]
(ARTICLES){id_rubrique}>
[(#TITRE|textebrut)]
</BOUCLE_articles_de_la_rubrique>
</div>
</body>
</html>
</BOUCLE_principale>

Télécharger

...faute de quoi, le comportement exhaustif décrit dans l'article précédent se produirait : le moteur de spip irait tout naturellement extraire les titres d'articles présent dans toute la base de données. Pourquoi ? et bien simplement parce que les titres qu'on veut ici afficher ne sont pas enregistrés dans la table RUBRIQUES mais dans la table ARTICLES, et qu'il faut donc adresser notre requête à cette table ARTICLES en sorte qu'elle spécifie à quelle id_rubrique sont associés les #TITRES qu'on veut extraire.

En résumé puisque la boucle principale ici spécifie une valeur d'id_rubrique spécifique, on n'a pas à la rappeler en elle-même, mais on doit absolument indiquer que c'est à l'id_rubrique du contexte qu'on fait référence en allant chercher des articles.

Incidence sur les inclusions de morceaux de squelettes

INCLURE

SPIP rend possible l'inclusion d'un fichier source séparé dans le calcul d'un squelette. Familère au spipeux, la syntaxe utilisée est de type [2] :

{fond=fichier}>

Le recours à cette facilité ne doit pas être excessif et se limiter à trois ou quatre par squelette sous peine d'augmenter plutôt que n'alléger le temps de calcul des pages par le serveur. Mais surtout là aussi, il faut bien prendre garde à adresser l'information de contexte appropriée si par exemple le fichier inclus contient des boucles en ayant besoin. C'est le cas par exemple d'un menu contextuel sensé figurer visuellement ce contexte (utilisation de la balise #EXPOSE, navigation des des éléments enfants de la rubrique en cours, etc.).

La syntaxe sera la même que pour le calcul d'une boucle interne au fichier ; ainsi si par exemple vous appeliez un menu composite dans un article combinant navigation des rubriques parentes et des articles connexes, ainsi qu'une matérialisation du titre de l'article en cours, il vous faudrait écrire ceci pour le voir fonctionner :

{fond=menu}{id_rubrique}{id_article}>

Plus généralement, il vous faudra apprendre à vous interroger sur la cohérence fonctionnelle de votre code bien avant d'aller "habiller" vos squelettes en associant des feuilles de styles à ses structures xhtml.

La méthodologie recommandée sera dans la mesure du possible d'écrire les corps de vos pages principales (sommaire, rubrique, article, breve, auteur, lien) de manière monobloc au départ, en navigant ensuite dans vos données, pour recourir aux inclusions à la fin du processus de développement primaire.

Pour en savoir plus sur INCLURE, reportez-vous à la documentation de SPIP.NET sur ce sujet

Les modèles

Le modèles constituent une méthode tierce permettant également d'insérer du code externe préparé. En fonction de leur conception eux aussi pourrant dans certains cas nécessiter qu'on leur adresse un contexte voire des paramètres spécifiques.

Leur différence essentielles avec les inclusions réside dans :

leur hébergement dans un répertoire dédié intitulé modeles

leur capacité à s'appeler aussi bien dans les squelettes eux-mêmes en utilisant #NOM_DU_MODELE{parametre_eventuel} que dans le texte d'article en utilisant cette fois la syntaxe [3].

Pour en savoir plus sur l'utilisation des modèles, reportez-vous à la documentation de SPIP.NET sur ce sujet.

[1] Par souci d'exemplarité on a ici remplacé l'appel générique id_rubrique par une instruction assignant une valeur déterminée à l'objet

[2] Remarquez bien qu'on appelle le nom du fichier html correspondant sans extension !

[3] Le N figure une valeur numérique indispensable pour instancier votre modele depuis un article ; si l'inclusion du modèle ne s'opère qu'une unique fois dans votre texte vous écrirez 1 et pour les inclusions suivantes vous numéroterez en évitant, ce qui est le plus important, de répéter une valeur numérique déjà invoquée.