SPIP - Contrib

[ar] [en] [es] [fr] [it]



Accueil du site > Administration > Le Couteau Suisse

Le Couteau Suisse à piloter

... ou comment le pré-configurer et/ou lui ajouter des outils à la volée

samedi 8 décembre 2007, par Patrice Vanneufville. Dernier ajout mercredi 12 décembre 2007


Ici est décrit la façon de pré-configurer facilement le Couteau Suisse, tout en lui ajoutant éventuellement vos propres lames personnalisées...


Mots-clés

Sur le Web

Le Couteau Suisse est un plugin qui propose d’introduire facilement de simples fonctionnalités supplémentaires à SPIP, et que vous pouvez trouver ici. Le présent article est destiné à tous ceux qui créent leurs propres squelettes et pensent trouver avec ce plugin une amélioration notable de leurs sites.

Le but de cet article est d’indiquer comment mieux associer un jeu de squelettes avec Le Couteau Suisse.

Tous les exemples de code ci-dessous sont à placer dans le fichier mes_options.php que vous trouverez/placerez dans le dossier config/.

Pré-configuration du Couteau Suisse

Une pré-configuration est la mise en place d’un pack permettant en un seul clic de configurer Le Couteau Suisse. Il permettra ensuite de choisir les outils à activer, de définir la valeur de certaines de leurs variables ainsi que certains define() surchargeables.

Voici un exemple qui s’allie avec le squelette "Alternatives" :

  1.  
  2. ######## CONFIGURATION COUTEAU SUISSE ########
  3.  
  4. // Installation des outils par defaut
  5. $GLOBALS['cs_installer']['Alternatives']['outils'] =
  6.         'supprimer_numero|decoupe|sommaire';
  7.  
  8. // Installation des variables par defaut
  9. $GLOBALS['cs_installer']['Alternatives']['variables'] = array(
  10.         'auto_sommaire' => 1,
  11.         'balise_sommaire' => 1, // ou 0, si on n'utilise pas la balise #CS_SOMMAIRE
  12. );
  13.  
  14. // Compatibilite ascendante avec l'ancien filtre 'decoupe'
  15. @define('_decoupe_COMPATIBILITE', '-----');
  16.  
  17. // "Navigation rapide" on aurait prefere "Sommaire", mais pas de traduction
  18. @define('_sommaire_TITRE', _T('icone_brouteur'));
  19.  
telecharger

Observez le résultat sur la page de configuration du Couteau Suisse (ecrire/?exec=admin_couteau_suisse), dans le cadre de gauche, sous la mention "Réinitialisations". Un lien cliquable "pour Alternatives" est apparu et vous permet de réinitialiser le plugin, tout en :

Astuce : Le fichier tmp/couteau-suisse/config.php contient la configuration en cours de votre Couteau Suisse.

Ajouter une lame personnalisée

Il vous est possible d’ajouter à la volée un outil au Couteau Suisse. La syntaxe ressemble à celle utilisée par les outils déjà présents au sein du plugin, et expliquée ici : Le Couteau Suisse pour les développeurs.

Les lames personnalisées apparaissent en italique sur la page de configuration du plugin (ecrire/?exec=admin_couteau_suisse) et doivent être activée comme toutes les autres fournies par défaut.

Voici un premier exemple qui remplace toutes les citations entre (vrais !) guillemets par des italiques simples. Exemple : « une citation » est changé en une citation :

  1.  
  2. ############## COUTEAU SUISSE : LAME PERSO #################
  3.  
  4.  // Installation d'une nouvelle lame personnalisee
  5.  $GLOBALS['mes_outils']['mes_citations'] = array(
  6.         'nom'         => 'Citations en italique',
  7.         'description' => 'Une lame qui transforme toutes les citations <html>&laquo; toto &raquo;</html> en simple {italique}.',
  8.         'categorie'   => 'typo-racc',
  9.         'pipeline:pre_typo'   => 'mes_citations_pre_typo',
  10.  );
  11.  
  12.  // Fonction de remplacement
  13.  function mes_citations_rempl($texte) {
  14.         return preg_replace(',«\s*(.*?)\s*»,msS', '{$1}', $texte);
  15.  }
  16.  
  17.  // Fonction de pipeline
  18.  function mes_citations_pre_typo($texte) {
  19.         if (strpos($texte, '«')===false) return $texte;
  20.         // appeler mes_citations_rempl() une fois que certaines balises ont ete protegees
  21.         return cs_echappe_balises('', 'mes_citations_rempl', $texte);
  22.  }
  23.  
telecharger

Voici un second exemple qui permet d’offrir un nouveau raccourci à vos rédacteurs pour mettre un texte en évidence :

  1.  
  2. ############## COUTEAU SUISSE : LAME PERSO #################
  3.  
  4. // Installation d'une nouvelle lame personnalisee
  5. $GLOBALS['mes_outils']['mise_evidence'] = array(
  6.         'nom'         => 'Mise en &eacute;vidence',
  7.         'description' => 'Un nouveau raccourci pour mettre un texte en &eacute;vidence. Syntaxe : [*un texte*]',
  8.         'auteur'      => 'Moi-m&ecirc;me',
  9.         'categorie'   => 'typo-racc',
  10.         'pipeline:pre_typo'   => 'mise_evidence_pre_typo',
  11.         'pipeline:BT_toolbox' => 'mise_evidence_BarreTypo',
  12. );
  13.  
  14. // Fonction de remplacement
  15. function mise_evidence_rempl($texte) {
  16.         return preg_replace(',\[\*(.*?)\*\],', '<span style="color:orange;">$1</span>', $texte);
  17. }
  18.  
  19. // Fonction de pipeline
  20. function mise_evidence_pre_typo($texte) {
  21.         if (strpos($texte, '[*')===false) return $texte;
  22.         // appeler mise_evidence_rempl() une fois que certaines balises ont ete protegees
  23.         return cs_echappe_balises('', 'mise_evidence_rempl', $texte);
  24. }
  25.  
  26. // Fonction indiquant le nouveau raccourci
  27. function mise_evidence_raccourcis() {
  28.         return 'Mise en &eacute;vidence : <b>[*texte*]</b>';
  29. }
  30.  
  31. // Aide le Couteau Suisse a calculer la balise #INTRODUCTION
  32. function mise_evidence_nettoie($texte) {
  33.         return preg_replace(',\[\*(.*?)\*\],', '$1', $texte);
  34. }
  35. $GLOBALS['cs_introduire'][] = 'mise_evidence_nettoie';
  36.  
  37. // Fonction qui renvoie une ligne de tableau entre <tr></tr>
  38. // afin de l'inserer dans la Barre Typo V2, si elle est presente
  39. function mise_evidence_BarreTypo($tr) {
  40.         return $tr.'<tr><td><a title="Mise en &eacute;vidence" href="javascript:barre_raccourci(\'[*\',\'*]\',@@champ@@)">Mise en &eacute;vidence</a></td></tr>';}
  41.  
telecharger

Répondre à cet article



Suivre la vie du site RSS 2.0 | Plan du site | Espace privé | Charte et vie SPIP-Contrib | SPIP | L'autre.net