Surcharger les raccourcis texte

© Christian PAULUS. Document créé le 1er janvier 2009 , mis à jour le 3 janvier 2009.

Aucune route n'est longue à côté d'un ami. Proverbe japonais

Accueil du site > Outils > Surcharger les raccourcis texte

Plugin / SPIP 1.9.2d, SPIP 2

Mots-clés

Même rubrique

RaPer (Raccourcis texte Perso) est un plug-in pour SPIP (à partir de la version 1.9.2) qui permet de surcharger les raccourcis texte utilisés dans vos squelettes.

Ce plug-in vous sera peut-être utile si vous voulez déléguer la gestion des raccourcis à un administrateur restreint, ou simplement vouloir personnaliser les raccourcis texte sans modifier vos squelettes.

Par exemple, le webmestre du site met en place les squelettes nécessaires, mais l’administrateur des rubriques souhaite modifier l’intitulé de certains éléments permanents (article suivant, articles de cet auteur, etc.) Pour modifier ces éléments permanents, il faut modifier le squelette de la rubrique ou de l’article concerné, parfois éditer le fichier local_fr.php, puis placer l’ensemble sur le site via FTP. Les administrateurs restreints n’ont pas toujours cette possibilité et le webmestre se retrouve souvent consulté pour effectuer une modification somme toute peu passionnante.

Avertissements

N’installez pas RaPer en production sans l’avoir testé et validé correctement.

RaPer est diffusé gratuitement sous licence GNU/GPL, sans aucune garantie de bon fonctionnement. Vous êtes seul responsable de l’installation et de la mise en œuvre de RaPer sur votre site.

Installation

Téléchargez l’archive Raccourcis texte perso sur la zone.

L’installation nécessite de placer le dossier du plug-in dans votre dossier plugins. Pour plus d’information sur l’installation d’un plugin, consulter cette page sur Spip.net.

Configurer RaPer

Les administrateurs toutes rubriques peuvent accéder à cette page de configuration.

La page de configuration du RaPer permet de déléguer l’administration des raccourcis aux administrateurs restreints.

Pour accéder à la page de configuration du RaPer, cliquez sur le bouton Configuration puis sur l’onglet Raccourcis texte.

Onglet Raccourcis texte pour un site multilingue {PNG}

L’onglet illustré ci-dessus est celui affiché pour un site multilingue. Si votre site est unilingue, il n’y a pas deux micros, mais un seul.

Cette page de configuration permet également de prendre en compte les raccourcis privés, et ceux de SPIP. Vous pouvez à tout moment redéfinir les modules (public, ecrire, spip) souhaités. Ainsi, activez la gestion du module ’ecrire’, ajoutez via la page d’édition du RaPer les raccourcis que vous désirez utiliser dans vos squelettes, puis retirez la gestion des raccourcis du module ’ecrire’ pour alléger la page d’édition. Vous profiterez ainsi des éventuelles traductions disponibles.

Si votre site est multilingue, vous avez la possibilité de sélectionner les langues définies (via la page de configuration multilingue) ou celles réellement utilisées sur votre site.

Pré-requis, les fichiers de langues

Pour ajouter des raccourcis à vos squelettes, ce raccourci doit exister, soit dans les fichiers officiels de la distribution, soit dans votre fichier local de langue ( local_fr.php par exemple).

Gérer les raccourcis

Survolez sur le bouton Edition pour accéder au bouton vous donnant l’accès à la page de gestion des raccourcis.

Bouton d’accès à la page d’édition des raccourcis {PNG}

Si le site est multilingue, le menu de sélection du même nom apparaît dans la liste des raccourcis. Ce menu permet de naviguer entre les différentes versions des raccourcis.

Exemple de menu multilingue {PNG}

Personnaliser les raccourcis

La page d’édition des raccourcis affiche les raccourcis ainsi :

Contenu original du raccourci {PNG}

Le raccourci <:sites_web :> a ici pour valeur "Sites Web".

Cliquez sur le petit crayon, dans la colonne de droite. Un formulaire apparaît et vous propose de personnaliser le raccourci.

Si votre site est multilingue, le formulaire vous propose de modifier ce raccourci pour les différentes langues utilisées sur votre site.

Boite d’édition multilingue d’un raccourci {PNG}

Il ne vous reste plus qu’à compléter les différents champs. Dans l’exemple multilingue ci-dessus, la version française du texte de votre raccourci est à placer à la droite de [fr].

Si votre site n’est pas multilingue, ou s’il n’utilise qu’une seule langue, seul le texte de la langue utilisée apparaît. Il est inutile dans ce cas d’envelopper le contenu du raccourci par le tag "multi".

Boite d’édition d’un raccourci pour un site unilingue {PNG}

Annulez (petite croix) ou validez (petit V) pour afficher le contenu du raccourci.

Contenu modifié du raccourci {PNG}

La petite croix à droite du contenu indique que le raccourci a été personnalisé. Vous pouvez cliquer sur cette petite croix pour supprimer cette personnalisation.

Contenu original du raccourci {PNG}

La petite croix disparaît, signifiant que le contenu du raccourci affiché est le contenu original.

Les fichiers de traduction propres à votre site

Après installation et configuration du RaPer les fichiers de traduction situés dans vos squelettes ne sont plus pris en compte. Il vous faut recopier les raccourcis personnalisés (ceux de votre local_fr.php, etc.) dans les préférences du RaPer.

