Twitter

Publié le : 17 juin 2013 – Dernière modification le 18 janvier 2023 – par Cerdic, cy_altern, Fil, kent1, [id-pop] – 149 commentaires

1
2
3
4
5
32 votes
En date du 12/01/2023 les API Twitter tierces-parties ont été fermées sans communication de la part de l’entreprise. Le plugin n’est donc plus fonctionnel.

Un plugin qui facilite l’intégration de Twitter dans un site SPIP et permet :

  • d’envoyer facilement des messages avec un ou plusieurs comptes Twitter
  • d’afficher des Widgets standards dans le site public (qui respectent la vie privée des visiteurs)
  • d’utiliser les données de Twitter avec une boucle (DATA)

Le plugin fait office de proxy afin qu’aucune requête ne soit faite par vos visiteurs vers Twitter et éviter tout traçage possible de leur activité (préservation de leur vie personnelle).

Ce plugin intègre les 2 plugins Microblog (dont seule la partie Twitter était encore fonctionnelle) et Twitter Widget. Il les remplace avantageusement pour SPIP 3.

(2020) Attention : suite aux changements successifs de l'API et de la politique de twitter vis a vis de l'usage de son API, il se peut que le plugin ne soit plus opérationnel.

Mode d’emploi

Le plugin s’installe comme tous les autres

Pré-requis

Ce plugin nécessite le module cURL de PHP pour fonctionner.

Configuration

Une fois le plugin activé, il faut passer sur sa page de configuration accessible depuis la page des plugins.

Configurer l’accès à Twitter

Toute l’API Twitter n’étant accessible qu’en étant identifié, il faut y configurer les clés secrètes d’une Application Twitter et ajouter un ou plusieurs comptes que le site pourra utiliser. Cette partie de la configuration est décrite en détail dans Créer une Application Twitter pour utiliser dans SPIP.

Configurer l’envoi de Tweets

Une fois l’application et les comptes configurés, vous pouvez ensuite indiquer :

  • les évènements qui déclencheront l’envoi d’une notification ; pour l’instant 4 types sont disponibles :
    • le post d’un nouveau message de forum (y compris message en attente de modération)
    • la publication d’un nouveau message de forum
    • le passage d’un article en mode « Proposé à la publication »
    • la publication en ligne d’un article.
  • la présence ou non d’une invite de status sur chaque article pour permettre de personaliser le Tweet qui sera envoyé.

Configurer les Widgets

Tout cela concerne la configuration du fonctionnement par défaut des Widgets lorsqu’ils seront insérés dans les squelettes. Ces réglages par défauts sont ensuite personnalisables au cas par cas lors de l’insertion.

Chose importante à noter : les résultats affichés dans les widgets sont récupérés avec le compte de l’utilisateur Twitter par défaut qui a été ajouté auparavant. Les tweets que cet utilisateur ne peut pas voir (comptes bloqués par exemple) ne s’afficheront pas.

Widget de recherche
Il affiche les tweets qui correspondent à une recherche Twitter.

Pour ajouter ce widget dans votre squelette vous pouvez utiliser le code :
#INCLURE{fond=inclure/twidget_search}

Widget de profil
Il affiche tous les tweets d’un utilisateur Twitter

Pour ajouter ce widget dans votre squelette vous pouvez utiliser le code :
#INCLURE{fond=inclure/twidget_profile}

Tweeter 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.

Tweeter n’importe quoi !

Le plugin propose aussi une interface pour envoyer un message immédiatement sur n’importe quel sujet. La page est accessible depuis le menu Publication > Twitter

Insérer les Widgets dans le site public

Widget de recherche
Pour ajouter le widget de recherche dans votre squelette insérez le code :
#INCLURE{fond=inclure/twidget_search}
Vous pouvez le personnaliser lors de l’insertion :
#INCLURE{fond=inclure/twidget_search,search=#SPIP,width=200}

