SPIP-Contrib

SPIP-Contrib

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

273 Plugins, 191 contribs sur SPIP-Zone, 52 visiteurs en ce moment

Accueil du site > Outils pour plugins > Le Couteau Suisse > Les Boîtes Privées

Les Boîtes Privées

3 janvier 2008 – par Joseph, Patrice Vanneufville – 22 <blink style='color:red;'>public|spip|ecrire:commentaires</blink>

16 votes

Les « Boîtes Privées » sont des cadres qui peuvent apparaître selon vos souhaits ici ou là dans la partie privée de votre site et vous donner des renseignements parfois fort utiles : Les articles au format SPIP, Les auteurs en stat, Les URLs propres, Les tris d’auteurs, Les révisions du Couteau Suisse, etc.

Présentation

Les « Boîtes Privées » sont des cadres bien pratiques qui peuvent apparaître selon vos souhaits ici ou là dans la partie privée de votre site.

Actuellement, nous pouvons vous proposer les boîtes suivantes :
-  Les révisions du Couteau Suisse
-  Les articles au format SPIP
-  Les auteurs en stat
-  Voir les URLs propres
-  Et pourquoi pas : ajouter une « boîte privée perso »

Installation

L’outil décrit ici est une fonctionnalité du plugin « Le Couteau Suisse » que vous pouvez trouver ici : Le Couteau Suisse.

Pour avoir accès aux diverses boîtes décrites dans cet article, il vous faut donc avoir préalablement installé ce plugin en suivant la procédure normale d’installation des plugins SPIP.

Ensuite, veuillez activer l’outil « Boîtes Privées » en vous rendant sur la page d’administration du plugin en espace privé (Bouton Configuration, et onglet "Le Couteau Suisse").

Une fois cet outil activé, vous aurez enfin la possibilité de choisir vos boîtes, chacun étant dés/activable.

Les révisions du Couteau Suisse

Le Couteau Suisse est un plugin qui évolue beaucoup ces temps-ci et il peut être intéressant d’en suivre les évolutions au fur et à mesure. Ici, vous pouvez trouver un historique automatique en format texte.

Exemple de boîte :

Où est donc cette boîte ?

Sur la page de configuration du Couteau Suisse (ecrire/?exec=admin_couteau_suisse), vous la trouverez dans un cadre à gauche si vous êtes en interface "Petit écran" ou à droite si vous êtes en interface "Grand écran".

Les articles au format SPIP

Lorsque l’on souhaite copier tout ou partie d’un article dans un autre article, il est nécessaire d’éditer cet article pour y avoir accès dans sa forme brute, c’est-à-dire avec les raccourcis typographiques de SPIP non traités.

Outre le fait que cela est parfois fastidieux, un rédacteur qui n’est pas autorisé à éditer un article ne pourra pas avoir accès à sa forme brute. Dans certaines situations, notamment sur des sites collaboratifs, il est nécessaire que les rédacteurs puissent copier le contenu d’autres articles. Par exemple, si l’on travaille avec des modèles d’articles, il est bon qu’un rédacteur puisse copier le modèle dans un nouvel article sans pour autant pouvoir le modifier. Dans d’autres situations par exemple, un secteur peut correspondre à des documents ressources qui seront réutilisés pour la rédaction d’analyses dans d’autres secteurs du site.

Cette boîte permet donc de copier le contenu d’un article avec ses raccourcis typographiques sans avoir à l’éditer.

Auteur : Joseph LARMARANGE

Où est donc cette boîte ?

Sur la page d’un article dans l’espace privé (ecrire/?exec=articles), vous trouverez sous les mots-clés une boîte intitulée Texte au format SPIP. Quand on la déplie apparaît le texte brut du descriptif, du chapeau, du texte principal et du post-scriptum de l’article (voir capture d’écran ci-dessous). Il est alors aisé de copier la totalité ou une partie du texte pour ensuite le coller dans un autre article. Cette boîte est accessible que l’on soit ou non autorisé à éditer l’article en question. Il faut juste être autorisé à visualiser l’article dans l’espace privé [1].