Ne supprimez pas vos fichiers de traductions. Ils vous seront peut-être utiles si vous désinstallez RaPer. De plus, ils sont utilisés par le RaPer pour retrouver la traduction originale.

Pour recopier vos traductions dans les préférences du RaPer, deux solutions :

  • recopier vos fichiers de traductions dans le dossier lang/ du plug-in ;
  • utiliser l’interface d’édition du RaPer en ajoutant un à un vos raccourcis personnalisés.

Si un raccourci est issu du fichier local au squelette (local_fr.php, etc.) il est entouré d’un petit filet rouge en pointillé.

Sauvegardez vos raccourcis

Pensez à sauvegarder de temps à autres les fichiers de traduction du RaPer. Ils sont situés dans le dossier lang/ du plug-in. Leur nom commence tous par "local".

Pré-requis techniques

RaPer utilise fortement la technologie Ajax en page d’édition, espace privé. La librairie jQuery v.1.1 fournie avec SPIP 1.9.2 est une version ancienne qui pose quelques problèmes de lenteur. Pour profiter pleinement de la fluidité offerte par Ajax, il est largement conseillé de mettre à jour jQuery sur votre site en SPIP 1.9.2. Pour mettre à jour jQuery, vous pouvez vous inspirer de ce mémo.

Désinstaller RaPer

RaPer n’écrit que dans un seul champ de la table spip_meta : "raper_preferences".

Pour le désinstaller, il suffit d’aller sur la page d’administration des plug-ins et de cliquer sur la petite valise du RaPer pour effacer ses préférences.

Attention : un click sur la petite valise, puis sur "Effacer TOUT" supprime également les fichiers de traduction du RaPer. Si vous ne désirez pas supprimer ces fichiers de traduction tout en désactivant le plug-in, ne cliquez pas sur la petite valise, décochez simplement la petite case à gauche du nom du plug-in.

Liens utiles

— Documentation sur le multilinguisme pour SPIP et sur l’internationalisation des squelettes ;
— La zone, où vous trouverez d’autres plug-ins pour SPIP.

Plussoyez !

Les forums sont fermés.

  • Surcharger les raccourcis texte 5 mars 2009 17:57, par tetue
    Attention, ce plugin concerne les « chaînes de langue » et non les « raccourcis SPIP » !

    Les forums sont fermés.

    • Surcharger les raccourcis texte 6 mars 2009 11:51, par Christian PAULUS

      Comme précisé en titre, il s’agit ici de raccourcis « texte » et non de raccourcis typographiques.

      En interface privée (192g)  ?exec=lang_raccourcis le texte de présentation précise qu’il est question de raccourcis. D’où l’appellation choisie.

      Les forums sont fermés.

  • Surcharger les raccourcis texte 16 mars 2009 17:57, par AlainF

    Bonjour et merci pour ce plugin,
    en effet cet outil est vraiment formidable et correspond à mes besoins.

    J’ai fais une copie de "squelettes/local_fr.php" dans "/plugins/auto/raccourcis_texte_perso/lang/"

    dont le contenu est :

    <?php

    // This is a SPIP language file  --  Ceci est un fichier langue de SPIP

    $GLOBALS[$GLOBALS['idx_lang']] = array(

    // 404
            '404_1' => 'D&eacute;sol&eacute; aucun article, br&egrave;ve ou rubrique disponible sur cette page',
            '404_2' => 'Ou vous voulez aller ?',
            '404_home' => 'Page d\'accueil',
            '404_lastpage' => 'Derni&egrave;re page consult&eacute;e',

    //A
    'accueil' => 'Accueil',
    'actualite' => 'l\'actualit&eacute;',       
    'article_s' => 'Article(s)',

    .............

    //Z
    );
    ?>

    J’ai également coché, dans :/ecrire/ ?exec=raper_configure,
    - Gérer les raccourcis publics de SPIP.
    - Gérer les raccourcis locaux (squelettes/ ou racine).

    Mais il ne trouve pas cette page local_fr.php

    Que dois-je faire sans reprendre tous ces éléments un par un, par avance, merci

    Alain

    Les forums sont fermés.

  • Surcharger les raccourcis texte 31 décembre 2010 15:47, par doriaN

    merci pour ce plugin pour le faire fonctionner avec 2.1 il faut changer l’appel de la fonction plugin_get_infos dans le fichier raper_api_prive ligne 227

    if(version_compare($GLOBALS['spip_version_code'],'15375','>=')) {
    $get_infos = charger_fonction('get_infos','plugins');
    $info = $get_infos(_DIR_PLUGIN_RAPER);
    }
    else {
    $info = plugin_get_infos(_DIR_PLUGIN_RAPER);
    }

    à la place de $info = plugin_get_infos(_DIR_PLUGIN_RAPER);

    cdt

    Les forums sont fermés.

    • Surcharger les raccourcis texte 31 décembre 2010 15:59, par Christian PAULUS
      Ok. Correction apportée. Merci.

      Les forums sont fermés.

      • Surcharger les raccourcis texte 8 décembre 2011 20:22, par Joseph Tux

        avec SPIP 2.1.12

        Le plugin semble fonctionner, mais ne garde pas la mémoire des modifications.

        Une modification est possible et cochée comme enregistrée, mais sans effet.

        Lorsque la coche indique la modification, le nombre de textes modifiables (en haut à gauche) ne change pas ;

        Lorsqu’un 2eme texte est coché, le 1er est décoché ;

        Bref aucun effet malgré une interface "propre".

        Merci pour ce plugin, pour moi encore très prometteur ;)

        Les forums sont fermés.