Ce plugin offre une fonction microblog() que l’on peut utiliser pour envoyer des micro-messages (status) sur les sites de microblog compatibles avec l’API Twitter [1].
La fonction s’utilise comme suit :
include_spip('inc/microblog');
microblog('Bonjour, monde', 'user', 'pass', 'spipo');Si pass est le mot de passe de l’utilisateur user sur le site spipo, un nouveau statut s’affichera.
- affichage sur spip.org
- affichage par jabber
À quoi ça sert-y donc ?
euh... essayons une théorie... faudra surtout voir en pratique.
Soit un ensemble de sources (les sites), et un ensemble de destinataires (des personnes intéressées par ces sources, qu’elles soient webmestres, participants aux forums ou simples lectrices).
Actuellement, chaque source doit écrire individuellement à chacun de ses destinataires ; il faut donc qu’elle en maintienne une liste. De plus cela ne facilite ni l’envoi (qui devient lourd s’il y a beaucoup de destinataires), ni la souplesse de codage (il faut un code pour chaque type de destinataire : email, jabber, SMS, RSS, etc.), ni la souplesse d’utilisation (à l’exception du suivi par RSS, il faut se déclarer sur un site pour pouvoir le suivre).
Le service de microblog (spip.org ou twitter, par exemple) sert de tiers pour la diffusion des nouveautés/alertes. Dès qu’elle a une alerte à envoyer, chaque source notifie le service de microblog, et le service notifie à son tour chaque abonné. C’est le service tiers qui fait le boulot délicat (se connecter au jabber de l’un, au laconi.ca de l’autre, envoyer un rss au 3ème et un mail au 4ème). C’est sur le service tiers que les abonnés indiquent leurs préférences (à quoi ils s’abonnent, comment ils veulent recevoir leurs infos). Bien entendu, si le tiers est planté, tout est planté.
Laconi.ca ou Twitter ?
Le site spip.org fonctionne avec le logiciel libre laconica, qui implémente l’API twitter. L’avantage de laconica est son caractère décentralisé : il est ainsi possible par exemple se créer un compte sur le site identi.ca mais de suivre une source qui « microblog » sur spip.org. L’avantage de twitter est son caractère industriel qui fait que, s’il plante, quelques dizaines d’ingénieurs seront mobilisés dans l’instant pour le remettre en service. A noter qu’il est possible d’utiliser les deux, et même de les faire communiquer.
Support Twitter. Attention depuis le 16 août 2010, twitter.com n’accepte plus l’API traditionnelle, et exige de passer par Oauth. Ce mécanisme est maintenant implémenté dans le plugin microblog, et vous pouvez aussi passer par le proxy supertweet.net.
Mode d’emploi
Une fois le plugin activé, il faut passer sur la page de configuration (.../ecrire/?exec=cfg&cf=microblog) pour renseigner les paramètres suivants :
- le service sur lequel le SPIP doit envoyer les notifications, à choisir parmi les 3 sites suivants : http://spip.org, http://laconi.ca (ces 2 sites utilisent la plate forme de microbloging de laconi.ca) ou le célébrissime http://twitter.com
- le compte ouvert sur ce service sur lequel seront envoyés les notifications (identifiant + mot de passe)
- les évènements qui déclencheront l’envoi d’une notification : pour l’instant 3 types sont disponibles : le post d’un nouveau message de forum, le passage d’un article en mode "Proposé à la publication" et la publication en ligne d’un article.
Pour tester le bon fonctionnement du plugin vous pouvez utiliser le compte d’identifiant spipotest / passe spiptest1 sur le service twitter. Les notifications seront visibles sur http://twitter.com/spipotest, par exemple : une notification d’envoi de forum ou le passage d’un article en mode proposé à la publication et le passage en statut publié de cet article
Attention, si vous choisissez d’envoyer le twitt quand l’article est publié ( cas d’une publication programmée dans le futur), il est nécessaire d’installer le plugin job_queue
Préalable dans le htaccess
Les liens figurant dans les messages générés sont des liens de type "ping" ultra-raccourcis pour ne pas trop empiéter sur les 140 caractères alloués. Typiquement, ils sont du type http://votresite.ext/1234 où 1234 est le numéro de l’article publié. Si votre site SPIP n’est pas récent, le fichier .htaccess n’intègre pas la lecture de ces urls, et il faut ajouter la ligne suivante dans le fichier .htaccess, juste avant la description des urls propres (sur une seule ligne) :
Microbloguer un article
Il est possible d’éditer le message qui sera envoyé, article par article, ou de bloquer l’envoi du message pour un article donné. On peut également relancer a posteriori l’envoi du message.
Lorsque vous visualisez le message avant publication de l’article, celui-ci incorpore une url vers la page d’édition de l’article. Si vous ne modifiez pas le message par défaut, l’url sera remplacée par l’url publique lors de la publication. Mais si vous modifiez le message, faites attention à bien donner une url publique de l’article, car le plugin ne touchera plus à votre message personalisé.
Pour rétablir le message d’origine, il suffit d’effacer complètement votre message personnalisé, et d’enregistrer.
Microbloguer n’importe quoi !
Le plugin propose aussi une interface pour envoyer un message immédiatement à n’importe quel sujet. La page est accessible depuis le menu Publication (il faut utiliser le plugin bandeau).
microblog.zip
Vos commentaires
# Le 8 septembre 2011 à 13:45, par tetue
En réponse à : Microblog
Microblog est un super plugin qui permet de tweeter plus vite que son ombre. Mais, pour être en cohérence avec le flux RSS qui ne les diffuse pas, il devrait ne pas tweeter par défaut les articles publiés en accès restreint.
Répondre à ce message
# Le 27 mai 2011 à 15:10, par balou
En réponse à : Microblog
Bonjour,
J’utilise depuis quelque temps le plugin qui rend tous les services attendus.
Pensez vous intégrer au plugin la possibilité de générer des format URL court de type Bit.ly.
Merci pour ce plugin.
# Le 27 mai 2011 à 15:20, par Fil
En réponse à : Microblog
Non ce n’est pas envisagé ; mais rien n’interdit d’en faire un plugin spécifique
Répondre à ce message
# Le 28 mars 2011 à 21:52, par Shnoulle
En réponse à : Microblog
Juste une petite question : pourquoi pas encore en zip ?
Merci à vous
Répondre à ce message
# Le 3 septembre 2010 à 15:04, par Jonathan
En réponse à : Microblog
Bonjour & déjà Merci pour ce plugin.
J’utilisais auparavant « Spip Loves Twitter » qui fonctionnait très bien jusqu’à ce que l’authentification nécessite Oauth au 1er septembre 2010.
J’ai donc décidé de passer à celui-çi, en me connectant via Supertweet.net.
J’ai réalisé un test manuel de nouvel article publié : Impeccable, ça fonctionne.
Mais ... je récupère pour mon site pas mal d’articles syndiqués (donc déclarés directement en « Publié » et là ... ça ne fonctionne plus ... Les nouveaux articles arrivent, sont déclarés publiés et apparaissent donc sans problème, mais Microblog ne les génère pas ...
Est-ce que vous auriez une solution ..?
Merci
Jonathan
http://www.discolab.fr/
# Le 10 septembre 2010 à 17:34, par micky74
En réponse à : Microblog
Même problème que Jonathan, l’authentification Oauth avec « spip loves twitter » ne fonctionne pas.
La solution que je teste est la suivante :
1- inscription sur http://supertweet.net (proxy de l’API Twitter)
2- dans le document twitter.class.php, remplacer plusieurs fois http://twitter.com par http://api.supertweet.net/1/
3- apparemment il faut désactiver le https (sécurisé) dans la partie admin.
A+
# Le 19 janvier 2011 à 17:37, par bapval
En réponse à : Microblog
Merci pour la solution ! SPIP loves Twitter fonctionne à nouveau chez moi...
Quelques précisions :
2- Il faut rechercher « http://twitter.com/ » et le remplacer par « http://api.supertweet.net/1/ » sinon on se retrouve avec un « // » dans les URLs.
3- Je confirme qu’il faut bien désactiver le https.
Répondre à ce message
# Le 21 décembre 2010 à 18:58, par Pierre
En réponse à : Microblog
J’vais finir par penser que c’est pas pour moi ... J’essaye depuis plusieurs heures/jours, impossible de le faire fonctionner, que ce soit en direct avec Oauth ou via supertweet.
Avec Oauth, quand je clique sur le lien qui permet d’ « Associer votre compte twitter à ce site », j’ai un magnifique « twitter_oauth_request : Accès interdit ».
Si je tente avec Supertweet, tout semble ok mais quand je tente de microbloguer, j’ai là un « Il y a une erreur, veuillez vérifiez la configuration. »
J’ai tenté toutes les combinaisons possibles de mes plugins (titre mots, cfg, bandeau, plutot simple quoi), je suis à la dernière version stable de tout (2.1.2), j’ai tenté sur 2 serveurs différents, là les idées commencent à me manquer.
Une question : quand on crée son appli sur tweeter.com, on a une « Registered OAuth Callback URL », j’ai donné l’adresse du site. Faut-il en fait fournir l’adresse avec « /ecrire » puisque les tweets partent de l’interface d’admin ?
Si d’autres idées, je suis preneur ... Merci d’avance. Pierre.
# Le 23 décembre 2010 à 18:00, par ?
En réponse à : Microblog
Idem en 2.1.5 ... je caressai le fol espoir d’un petit bug corrigé.
Pierre.
Répondre à ce message
# Le 20 novembre 2010 à 12:05, par Skeepy
En réponse à : Microblog
Bonjour,
j’ai configuré Microblog pour twitter avec Oauth, mais j’ai ce message d’erreur qui s’affiche maintenant à l’invite de CFG :
Parse error : syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or ’}’ in /homez.13/cathoweb/www/plugins/microblog/inc/twitteroauth.php on line 17
Une idée d’où ça peut venir ?
Merci !
# Le 20 novembre 2010 à 22:58, par Skeepy
En réponse à : Microblog
Il semble que le problème soit lié à l’implémentation d’Oauth... j’ai vidé les paramètres dans spip_meta puis enregistré mon compte supertweet et là ça marche.
Par contre, quand je remet les paramètres Oauth, le même message s’affiche...
# Le 11 décembre 2010 à 20:24, par Pierre
En réponse à : Microblog
Idem ici, impossible à faire marcher avec Oauth ... J’ai créé mon app sur le site de twitter, la saisie des clés client et secrête revient sur le même écran sans sauvegarde de ces données ...
J’ai ensuite tenté en utilisant CFG, la les données semblent sauvegardées mais impossible d’envoyer un tweet manuel, ça me dit « erreur de configuration ».
Quand j’utilise CFG, un lien apparait sous les champs de saisie des clés : « Associer votre compte twitter à ce site » ... un clic dessus donne : « twitter_oauth_request : Accès interdit »
Bon je vais peut-être tenter avec tweeterfeed.
# Le 11 décembre 2010 à 23:17, par Pierre
En réponse à : Microblog
J’ai tenté sur un autre serveur/domaine, recréé app sur twitter, pareil ...
Coup de bol final : site de supertweet est HS. Super soirée :-)
Pierre.
# Le 13 décembre 2010 à 12:11, par Pierre
En réponse à : Microblog
Bon supertweet.com refonctionne ce matin, mais quelque part ça me chagrine d’autoriser supertweet à utiliser .... bref je trouverai plus sain de faire ça en direct avec twitter. Si un des auteurs passe par là ou si quelqu’un a réussi à utiliser Oauth (Indie, JLuc apparemment), peuvent-ils confirmer que eux y arrivent (avec le dernier svn bien sûr) ?
Merci d’avance !
Pierre.
Répondre à ce message
# Le 22 octobre 2010 à 14:31, par JLuc
En réponse à : Microblog
Après pas mal de tatonnements pour twitter, voici une description du mode opératoire qui marche :
- aller sur http://dev.twitter.com/apps pour créer une « app »
- renseigner les champs, en particulier, indiquer
- Le site indique ensuite les clés consumer et consumer secret. Reporter ces clés dans les champs de la page de conf de microblog
- valider
- il apparait alors un lien pour « associer le site à twitter ». Cliquer
- si c’est bon, vous vous retrouvez sur twitter avec une demande de confirmation : cliquez « Allow »
Voilà, c’est en place.
Pour passer des messages en plus des notifications automatiques de publication, l’adresse c’est ecrire/ ?exec=microbloguer
Répondre à ce message
# Le 20 octobre 2010 à 15:27, par indie
En réponse à : Microblog
Super avec l’implémentation de Oauth pour twitter ! Merci les auteurs.
Par contre, je rencontre un bug : les tweets générés sont de la forme http://monsite.tld/ecrire/articlexxx.html (urls en html, c’est normal) .... c’est le /ecrire/ qui me gêne. Une idée d’où ça peut venir ? J’ai pas implémenté la modif du .htaccess, ça peut arranger les choses à votre avis ?
Sinon, comme Med http://www.spip-contrib.net/Microblog,3051#forum435907 ... j’aurais bien voulu une option de tweet manuel.
# Le 20 octobre 2010 à 17:45, par Cedric Morin
En réponse à : Microblog
J’ai complété la doc pour la possibilité d’envoyer un tweet manuel
# Le 21 octobre 2010 à 22:14, par ?
En réponse à : Microblog
Amusant, j’ai tout décoché, « Forums postés / Articles proposés / Articles publiés » ... et ça continue à tweetter à l’insu de mon plein gré. Bug ou pas ?
Répondre à ce message
# Le 19 octobre 2010 à 05:58, par Med_
En réponse à : Microblog
Installé en local et testé aujourd’hui, marche parfaitement, Twitter est bien notifié via supertweet à la publication d’un article.
Par contre, petite question : ce n’est pas possible de twitter manuellement ? Je veux dire, twitter non pas automatiquement à la publication d’un article ou autre, mais simplement lorsqu’on le choisit. Actuellement, le cadre « Microbloguer » dans le formulaire d’édition d’un article disparaît si on décoche toutes les options de notif automatique dans la conf du plugin... Pourquoi ne pas laisser le formulaire en place et autoriser un envoi manuel ?
Merci encore ! ;-)
# Le 20 octobre 2010 à 17:45, par Cedric Morin
En réponse à : Microblog
J’ai complété la doc pour la possibilité d’envoyer un tweet manuel
# Le 21 octobre 2010 à 08:33, par Med_
En réponse à : Microblog
Très bien, merci !
Répondre à ce message
# Le 17 octobre 2010 à 19:18, par Valéry
En réponse à : Microblog
Installé et testé la dernière version du plugin sur l’un de mes sites. Tout foncitonne et Twitter est notifié à la parution de l’article. Génial !
Répondre à ce message