SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

289 Plugins, 197 contribs sur SPIP-Zone, 85 visiteurs en ce moment

Accueil > Documentation > Tutoriaux pour le code de SPIP > Archives tutoriaux code SPIP > BaliseCommentaire

BaliseCommentaire

19 août 2004

1 vote

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

Attention, cet exemple ne marche plus avec la version actuelle du cvs. C’est juste une histoire de commentaires imbriqués, alors les principes décris ici restent intéressant à lire.

Dans SPIP, quand on veut commenter un squelette, c’est pas toujours jolie. On se retrouve dans la page html avec des commentaires pas très pertinents et souvent répétés (à cause des boucles).

Voyons donc comment utiliser la magie du nouveau compilateur pour créer des balises de commentaire.

But

On veut tout simplement émuler /* et */ (commentaire en bloc) comme dans beaucoup de langages de programmation. On déclare donc deux nouvelles balises :
-  #DEBUT_COMMENT
-  #FIN_COMMENT

Comment on déclare une nouvelle balise

Avec la nouvelle version du compilateur proposé par ESJ et actuellement inclus dans la version 1.8a4, on peut facilement déclarer (ou redéclarer) une balise. Il suffit pour cela de placer dans mes_options.php3 une fonction qui s’appelle :
balise_MABALISE

qu’est ce qui se passe dans SPIP

On apprend en regardant dans le code de spip, que cette nouvelle fonction doit :


[...] genere le code PHP correspondant a la balise Spip.

Retourne [...] une EXPRESSION php [...]

La nouvelle fonction de calcul de balise doit donc retourner du code PHP. Mais pourquoi ?

SPIP va utiliser ce code pour construire un fichier .php dans le cache. Ce fichier sera ensuite exécuter pour créer une page — si possible — totalement en html. MAIS il ne faut pas renvoyer n’importe quel code ! il faut renvoyer du code qui renvois une chaîne de caractères. En effet, le compilateur concatène les chaînes retournées par le code de chaque balise avec le code html — ou autre — qui les entoure dans le squelette.

Le code

Regardons le code pour nos deux nouvelles balises :

Explication

Spip va donc essayer de concatener la chaîne retournée par notre code avec le reste des chaînes calculées. On ne peut donc pas juste retourner /* et */, sinon on aura quelque chose comme ça :

$ducode . "du texte brute<br/>"./*. un commentaire .*/ . $leresteducode

Il y aura donc un . de trop. C’est pourquoi — dans le code de la 1er balise — on retourne ''/*. Ainsi on annule le point en trop :

$ducode . "du texte brute<br/>".''/*. un commentaire .*/ . $leresteducode

Dernière modification de cette page le 16 juin 2007

Retour en haut de la page

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Escal-V3 et Escal-V4

    16 février 2012 – 314 commentaires

    Un jeu de squelettes proposant un affichage en 2 ou 3 colonnes avec un large choix de noisettes à insérer ou pas, fortement paramétrable depuis l’espace privé. Présentation A l’instar de sa petite soeur plugin Escal-V2 dont elle reprend toutes les (...)

  • SPIP-Cli

    20 décembre 2015 – 13 commentaires

    SPIP-Cli est une interface en ligne de commande pour SPIP. SPIP-Cli sert à interagir avec SPIP depuis la ligne de commande, à la fois avant d’avoir un SPIP sous la main (installation, configuration…), puis ensuite pour administrer ou modifier un (...)

  • Plugin Google Viewer

    22 mai 2011 – 34 commentaires

    Ce plugin fournit des modèles d’incrustation de documents utilisant le lecteur de documents de Google. Principe Ce plugin permet d’utiliser le lecteur de documents de Google pour incruster des documents dans vos textes. L’ensemble des (...)

  • Social tags

    8 septembre 2008 – 444 commentaires

    Le plugin Social Tags permet d’ajouter des icônes de partage de liens vers les sites tels que Digg, Facebook, Delicious.... Une fois le plugin installé et activé (voir doc.), le choix des sites se fait via un menu de configuration. Insertion (...)

  • LESS pour SPIP : Less-CSS (anciennement LESSpip)

    5 novembre 2010 – 51 commentaires

    Less-CSS (Anciennement LESSpip) est un plugin intégrant facilement le logiciel LESS dans SPIP. LESS est une extension de CSS ajoutant les variables, les classes, les opérations, les imbrications au langage. Facilitant ainsi l’écriture de feuilles (...)