Les variables personnalisables sont :

  • search : terme(s) recherché(s)
  • title : titre en clair de la recherche
  • subject : sous titre de la recherche
  • interval : intervalle de mise à jour en millisecondes
  • width : largeur en px
  • height : hauteur en px
  • shell_background : couleur de background
  • shell_color : couleur de police
  • tweets_background : couleur de background
  • tweets_color : couleur de police
  • tweets_links : couleur des liens
  • scrollbar : true/false
  • loop : true/false
  • live : true/false
  • hashtags : true/false
  • timestamp : true/false
  • avatar : true/false
  • toptweets : true/false

Widget de profil
Pour ajouter le widget de profil dans votre squelette insérez le code :
#INCLURE{fond=inclure/twidget_profile}

Vous pouvez le personnaliser :
#INCLURE{fond=inclure/twidget_profile,user=spip,width=200,height=300}

Les variables personnalisables sont :

  • user : nom de l’utilisateur Twitter dont la timeline est affichée
  • rpp : nombre de résultats affichés
  • interval : intervalle de mise à jour en millisecondes
  • width : largeur en px
  • height : hauteur en px
  • shell_background : couleur de background
  • shell_color : couleur de police
  • tweets_background : couleur de background
  • tweets_color : couleur de police
  • tweets_links : couleur des liens
  • scrollbar : true/false
  • loop : true/false
  • live : true/false
  • hashtags : true/false
  • timestamp : true/false
  • avatar : true/false

API tweet()

Ce plugin offre une fonction tweet() que l’on peut utiliser pour envoyer des micro-messages (status) sur Twitter [1].

