MiniGriSpip

MiniGriSpip 1.2 pour Spip 2 et 3

FredoMkb — 2011-12-14T10:12:05Z

Bonjour à tous,

Je suis heureux de vous annoncer que MiniGriSpip n'est pas mort !

En effet, grâce à l'implication de Suske, cet ancien squelette est désormais compatible avec les dernières versions de Spip 2.x et 3.x.

Pour ce travail d'adaptation, Suske est parti de la version 1.2 de MGS, car c'était la plus simple selon lui à rendre compatible.

Si ce projet vous intéresse, je vous invite chaleureusement à suivre le développement de cette nouvelle versions de MiniGriSpip sur le site dédié géré par Suske.

Une brève présentation est également disponible sur le site de Spip-Contrib.

Je tiens ici à remercier publiquement Suske pour son travail et sa courtoisie, j'espère qu'il pourra redonner une nouvelle jeunesse à ce squelette et que bien d'autres débutants pourront découvrir avec lui toutes les possibilités offertes par ce fabuleux projet qu'est SPIP.

Je tâcherai de l'aider dans la mesure de mes disponibilités afin de l'accompagner un peu dans ce projet.

Merci et à bientôt,

FredoMkb

Forums Fermés...

FredoMkb — 2008-11-26T18:48:19Z

Fermeture des forums pour cause de spams...

Bonjour à tous :-)

Je suis contraint de fermer les forums des articles, qui étaient déjà en modération "a priori", pour cause d'un nombre impressionnant de spams reçus ces derniers temps (environs 40 par jour :-/)...

J'espère que cette mesure, provisoire en principe, saura dissuader les "robots" et leurs "maîtres" à aller exercer leur basse besogne ailleurs (si ça pouvait les convaincre d'arrêter définitivement, ce serait une bonne chose... mais ne rêvons pas trop non plus)...

Désolé auprès de tout ceux qui auraient voulu participer aux forums des articles, mais tout n'est pas perdu, si vous avez envie ou besoin de parler de MGS, les forums techniques sont à votre disposition après une simple petite inscription.

Merci de votre compréhension...

à bientôt :-)

Fredo

Filtre Note Bulle 1.0

FredoMkb — 2008-04-28T09:28:26Z

Petit filtre pour afficher les notes de bas de page, insérées dans un article ou dans une brève, dans des info-bulles personnalisables...

Sommaire

Avant Propos

Il arrive parfois, surtout pour des longs articles, que la consultation des notes de bas de page, par des aller/retour répétés dans le texte, perturbe la fluidité de la lecture.

De plus, il arrive souvent que les info-bulles, affichées automatiquement grâce à l'attribut "title" des liens des notes se trouvant dans le texte, se révèlent être bien trop limitées pour afficher l'ensemble du texte de la note.

Pour ces raisons, et suite à une demande dans les forums techniques du squelette MiniGriSpip, j'ai imaginé un petit filtre qui permet d'afficher une info-bulle personnalisable, par des styles Css, directement sous le lien de la note de bas de page située dans le texte de l'article.

Le fonctionnement "normal" du lien est préservé, mais l'apparition de l'info-bulle originale (attribut "title") est inhibée, avec un petit bout de code JavaScript, afin qu'elle ne perturbe pas l'affichage de l'info-bulle personnalisée.

Installation

Ce filtre est constitué d'une fonction Php qui analyse le texte de l'article (ou brève) pour ajouter quelques balises Html autour des notes de bas de page existantes.

Le code Php du filtre est le suivant :

