Dans mon article sur le choix de ma stack blog, je mentionnais vouloir connecter ce blog au Fediverse. L'idée : permettre aux gens de me suivre depuis Mastodon ou Bluesky, et récupérer leurs interactions directement sur mes articles. Pas de système de commentaires à gérer, pas de spam, pas de RGPD. Juste des conversations.

Et c'est reparti comme en 40 : j'ai développé un plugin Grav pour ça à grand coups de Claudy. Il s'appuie sur Bridgy Fed et gère tout le bazar technique sous le capot. Je vous explique comment ça marche et les galères que j'ai rencontrées en chemin.

En bref

Pour les pressés, voici le parcours :

• Créer un compte sur Bridgy Fed en liant votre domaine
• Installer le plugin sur votre Grav
• Quand vous publiez un article, le plugin notifie Bridgy Fed qui crée un post sur le Fediverse
• Quand quelqu'un interagit (like, boost, réponse), Bridgy Fed vous renvoie l'info via Webmention
• Le plugin stocke et affiche ces interactions sur votre article

C'est quoi Bridgy Fed ?

Bridgy Fed est un service gratuit créé par Ryan Barrett. Son but : faire le pont entre votre site web et le Fediverse (Mastodon, Bluesky, etc.) sans que vous ayez à héberger un serveur ActivityPub.

Concrètement, Bridgy Fed :

• Crée une identité Fediverse pour votre domaine (genre @trucs.hophop.be@trucs.hophop.be)
• Convertit vos articles en posts ActivityPub que les gens peuvent voir sur Mastodon
• Vous renvoie les interactions (likes, boosts, réponses) via le protocole Webmention

C'est pas mal comme truc. Vous gardez votre contenu chez vous, sur votre serveur, et le Fediverse vient le chercher.

Ce que fait le plugin

Le plugin grav-plugin-bridgyfed gère toute l'intégration :

Injection des Microformats2 — Bridgy Fed a besoin de comprendre la structure de vos pages. Le plugin ajoute automatiquement les classes h-card, h-entry, p-author, etc. dans votre HTML. Vous n'avez rien à faire côté template.

Redirections well-known — Pour que le Fediverse vous découvre, il faut répondre à certaines requêtes (/.well-known/webfinger, /.well-known/host-meta...). Le plugin redirige tout ça vers Bridgy Fed.

Envoi des Webmentions — Quand vous publiez un article et cochez "Publier sur le Fediverse", le plugin envoie une notification à Bridgy Fed.

Réception et affichage — Quand quelqu'un interagit avec votre post, Bridgy Fed envoie une Webmention à votre blog. Le plugin la stocke et l'affiche en bas de l'article (likes, boosts, réponses avec avatars). Vous pouvez voir un exemple concret sur mon article de test qui affiche les interactions reçues depuis le Fediverse.

Comment ça marche concrètement

Quand je publie un article

Mon article Grav
      │
      ▼
Plugin Bridgy Fed (Webmention sortante)
      │
      ▼
fed.brid.gy reçoit la notification
      │
      ▼
Bridgy Fed lit mon article (grâce aux Microformats)
      │
      ▼
Création d'un post ActivityPub
      │
      ▼
Visible sur Mastodon, Bluesky, etc.

Quand quelqu'un répond

Utilisateur Mastodon répond/like/boost
      │
      ▼
L'instance Mastodon notifie Bridgy Fed
      │
      ▼
Bridgy Fed m'envoie une Webmention
      │
      ▼
Mon plugin reçoit et stocke l'interaction
      │
      ▼
Affichage sur l'article (facepile, commentaires)

C'est élégant. Tout passe par des standards ouverts (ActivityPub, Webmention, Microformats2), et mon blog reste le point central.

Installation et configuration

Étape 1 : Créer son compte Bridgy Fed

Rendez-vous sur fed.brid.gy et entrez l'URL de votre site. Bridgy Fed va vérifier que vous êtes bien le propriétaire (via un lien dans votre page d'accueil ou les redirections well-known).

Une fois validé, vous aurez une identité Fediverse du style @votredomaine.com@votredomaine.com. Les gens pourront vous chercher et vous suivre depuis Mastodon.

Étape 2 : Installer le plugin

cd user/plugins
git clone https://github.com/ndieschburg/grav_plugin_bridgyfed.git bridgyfed
cd bridgyfed
composer install

Activez-le ensuite dans l'admin Grav (Plugins > Bridgy Fed).

Étape 3 : Configurer

Dans l'admin, configurez au minimum :

• Votre nom et photo de profil — Important pour l'affichage sur le Fediverse
• Les templates d'articles — Par défaut item, blog-item, post

Côté articles, un nouvel onglet "Fediverse" apparaît dans l'éditeur. Cochez "Publier sur le Fediverse" et sauvegardez.

Les galères (parce qu'il y en a eu)

Comme dirait le vieux proverbe : c'est au pied du mur qu'on reconnaît le forgeron. Et des murs, j'en ai pris quelques-uns.

Problème 1 : Personne ne pouvait me suivre

Après avoir tout configuré, j'ai essayé de me suivre depuis mon compte Mastodon. Erreur. J'ai demandé à des potes de tester. Pareil. Impossible de s'abonner à mon profil Bridgy Fed.

Le truc vicieux, c'est que sans abonnés, vos articles ne sont distribués à personne. Les instances Fediverse ne téléchargent les posts que si au moins un de leurs utilisateurs suit l'auteur. Donc j'avais un blog connecté au Fediverse... qui parlait dans le vide.

J'ai contacté Ryan Barrett (le développeur de Bridgy Fed) sur GitHub. Il a identifié un bug dans la gestion de certains domaines. Quelques jours plus tard, c'était corrigé. Merci Ryan !

Problème 2 : Mes interactions n'arrivaient jamais

Une fois le suivi réparé, j'ai testé : je likais mes propres articles depuis Mastodon, je répondais, je boostais. Rien. Nada. Pas une Webmention en retour.

Rebelote, j'ai contacté Ryan. Après investigation, il m'a pointé vers la doc : les interactions provenant d'utilisateurs sans photo de profil sont ignorées. C'était écrit noir sur blanc dans la documentation de Bridgy Fed. J'avais juste zappé ce détail.

Mon compte Mastodon de test n'avait pas d'avatar. Une fois la photo ajoutée, tout fonctionnait. Sindjeu, j'aurais pu lire la doc plus attentivement...

Conclusion

Le plugin est fonctionnel et disponible sur GitHub : grav-plugin-bridgyfed.

C'est de l'open source, donc si vous utilisez Grav et que le Fediverse vous tente, n'hésitez pas à tester. Les issues et PR sont les bienvenues.

En espérant avoir aidé quelqu'un qui galère avec la même idée. D'ailleurs, si vous voulez aussi piloter votre blog Grav avec Claude, jetez un œil à mon plugin MCP. Et si vous me suivez depuis Mastodon... ben merci, ça fait au moins 5 personnes maintenant !