La fonction s’utilise comme suit :

   include_spip('inc/twitter);
   tweet('Bonjour, monde');

Boucle (DATA){source twitter}

Si vous utilisez Twitter, le plugin permet [2] l’utilisation facile de l’API Twitter dans une boucle (DATA) pour afficher par exemple vos tweets, les tweets de votre timeline, les tweets résultats d’une recherche....

Pour ce faire, il suffit d’utiliser {source twitter,...} dans une boucle (DATA), en y précisant quelle méthode de l’API utiliser (toutes les méthodes GET de https://dev.twitter.com/docs/api/1.1 sont possibles) et les arguments sous forme de query-string.

Par exemple :

Dans un exemple complet, cela donne :

<B_tweets>
<ul class='liste-items'>
<BOUCLE_tweets(DATA)
 {source twitter,search/tweets?q=%23spip}
 {datapath statuses}
 {pagination 10}
>
<li class='item tweet'>
<img src='#VALEUR{user/profile_image_url}' style='float:right' />
from <a href='http://twitter.com/#VALEUR{user/screen_name}'>@#VALEUR{user/screen_name} (#VALEUR{user/name})</a> :
&laquo;<q>#VALEUR{text}</q>&raquo;
</li>
</BOUCLE_tweets>
</ul>
[<p class='pagination'>(#PAGINATION{precedent_suivant})</p>]
</B_tweets>

Attention, il faut bien avoir en tête que les requêtes sont faites à l’API Twitter en utilisant le compte Twitter associé au site, et donc seuls les tweets visibles par cet utilisateur seront listés dans tous les cas.

Flux RSS

Le plugin Twitter génère automatiquement un flux RSS des tweets du compte Twitter par défaut auquel il est associé.

Ce flux RSS est disponible à l’adresse spip.php?page=twitter-backend de votre site (par sécurité, il ne répondra rien si le compte Twitter est protégé).

Le squelette twitter-backend.html peut être pris comme modèle pour générer d’autres flux RSS pour d’autres utilisateurs.

Notes

[1] la fonction microblog() héritée du plugin Microblog reste fonctionnelle

[2] à partir de la version 1.1

Discussion

5 ans 1 an 3 mois Sans limite
par date
Filtrer

54 discussions

  • 1
    ierpe

    Bonjour,

    Est-t-il actuellement possible d’accéder à l’image d’un Tweet ?

    La documentation Twitter précise que la réponse json inclut les media dans entities -> media -> media_url, mais quand j’essaie #VALEURentities/media/media_url dans ma boucle, ça ne fonctionne pas.

    Pareil pour l’url partagée d’un Tweet, est-il possible de l’obtenir ?

    Ce serait pratique d’avoir un exemple plus poussé des valeurs disponibles dans la boucle :)

    • steph

      Bonjour,
      je débute en spip et je suis plutôt programmateur du dimanche en html et php, mais êtes vous arrivé à insérer une image lors de l’utilisation du plugin twitter ? Merci d’avance pour votre réponse, j’aimerais pouvoir le faire pour le site que j’ai mis en ligne :)

    Répondre à ce message

  • joz

    Bonjour,
    Quand je vérifie la validité du html de mon site ça me dit « Element script must not have attribute charset unless attribute src is also specified. »
    Cela concernt le fichier inclure/twidget_profile de ce plugin.
    Je ne sais pas si vous trouvez ça important ?
    à+
    j

    Répondre à ce message

  • Philippe

    bonjour

    après plusieurs tentative et vérification de tous les champs, plusieurs fois.
    j’ai même recréé la API key etc.

    mais toujours la même erreur ...

    Erreur : Cette fonctionnalité est temporairement indisponible
Le serveur a repondu 401 Unauthorized
Avez-vous bien rempli le champ "Callback URL" de votre application Twitter ?

    Répondre à ce message

  • 1

    Bonjour,

    J’utilisais avec succès la syntaxe from:@AstuceSPIP dans le widget de recherche, mais depuis le début de l’année, je n’ai plus de résultat.

    Si je teste cette syntaxe, via l’outil de recherche de Twitter : https://twitter.com/search-home les résultats sont correctement affichés.

    Est-ce qu’il y a eu une modification de l’api Twitter qui empêcherait d’utiliser cette syntaxe ?

    Merci

    • maat

      Bonjour,

      Je rencontre le même souci avec la syntaxe suivante dans un bloc de texte libre :

      <twitter|search=from:@toto #monhashtag>

      Ça remonte en « live » des tweets faits APRES ouverture de la fenêtre mais il n’y a pas de tweets pré-existants qui remontent.

      J’ai loupé quelque chose ?

    Répondre à ce message

  • 7
    GIL

    Bonjour,

    J’ai le message cURL is missing
    Alors qu’il est installé sur le VM, ainsi qu’OpenSSL

    Que faire ?

    Merci.

    • Fil

      Il te faut la colle entre php et curl (package php5-curl si tu es sous Debian).

    • Gil

      C’est à dire ?

    • Fil

      Tu dis que tu as cURL sur la machine mais PHP ne sait pas lui parler car il manque la fonction PHP curl_init() et ses copines. Si tu es sous Debian celles-ci s’installent en faisant apt-get install php5-curl.

    • GIL

      Merci

      Gil

    • GIL

      Super ça a fonctionné ... du moins le problème précédent corrigé.
      Par contre ça me met le message suivant (capture) lors de la connection ...

    • Gil

      Bon, ça fonctionne, ça a débuggé tout seul :-)
      SUPER PLUGIN !

      Dernière question, lorsque l’intègre les tweets avec la boucle, il n’y a pas les liens actifs dans le texte. tout est en textebrut.
      Y a t’il moyen de changer cela ?

    • Gil

      en attendant je vous offre mon code :

      [(#REM) Liste des tweets ]
<B_tweets>
<div class="menu menu_comments">
<h2>Dernier Tweet</h2>

<ul>
<BOUCLE_tweets(DATA) {source twitter,#VAL{statuses/user_timeline}|parametre_url{count,40,'&'}|parametre_url{screen_name,#GET{screen_name},'&'}}{0,1}>
<li><!-- <img src='#VALEUR{user/profile_image_url}' style='float:left; margin-right:5px;' /> -->

<q>#VALEUR{text}</q>

<div style="font-size:0.8em;">de <a href='http://twitter.com/#VALEUR{user/screen_name}'>@#VALEUR{user/screen_name} </a> 

| 
<!-- formatage de la date du Tweet -->
<?php 
$date_tweet= new DateTime( $tweet->created_at );
echo $date_tweet->format('d-m-Y | H:i');
?>
<!-- formatage de la date du Tweet -->
<br />
<a target="_blank" class="twtr-reply" href="https://twitter.com/intent/tweet?in_reply_to=#VALEUR{id}">r&eacute;pondre</a> | <a target="_blank" class="twtr-reply" href="https://twitter.com/intent/retweet?tweet_id=#VALEUR{id}">retweeter</a>
</div></li>
</BOUCLE_tweets>
</ul>
</div>
</B_tweets>

    Répondre à ce message

  • Nicolas

    Bonjour,
    j’ai découvert et installé aujourd’hui ce super plugin. Tout semble marcher parfaitement et la mise en place est très rapide.
    Petit souci cependant : si, dans la page de configuration, il est indiqué que par défaut, seuls les admins ont accès à l’invite de status, avec la dernière version, tout le monde semble y avoir accès, rédacteurs et admins, ce qui est plutôt gênant car tout le monde peut envoyer un message Twitter sur le compte du site…
    Il doit y avoir un paramètre à changer quelque part dans un des fichiers, mais je ne l’ai pas trouvé pour le moment.
    Si vous avez des pistes, nous sommes intéressés.
    Nicolas

    Répondre à ce message

  • 1
    raphael valentin

    Bonjour,
    Je tente de mettre en place le plugin sur mon site et je rencontre un petit soucis technique. Il semblerait que si je peux associer des comptes twitter en utilisant le plugin, il m’est impossible de les dissocier. Je suis dirigé vers le lien http://xxx/edit/@url_assoc@ puis sur une page 404. Lorsque je ré install le plugin (avec rm), les associations subsistent. J’utilise SPIP 3.0, et NGINX. Est-ce un mauvaise configuration de ma part ou un bug ? Comment faire pour les dissocier ?
    Merci d’avance pour votre réponse.

    • ashledombos

      Salut,

      ça fait longtemps que ce message est posté, tu as peut-être trouvé depuis, mais as-tu une ligne de ce type dans ton fichier de conf :

      rewrite ^/([\w]+).api(/(.*))?$ /spip.php?action=api_$1&arg=$3 last;

    Répondre à ce message

  • wilfrid

    Bonjour,
    Je ne comprends pas pourquoi la création d’application m’oblige à donner mon numéro de téléphone mobile à twitter.

    Error
    You must add your mobile phone to your Twitter profile before creating an application. Please read https://support.twitter.com/articles/110250-adding-your-mobile-number-to-your-account-via-web for more information

    Est-ce qu’il est possible d’évité ce message et d’utiliser le plugin ?

    Bonne journée,

    Répondre à ce message

  • Jo Arb

    Bonjour Cedric
    Le plugin à l’air super mais je n’arrive pas à utiliserla fonction « tweeter n’importe quoi »
    J’ai ce message « Il y a une erreur, veuillez vérifiez la configuration »
    Avez vous une idée ?
    Merci !!!!.

    Répondre à ce message

  • 3
    yanouil

    Bonjour,

    Merci pour ce plugin.
    J’ai cependant un souci, l’adresse des tweet est sous forme :
    http://monsite.fr/30

    Or, cette adresse retourne une erreur. Mon article 30 étant à l’adresse : http://monsite.fr//spip.php?article30.

    Y a t-il un moyen de régler ce problème ?

    Merci d’avance

    • Fil

      Le htaccess de SPIP prévoit ce cas — il faut peut-être faire une mise à jour de ce fichier.

    • yanouil

      Ah oui effectivement.

      Quelle réactivité. Merci beaucoup

    • Jo Arb

      Bonjour
      Je rencontre le meme probleme
      Pouvez vous me dire ce que vous avez modifié dans htacces ?
      Merci !

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

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

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom