Accueil du site > SPIP > Plugin Flattr pour SPIP

Plugin Flattr pour SPIP

mercredi 1er septembre 2010, par Fil

Toutes les versions de cet article : [English] [français]

Comme promis dans l’article Flattr-ies et Kurbettes, voici un plugin facilitant l’intégration dans SPIP du système de microdons Flattr.

Téléchargement

Le plugin est développé sur SPIP-Zone, disponible via la commande

svn co svn://zone.spip.org/spip-zone/_plugins_/flattr/

On trouvera aussi le plugin sous forme de ZIP à l’adresse http://files.spip.org/spip-zone/fla...

Version courante : 0.2

Configuration

Ce plugin se configure avec CFG ; on y indique le UserID du compte Flattr qui recevra les microdons. On peut aussi préciser le type de contenus qu’on propose sur le site, dans la nomenclature de Flattr : text, images, video, audio, software...

Intégration

Pour l’intégrer à son site SPIP, on utilise un modèle article_flattr.html ; ce modèle peut s’intégrer :
— au cas par cas, en saisissant dans le corps ou le post-scriptum d’un article un contenu du type <article66|flattr> ;
— dans un squelette (par exemple extra/article.html en y indiquant #MODELE{article_flattr,id_article}.

Un autre modèle permet de flattr la page d’accueil du site : <site|flattr> ou #MODELE{site_flattr}.

Note sur le javascript. Le bouton standard que propose Flattr ne convient pas, car tel un mouchard il envoie chaque visiteur de votre site sur le site Flattr.com ; en termes de privacy c’est assez inacceptable. Nous avons donc dans ce plugin un JS un peu plus élaboré, qui ne contacte Flattr.com que lorsque l’utilisateur appuie sur le bouton. Le JS principal est servi par votre site ; vous pouvez, si vous mettez le bouton partout, l’intégrer dans votre inc-head ; dans le cas contraire, il sera chargé à la demande en fonction du besoin, lors du survol du bouton.

Paramétrage

Les paramètres par défaut du bouton sont :
— title : titre de l’article.
— description : descriptif de l’article, coupé à 1000 car.
— uid : User ID configuré dans le CFG
— hidden : true ou false (CFG)
— button : default
— tags : mots-clés de l’article
— category : text (ou autre, défini dans CFG)

Il est possible de modifier ces paramètres en les passant directement au modèle, ainsi par exemple si l’article 67 représente une vidéo, on indiquera :

<article67|flattr|category=video>

Si un article correspond à une flatterie pour un autre auteur que celui défini dans le CFG, on passera son uid au modèle :

<article67|flattr|uid=2106>

Idem pour les autres paramètres.

A noter : si vous ne créez pas vos ‘things’ à la main depuis l’interface de Flattr, ils sont créés lors du premier microdon effectué dessus à partir de votre site. Dès lors qu’un article (à une certaine URL) a été créé dans Flattr, ses paramètres sont figés ; vous pouvez encore les éditer, mais uniquement à partir de votre dashboard sur le site Flattr.

Démo

Le bouton est en action ici-même :

<article66|flattr|category=software>

<site|flattr>

21 Messages de forum

  • Plugin Flattr pour SPIP Le 3 septembre 2010 à 16:50 , par Milhouse

    Sous quelle licence est le plugin ?

    • Plugin Flattr pour SPIP Le 3 septembre 2010 à 16:56 , par Fil

      J’ai marqué GNU/GPL mais si tu veux autre chose n’hésite pas à demander ; il n’y a rien de particulièrement valable dans le code :-)

  • Plugin Flattr pour SPIP - merci ! Le 7 septembre 2010 à 18:51 , par Suske

    Installé via le modèle dans le squelette de mon spip-clear, le plug occasionnait une erreur js sur la description : un \n provoquait le renvoi à la ligne du guillemet fermant et de la virgule => erreur.

    Cela a disparu quand j’ai ajouté un |couper : description: "[(#ENV{description}|couper{250}|texte_backend)]",.

    A priori, c’est lié au fait que j’utilise le champs descriptif, lequel est court et donc intégré complètement. SPIP ajoute alors un saut de ligne ?

  • Plugin Flattr pour SPIP Le 8 septembre 2010 à 20:18 , par baroug

    Moi je flaterriserai quand le designer du site l’aura updaté un peu là

    • Plugin Flattr pour SPIP Le 24 septembre 2010 à 15:06 , par Fil

      Moi je ne mettrai à jour que quand le designer aura flattré.

  • Plugin Flattr pour SPIP Le 11 septembre 2010 à 08:30 , par davduf

    Mon cher Fil,

    Aie, je rencontre quelques soucis :-(
    www.davduf.net

    Tout fonctionne bien, semble-t-il, si un article a déja été « flattré ». En survolant le logo Flattr, on découvre le nombre de flatteries et on peut flattrer à son tour.

    J’utilise dans mon squelette :
    #MODELEarticle_flattr,id_article

    Si l’article en question n’a jamais été flattré, on découvre au survol le chiffre « zéro » (normal) mais on ne peut pas flatter... Le logo ne renvoie pas à l’url de flatter...

    C’est mon probleme n°1 ,-)

    Autre problème, dans la colonne de droite de tout le site (breve, article, rubrique, etc), je mettais un bouton flatter dans un encadré appelé partout par un inc. Depuis l’installation du plug in, le logo flattr apparait mais un "error" survient au survol...

    En gros, comment faire pour mettre un logo flatter « général » à un site en plus d’un bouton flattr spécifique à chaque article ?

    Là, j’utilise (mal ?) :
    #MODELEflattr

    Pour tout dire, je soupçonne mes incompétences, notamment au niveau du JS. J’ai copié collé l’intégralité du fichier flattr-load-06.js dans mon inc-head.html, et ce fut pire encore...

    Merci encore pour tout ! ,-)

    • Plugin Flattr pour SPIP Le 11 septembre 2010 à 09:41 , par Fil

      Hé bien :

      1. je viens de flattrer http://www.davduf.net/Prison-Valley-Prix-du.html avec succès ;
      2. le modèle ne fonctionne que si tu lui passes l’id_article ; peut-être est-ce que ton inc- ne connaît pas cette valeur ? Essaie de mettre #ID_ARTICLE juste devant pour voir s’il s’affiche ; le cas échéant ajoute {id_article} dans ta commande INCLUDE.
      3. pour flattrer le site il faut que tu mettes à jour le plugin en version 0.2 ; tu pourras ensuite utiliser #MODELE{site_flattr} dans un squelette, ou <site|flattr> dans un article.
  • Plugin Flattr pour SPIP Le 11 septembre 2010 à 14:35 , par davduf

    Hé bien, hé bien...

    Alors, pour ce qui concerne le second problème (un bouton flatter « générique » sur toutes les pages), la version 0.2 a tout résolu ! Top.

    En revanche, toujours un soucis chez moi : impossible de flatter un article s’il n’a déjà été flatté. Le logo flatter passe à « zéro » mais il n’est pas cliquable...

    Ex :
    http://www.davduf.net/Reclame-et-droit-moral-a-propos-de.html

    J’ai mis

    #MODELEarticle_flattr,id_article


    dans le corps même du squelette (sans include) et j’ai fais tout comme tu dis (mise à jour en 0.2, etc)

    Merci encore ,-)

  • Plugin Flattr pour SPIP Le 11 septembre 2010 à 14:47 , par davduf

    Ça y est -) J’ai compris mon erreur, tout est de ma faute, maxi mea culpa.
    En fait, c’est très bien fait, on ne peut pas d’auto-flattrer. Du coup, ça ne marchait pas, chez moi, tant que j’étais loggé avec mon compte chez Flatter.

    Bref, en me déloggant, ça marche du feu de Spip.

    Merci !

  • Plugin Flattr pour SPIP Le 28 septembre 2010 à 16:44 , par tetue

    Le bouton flattr n’est pas affiché sous Internet Explorer (7 en l’occurrence) ni ici, ni chez davduf, ni sur imflattrd.com...

  • Plugin Flattr pour SPIP Le 14 novembre 2010 à 17:21 , par tetue

    Ayé, Flattr est adopté chez moi :-)

    J’ai mis le plugin à jour car le boutton Flattr a changé dernièrement. Mais ce changement accentue certains défauts ergonomiques :

    • contrairement aux autres boutons Flattr croisés sur le Web, celui intégré par SPIP n’affiche pas le nombre de clics : il semble donc incomplet et peut donner le sentiment qu’il est défaillant (ce qui est renforcé par sa disparition temporaire lorsqu’on le survole). Afficher le nombre de clic me semble important. C’est informatif et ça m’a par ailleurs poussée au don : quand je vois « 0 » sur un bon article, je ne peux m’empêcher de le flattrer ;-)
    • le bouton statique (image) est plus énigmatique qu’avant : il dit seulement « flattr », sous la bulle, vide, là où il disait avant, plus explicitement « flattr this ». Je ne sais pas trop comment le rendre plus explicite. J’essaye en ce moment chez moi en affichant « J’aime ! » dans la bulle, mais bof...
    • il faut cliquer sur la partie basse pour que le clic soit comptabilisé, et non sur pas sur le chiffre comme c’est le cas en premier réflexe. Ce défaut est natif, mais que le bouton disparaisse préalablement au survol n’arrange rien, car c’est déroutant, et je me plusieurs fois retrouvée à cliquer à répétition comme une brute, sans comprendre pourquoi le compteur n’incrémentait pas.

    Ce sont des « détails » qui, cumulés, peuvent réduire considérablement l’efficacité du truc. Je ne sais pas si on peut faire mieux ?

    • Plugin Flattr pour SPIP Le 14 novembre 2010 à 18:10 , par Fil

      Pour afficher le nombre de clics il faut que le client interroge le site de flattr (il le fait en javascript). Ca permet donc à flattr de savoir qui regarde quoi sur le Web. Personnellement je me refuse à installer ce type de mouchards, qu’il s’agisse du bouton like de facebook, des bidules twitter ou des gravatars chargés en direct..

    • Plugin Flattr pour SPIP Le 14 novembre 2010 à 18:14 , par Fil

      Après ta mise à jour je vois que chez toi c’est super, mais chez moi ça provoque un effet bizarre, comme si l’image était trop grosse. Quant au " ?" c’est en effet pas terrible, comment fait-on pour mettre autre chose ?

    • Plugin Flattr pour SPIP Le 14 novembre 2010 à 21:36 , par Fil

      Pour l’image trop grosse, c’est réglé. Reste le " ?"

    • Plugin Flattr pour SPIP Le 16 novembre 2010 à 12:59 , par tetue
    • Plugin Flattr pour SPIP Le 21 novembre 2010 à 23:27 , par Fil

      Merci, « j’aime » !

  • Plugin Flattr pour SPIP Le 14 novembre 2010 à 23:59 , par Cédric

    Sans vouloir me mêler, je crois que tu pourrais afficher le compteur tout en respectant la vie privée, avec un peu plus de javascript :)

    Il suffirait par exemple de récuperer l’info en js quand quelqu’un clic, et la renvoyer à SPIP pour qu’il l’affiche ensuite aux prochains visiteurs.

    D’ailleurs, tant qu’à faire, il faudrait aussi éviter l’effet de clignotement.

    Cela peut se faire en chargeant l’iframe non visible, et en la switchant quand elle est chargée.

    Ou mieux encore, en prenant en charge en js le clic dans ta page, et à ce moment là seulement charger l’iframe et déclencher le clic en js, puis récuperer le compteur, le mettre à jour dans la page, et renvoyer cela à SPIP.

    Ainsi seuls ceux qui cliquent sont fliqués, et on en profite pour mettre à jour le compteur dans une copie cachée côté SPIP.

    • Plugin Flattr pour SPIP Le 23 novembre 2010 à 23:31 , par Fil

      Oui, mais vu le succès trèèès limité de Flattr je vais avoir d’autres priorités :-)