/**********************************************************************************************************/ /* Filtre "note_bulle" 1.0 */ /* ---------------------------------------------------------------------------------------------------- */ /* Infos : GPL - 04/08 (c) FredoMkb */ /* Utilisation : #TEXTE*|note_bulle|propre */ /* Usage : Insere des balises "span" qui s'affichent comme info-bulles lors de leur survol */ /* Voir styles Css "notebulle" associes */ /* ---------------------------------------------------------------------------------------------------- */ function note_bulle($texteOrig) { // Fonction pour creer des info-bulles dans le texte des articles et breves. // La fonction verifie l'existence des balises ouvrantes "[[|" et fermantes "|]]" // si c'est le cas, elle les remplace par une balise survolable affichant une info-bulle // avec tout le contenu des balises, meme s'il est formate en Html. // Test de l'existence des info-bulles. preg_match("#\\[\\[\\|(.*?)\\|\\]\\]#iU", $texteOrig, $testInfoBulle); // Si un des info-bulles existent, alors on genere les balises survolables. if ($testInfoBulle[1] != false) { // On exclu les textes des codes et cadres $texteOrigClean = preg_replace('#< cadre >(.*?)< /cadre >#s','',$texteOrig); $texteOrigClean = preg_replace('#< code >(.*?)< /code >#s','',$texteOrigClean); // Recuperation des toutes les info-bulles presentes dans le texte nettoye. preg_match_all('#\\[\\[\\|(.*?)\\|\\]\\]#iU', $texteOrigClean, $listeOrig); // On place le resultat dans une variable et on initialise les autres variables. $listeInfoBullesOrig = $listeOrig[1]; $lienDebut = '<span class="notebulle" onmouseover="this.childNodes[1].setAttribute(\'title\', \'\');">[['; $lienCentre = ']]<span>'; $lienFin = '</span></span>'; // Boucle sur chaque element de la liste des info-bulles recuperees. foreach ($listeInfoBullesOrig as $textInfoBulleOrig) { $textInfoBulleNew = $lienDebut.$textInfoBulleOrig.$lienCentre.$textInfoBulleOrig.$lienFin; $texteOrig = str_replace("[[|".$textInfoBulleOrig."|]]", $textInfoBulleNew, $texteOrig); }; }; // Retour du texte modifie. return $texteOrig; } /**********************************************************************************************************/

Pour installer ce filtre, il suffit d'éditer le fichier "mes_fonctions.php" de votre squelette puis d'ajouter, au début, juste après la balise d'ouverture "

Attention !

Les balises "cadre" et "code" ont été légèrement modifiés dans le code publié ici, en ajoutant une espace après le "<" et avant le ">", histoire que l'affichage dans cette page ne soit pas perturbé. Si vous utilisez ce code par un simple copier/coller, veillez à enlever les espaces en trop dans ces deux balises. Pour éviter tout bogue lors du copier/coller, le plus judicieux serait d'utiliser le code fourni dans le fichier "note_bulle.php" disponible dans l'archive ".zip" téléchargeable à la fin du présent article.

Formatage

Pour que les info-bulles puissent s'afficher correctement, il faut ajouter à la fin de la feuille de styles principale de votre squelette, deux styles supplémentaires que voici :

Ces styles de base correspondent à une utilisation avec le squelette MiniGriSpip, mais vous pouvez les personnaliser à souhait selon besoins.

L'idéal serait que la largeur de l'info-bulle corresponde à la largeur de la colonne de texte de vos articles et/ou brèves, histoire de pouvoir accéder, avec le curseur de la souris, au contenu de l'info-bulle et ainsi pouvoir cliquer sur les éventuels liens présents.

Intégration

Pour pouvoir utiliser ce filtre, il faut l'intégrer dans les fichiers Html correspondant aux articles et/ou brèves de votre squelette, dans la balise "#TEXTE" des boucles "ARTICLES" et "BREVES" respectivement.

Voici deux exemples d'intégration, ici en nous basant toujours sur le squelette MiniGriSpip, mais la méthode reste identique pour tout autre squelette.

Il suffit donc de remplacer la balise "#TEXTE" originale, dans la boucle "ARTICLES" du fichier "article.html", par une de ces propositions (suivant votre version de Mgs), ou à adapter au code de votre squelette :

MiniGriSpip version 1.4.x :

MiniGriSpip version 1.6.0 :

Mêmes changements pour la balise "#TEXTE" dans la boucle "BREVES" du fichier correspondant.

Important

Il faut que la balise "#TEXTE" soit suivie d'un astérisque avant le premier filtre et que le filtre "note_bulle" soit suivie du filtre "propre" afin d'assurer le formatage typographique normal de Spip.

Utilisation

L'utilisation de ce filtre est très simple, il suffit d'utiliser deux raccourcis légèrement différents des originaux de Spip, qui sont les doubles crochets "[" d'ouverture et deux autres crochets "]" de fermeture, pour entourer les contenus des notes de bas de page.

Ce filtre s'utilise donc avec exactement les mêmes raccourcis mais en y ajoutant une barre verticale "|" après les doubles crochets d'ouverture "[" et une autre barre verticale "|" juste avant les deux crochets de fermeture "]" de la note de bas de page.

Ce qui donne :

Texte [[|Ceci est une note de bas de page qui sera affichée sous forme d'info-bulle.|]]

La barre verticale "|" est un caractère obtenu par la combinaison des touches "alt + shift + L" (sur Mac et pour un claver Azerty, pour d'autres plate-formes ou claviers il faudra chercher la correspondance).

Donc, pour l'exemple, le texte suivant :

Donnera le résultat suivant :

__2__

Non equidem insector delendave carmina Livi esse reor, memini quae plagosum mihi parvo Orbilium dictare ; sed emendata videri pulchraque et exactis minimum distantia miror. [1]

__2__

Soit :

Important

Bien entendu, le raccourcis originaux des notes de bas de pages de Spip restent toujours utilisables, les deux syntaxes peuvent ainsi cohabiter sans aucun souci dans le même texte.

Téléchargement

Voici une archive ".zip" avec le code Php du filtre, une feille de style avec les formatages des info-bulles et un exemple d'intégration dans un fichier "article.html" (issu du squelette MiniGriSpip 1.6.0).

FiltreSpip-NoteBulle

Remerciements

À Vincent, sur les forums techniques de Mgs, à tous les utilisateurs du squelette MiniGriSpip et, bien-sûr, à toute la communauté de Spipeurs.

[1] |Non equidem insector delendave carmina reor, memini quae plagosum mihi parvo Orbilium dictare. Inter quae verbum emicuit si forte. Un lien.|

Balise #TMP

FredoMkb — 2008-02-09T02:56:57Z

Cette contrib est avant tout un exemple de création d'une balise qui, je l'espère, pourra quand-même rendre service aux Spipeurs...

Bien-sûr, ce n'est qu'un exemple, il est donc fort probable que des améliorations soient souhaitables, voire nécessaires, pour optimiser son fonctionnement, n'hésitez donc pas à faire part de vos remarques et/ou suggestions dans le forum attaché à l'article...

Sommaire

Avant-Propos

Alors, voici le contexte :

Imaginons qu'on souhaite mémoriser quelques informations ou données pour être utilisées par la suite...

Imaginons aussi qu'on souhaite pouvoir disposer des données mémorisées partout dans les squelettes...

Enfin, imaginons qu'on souhaite disposer d'un système suffisamment souple permettant d'ajouter, modifier et supprimer des données...

Bien-sûr, certains diront qu'un tel mécanisme existe déjà, fourni par défaut dans Spip, sous la forme des balises #SET et #GET (voir documentation), mais ces balises sont un peu limités, c'est à dire qu'elles ne fonctionnent pas dans toutes les situations...

En effet, si on mémorise une variable à l'intérieur d'un squelette, les squelettes inclus (les "noisettes" donc) n'auront pas acces aux données des ces variables, ce qui peut s'avérer un peu embêtant dans certaines circonstances...

Il était donc peut-être intéressant de pouvoir disposer d'un système capable de fonctionner dans ce type de situations, c'est donc le rôle de cette balise #TMP (pour "tampon" ou "temporaire").

Attention !

Au même titre que les balises #SET et #GET, cette balise #TMP n'aura aucun effet dans une boucle si la valeur à récupérer a été mémorisée dans la partie optionnelle de la même boucle. Ce comportement est dû au mode de fonctionnement des boucles Spip.

En effet, les parties optionnelles des boucles sont analysées et traitées après la partie principale de la boucle, et seulement si cette dernière retourne au moins une valeur, autrement dit, si la boucle principale ne retourne aucune valeur, les perties optionnelles ne seront pas considérées.

Utilisation

Passons à l'utilisation de la bête avant d'ouvrir le capot et d'examiner le moteur.

Voici toutes les utilisations possibles et leur syntaxe :

Mémoriser une Valeur

Deux méthodes pour mémoriser une valeur, soit en passant par la balise #TMP, soit en passant par le filtre |tmp.

La balise #TMP sert surtout à mémoriser des données libres, c'est à dire toute information non fournie par Spip, alors que le filtre |tmp est plutôt dédié à la mémorisation des données générées par Spip (les balises), ce que la balise #TMP ne permet pas. [1]

__3__

Avec la balise #TMP :

Si par exemple on souhaite mémoriser la valeur "Coucou les amis..." sous la clé "coucou", voici comment faire :

[(#TMP{coucou,'Coucou les amis...'})]

Dans cette méthode, la première valeur fournie est donc la clé d'identification sous laquelle les données seront mémorisées, puis la deuxième valeur est la donnée elle même (la syntaxe de cette balise est donc exactement la même que celle de la balise #SET de Spip).

__3__

Avec le filtre |tmp :

Le filtre ne permet pas, par défaut, de mémoriser des données libres, ceci est plutôt le rôle de la balise, mais le filtre |tmp est nécessaire pour mémoriser des données générées par Spip (les balises donc).

Si on souhaite par exemple afficher la date du jour à l'intérieur d'une boucle (ARTICLES) (c'est juste un exemple hein ;-)), on ne pourrait pas utiliser la balise #DATE de Spip, puisque cette balise retourne une valeur différente suivant le contexte, dans notre cas c'est la date de publication de l'article qui serait affichée et non pas la date du jour...

Pour y arriver, le filtre |tmp peut nous être utile, en mémorisant la date du jour, sous la clé "today" par exemple, avant le code de la boucle (ARTICLES), avec la syntaxe suivante :

[(#DATE|tmp{today})]

Dans cette méthode, la première valeur fournie au filtre, la balise #DATE donc, est la donnée à mémoriser, et l'argument fourni au filtre entre les accolades, {today}, est la clé sous laquelle la date du jour sera conservée.

__2__

Récupérer une Valeur

Pour retrouver une valeur mémorisée, rien de plus simple, la balise #TMP s'utilise de la même manière que son homologue #GET de Spip, avec la syntaxe :

[(#TMP{coucou})]

Cet exemple retournera notre "Coucou les amis...". Autrement dit, il suffit de fournir, comme argument a la balise, la clé sous laquelle l'information a été enregistrée, quelque soit la méthode de mémorisation utilisée, par balise ou par filtre.

Notre second exemple retournera la date du jour au moment de la mémorisation de la valeur :

[(#TMP{today})]

__2__

Valeur par Défaut

Il peut être pratique de disposer d'une valeur par défaut à utiliser si la variable demandée n'est pas ou n'est plus disponible, ceci est possible de la manière suivante :

[(#TMP{coucou,'',defaut})]

La syntaxe à respecter nécessite donc de fournir 3 arguments à la balise, dont le premier correspond a la clé des données qu'on cherche à récupérer, le deuxième argument doit être vide, ce qu'on obtient en mettant deux guillemets, ou deux apostrophes, sans aucun contenu entre les deux, enfin, le troisième argument est la valeur par défaut à afficher si la clé du premier argument n'est pas trouvée.

Attention !

La valeur par défaut est une donnée libre, c'est à dire qu'il ne s'agit pas d'une clé servant à extraire d'autres données en mémoire, mais d'une valeur "brute" à afficher tel-quelle si la clé du premier argument est introuvable.

__2__

Modifier une Valeur

Il est aussi possible de modifier la valeur d'une variable déjà en mémoire, il suffit de mémoriser la nouvelle valeur avec exactement la même clé que la valeur originale, ceci fonctionne avec les deux méthodes : balise et filtre.

Suivant notre premier exemple, si au lieu d'avoir "Coucou les amis..." nous souhaitions afficher "Bonjour monde..." à la place, on ferait :

[(#TMP{coucou,'Bonjour monde..'})]

Dès lors, la clé "coucou" retournera cette nouvelle valeur.

__2__

Supprimer une Valeur

Pour ne pas saturer inutilement l'espace mémoire utilisé (voir chapitre "Mécanique") avec des données qui ne sont plus nécessaires, il est possible de supprimer les valeurs obsolètes.

La méthode est très simple, il suffit de fournir deux arguments à la balise #TMP, dont le premier doit être vide et le deuxième correspondre à une clé existante en mémoire.

Par exemple, si on souhaite supprimer notre variable "coucou", il suffit d'utiliser la syntaxe suivante :

[(#TMP{'',coucou})]

Ici on fourni à la balise un premier argument vide, qu'on obtient en mettant deux guillemets, ou deux apostrophes, sans aucun contenu entre les deux, puis on fourni le nom de la clé correspondant aux données à supprimer.

Attention !

Ceci a pour effet de supprimer purement et simplement le couple "clé/valeur" concerné, les données seront donc perdues définitivement.

__2__

Supprimer Toutes les Valeurs

On peut aussi supprimer toutes les données mémorisées en une seule opération, et éviter ainsi de devoir faire autant de suppressions individuelles, épargnant du coup un peu de travail au serveur.

Pour supprimer donc toutes les entrées mémorisées, il suffit d'insérer la balise #TMP toute seule, sans aucun argument, soit :

[(#TMP)]

Attention !

Ceci a pour effet de supprimer purement et simplement toutes les entrées en mémoire gérées par la balise, les données seront donc perdues définitivement.

__1__

Résumons

Mémoriser une valeur : [(#TMP{cle,valeur})] ou [(#VALEUR|tmp{cle})]

Récupérer une valeur mémorisée : [(#TMP{cle})]

Valeur par défaut (au cas où) : [(#TMP{cle,'',defaut})]

Supprimer une valeur : [(#TMP{'',cle})]

Supprimer toutes les valeurs : [(#TMP)]

Mécanique

Le mécanisme mis en oeuvre est relativement simple, voire simpliste aux yeux de certains, mais il a le mérite d'assurer un bon fonctionnement.

Il s'agit donc d'utiliser la variable globale $GLOBALS pour y stocker des données et informations qui seront ensuite récupérées pour être exploités aux endroits souhaités dans les différents squelettes...

D'accord, de l'avis de certains, c'est "mal" d'utiliser cette variable globale un peu pour tout et parfois pour n'importe quoi, mais avouons qu'elle a le grand avantage d'être disponible et facilement accessible sans avoir à sortir la grosse artillerie des sauvegardes en base de données ou dans des fichiers... ce qui aurait été un peu lourd pour des besoins relativement modestes, tels qu'abordés dans cette contrib.

Donc, en gros, pour ceux qui lisent un peu du Php, il s'agit de créer des nouvelles entrées dans la variable $GLOBALS, sous la clé générique ['tmp'], avec la syntaxe suivante :

$GLOBALS['tmp'][$cle] = $valeur;

Pour ensuite être utilisable par :

return $GLOBALS['tmp'][$cle];

Moteur

Voyons donc ce qui se cache sous le capot...

La balise est construite avec trois fonctions Php :

La première fonction implémente la balise #TMP elle même, c'est le code appelé par Spip.

La deuxième fonction est juste un pont entre le code de la balise #TMP et celui du filtre |tmp.

Enfin, la troisième fonction correspond au filtre |tmp, et c'est elle qui gère les accès aux données.

Voici le code complet, avec quelques commentaires :

<?php /**************************************************************************************/ /* Balise "#TMP" 1.0 */ /* ---------------------------------------------------------------------------------------------------- */ /* Infos : GPL - 02/08 (c) FredoMkb */ /* Utilisation : #TMP{cle,valeur,defaut} (voir details dans le code) */ /* Role : Memorise des valeurs pour pouvoir les utiliser ensuite */ /* ---------------------------------------------------------------------------------------------------- */ function balise_TMP($p) { // Fonction de la balise "#TMP", c'est le code appele par Spip. // Initialisation des variables qui vont recevoir les arguments $cle = ""; $val = ""; $dft = ""; // Recuperation des paramettres fournis, 3 arguments reconnus // On test d'abord l'existence de chaque parametre, s'il existe, // alors on affecte l'argument a la variable correspondante. if (isset($p->param[0][1])) { $cle .= ($p->param[0][1][0]->texte); } if (isset($p->param[0][2])) { $val .= ($p->param[0][2][0]->texte); } if (isset($p->param[0][3])) { $dft .= ($p->param[0][3][0]->texte); } // Comme on ne peut pas passer des "array", il faut generer du "string" exploitable $listargs = var_export(array($cle,$val,$dft), true); // Affectation du nom de la fonction a utiliser dans la balise, avec les arguments $p->code = "get_tmp($listargs)"; // Le statut 'php' est sur, le statut 'html' passe le retour par le filtre 'interdire_scripts'. // On peut aussi faire : '$p->interdire_scripts = false;' ou 'true' $p->statut = 'html'; // Retour du resultat return $p; } function get_tmp($listargs) { // Fonction pour faire le "pont" entre la balise "#TMP" et le filtre "|tmp". $cle = $listargs[0]; $val = $listargs[1]; $dft = $listargs[2]; // On change un peu l'ordre des arguments afin que le filtre // puisse trouver la variable $val en premiere place return tmp($val, $cle, $dft); } function tmp($val='', $cle='', $dft='') { // Fonction du filtre "|tmp", gere les donnees, pour memoriser ou retourner une valeur. if (empty($cle) && empty($val) && empty($dft)) { // Si les trois arguments sont vides, alors on supprime la GLOBALE "tmp" // Utilisation : [(#TMP)] unset($GLOBALS['tmp']); } elseif (empty($cle) && !empty($val)) { // Si la cle est vide mais pas la valeur, alors un utilise cette derniere comme cle // pour supprimer l'entree ayant comme cle la valeur fournie // Utilisation : [(#TMP{'',cle})] unset($GLOBALS['tmp'][$val]); } elseif (!empty($cle) && !empty($val)) { // Si la cle et la valeur sont fournies, alors on memorise ces infos // Utilisation : [(#TMP{cle,valeur})] ou [(#VALEUR|tmp{cle})] $GLOBALS['tmp'][$cle] = $val; } elseif (!empty($cle) && isset($GLOBALS['tmp'][$cle])) { // Si la cle seule est fournie, alors on tente de retourner les donnees correspondantes // Utilisation : [(#TMP{cle})] return $GLOBALS['tmp'][$cle]; } else { // Si rien de ce qui precede ne fonctionne, alors on retourne la valeur par defaut fournie // Utilisation : [(#TMP{cle,'',defaut})] return $dft; } } /**************************************************************************************/ ?>

Installation

Pour éviter d'éventuels problèmes d'encodage du texte, vous pouvez récupérer le code complet en téléchargeant l'archive suivante :

Balise #TMP

Pour installer la balise, utilisez une des deux méthodes suivantes :

__2__

Par Copier/Coller

Éditez simultanément le fichier téléchargé "spip_balise_tmp.php" et le fichier "mes_fonctions.php" qui se trouve dans le dossier "squelettes" de votre site.

Faites un simple copier/coller de l'ensemble du code de la balise, fichier "spip_balise_tmp.php" donc, dans le fichier "mes_fonctions.php", au début ou à la fin du fichier.

Assurez-vous juste de ne pas copier les balises Php <?php et ?> qui se trouvent respectivement en début et fin du code.

__2__

Par Inclusion

Cette méthode est plus simple et donc plus recommandée.

Il s'agit de placer le fichier téléchargé "spip_balise_tmp.php" au même niveau que le fichier "mes_fonctions.php", dans le même répertoire donc.

Il faut ensuite éditer le fichier "mes_fonctions.php" pour y placer, au début (juste après la balise d'ouverture Php), le bout de code suivant :

include('spip_balise_tmp.php');

Dans les deux cas, enregistrez les modifications du fichier "mes_fonctions.php" puis videz le cache de Spip (espace privé => Configuration => Vider le cache).

Limitations

La balise #TMP, en l'état, n'est pas capable de traiter dans ses arguments des valeurs dynamiques, d'autres balises par exemple, il s'agit donc pour l'instant d'une simple balise "statique".

Le filtre |tmp tente de pallier, en partie, à cette restriction de la balise, mais son champ d'action reste assez limité tout de même, puisqu'il n'est pas possible, par exemple, d'insérer du code Html de manière simple et directe (voir chapitre "Astuces").

Enfin, l'utilisation de la variable globale $GLOBALS, pour mémoriser les variables, n'autorise pas la manipulation de grands volumes de données, ni de données aux contenus complexes, il faut donc se limiter à une utilisation modeste, voire basique, de cette solution.

Astuces

Mini Config

Une idée d'utilisation de cette balise #TMP serait, par exemple, de préparer une "noisette" contenant un ensemble de valeurs à mémoriser, pour qu'elles soient disponibles dans toutes les pages du squelette, un peu comme s'il s'agissait d'un mini système de configuration...

Par exemple, on crée un fichier Html nommé "inc-mini-config.html", dans lequel on insère autant de balises #TMP que des infos à mémoriser, sans aucun autre code Html.

Il suffit d'insérer cette noisette, par un simple #INCLURE (voir encadré ci-dessous), dans le fichier d'en tête du site "inc-head.html", pour avoir toutes ces données accessibles sur l'ensemble des fichiers du squelette.

Bien-sûr, il ne faut pas trop abuser de cette technique, il vaut mieux se tourner vers d'autres solutions de configuration, comme le plugin CFG par exemple, pour disposer d'un système de configuration plus souple et puissant.

Attention !

Spip possède deux mécanismes différents pour inclure des fichiers externes dans un fichier hôte, soit par la balise #INCLURE (depuis Spip 1.9.1) soit par la méthode historique <INCLURE> (voir documentation).

Or, ces deux techniques ne travaillent pas exactement de la même manière, notamment en ce qui concerne la gestion du cache, ce qui restreint l'utilisation de notre balise #TMP à travailler uniquement avec les inclusions de type #INCLURE pour pouvoir bénéficier d'une disponibilité efficace des valeurs mémorisées dans la variable $GLOBALS.

Pour tenter de résumer en deux mots, les fichiers hôte qui travaillent avec la balise #INCLURE génèrent un seul fichier de cache avec les données locales et celles issues du fichier externe, alors que la méthode par <INCLURE> génère autant de fichiers de cache que des fichiers traités, autrement dit, ils ne partage pas forcément le même espace mémoire et donc pas les mêmes données.

Ces remarques ne font que reprendre (d'après ce que j'ai compris) des explications for instructives partagées par Matthieu Marcillaud quant au fonctionnement des inclusions et à l'efficacité relative de cette contrib avec elles, merci à lui pour tout ces éclaircissements.

__2__

Balises et Html

Comme expliqué dans le chapitre "Limitations", la balise n'est pas adaptée à traiter des données dynamiques, et le filtre est incapable en l'état de mélanger des balises Spip a du code Html... voici donc une astuce pour contourner cette restriction.

Il s'agit d'utiliser la balise #REM pour lui forcer à afficher quelque chose (technique expliquée dans l'article "Appliquer un filtre sur autre chose qu'une balise"), puis d'appliquer le filtre sur ce résultat.

Imaginons que nous désirons insérer, un peu partout sur nos squelettes, un lien complet avec l'adresse du site, il peut être sympa de ne pas avoir à mettre toujours le même code Html, voici donc comment mémoriser un tel code afin de l'utiliser autant de fois qu'on le souhaite :

[(#REM|sinon{<a href="#URL_SITE_SPIP" title="[(#DESCRIPTIF_SITE_SPIP|couper{50})]">
 <:bienvenue_sur:>#NOM_SITE_SPIP</a>}|tmp{url})]

Petite explication, on force une balise #REM à afficher quelque chose grâce au filtre |sinon (voir documentation), puis on applique notre filtre |tmp en lui fournissant la cle d'identification du contenu à mémoriser.

Comme le montre l'exemple, on peut mettre des balises, des filtres et même des textes localisés entre les accolades du filtre |sinon, mais il ne faut pas trop compliquer le contenu à mémoriser, il n'est pas garanti que Spip puisse gérer de telles acrobaties de calcul avec des codes trop complexes.

Enfin, pour placer ce code dans les squelettes, rien de plus simple :

[(#TMP{url})]

Un petit avantage de cette méthode est que le code Html est calculé une seule fois, puis le résultat est conservé en mémoire en l'état, ce qui permet de l'utiliser autant de fois que souhaité sans avoir à les recalculer.

Avertissements

Comme signalé à plusieurs reprises dans l'article, ne tentez pas d'utiliser cette technique pour des traitements lourds, elle n'est pas adaptée, préférez vous tourner vers de plugins capables d'une meilleur interaction avec Spip.

Enfin, veillez à nommer de manière la plus simple possible vos clés d'identification pour les données à mémoriser, évitez par exemple d'utiliser des caractères accentués ou spéciaux et, dans la mesure du possible, préférez les tirets bas "_" aux espaces pour séparer les différents mots de la clé.

Remerciements

Comme d'hab, à toute la communauté de Spipiens pour toutes leurs contributions, les unes plus enrichissantes que les autres, et aussi, surtout, à tout ceux qui se démènent (jour et nuit) pour développer ce magnifique CMS qu'est SPIP.

Un grand merci à Matthieu Marcillaud pour toutes ces explications à propos des techniques d'inclusion.

[1] Ceci est dû au fait que #TMP n'est pas une balise dynamique (ce que je n'aurais pas su réaliser vu mon niveau en développement).

Et Mgs alors ?

FredoMkb — 2008-02-09T02:56:47Z

Le développement de Mgs n'est pas abandonné, malgré un silence prolongé sur ce site...

Bonjour à tous :-)

Ce petit message pour vous annoncer que le projet Mgs est toujours en cours de développement, et la prochaine versions devrait apporter, en plus de quelques améliorations esthétiques, un certain nombre de nouvelles fonctionnalités.

Il est encore trop tôt pour vous en dire d'avantage, il reste encore beaucoup de boulot à faire, et comme je ne peux pas consacrer beaucoup de temps au quotidien, le projet n'avance qu'à petits pas... mais il avance tout de même ;-)

Enfin, si tout va bien, en mars ou avril il devrait commencer à pointer le bout de son nez :-)

En tout cas, je tiens à remercier l'ensemble des utilisateurs qui ont partagé leurs remarques et suggestions sur les forums du site.

J'espère pouvoir vous annoncer une bonne nouvelle lors de mon prochain édito, en attendant, n'hésitez pas à vous exprimer dans les forums, votre soutient est le seul moteur qui m'encourage à continuer à faire évoluer ce projet...

Merci à tous et à très bientôt... :-)

Fredo

Des nouvelles du front...

FredoMkb — 2007-06-19T12:03:51Z

Quelques nouvelles après cette petite période d'absence...

Bonjour à tous :-)

Voilà, pour ceux qui ont un peu suivi mes récentes péripéties, j'ai le plaisir de vous annoncer que le gros de mon déménagement est enfin fait.

Maintenant, il ne me reste plus (façon de dire) qu'à investir et emménager mon nouveau lieu de vie, ce qui se fera progressivement dans les jours qui viennent, après quelques travaux de rafraîchissement nécessaires.

Dans le même temps, je dois suivre des stages auprès des organismes partenaires de l'ANPE pour mon futur avenir professionnel.

Il y a bien-sûr d'autres contraintes et obligations, de type administratif en général, que je dois régler, et des engagements d'ordre personnel dont je dois m'acquitter.

En fait, si tout va bien, je serais installé pour de bon au mois de juillet.

Tout ceci fait que le projet MiniGriSpip sera en pause encore un temps, même si, peu à peu, à mes temps libres (le soir en général), je tente quand-même d'avancer sur un ordinateur portable qu'on m'a prêté il y a quelques jours et à partir duquel je rédige ces quelques mots.

L'idéal, pour moi, serait de publier la nouvelle version du squelette courant le mois de septembre prochain, car je serais bien trop occupé par mes obligations professionnelles par la suite.

Enfin, après cette mise à jour majeure, suivant les conseils de Job et d'autres membres des forums, je vais proposer le projet MiniGriSpip sur la Spip-Zone, afin que d'autres développeurs puissent le faire évoluer petit à petit suivant les besoins des utilisateurs et les nouvelles versions de Spip.

Voilà, grosso-modo, quelques nouvelles du front, je tenterais d'être un peu plus présent sur les forums, mais ce ne sera pas forcément quotidien tant que je ne serai pas complétement installé.

Merci à tous pour votre compréhension et à Job pour son aide précieuse sur les forums...

À bientôt :-)

Fredo

Mgs 1.6, les pictos...

FredoMkb — 2007-05-29T07:39:59Z

Suite à plusieurs demandes de webmaîtres, voici l'ensemble des pictos utilisés dans les titres des blocs de Mgs 1.6...

Sommaire

Avant-propos

J'ai reçus, à plusieurs reprises, des demandes, de différents webmaîtres, pour obtenir les fichiers originaux des pictos affichés sur les titres des blocs de MiniGriSpip 1.6.

Leur but étant, bien-sûr, de pouvoir adapter certains pictos à leur site, ou concevoir de nouveaux pictos en respectant l'esprit des originaux.

Voici donc l'ensemble de ces pictos, au format "PSD" [1], avec tous le calques afin de faciliter le travail d'adaptation et de création.

Personnalisation

Seule recommandation, respecter le système de nommage des fichiers, qui est ensuite utilisé dans les feuilles de style du squelette pour afficher les pictos.

Les fichiers doivent se nomme de la manière suivante : "PictoNomNUM.ext", ce qui donne en détail :

Toujours commencer par "Picto" ;
Ensuite "Nom" correspond à 3 lettres pour identifier le picto, du genre "Art" pour "Article" ;
Puis "NUM" correspond à 3 chiffres indiquant la dimension du picto, par exemple, "064" indique une dimension de 64 pixels de côté, sachant que la taille par défaut utilisée dans le squelette est de 24 pixels ;
Enfin, "ext" correspond à l'extension du type de fichier image utilisé, comme "png" ou "jpg".

Le format de fichier par défaut utilisé sur le squelette est le "png", car les pictos ont un petit effet d'ombre semi-transaprent, et le format "png" est particulièrement adapté à l'affichage de ce type d'effets, mais attention, certains navigateurs ont la réputation de mal gèrer ce format, si vous rencontrez ce type de difficultés, préférez alors des formats de fichier tels que "jpg" ou "gif".

Dans la feuille de style, vous trouverez les styles des pictos, par exemple, pour le picto des bloc des articles :

.mgs_picto_art { background-image: url(images/PictoArt024.png); }

Si vous créez des nouveaux pictos, vous devrez donc ajouter des nouvelles lignes de style correspondant à vos pictos en respectant le format de nommage déjà existant, c'est à dire "mgs_picto_nom", ou "nom" correspond aux 3 lettres d'identification du fichier picto correspondant.

Prévisualisation

Voici la liste des pictos disponibles :

Articles	Auteurs	Brèves
Calendrier	Documents	Dossier
Éditos	Commentaires	Images
Infos	Mots-clés	Navigation
Plan	Recherche	Rubriques
Sites	Syndication	Une

Téléchargement

Tous ces pictos sont libres d'utilisation, sachant que certains utilisent des images issues des icônes présents dans le système MacOsX, et d'autres ont été dénichées sur internet.

Cliquez sur l'icône pour télécharger l'archive "zip"

Tous les Pictos Mgs 1.6

__0__

Pour toute remarque technique, merci de le faire sur les forums de MiniGriSpip.

[1] PSD = PhotoShop Document

Mgs 1.4.2, Modules...

FredoMkb — 2007-05-14T15:32:06Z

Quelques modules issus de MiniGriSpip 1.6 adaptés pour les installer dans une ancienne version 1.4.x du squelette...

Sommaire

Avant-propos

Le squelette MiniGriSpip a bénéficié de quelques évolutions majeures lors de la récente sortie de sa version 1.6.

Note : pour connaître l'ensemble de nouveautés apportées par cette version 1.6 du squelette, rendez-vous sur l'article de présentation publié lors de sa sortie.

Cependant, il y a des utilisateurs des anciennes versions 1.4.x, qui souhaiteraient pouvoir profiter de certaines des nouvelles fonctionnalités sans pour autant changer de version du squelette...

Les raisons peuvent être multiples, mais la plus évidente est qu'ils ont certainement beaucoup travaillé pour personnaliser le squelette afin de l'adapter à leur besoins et envies, et qu'il serait très fastidieux pour eux de recommencer tout ce travail sur la nouvelle version de Mgs...

Alors, suite à quelques demandes dans les forums dédiés à MiniGriSpip, voici donc certains modules modifiés et adaptés aux anciennes versions 1.4.x du squelette.

Il n'est pas obligatoire d'installer tous les modules, vous pouvez les intégrer individuellement suivant vos désirs.

Dans les chapitres suivants je m'attacherai à décrire, le plus clairement possible [1] l'installation et l'intégration de chacun des modules.

Important : avant de commencer, et par simple mesure de prudence, je vous conseil de faire une sauvegarde de l'ensemble des fichiers originaux du squelette, afin de pouvoir revenir en arrière en cas de besoin.

Téléchargement

Donc, pour commencer, il faut télécharger les fichiers des différents modules, qui sont tous regroupés dans l'archive "zip" suivante :

Cliquez sur l'icône pour télécharger l'archive
Mgs 1.4.x Modules

Un fois l'archive téléchargée, décompressez-la, vous devriez obtenir un dossier nommé "Mgs142Modules", dans lequel vous devriez trouver les éléments suivants :

0Documentation : fichier lien vers cet article ;

0MajLocalisation : dossier contenant le fichier de localisation "local_fr.php" à mettre à jour ;

1ModuleRubriques : dossier contenant le fichier du module du menu rubriques ;

2ModuleCalendrier : dossier contenant l'ensemble des fichiers du module du bloc calendrier et des options annexes ;

3ModuleZoom : dossier contenant le fichier du module du bloc "Zoom" ;

4ModuleInfos : dossier contenant les fichiers du module du bloc "Infos" ;

Suivez les instructions détaillées dans les chapitres suivants pour installer et intégrer les modules de votre choix.

Pour tous les modules

Quelque soit le module que vous souhaitez installer, vous devrez tout d'abord mettre à jour le fichier de localisation du squelette.

Pour ce faire, remplacez le fichier Php nommé "local_fr.php" du squelette, par celui homonyme présent dans le dossier 0MajLocalisation du dossier téléchargé.

Module Rubriques

Cliquez sur la vignette pour l'aggrandir
Menu Rubriques

Ce module s'installe assez simplement, même si certaines manipulations sont nécessaires... voici donc la marche à suivre :

1. Déplacez (ou dupliquez) le fichier Html nommé "inc-menu-rubriques.html", qui se trouve dans le dossier 1ModuleRubriques du dossier téléchargé, au premier niveau du dossier du squelette ;

2. Éditez le fichier Html nommé "inc-menu.html" du squelette ;

3. Retrouvez le code suivant :

<!-- Bloc liste hierarchique de toutes les rubirques existantes -->
 <div class="mgs_menu">
 <ul class="general">
 <li class="mgs_menu_titre"><:rubriques:></li>
 [(#ID_RUBRIQUE|menu)]
 </ul>
 </div>

4. Remplacez ce code par celui-là :

<!-- Inclusion du menu rubriques -->
 <INCLURE{fond=inc-menu-rubriques.html}{id_rubrique}{lang}>

5. Cette étape est peut-être la plus fastidieuse, mais elle est nécessaire pour pouvoir bénéficier de la surbrillance des rubriques selon le contexte.

La manipulation s'applique aux fichiers Html suivants du squelette :

article.html
auteur.html
breve.html
forum.html
plan.html
recherche.html
rubrique.html
sommaire.html

Éditez chacun de ces fichiers, puis remplacez le code suivant :

<!-- Bloc d'inclusion du menu de navigation -->
 <INCLURE{fond=inc-menu}{lang}>

Par le code qui suit :

<!-- Bloc d'inclusion du menu de navigation -->
 <INCLURE{fond=inc-menu}{id_rubrique}{lang}>

6. Voilà, enregistrez les changements de tous les fichiers modifiés, videz le cache de Spip (espace privé -> Configuration -> Vider le cache), puis rechargez vos pages pour mettre à jour l'affichage du site.

Module Calendrier

Cliquez sur la vignette pour l'aggrandir
Calendrier

Se module se compose d'un certain nombre de fichiers, qui ont pour rôle de proposer plusieurs possibilités d'affichage des différentes informations.

L'installation et l'intégration nécessitent plusieurs étapes, voici donc la marche à suivre :

1. Commencez par déplacer (ou dupliquer) l'ensemble des fichiers contenus dans le dossier 2ModuleCalendrier, du dossier téléchargé, au premier niveau du dossier du squelette ;

2. Intégration de la feuille de style du calendrier :

Éditez les fichiers Html suivants du squelette :

article.html
auteur.html
breve.html
forum.html
plan.html
recherche.html
rubrique.html
sommaire.html

Dans chacun de ces fichiers, retrouvez le code suivant :

Ajoutez juste après la ligne de code suivante :

Note : au lieu d'insérer l'appel à la feuille de style du calendrier dans tous ces fichiers Html du squelette, vous pouvez faire un seul import dans le fichier de feuille de style par défaut du squelette. Ainsi, il suffit d'éditer le fichier Css nommé "style.css" (ou "styleperso.css" si vous l'utilisez), puis d'intégrer au début du fichier le code suivant : @import url(calendrier.css).
Attention toutefois, certains navigateurs gèrent mal ce type d'imports.

3. Intégration de la fonction qui génère le calendrier :

Éditez le fichier Php nommé "mes_fonctions.php" du squelette.

Juste après le code Php de départ <?php, insérez la ligne de code suivante :

include_once('calendrier.php');

4. Intégration du calendrier :

Éditez le fichier Html nommé "inc-menu.html" du squelette.

Insérez, à l'endroit de votre choix entre deux autres blocs de menu, le code suivant :

<!-- Inclusion du bloc calendrier -->
 <INCLURE{fond=inc-menu-calendrier.html}{cal}{date}{annee}{lang}>

5. Voilà, enregistrez les changements de tous les fichiers modifiés, videz le cache de Spip (espace privé -> Configuration -> Vider le cache), puis rechargez vos pages pour mettre à jour l'affichage du site.

Module Zoom

Cliquez sur la vignette pour l'aggrandir
Bloc Zoom

L'intégration de ce module est très simple, voici le pas-à-pas :

1. Commencez par déplacer (ou dupliquer) le fichier nommé "inc-menu-zoom.html", contenu dans le dossier 3ModuleZoom du dossier téléchargé, au premier niveau du dossier du squelette ;

2. Éditez le fichier Html nommé "inc-menu.html" du squelette ;

3. Insérez, à l'endroit de votre choix entre deux autres blocs de menu, le code suivant :

<!-- Inclusion du bloc Zoom -->
 <INCLURE{fond=inc-menu-zoom.html}{lang}>

4. Voilà, enregistrez les changements de ce fichier, videz le cache de Spip (espace privé -> Configuration -> Vider le cache), puis rechargez vos pages pour mettre à jour l'affichage du site.

Module Infos

Cliquez sur la vignette pour l'aggrandir
Bloc Infos

Voici les étapes à suivre pour intégrer ce module :

1. Commencez par déplacer (ou dupliquer) les fichiers nommés "inc-menu-infos.html" et "infos.php", contenus dans le dossier 4ModuleInfos du dossier téléchargé, au premier niveau du dossier du squelette ;

2. Éditez le fichier Html nommé "inc-menu.html" du squelette ;

3. Insérez, à l'endroit de votre choix, entre deux autres blocs de menu ou à la fin du fichier, le code suivant :

<!-- Inclusion du bloc Infos -->
 <INCLURE{fond=inc-menu-infos.html}{lang}>

4. Éditez le fichier Php nommé "mes_fonctions.php" du squelette.

Juste après le code Php de départ <?php, insérez la ligne de code suivante :

include_once('infos.php');

Conclusion

Alors, avant de finir, je dois vous avouer que je n'ai pas encore testé et validé le fonctionnement de l'ensemble de ces modules sur une version 1.4.x du squelette (et je crois que je n'aurais pas le temps matériel de le faire), il est donc possible (probable ?) que certains ajustements soient nécessaires pour assurer un fonctionnement irréprochable de tous les modules.

Si jamais vous rencontrez des difficultés pour intégrer un ou plusieurs de ces modules, n'hésitez pas à nous en faire part dans les forums dédiés au squelette MiniGriSpip, on cherchera ensemble la meilleure solution possible.

Voilà, j'espère que ce modules sauront rendre service aux utilisateurs des précédentes version du squelette, d'ailleurs, je tiens à remercier l'ensemble des utilisateur qui, grâce à leurs remarques, suggestions et témoignages, permettent à Mgs d'évoluer dans le bon sens.

[1] Si certaines explications suscitent des questions, n'hésitez pas à les formuler dans le forum dédié à MiniGriSpip.

Calendrier Mgs 1.6, corrections...

FredoMkb — 2007-05-11T20:00:12Z

Suite à différents échanges sur les forums, voici quelques petites corrections pour le calendrier fourni avec le squelette...

Sommaire

Avant-propos

La prochaine version majeure du squelette est en cours de préparation, mais elle n'avance que très lentement pour l'instant... si tout va bien, elle vera peut-être le jour au mois de juin, sauf contretemps dû à mes nouvelles occupations... je vous tiendrait au courant...

En attendant, voici quelques petites corrections sur le calendrier du squelette, et une petite fonctionnalité nouvelle...

Nouveautés

La correction majeure concerne l'affichage des accents, en effet, grâce à la perséverence de Frdm sur les forums de Mgs, il en resulte qu'une petite modification dans la liste des codes de localisation des dates, au profit d'un encodage Unicode (Utf-8), permet de retrouver l'affichage correct des accents dans le calendrier...

De plus, suite à la demande de iMike sur les forums, le calendrier affiche désormais des liens annuels vers une page regroupant les 12 mois de l'année demandée, avec des liens vers l'ensemble des jours ayant des contenus publiés... c'est une manière simple et rapide de visualiser les archives du site.

Par ailleurs, en plus des pages listant les contenus publiés un jour donnée ou un mois donnée, on peut désormais afficher la liste de l'ensemble des contenus publiés une année donnée... pour ce faire, des nouveaux liens sont présents dans les pages listant les contenus des jours et des mois, ainsi que l'année affichée sur la page archive des 12 calendriers d'une année...

Si ces explications ne sont pas assez claires, je vous invite à tester tout ça sur ce site, cliquez sur les différents liens afin de découvrir les nouvelles possibilités de navigation et d'affichage...

Installation

Téléchargez et décompressez l'archive "zip" (voir chapitre suivant), vous devrais avoir un dossier décompressé nommé "calendrier".

Ensuite, remplacez les fichiers suivants, présents au premier niveau du dossier du squelette Mgs, par ceux existants au premier niveau du dossier décompressé :

calannuel.html
calendrier.html
mes_fonctions.php

Puis, remplacez les fichiers suivants, présents dans le dossier "inc" qui se trouve au premier niveau du dossier du squelette, par ceux qui se trouvent dans le dossier "inc" du dossier décompressé :

inc-cal-jour.html
inc-cal-mois.html
inc-cal-annee.html

Dernière étape, modifier un bout de code dans le fichier Html nommé "inc-menu.html", qui se trouve dans le dossier "inc" placé à la racie du dossier du squelette.

Il s'agit de remplacer le code d'affichage de l'ancien calendrier par le nouveau, qui ajoute les liens vers les pages archives annuels, voici donc la marche à suivre :

1. Éditez le fichier Html nommé "inc-menu.html" ;

2. Retrouvez le bout de code suivant :

3. Remplacez ce code par le suivant :

4. Enregistrez les modifications de ce fichier ;

5. Enfin, rendez-vous dans l'espace privé de votre site pour vider le cache de Spip (-> Configuration -> Vider le cache), rechargez une ou plusieurs fois les pages de l'espace public de votre site... et c'est fait !

Vous pouvez désormais profiter des nouveautés de cette mise-à-jour...

Téléchargement

Cliquez sur l'icône pour télécharger l'archive "zip"
Calendrier

Remerciements

Un grand merci à tous les utilisateurs du squelette Mgs pour toutes leurs remarques et suggestions qui permettent à ce projet d'évoluer...

Merci notamment à Frdm pour l'ensemble de ses contributions constructives, à iMike pour son idée de page archive annuel, à Job pour sa présence active sur les forums, et à tous ceux qui apportent jour après jour des bonnes idées et conseils avisés...

Enfin, merci à toute la communauté Spipienne pour leur aide permanente et à tous les développeurs qui conçoivent et réalisent ce magifique CMS francophone !

MiniGriSpip 1.6

FredoMkb — 2007-04-16T02:14:33Z

MiniGriSpip est un squelette simple et sobre particulièrement adapté aux sites éditoriaux (journaux, blogs, etc.). Nouvelle version numérotée 1.6 apportant son lot de nouveautés et améliorations.

Nom du Squelette : MiniGriSpip (Mgs)
Version du squelette : 1.6
Auteur : FredoMkb
Licence : GPL
Compatibilité SPIP : compatible SPIP 1.9 et supérieur
Site(s) exemple : MiniGriSpip démo...

Testé sur ces navigateurs

Testé ?	Plate-forme	Navigateur	Version
Oui	Mac	Firefox	1.5.11
Oui	Mac	Safari	2.0.4
Oui	Mac	Opera	9.01
Oui	Mac	Internet Explorer	5.2.3

Aucune autre plate-forme ni navigateur pour l'instant...

Attention, certains problèmes d'affichage peuvent apparaître sous Internet Explorer, mais l'ensemble du site reste correctement accessible.

#Sommaire

Présentation

Cette version de MiniGriSpip, numérotée 1.6, est une évolution singulière de la version 1.4.2 précédente, que vous pouvez toujours découvrir sur cette page.

Avec cette nouvelle version, MGS affirme d'avantage son orientation de squelette pour sites éditoriaux (journaux, blogs, web-zines, etc.), en mettant l'accent sur l'accessibilité aux données, grâce à une présentation à plat (sans arborescence), la plus complète possible selon le contexte, de l'ensemble des contenus disponibles.

Ainsi, par exemple, lors de l'affichage des informations d'une rubrique, l'utilisateur pourra désormais visualiser l'ensembles des contenus directement liés à cette dernière, autorisant, par la même, une navigation rapide et fluide sur l'ensemble des données publiées.

La présentation à plat des contenus, sans mettre en valeur l'arborescence particulière de chaque site, a l'avantage de s'adapter à tout type d'architecture, de la plus simple à la plus complexe, sans pour autant désorienter le visiteur, qui pourra ainsi se concentrer sur la recherche et la consultation des contenus tout en faisant abstraction de la structure du site.

D'autre part, toujours dans le but d'améliorer l'accessibilité aux contenus, différentes fonctions de navigation ont été intégrées, aussi bien pour accéder rapidement aux informations présentes dans chaque page que pour l'accès direct aux contenus listés, généralisant la navigation transversale.

Enfin, une consultation chronologique est désormais possible grâce à l'apparition d'un calendrier indiquant les articles, brèves et commentaires publiés à une date donnée.

Nouveautés

Comme il y a un bon nombre de nouveautés, certaines importantes et d'autres mineures, par rapport à la précédente version du squelette, il serait fastidieux de toutes les détailler, néanmoins, voici une petite liste des plus marquantes :

Le menu des rubriques a été revu et corrigé, entièrement réalisé avec des boucles SPIP, il affiche désormais une arborescence qui se déplie et replie selon la navigation dans la hiérarchie des rubriques et contenus.

Apparition d'un calendrier autorisant une navigation temporelle, en indiquant les articles, brèves et commentaires publiés à chaque date ou mois affiché.

Une barre de navigation contextuelle s'affiche désormais au sommet de chaque page, permettant l'accès rapide aux contenus affichés.

Les images intégrées aux rubriques et articles, sont désormais regroupées dans une galerie de vignettes cliquables (elles s'affichent automatiquement dans une fenêtre indépendante redimensionnée à la taille de l'image).

La page d'accueil a été revue permettant d'afficher un article comme édito, par l'utilisation d'un mot-clé "edito", et les dernières brèves publiées sont mieux mises en valeur.

La page plan a été aussi complétée, affichant désormais l'ensemble des données et contenus publiés sur le site sous une présentation à plat.

L'ensemble des listes paginées reçoivent maintenant 20 éléments par pagination, et les commentaires affichent désormais 50 messages par pagination.

Un bloc menu nommé "Zoom" permet d'afficher, de manière aléatoire, une des images intégrées dans les contenus du site, permettant par la même un accès direct à la rubrique, l'article ou la brève où l'image a été publiée.

Un bloc menu nommé "Infos" 'affiche quelques informations sur le site, comme la date de la dernière modification effectuée, des statistiques sur les contenus publiés ainsi que des statistiques sur les visites du jour et le total de visites.

Les filtres "Sommaire Tableau" et "Filets de séparation" sont intégrés par défaut pour les textes des articles et brèves.

Quelques ajustements graphiques apportent un peu de dynamisme aux pages, comme des mini pictos thématiques qui débutent les titres des blocs des contenus.

Code source modulaire plus facilement personnalisable, comportant des nombreux commentaires afin de rendre les modifications plus accessibles aux débutants.

Utilisation

Voici quelques informations sur l'utilisation des différentes fonctionnalités du squelette.

Le bandeau d'en tête

Les informations affichées dans le bandeau d'en tête (nom, descriptif et logo du site) sont directement issues de la page "Configuration" de l'espace privé du site.

Le bouton-lien "Contact" reprend l'adresse e-mail du webmestre du site, information également issue de la page "Configuration" de l'espace prive. Cette adresse e-mail est désormais cryptée dans le code source des pages, afin d'empêcher sa récupération par les robots spammeurs.

En éditant le fichier Html nommé "inc-bandeau.html", vous pouvez ajouter d'autres boutons-liens selon vos besoins, il suffit d'ajouter un item, à l'emplacement de votre choix, dans la liste qui débute par le commentaire Html : .

Par exemple, si vous souhaitez ajouter un bouton-lien pointant vers une page "Crédits", matérialisée par un fichier Html nommé "credits.html", ajoutez, dans le fichier "inc-bandeau.html" du squelette, la ligne de code suivante : <li><a href="#URL_PAGE{credits}">Crédits</a></li>, pour obtenir un code complet semblable au suivant :

__2__

La colonne de navigation

Le champ de recherche apparaît désormais au sommet de la colonne de navigation, améliorant ainsi son affichage et accessibilité.

__3__

Cliquez sur la vignette pour l'aggrandir
Menu Rubriques

Le menu "Rubriques", permettant la navigation dans la hiérarchie des rubriques du site, est désormais entièrement réalisé avec des boucles SPIP.

L'arborescence des rubriques et sous-rubriques est repliée par défaut, ainsi, les rubriques contenant des sous-rubriques sont identifiées par un signe plus entre crochets [+].

Les rubriques et sous-rubriques se mettent automatiquement en surbrillance pour indiquer le chemin d'accès en rapport direct avec le contexte affiché.

Des info-bulles reprennent le titre en entier de la rubrique et affichent aussi son descriptif.

__3__

Cliquez sur la vignette pour l'aggrandir
Calendrier

Un bloc "Calendrier" voit le jour, permettant une navigation chronologique dans les différents contenus publiés du site.

Le calendrier recense par date l'ensemble des articles, des brèves et des commentaires publiés, en créant un lien vers une page particulière sur chaque date concernée.

Lorsqu'on clique sur un des liens du calendrier, une page spéciale s'affiche listant tous les articles, brèves et commentaires publiés à la date choisie.

Il est possible aussi d'afficher l'ensemble des contenus publiés un mois donné en cliquant sur lien du mois affiché par le calendrier.

L'affichage du calendrier se met automatiquement à jour selon le contexte, ainsi, si on affiche un article daté du 16 septembre 2006 par exemple, le calendrier affiche automatiquement l'ensemble des contenus publiés au mois de septembre 2006, ce qui permet une navigation simple et rapide en rapport direct avec le contexte.

Enfin, des info-bulles indiquent en permanence, sur chaque lien, le nombre d'articles, brèves et commentaires publiées à chaque date ou mois.

__3__

Cliquez sur la vignette pour l'aggrandir
Bloc Zoom

Un nouveau bloc "Zoom" apparaît, affichant une image tirée au hasard de l'ensemble des images publiées dans le site.

En cliquant sur la vignette, on affiche l'image à taille réelle dans une nouvelle fenêtre, et en cliquant sur le lien affiché juste en dessous de la vignette, on accède directement à l'article dans lequel l'image à été publiée.

Important : pour pouvoir bénéficier convenablement de cette fonctionnalité, il faut veiller à activer l'option "Générer automatiquement les miniatures des images.", qui se trouve dans la page "Fonctions avancées" de la zone "Configuration" de l'espace privé, en y inscrivant une valeur inférieure ou égale à 200 pixels pour les vignettes.

__3__

Cette nouvelle version de MGS conserve le mêmes listes des 10 derniers commentaires publiés, des 10 sites référencés et des 10 articles syndiqués, avec des info-bulles un peu plus informatives qu'auparavant.

__3__

Cliquez sur la vignette pour l'aggrandir
Bloc Infos

Un nouveau bloc menu "Infos" affiche des informations générales sur le site, à savoir : la date de la dernière modification effectuée, des statistiques sur les différents contenus publiés sur le site, enfin, des statistiques sur le nombre de visites enregistrées, celles du jour même et le total depuis l'ouverture du site.

Ce bloc d'infos est librement inspiré de celui proposé avec le squelette Sarka-Spip, une partie du code est d'ailleurs directement adapté de ce squelette.

__2__

La colonne principale des contenus

La colonne des contenus, qui affiche l'ensemble des données mémorisées (articles, brèves, commentaires, etc.), a également été largement revue par rapport à la précédente version du squelette.

Cette colonne regroupe le plus grand nombre d'informations et contenus suivant le contexte demandé, ainsi, par exemple, lors de l'affichage de la page d'une rubrique précise, toutes les données attachées à cette rubrique sont listées dans cette colonne.

Cliquez sur la vignette pour l'aggrandir
Barre de navigation

Chaque page affiche, au sommet de la colonne de contenus, une barre de navigation facilitant l'accès aux contenus affichés. Les liens présents sur cette barre de navigation s'adaptent au contexte.

__2__

La page Sommaire

La page "Sommaire", ou page d'accueil du squelette, présente un certain nombre de données qui s'organisent de la manière suivante :

__3__

Un bloc "Bienvenue" affichant un message d'accueil, qui correspond à un simple contenu statique issu d'un fichier Html dédié. Vous pouvez modifier le contenu de ce message, afin de l'adapter à votre site, en éditant le fichier Html nommé "inc-bienvenue.html".

Si jamais vous ne souhaitez pas afficher ce bloc de bienvenue, il suffit d'éditer le fichier Html nommé "sommaire.html", et effacer les codes suivants :

<!-- Bloc d'inclusion d'un petit message de bienvenue -->
 <INCLURE{fond=inc/inc-bienvenue}{lang}>

Vous devrez également effacer les codes du lien correspondant dans la barre de navigation, à savoir :

<a href="#mgs_bienvenue"><:mgs_bienvenue:></a>
 -

Note : au lieux d'effacer ces bouts de code, vous pouvez tenter, à la place, de les commenter, en utilisant la balise #REM propre à la syntaxe de Spip (voir le chapitre "Balises techniques" sur la page "Les balises propres au site"). Cette solution peut parfois s'avérer inopérante sur des blocs de code importants.

__3__

Un bloc "Édito" peut afficher un article éditorial.

Un édito est un article, souvent composé d'un texte relativement court, qu'on souhaite mettre en valeur et qui a pour rôle d'introduire le lecteur au contenu actualisé du site.

Ce bloc édito affiche donc le dernier article en date associé à un mot clé débutant par le mot "edito" (sans accent).

Par exemple, un article associé à un mot-clé nommé "edito nouvelles", sera affiché automatiquement, dans son intégralité, sur la page sommaire.

Il est alors possible de rédiger, périodiquement, différents articles éditoriaux, dans les rubriques de votre choix, sachant que seul le plus récent sera affiché dans la page sommaire, les plus anciens restants toujours accessibles par les méthodes de navigation habituelles.

Si vous ne souhaitez pas utiliser cette fonctionnalité, il suffit d'éditer le fichier Html nommé "sommaire.html", et effacer les codes présents entre les commentaires Html suivants :

<!-- Bloc affichant le dernier article en date débutant par le mot-clé "edito" -->
 --
 <!-- /Fin du bloc edito -->

Vous devrez également effacer les codes du lien correspondant dans la barre de navigation, à savoir :

<a href="#mgs_edito"><:mgs_edito:></a>
 -

Note : au lieux d'effacer ces bouts de code, vous pouvez tenter, à la place, de les commenter, en utilisant la balise #REM propre à la syntaxe de Spip (voir le chapitre "Balises techniques" sur la page "Les balises propres au site"). Cette solution peut parfois s'avérer inopérante sur des blocs de code importants.

__3__

Un bloc "À la une" affiche les deux articles les plus récents mises en exergue.

Un bloc "Articles récents" affiche une liste des 5 articles les plus récents suivant les deux présents dans le bloc précédent.

Un bloc "Dernières brèves" liste les 5 brèves les plus récentes.

__2__

Les pages Auteur, Mot et Rubrique

Les pages "Auteur", "Mot" et "Rubrique" sont organisées d'une manière très similaire, seules les informations affichées diffèrent selon les données associées.

__3__

La page "Auteur" affiche un premier bloc d'infos, puis une liste d'articles écrits par l'auteur demandé, enfin, un champ permettant d'envoyer directement un e-mail à l'auteur demandé.

La page "Mot" affiche un premier bloc d'infos, puis différentes listes regroupant l'ensemble des rubriques, articles, brèves et sites associés au mot-clé demandé.

La page "Rubrique" affiche un premier bloc d'infos, puis différentes listes regroupant l'ensemble des articles, brèves, images, documents joints, sites et mots-clés attachés à la rubrique demandée.

__2__

Les pages Article et Brève

Les pages "Article" et "Brève" sont organisées d'une manière très similaire, seules les informations affichées diffèrent selon les données associées.

__3__

La page "Article" affiche un premier bloc avec tout le contenu rédigé, puis différentes listes regroupant l'ensemble des images, documents joints, mots-clés et commentaires attachés à l'article demandé.

De plus, lorsqu'on affiche un article, un bloc de navigation supplémentaire apparaît dans la colonne de navigation listant l'ensemble des autres articles attachés à la même rubrique à laquelle appartient l'article affiché.

La page "Brève" affiche un premier bloc avec tout le contenu rédigé, puis différentes listes regroupant l'ensemble des mots-clés et commentaires attachés à là brève demandée.

__2__

La page Plan

Les page "Plan" affiche l'intégralité des données enregistrés sur le site. On retrouve donc différentes listes regroupant l'ensemble des articles, brèves, images, documents joints, sites, commentaires, rubriques, mots-clés et auteurs.

Vous pouvez masquer les infos que vous ne désirez pas publier sur cette page, il suffit d'éditer la page Html nommée "plan.html" et d'effacer les codes correspondants aux données à masquer.

Par exemple, si vous ne souhaitez pas afficher la liste des rubriques dans la page plan, il suffit d'effacer les deux lignes de code suivantes :

<!-- Inclusion des Rubriques publiees -->
 <INCLURE{fond=inc/inc-rubriques}{lang}>

Vous devrez également effacer les codes du lien correspondant dans la barre de navigation, à savoir :

<a href="#mgs_rubriques"><:mgs_rubriques:></a></a>
 -

Vous pouvez procéder de la même manière pour masquer d'autres données.

Note : au lieux d'effacer ces bouts de code, vous pouvez tenter, à la place, de les commenter, en utilisant la balise #REM propre à la syntaxe de Spip (voir le chapitre "Balises techniques" sur la page "Les balises propres au site"). Cette solution peut parfois s'avérer inopérante sur des blocs de code importants.

Prévisualisation

Rendez-vous sur le site de démonstration de MiniGriSpip pour tester l'ensemble des fonctionnalités présentes dans cette nouvelle version du squelette.

Si jamais vous rencontrez des difficultés à afficher le site de démonstration (serveur saturé, site en travaux, etc.), voici une capture d'écran de la page sommaire afin de vous en faire une petite idée :

Cliquez sur la vignette pour l'aggrandir
Page Sommaire

Installation

Cette version 1.6 de MiniGriSpip s'installe exactement de la même manière que la version précédente, c'est à dire, par les étapes suivantes :

Téléchargez l'archive "zip" du squelette (voir le chapitre suivant) ;
Décompressez l'archive téléchargée, vous devriez obtenir un répertoire comme celui-ci :

Cliquez sur la vignette pour l'aggrandir
Répertoire "squelettes" de MiniGriSpip

Copiez ou transférez le répertoire "squelettes" décompressé, avec tout son contenu, à la racine de votre installation de SPIP.

Important : si un dossier portant le même nom existe déjà, veuillez le sauvegarder avant de le remplacer par celui de MiniGriSpip.

Ceci correspond à une installation basique, il est aussi possible d'installer plusieurs squelettes différents dans le répertoire "squelettes", pour en savoir plus, veuillez consulter la documentation de SPIP, ou interroger les utilisateurs avertis sur la liste de discussion de SPIP.

Téléchargement

Cliquez sur l'icône pour télécharger MiniGriSpip
MiniGriSpip 1.6

Remerciements

Merci à la communauté des utilisateurs de SPIP pour leur entraide permanente, ainsi qu'aux développeurs de ce super outil de publication qu'est SPIP...

Un grand merci à tous les utilisateurs des différentes versions de MiniGriSpip, qui ont su apporter un soutien précieux, non seulement grâce à l'accueil chaleureux et enthousiaste qu'ils ont réservé à ce squelette, mais aussi par leurs remarques et suggestions pertinentes qui permettent à MiniGriSpip d'évoluer dans le bon sens...

Un remerciement tout particulier à Job pour son aide inestimable.

Bonne utilisation de MiniGriSpip, n'hésitez pas à me faire part de vos remarques et suggestions, ou à partager les liens des sites utilisant ce squelette, dans le forum de discussion spécialement dédié à Mgs...
Merci à tous :-)