SPIP-Contrib

SPIP-Contrib

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

291 Plugins, 198 contribs sur SPIP-Zone, 82 visiteurs en ce moment

Accueil > Interactivité, échanges > Recommandation Sociale > Microblogage > Mastodon > Mastodon

Mastodon

3 octobre 2017 – par Cerdic – commentaires

11 votes

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

  • d’envoyer facilement des messages avec un ou plusieurs comptes Mastodon
  • d’utiliser les données de Mastodon avec une boucle (DATA)

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 à Mastodon

Le plugin s’enregistre automatiquement auprès de chaque instance Mastodon avec laquelle il devra discuter, en demandant une clé d’accès qui sera stockée dans le dossier config/credentials.

Pour ajouter un compte Mastodon dans la configuration, indiquez l’instance (par défaut le plugin enverra vers https://mamot.fr) et cliquez sur « Ajouter un compte ».
Vous serez envoyé vers la page d’autorisation de l’instance concernée : connectez-vous avec le compte concerné si besoin, et autorisez l’application à utiliser votre compte. Vous serez alors redirigé vers la page de configuration et le compte ajouté devrait apparaitre dans la liste des comptes disponibles.

Si vous ajoutez plusieurs comptes, vous pouvez choisir celui qui sera utilisé par défaut pour les envois de pouets depuis l’interface de SPIP. Les autres comptes sont utilisables quand vous utilisez la fonction pouet() en PHP.

Configurer l’envoi de Pouets

Une fois les comptes configurés, vous pouvez ensuite indiquer :

  • la visibilité par défaut des messages envoyés :
    • Publics (apparaissent sur les timelines publiques)
    • Non listé (les messages sont publics mais n’apparaissent pas sur les timelines)
    • Privé (les messages ne sont visibles que des seuls abonnés au compte Mastodon)
    • Direct (les messages ne sont visibles que des seules personnes mentionnées dans le message)
  • 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 personnaliser le Pouet qui sera envoyé.

Pouetter 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 personnalisé.

Pour rétablir le message d’origine, il suffit d’effacer complètement votre message personnalisé, et d’enregistrer.

Pouetter 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 > Mastodon

Depuis cette page vous pouvez modifier la visibilité de chaque message envoyé, au cas par cas.

API pouet()

Ce plugin offre une fonction pouet() que l’on peut utiliser pour envoyer des messages sur Mastodon.

La fonction s’utilise comme suit :

  include_spip('inc/Mastodon);
  pouet('Bonjour, monde');

La fonction peut prendre un second argument permettant d’indiquer :

  • user_name : le nom du compte Mastodon à utiliser (pseudo@instance.fr, il faut évidemment que ce compte ait été ajouté dans la configuration du plugin)
  • visibility : la visibilité du message (par défaut celle indiquée dans la configuration)
  • max_len : la longueur maxi des messages (par défaut 500 caractères)

Boucle (DATA){source Mastodon}

Le plugin permet l’utilisation facile de l’API Mastodon dans une boucle (DATA) pour afficher par exemple vos pouets, les pouets de votre timeline, les pouets résultats d’une recherche....

Pour ce faire, il suffit d’utiliser {source Mastodon,...} dans une boucle (DATA), en y précisant quelle méthode de l’API utiliser (toutes les méthodes GET de https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md sont possibles) et les arguments sous forme de query-string.

Par exemple :

Il y a une API de recherche, mais elle ne vous permettra de trouver que des comptes et des hashtags, car par construction la recherche plein texte n’est pas proposée par Mastodon.

Dans un exemple complet, cela donne :

  1. <B_pouets>
  2.  <ul class='liste-items'>
  3.  <BOUCLE_pouets(DATA)
  4.  {source mastodon,#VAL{timelines/home}|parametre_url{mastodon_account,#ENV{account,''}}}
  5.  {pagination 10}
  6. >
  7.  <li class='item pouet'>
  8.   <img src='#VALEUR{account/avatar_static}' style='float:left;margin:0 10px 10px 0' width="32" height="32"/>
  9.   from <a href='#VALEUR{account/url}'>[(#VALEUR{account}|mastodon_user_full_screen_name)][ \((#VALEUR{account/display_name})\)]</a>
  10.   [<a href="#VALEUR{url}">(#VALEUR{created_at}|affdate)</a>]
  11.   <blockquote>
  12.    #VALEUR{content}
  13.    <BOUCLE_images(POUR){tableau #VALEUR{media_attachments}}>[(#VALEUR{type}|=={image}|oui)<img src="#VALEUR{url}" />]</BOUCLE_images>
  14.   </blockquote>
  15.  </li>
  16.  </BOUCLE_pouets>
  17.  </ul>
  18.  [<p class='pagination'>(#PAGINATION{precedent_suivant})</p>]
  19. </B_pouets>

Télécharger

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

Dernière modification de cette page le 3 octobre 2017

Retour en haut de la page

Vos commentaires

  • Le 21 novembre à 15:39, par fredo333 En réponse à : Mastodon

    Bonjour,
    tout d’abord je vous présente mes excuses pour ce message.
    Mais je ne parviens pas à relier notre site en Spip avec le plugin mastodon pour de l’envoi vers notre compte framapiaf. auriez-vous un tuto ou une combine ?

    J’ai bien « Autoriser SpipToMastodon à utiliser votre compte  ? » Mais j’ai une ereur 404

    Merci d’avance. Frédéric

    Répondre à ce message

  • Le 14 novembre à 18:46, par boris En réponse à : Mastodon

    Merci pour ce plugin !

    Je l’avais testé il y a un moment mais j’avais à chaque fois l’erreur « L’URL de redirection n’est pas valide. » sur mon instance Matomo.
    J’ai supprimé le fichier stocké dans le dossier config/credentials, puis j’ai refait l’association et maintenant ça fonctionne bien.

    Répondre à ce message

  • Le 16 mai à 20:03, par Denis En réponse à : Mastodon

    Si c’est facile à mettre en place, je trouverais chouette de pouvoir intégrer le logo de l’article dans le message ...

    Répondre à ce message

  • Le 24 avril à 11:59, par Valéry En réponse à : Mastodon

    « 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. »

    En SPIP 3.2.1 avec le plugin en 1.1.2 je ne vois pas cetet interface s’afficher (observé sur Chrome).

    Bon en regardant bien c’est le lien qui est peu visible sur fond bleu.

    Répondre à ce message

  • Le 3 octobre 2017 à 16:35, par Matthieu Marcillaud En réponse à : Mastodon

    Bravo ! Ça pouet() avec classe !

    Répondre à ce message

Répondre à cet article

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

  • Formidable, le générateur de formulaires

    23 janvier 2012 – 2531 commentaires

    Un générateur de formulaires facilement configurable pour les non-informaticiens et facilement extensible pour les développeurs. Introduction L’objectif était de créer un plugin permettant de générer des formulaires. Historiquement, 2 plugins (...)

  • Calendrier Mini 2.0

    19 mai 2012 – 256 commentaires

    Ce plugin ajoute la balise #CALENDRIER_MINI qui insère un petit widget de navigation par mois dans les dates des évènements. Fonctionnement du mini calendrier Le mini calendrier présente un mois à la fois. Les jours du mois comportant des (...)

  • Owl Carousel 2

    30 novembre 2017 – 41 commentaires

    Owl Carousel est un diaporama jQuery adaptable aux différentes tailles d’écran, qu’on peut actionner par glisser, il utilise CSS3 mais il est compatible avec les vieux navigateurs, et il est aussi paramétrable. Le présent plugin permet d’utiliser (...)

  • Paiement avec Formidable

    16 février 2015 – 69 commentaires

    Ce plugin « Paiement avec Formidable » permet d’ajouter une étape de paiement à la fin de la saisie d’un formulaire créé par le plugin Formidable. Il le complète et nécessite par ailleurs le plugin bank qui gère l’interface technique avec les prestataires (...)

  • Bouquinerie V2 : guide de l’utilisateur

    3 janvier – 18 commentaires

    Configuration Quels contenus Selon la maquette adoptée pour votre site, vous pouvez décider que certains éléments des livres ou auteurs de livre ne sont pas utilisés. Vous trouverez dans la page de configuration du plugin la possibilité de (...)