Et dans l’espace public ?

SPIP vous fournit la solution de manière native. En effet, pour court-circuiter les traitements typographiques de SPIP et afficher le contenu d’un champ tel qu’il est enregistré dans la balise de données, il suffit de rajouter une astérisque ou * à votre balise. Par exemple #TEXTE* pour afficher le texte brut d’un article. Pour plus de détails, voir la documentation officielle de SPIP.

Les auteurs en stat

Cette boîte renseigne les administrateurs (uniquement) du site sur :
-  Les derniers auteurs connectés
-  Les insriptions non confirmées

Vous avez accès dans ce cadre aux dates de connexion et aux liens adéquats.

Exemple de boîte :

Où est donc cette boîte ?

Sur la page des auteurs (ecrire/?exec=auteurs), vous la trouverez dans un cadre à gauche si vous êtes en interface "Petit écran" ou à droite si vous êtes en interface "Grand écran".

Depuis la version 1.8.14.03 du plugin, cette boîte utilise le fond fonds/derniers_connectes.html. Si vous souhaitez surcharger ce fichier, recopiez-le dans le dossier fonds/ de votre squelette avant de le modifier à votre guise.

Les webmestres SPIP

Cette boîte renseigne les administrateurs (uniquement) du site sur :
-  Les administrateurs promus webmestres

Vous avez accès dans ce cadre aux identifiants et aux liens adéquats.

Exemple de boîte :

Où est donc cette boîte ?

Sur la page des auteurs (ecrire/?exec=auteurs), vous la trouverez dans un cadre à gauche si vous êtes en interface "Petit écran" ou à droite si vous êtes en interface "Grand écran".

Voir les URLs propres

Ce cadre dépliable indique l’URL propre associée aux objets de contenu et calculée d’après leur titre. Les alias d’URLs que SPIP 2.0 permet d’ajouter sont également listés. Vous pourrez donc connaître grâce à cette boîte, le lien public principal que SPIP utilise lors d’une demande d’accès à l’objet en question.

L’outil « Format des URLs » vous permet une configuration fine des URLs. Les URLS propres ne sont pas utilisées si vous choisissez l’un des format d’URLs suivants : html, page, standard.

Exemple de boîte :

Où est donc cette boîte ?

Sur chaque page concernant un objet de contenu SPIP (article, rubrique, auteur, brève, mot-clé, site...)

Les tris d’auteurs

Ce cadre dépliable pour les articles contenant plus d’un auteur et permettant simplement d’en ajuster l’ordre d’affichage. Ceci est utile pour placer par exemple l’auteur original ou principal d’un article en toute première position.

Exemple de boîte :

Attention : le tri des auteurs que vous avez défini manuellement n’est pas pris en compte lorsque votre boucle (AUTEURS) comporte un critere de tri. Vérifiez bien vos squelettes et vos modèles. Exemples :

Boucle triée selon vos spécifications :
<BOUCLE_auteurs(AUTEURS){id_article}{","}>#NOM</BOUCLE_auteurs>
Boucle triée par nom d'auteur :
<BOUCLE_auteurs(AUTEURS){id_article}{par nom}{","}>#NOM</BOUCLE_auteurs>

Par défaut, SPIP v3.0 trie les auteurs par nom.

Où est donc cette boîte ?

Pour l’instant, sur la page d’un article rédigé par au moins 2 auteurs. Mais dès SPIP v3.0, il est possible d’étendre cette fonctionnalité à d’autres objets liés à des auteurs : parlez-en dans le forum ci-dessous si besoin est !

Et pourquoi pas : ajouter une « boîte privée perso » !

Il est possible, depuis la version 1.8.09.02 du plugin, d’ajouter facilement une boîte privée de votre fabrication dans l’espace privé. L’outil « Boîtes Privées » va scruter les globales boites_privees_gauche, boites_privees_milieu et boites_privees_droite afin d’insérer automatiquement votre boîte dans les pipelines de SPIP : affiche_gauche, affiche_milieu et affiche_droite. Ces trois globales doivent contenir un tableau de fonctions déclarées comme ceci : function ma_boite_privee($flux, $exec)

