Fediverse Plugin

The Mastodon plugin syncs comments between your AIGCS site and ActivityPub platforms.

Supported Platforms

Setup

1. Add Instance — enter your Mastodon instance URL
2. OAuth Authorization — authorize AIGCS to access your account (popup flow)
3. Bind a Status — link a Mastodon post to a page path on your site

Binding

A binding connects a Mastodon status to a page on your site:

Mastodon post: https://mastodon.social/@user/12345
       ↓ bind
Site page: /blog/my-article

Bindings can be:

• Created manually in the admin panel — enter either a Status ID or a full Status URL
• Auto-created when publishing a toot from the admin
• Synced from search results

Creating a binding (manually or via search) automatically creates a corresponding cache entry so comments appear immediately.

Fetching Comments

Once bound, AIGCS can automatically fetch and cache replies to the Mastodon status:

When autoFetch is enabled, cached replies are served on page load; when disabled, live data is fetched on every page visit.

Reverse Proxy & Graceful Fallback

The core role of the Fediverse plugin is to act as a reverse proxy. It proxies the fetching of replies from the authorized Mastodon instance account via the AIGCS backend, and then displays them on the frontend Widget. This design effectively solves network connectivity issues for some visitors who cannot directly access certain Mastodon instances.

Fetched Fediverse comments will be injected into the widget alongside AI-generated comments and native comments. Please Note: AIGCS features a highly decoupled design. If a network timeout or error occurs while fetching Fediverse data, the plugin will fail silently and gracefully degrade. This will never block or affect the normal display of AI comments or native visitor comments.

Splitting Domain and Account

The plugin supports split-domain configurations where the OAuth instance differs from the account's home instance.

Avatar Mode