Search by

indieweb / wordpress-microsub

pfefferle

A Microsub server reference implementation for WordPress with adapter support for reader plugins.

Package info

github.com/indieweb/wordpress-microsub

Type:wordpress-plugin

pkg:composer/indieweb/wordpress-microsub

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 2

Dependents: 0

Suggesters: 0

Stars: 2

Open Issues: 0

dev-main 2026-09-08 15:12 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

GPL-2.0-or-later 6eb8cc992f0de9eeb9a7c976cf0b7618b79dffcb

  • Matthias Pfefferle

Published on Packagist.org on 2026-09-08 15:12 UTC

This package is auto-updated.

Last update: 2026-09-08 15:12:22 UTC

README

A Microsub server reference implementation for WordPress.

Description

Microsub is a standardized API for creating and managing feeds. It separates feed reading clients from feed aggregation servers, allowing users to use any compatible client with any compatible server.

This plugin implements the server side of the Microsub specification. It provides a flexible adapter system that allows reader plugins to integrate with the Microsub API.

Features

  • Full Microsub API implementation
  • Multi-adapter support with result aggregation
  • Automatic endpoint discovery via HTML and HTTP headers
  • IndieAuth integration for authentication

Requirements

  • IndieAuth plugin for authentication
  • A reader plugin that provides a Microsub adapter

Frequently Asked Questions

What is Microsub?

Microsub is a standardized API for creating and managing feeds. It separates the feed reading interface (client) from the feed aggregation and storage (server), similar to how IMAP separates email clients from email servers.

How do I use this plugin?

This plugin provides the Microsub API endpoint. You need:

  1. The IndieAuth plugin for authentication
  2. A reader plugin that provides a Microsub adapter (like the Friends plugin)
  3. A Microsub client (like Monocle, Indigenous, or Together)

Where is the Microsub endpoint?

The endpoint is available at /wp-json/microsub/1.0/endpoint. Discovery is automatically added to your site's HTML <head> and HTTP headers.

How do I create a custom adapter?

See the adapter documentation for a complete guide on creating custom adapters.

How do I set up a local development environment?

See the development documentation for setup instructions, testing, and code quality tools.

What scopes are required?

  • read - Required for timeline, search, and preview actions
  • channels - Required for channel management
  • follow - Required for follow/unfollow actions
  • mute - Required for mute/unmute actions
  • block - Required for block/unblock actions

Changelog

1.0.0

  • Initial release
  • Full Microsub API implementation
  • Multi-adapter support
  • Friends plugin adapter included

Installation

Follow the normal instructions for installing WordPress plugins.

Automatic Plugin Installation

  1. Go to Plugins > Add New
  2. Search for "microsub"
  3. Click Install Now
  4. Click Activate

Manual Plugin Installation

  1. Download the plugin from GitHub
  2. Upload the microsub folder to /wp-content/plugins/
  3. Activate the plugin through the Plugins menu

Upgrade Notice

1.0.0

Initial release.