Le plugin « Le Couteau Suisse » propose d’introduire facilement de simples fonctionnalités supplémentaires à SPIP (que l’on pourra appeler « des outils » ou même « des lames ») sans pour autant alourdir le core.
Le but est donc de réunir toutes ces fonctionnalités, petites mais pratiques, en un seul plugin et d’ajouter dans l’espace d’administration une page de configuration où il suffira de cocher les outils voulus. Le gain en performances et en clarté est non négligeable : le plugin précompile les fonctionnalités lors de l’installation et permet ensuite une navigation plus fluide. Les débutants qui ne connaissent rien au php, html ou à SPIP, seront les premiers servis dans ce projet. Rien de plus facile pour moi ou pour la plupart d’entre vous d’ajouter une ligne de code qui va bien … Mais ce n’est pas le cas de tout le monde !!
Inhibition du cache de SPIP pour le développement du site.
Modifie le quota réservé au cache. Une valeur vide ou égale à 0 signifie qu’aucun quota ne s’applique.
Modifie le dossier du squelette utilisé. Par exemple : « squelettes/monsquelette ». En laissant la case vide, c’est le squelette original « dist » fourni par SPIP qui sera utilisé.
Spécifie le préfixe à donner aux cookies de ce site. Utile pour installer des sites SPIP dans des sous-répertoires.
Applique la fonction SPIP paragrapher() aux textes qui sont dépourvus de paragraphes en insérant des balises <p>.
Sélectionne d’office le type d’interface privée (simplifiée ou avancée) pour tous les rédacteurs déjà existants ou à venir et supprime le bouton correspondant du bandeau des petites icônes (version 1.9.2 mini).
Désactive le menu de changement rapide de statut d’un article au survol de sa puce colorée. Cela est utile si vous cherchez à obtenir une interface privée la plus dépouillée possible afin d’optimiser les performances client (version 1.9.3 mini).
Pour gérer le javascript dans les articles, trois modes sont disponibles :
Attention : dans les forums, pétitions, flux syndiqués, etc., la gestion du javascript est toujours sécurisée.
Par défaut les messages de forum ne sont pas limités en taille. Si cet outil est activé, un message d’erreur s’affichera lorsque quelqu’un voudra poster un message d’une taille supérieure à la valeur spécifiée, et le message sera refusé.
Incite tous les auteurs de messages publics à remplir (d’au moins une lettre !) le champ « Votre nom (ou pseudonyme) :» afin d’éviter les contributions totalement anonymes. Cette fonctionnalité utilise la librairie jQuery.
Un auteur d’article est toujours informé lorsqu’un message est publié dans le forum associé. Mais il est aussi possible d’avertir en plus tous les participants au forum ou seulement les auteurs de messages en amont.
Désactive le mécanisme d’enregistrement automatique des adresses IP des visiteurs de votre site par soucis de confidentialité : SPIP ne conservera alors plus aucun numéro IP, ni temporairement lors des visites (pour gérer les statistiques ou alimenter spip.log), ni dans les forums (responsabilité).
Désactive le système de verrouillage de fichiers en neutralisant la fonction PHP flock(). Certains hébergements posent en effet des problèmes graves suite à un système de fichiers inadapté ou à un manque de synchronisation. N’activez pas cet outil si votre site fonctionne normalement.
Permet d’afficher un message personnalisable pendant une phase de maintenance sur tout le site public.
(Les outils suivants modifient juste l’apparence de vos textes, sans en modifier la source)
Remplace les puces « - » (tiret simple) des articles par des listes notées « -* » (traduites en HTML par : <ul><li>…</li></ul>) et dont le style peut être personnalisé par css.
Textes français : améliore le rendu typographique des abréviations courantes, en mettant en exposant les éléments nécessaires. Ainsi, Mme devient M<inf>me</inf> et en corrigeant les erreurs courantes 2ème ou 2me, par exemple, deviennent 2e, seule abréviation correcte.
Remplace automatiquement les guillemets droits (”) par les guillemets typographiques de la langue de composition. Le remplacement, transparent pour l’utilisateur, ne modifie pas le texte mais seulement l’affichage final.
Remplace systématiquement tous les liens laissés en texte par les utilisateurs (notamment dans les forums) et qui ne sont donc pas cliquables, par des liens hypertextes au format SPIP. Par exemple www.spip.net est remplacé par http://www.spip.net. Vous pouvez choisir le type de remplacement :
Remplace tous les smileys écrits « en texte » par l’image souriante correspondante. Outil très utile pour les forums. Une balise est disponible pour afficher un tableau de smileys dans vos squelettes : #SMILEYS.
Masque tous les liens de courriel présents dans vos textes en les remplaçant par un lien Javascript permettant quand même d’activer la messagerie du lecteur. Cet outil antispam tente d’empêcher les robots de collecter les adresses électroniques laissées en clair dans les forums ou dans les balises de vos squelettes.
(Les outils suivants introduisent de nouveaux raccourcis pour la rédaction de vos textes)
Découpe l’affichage public d’un article en plusieurs pages grâce à une pagination automatique. placez simplement dans votre article quatre signes plus consécutifs (++++) à l’endroit qui doit recevoir la coupure. Si vous utilisez ce séparateur à l’intérieur des balises <onglets> et </onglets> alors vous obtiendrez un jeu d’onglets. Dans les squelettes : vous avez à votre disposition les nouvelles balises #ONGLETS_DEBUT, #ONGLETS_TITRE et #ONGLETS_FIN.
Introduit le raccourci <:un_texte:> pour introduire librement des blocs multi-langues dans un article. La fonction SPIP utilisée est : _T(’un_texte’, $flux). N’oubliez pas de vérifier que ’un_texte’ est bien défini dans les fichiers de langue.
Permet aux rédacteurs d’un article d’appliquer les styles <sc>capitales</sc>, <souligne>souligné</souligne>, <barre>barré</barre>, <dessus>dessus</dessus>, <clignote>clignote</clignote> <surgris>gris</surgris> et <surfluo>fluo</surfluo> à un texte. Cet outil du couteau suisse est particulièrement conseillé à tous ceux qui veulent égayer leur site et y mettre de la couleur.
Permet d’appliquer facilement des couleurs (éventuellement paramétrables) à tous les textes du site (articles, brèves, titres, forum, …) en utilisant des balises en raccourcis (anglais ou français). Deux exemples identiques : Lorem ipsum [rouge]dolor[/rouge] sit amet et Lorem ipsum [red]dolor[/red] sit amet.
Insère des images (ou chatons pour les tchats) dans tous les textes où apparaît une chaîne du genre : nom. Comme pour les smileys, cet outil remplace les raccourcis en texte par les images du même nom qu’il trouve dans le répertoire plugins/couteau_suisse/img/chatons.
Permet d’insérer très facilement des filets de séparation personnalisés dans les textes.
Vous permet de créer des blocs dont le titre cliquable peut les rendre visibles ou invisibles. Dans les textes SPIP : les rédacteurs ont à disposition les nouvelles balises <bloc> (ou <invisible>) et <visible> à utiliser dans leurs textes. Dans les squelettes : vous avez à votre disposition les nouvelles balises #BLOC_TITRE, #BLOC_DEBUT et #BLOC_FIN.
(Les outils suivants modifient juste l’apparence des pages publiques)
Applique la fonction SPIP supprimer_numero() à l’ensemble des titres ou des noms du site public, sans qu’elle soit présente dans les squelettes.
Force le contexte de langue pour les jeux de squelettes multilingues disposant d’un formulaire ou d’un menu de langues sachant gérer le cookie de langues.
Jusqu’à la version 1.92 de SPIP, les paragraphes html (marqués par la balise <p>) étaient systématiquement affublés du style class=“spip”. Cet outil vous permet de définir le style de vos paragraphes en fonction de vos feuilles de style.
Active le validateur xml pour l’espace public tel qu’il est décrit dans la documentation.
Supprime les objets flash des pages de votre site et les remplace par le contenu alternatif associé. Nécessite le plugin jQuery ou une version de SPIP supérieure à 1.9.2.
Permet aux liens externes au site de s’ouvrir dans une nouvelle fenêtre extérieure. Activer cet outil revient à ajouter target=“_blank” à toutes les balises <a> dotées par SPIP des classes spip_out et/ou spip_url. Il est parfois nécessaire d’ajouter l’une de ces classes aux liens du squelette du site (fichiers html) afin d’étendre au maximum cette fonctionnalité.
Empêche l’installation de jQuery dans la partie publique. Cette librairie (http://jquery.com/) apporte de nombreuses commodités dans la programmation de Javascript et peut être utilisée par certains plugins. SPIP l’utilise dans sa partie privée.
Construit un sommaire en début d’article afin d’accéder rapidement aux gros titres (balises <h3>Un titre</h3> ou raccourcis SPIP un-autre-titre}.
Gestion d’un glossaire interne lié à un groupe de mots-clés nommé « Glossaire ». Pour chaque mot, vous avez la possibilité de choisir le nombre maximal de liens créés dans vos textes.
Ajoute les critères {portrait}, {carre} et {paysage} dans vos squelettes pour le classement des photos. Idée d’origine
2 filtres pour vos squelettes. version_texte : extrait le contenu texte d’une page html à l’exclusion de quelques balises élémentaires. version_plein_texte : extrait le contenu texte d’une page html pour rendre du texte plein.
Active #INSERT_HEAD sur tous les squelettes, qu’ils aient ou non cette balise entre <head> et </head>. Grâce à cette option, les plugins pourront insérer du javascript (.js) ou des feuilles de style (.css).
Vous pouvez préciser (en pourcentage par rapport à la valeur utilisée par défaut) la longueur du texte renvoyé par balise #INTRODUCTION. Une valeur nulle ou égale à 100 ne modifie pas l’aspect de l’introduction et utilise donc les valeurs par défaut suivantes : 500 caractères pour les articles, 300 pour les brèves et 600 pour les forums ou les rubriques.
Par défaut, les points de suite ajoutés au résultat de la balise #INTRODUCTION sont : '  ;(…)’. Cette balise à placer dans les squelettes sert en général à la une ou dans les rubriques afin d’introduire les articles, les brèves, etc.. Vous pouvez donc préciser votre propre chaîne de caractère indiquant à l’utilisateur que le texte tronqué a bien une suite.
Si la balise #INTRODUCTION est utilisée pour résumer un article, alors le Couteau Suisse peut fabriquer un lien hypertexte sur les points de suite définis ci-dessus afin de mener le lecteur vers le texte original. Par exemple : « Lire la suite de l’article… »
Met à votre disposition le filtre : ’liens_en_clair’. Votre texte contient probablement des liens hypertexte qui ne sont pas visibles lors d’une impression. Ce filtre ajoute entre crochets la destination de chaque lien cliquable (liens externes ou mails). Attention : En mode impression (parametre ’cs=print’ dans l’url de la page), cette fonctionnalité est appliquée automatiquement.
Inscrit de nombreux renseignements à propos du fonctionnement du plugin « Le Couteau Suisse » dans les fichiers spip.log que l’on peut trouver dans le répertoire temporaire (/tmp pour SPIP v1.9.2)
Ajoute un cadre sur la page de configuration du plugin, où figurent les dernières modifications apportées au code du plugin « Le Couteau Suisse » (Source).
Page de référence sur Spip-Contrib