Un exemple étant parfois mieux qu’un long discours, voici un extrait de code à ajouter dans un mes_options (config/mes_options.php par exemple) :

  1. $GLOBALS['boites_privees_gauche'][] = 'ma_boite_privee';
  2. function ma_boite_privee($flux, $exec) {
  3.         return $flux
  4.                 . debut_boite_info(true)
  5.                 . 'Youpi !!'
  6.                 . fin_boite_info(true);
  7. }

Notez que :
-  le paramètre $flux contient l’ensemble du code HTML passé de plugin en plugin. N’en parlez à personne, mais en plus d’ajouter une boîte perso, vous pouvez également modifier le code des boîtes privées déposées par les plugins en amont, et notamment celles du Couteau Suisse lui-même... Chuuuut !
-  le paramètre $exec contient le nom de la page en cours, vous permettant éventuellement de mieux cibler le contexte d’affichage de votre boîte.

A titre d’indications, SPIP offre tout un panel de fonctions de cadres (étudiez le fichier ecrire/inc/presentation.php ) :

function debut_boite_info($return=false)
function fin_boite_info($return=false)
function debut_cadre_relief($icone='', $return = false, $fonction='', $titre = '', $id="", $class="")
function fin_cadre_relief($return = false)
function debut_cadre_enfonce($icone='', $return = false, $fonction='', $titre = '', $id="", $class="")
function fin_cadre_enfonce($return = false)
function debut_cadre_couleur($icone='', $return = false, $fonction='', $titre='', $id="", $class="")
function fin_cadre_couleur($return = false)
etc. !

Afin de rester compatible avec toutes les versions de SPIP, le Couteau Suisse a harmonisé le dépliement de ses boîtes privées grâce à la fonction suivante :

function cs_cadre_depliable($titre, $id_alpha, $texte)

Notes

