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>
Plugin Flattr pour SPIP
<site|flattr>
21 Messages de forum