[1Ce qui est le cas par défaut pour les rédacteurs sauf si l’on a recours à des plugins de restriction d’accès.

Retour en haut de la page

Vos commentaires

  • Le 9 mars 2010 à 13:02, par kris En réponse à : connexion visiteur donne toujours le 0/00/00 à 00h00

    Bonjour Patrice,
    J’ai toujours le même problème :-/
    J’ai mis à jour le plugin (1.8.15), et retenté en créant un nouveau visiteur, connecté puis déconnecté, rien n’y fait !
    C’est comme si effectivement l’enregistrement ne s’effectuait pas...

    Il s’agit d’un article (article.html) protégée par :

    if ($auteur_session) {
    blah blah
    } else {
    #LOGIN_PUBLIC
    }

    Sont activées : Les stats, l’inscription des visiteurs, et un article possède un forum sur abonnement...

    Une idée ?

    • Le 9 mars 2010 à 19:42, par Patrice Vanneufville En réponse à : connexion visiteur donne toujours le 0/00/00 à 00h00

      J’ai également remarqué ce pb sous SPIP 2.0.10 : le passage sur le site de certains auteurs ne sont parfois pas enregistrés. En fait, le champ ’en_ligne’ n’est pas renseigné en base, il est simplement mis à zéro. Sans doute faudrait-il circonscrire le bug pour le rendre reproductible et écrire un nouveau ticket pour les devs de SPIP.

      Rappel : Le Couteau Suisse ne fait que lire les infos en base stockées par SPIP.

    Répondre à ce message

  • Le 22 février 2010 à 16:25, par kris En réponse à : Connexion visiteur

    Merci Patrice (sifflement admiratif) !
    Quelle réactivité... Décidément, spip et sa communauté ont de la chance ;-)
    Je vais voir ce que je peux faire (probablement pas aujourd’hui...), et te tiens au courant.

    Encore bravo !

    Répondre à ce message

  • Le 22 février 2010 à 14:26, par kris En réponse à : Connexion visiteur

    Bonjour Patrice,
    Oui j’ai testé, et la dernière connexion du visiteur que j’ai créé pour l’occasion me donne : le 0/00/00 à 00h00
    Pourtant, je me suis connecté puis déconnecté...
    Est-ce le cookie qui interprète la session comme « en cours » ?

    • Le 22 février 2010 à 14:31, par Patrice Vanneufville En réponse à : Connexion visiteur

      Aucune idée pour ma part... J’allais dire que c’est « à SPIP » de demander ça... Car la boîte ici se borne à scruter la base de donnée et je ne peux pas te dire comment cette base est tenue à jour...

    • Le 22 février 2010 à 16:06, par Patrice Vanneufville En réponse à : Connexion visiteur

      Pour info, je viens de passer cette boîte en fond surchargeable, au cas où ça t’intéresse. J’ai modifié l’article ci-dessus.

      Pour ce qui est des visiteurs, il s’agit du champ ’en_ligne’ qui est ici récupéré. SPIP ne le met peut-être pas à jour ?

    Répondre à ce message

  • Le 22 février 2010 à 12:45, par kris En réponse à : connexion des visiteurs

    Bonjour,
    La boite « connexions » permet-elle d’afficher les dates de connexion des auteurs ayant le statut de « visiteur » ?
    Merci :)

    Répondre à ce message

  • Le 20 août 2009 à 11:54, par goetsu En réponse à : Les Boîtes Privées

    personnellement sur un spip 2.0.9 la boite gestion des urls ne s’affiche pas

    • Le 23 août 2009 à 23:04, par Patrice Vanneufville En réponse à : Les Boîtes Privées

      Merci du retour. Cette boîte ne fonctionne effectivement plus depuis le 13 février à cause d’une grosse fôte de frappe dans le code... La version 1.8.09.04 du plugin devrait corriger le problème.

    Répondre à ce message

  • Le 19 juillet 2008 à 09:33, par Philippe G. En réponse à : Les Boîtes Privées

    Bonjour,

    J’ai mis récemment un mail sur le forum g.c.w.s.devel de SPIP sans résultat jusque là... Je le recopie (en gros) ici :

    J’ai - semble-t-il - un problème avec le couteau suisse. J’utilise la dernière version 1.7.18.03 (au moment où j’écris) avec une SPIP 192d.
    Problème : quand je veux éditer un auteur j’ai le message suivant :


    Warning : boites_privees_affiche_droite(../plugins/couteau_suisse/cout_fonctions) [function.boites-privees-affiche-droite] : failed to open stream : No such file or directory in /var/www/virtual/catholique-saint-brieuc.cef.fr/brieucbr/plugins/couteau_suisse/outils/boites_privees.php on line 26

    Warning : boites_privees_affiche_droite() [function.include] : Failed opening ’../plugins/couteau_suisse/cout_fonctions’ for inclusion (include_path=’. :/usr/share/php :/usr/share/pear’) in /var/www/virtual/catholique-saint-brieuc.cef.fr/brieucbr/plugins/couteau_suisse/outils/boites_privees.php on line 26

    Fatal error : Call to undefined function : cs_lien() in /var/www/virtual/catholique-saint-brieuc.cef.fr/brieucbr/plugins/couteau_suisse/outils/boites_privees.php on line 96


    J’ai pu corriger cela en dévalidant les « Boites privées » du couteau suisse. J’ai eu cela sur plusieurs sites avec les mêmes configurations...

    Merci pour vos éclaircissements,
    Cordialement,

    Philippe

    • Le 29 août 2008 à 19:11, par Jean-Pierre Catusse En réponse à : Les Boîtes Privées

      Bonjour Philippe,
      Avec le meme environnement (SPIP 1.9.2d, couteau suisse 1.7.18.03), j’ai eu les memes pbs. En fait, seule la boite « Les articles au format SPIP » était OK.
      J’ai mis à jour en 1.7.18.04 (depuis http://files.spip.org/spip-zone/) et là, la boite « les auteurs en stats » marche, la 3ème (les révisions) donne des warnings similaires.

      Donc, si seules les 2 premières boites t’intéressent, la rev 1.7.18.04 est la solution. Il suffit de désactiver la boite « révisions » dans la configuration des boites privées depuis la page admin du Couteau Suisse.

      Je pense que certaines boites privées ne sont pas encore stabilisées, et donc à suivre.
      Si quelqu’un a une piste ou info, merci d’avance.

    • Le 1er septembre 2008 à 16:34, par Jean-Pierre En réponse à : Les Boîtes Privées

      Bonjour,
      Je complète et corrige. Les trois options marchent avec la révision 1.7.18.04, y compris les révisions.
      Merci aux développeurs pour leur révision.

    Répondre à ce message

  • Le 19 juillet 2008 à 10:03, par Pierre kuhn En réponse à : Les Boîtes Privées

    Bonjour

    est ce qu’il serais possible de modifier le nombre des stats de la boite privé, que chacun puisse la réglé à sa guise

    Répondre à ce message

  • Le 5 janvier 2008 à 18:38, par saintvinasse2 En réponse à : Les Boîtes Privées

    Bon, si je comprend bien, il n’est pas très simple de faire ses boîtes perso... Serait-il possible de faire des boites avec boucles...

    Je m’explique, il m’est souvent demandé de faire des tutoriels d’utilisation de l’espace privé, particulièrement lorsque ce dernier risque d’être utilisé par un grand nombre de personnes...

    Idéalement, je mettrais une boucle récupérant les articles contenu dans une rubrique « tutorial » ou, au moins, un lien vers cette rubrique...

    Des idées ou pistes ?

    Je suis nul en PHP.

    Merci

    • Le 7 janvier 2008 à 10:47, par Patrice Vanneufville En réponse à : Les Boîtes Privées

      Dans ce cas, une bonne doc avec copies d’écrans, non ?

      En ce qui concerne la lame perso, voici un exemple qui ajoute des cadres de tuto bien flashies dans la colonne de droite en partie privée :

      1. ############## COUTEAU SUISSE : LAME PERSO #################
      2.  
      3.  // Installation d'une nouvelle lame personnalisee
      4.  $GLOBALS['mes_outils']['mes_boites'] = array(
      5.         'nom'         => 'Mes bo&icirc;tes priv&eacute;es',
      6.         'description' => 'Une lame qui ajoute des cadres de tuto ici ou l&agrave; dans l\'espace priv&eacute;.',
      7.         'categorie'   => 'admin',
      8.         'pipeline:affiche_droite'   => 'mes_boites_affiche_droite',
      9.         'code:css' => '.mes_boites {background-color:yellow; border:3px solid yellow; color:blue; float:right; font-size:85%; padding:5px; width:100%;}',
      10.  );
      11.  
      12.  // Fonction de pipeline
      13.  function mes_boites_affiche_droite($flux) {
      14.         switch($flux['args']['exec']) {
      15.                 case 'auteurs':
      16.                         $flux['data'] .= '<div class="mes_boites"><p><b>Tutoriel</b></p>'
      17.                                 . "<p>Ici, vous &ecirc;tes dans l'espace r&eacute;serv&eacute; aux auteurs !</p>"
      18.                                 . '</div>';
      19.                         break;
      20.                 default:
      21.                         break;
      22.         }
      23.         return $flux;
      24.  }

    Répondre à ce message

  • Le 3 janvier 2008 à 22:26, par Samy En réponse à : Les Boîtes Privées

    On peut en faire facilement soi même, de ces boites ?

    • Le 4 janvier 2008 à 18:41, par Joseph En réponse à : Les Boîtes Privées

      Tout dépend du contenu de chaque boîte mais c’est relativement simple. Le couteau suisse étant développé sur la zone, il est possible d’en proposer de nouvelles.

    • Le 4 janvier 2008 à 19:27, par Samy En réponse à : Les Boîtes Privées

      Sans vouloir faire le rabat-joie, pourrais tu m’indiquer où les trouver ? Y a un t il un sous-dossier « boites » dans le dossier SVN du couteau suisse ?

    • Le 4 janvier 2008 à 19:38, par Patrice Vanneufville En réponse à : Les Boîtes Privées

      C’est pas si simple ;-) Les boîtes privées viennent tout juste d’être développées. Elles peuvent encore progresser !

      Ce qui est facile, c’est ajouter une lame perso : voir ici

      Je ne cerne pas dans ta question si tu veux ajouter des boîtes intéressantes et natives au Couteau Suisse, ou si tu veux ajouter une boîte très perso qui ne servira qu’à toi...

      Quelles idées as-tu derrière la tête ? Les deux voies sont possibles...

    • Le 4 janvier 2008 à 20:07, par Samy En réponse à : Les Boîtes Privées

      C’est plutot des boîtes persos (qui pourraient être intégrées au CS au final), mais pas des nouvelles lames.

    • Le 4 janvier 2008 à 21:37, par Patrice Vanneufville En réponse à : Les Boîtes Privées

      Actuellement, il n’y a pas de mécanisme simple qui permet d’ajouter à la volée une boîte perso à l’outil « Boîtes Privées ».

      Le fichier qui gère les boîtes « Auteurs en stat » et « Format SPIP » est : « outils/boites_privees.php », le fichier qui déclare les boites est « config_outils.php » (ligne 360), le fichier qui gère la description est « lang/desc_fr.php » (ligne 394) et celui qui gère les chaines de langue est : « lang/cout_ ??.php » (ligne 10).

      Tu as donc les 4 fichiers à modifier si tu veux vraiment ajouter une boîte privée de ton cru, sachant qu’un fork des fichiers originaux du Couteau Suisse te prive de toute mise à jour ultérieure, ce qui est fortement déconseillé. A moins que tu fasses profiter la communauté de tes travaux... Et nous sommes toute ouïe !

      Bon, si vraiment ta boite privée est très très privée, je te conseille simplement de construire une lame perso dans config/mes_options.php et utiliser les pipelines déclarés dans couteau_suisse/plugin.xml.

    Répondre à ce message

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

  • Une licence pour un article

    18 avril 2007 – 25 <blink style='color:red;'>public|spip|ecrire:commentaires</blink>

    Sur une idée originale de erational, voici un plugin permettant de lier une licence à un article.

  • Plugin Parrainage

    6 novembre 2011 – <blink style='color:red;'>public|spip|ecrire:commentaire</blink>

    Permettre aux utilisateurs d’inviter leurs contacts à s’inscrire sur le site. Description Vous connaissez le web moderne et son cortège d’applis toujours en version « beta » et de buzz sur le dernier réseau à la mode ? Vous voulez vous aussi vous y (...)

  • Formulaire de contact libre

    27 avril 2011 – 36 <blink style='color:red;'>public|spip|ecrire:commentaires</blink>

    Dans SPIP il n’y a pas un formulaire de contact, mais autant de formulaires de contact que d’auteurs. Cette phrase de Romy, dans son article Une page de contact dans mon SPIP, pointe un petit manque de SPIP. La possibilité d’insérer rapidement un (...)

  • Plugin Mot de Passe Compliqué

    2 novembre 2007 – 16 <blink style='color:red;'>public|spip|ecrire:commentaires</blink>

    Ce plugin ajoute un testeur de complexité de mot de passes dans les formulaires de choix de mot de passe de SPIP.

  • Navigation AJAX

    31 janvier – 18 <blink style='color:red;'>public|spip|ecrire:commentaires</blink>

    Ce plugin permet de modifier automatiquement une parties des liens internes de manière à ce qu’ils ne déclenchent pas un chargement complet de la page cible, mais un chargement en AJAX de certains éléments spécifiés à l’avance. Il permet aussi de (...)