The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format.
Enter the fediverse with ActivityPub, broadcasting your blog to a wider audience! Attract followers, deliver updates, and receive comments from a diverse user base of ActivityPub-compliant platforms.
With the ActivityPub plugin installed, your WordPress blog itself function as a federated profile, along with profiles for each author. For instance, if your website is example.com
, then the blog-wide profile can be found at @[email protected]
, and authors like Jane and Bob would have their individual profiles at @[email protected]
and @[email protected]
, respectively.
An example: I give you my Mastodon profile name: @[email protected]
. You search, see my profile, and hit follow. Now, any post I make appears in your Home feed. Similarly, with the ActivityPub plugin, you can find and follow Jane’s profile at @[email protected]
.
Once you follow Jane’s @[email protected]
profile, any blog post she crafts on example.com
will land in your Home feed. Simultaneously, by following the blog-wide profile @[email protected]
, you’ll receive updates from all authors.
Note: if no one follows your author or blog instance, your posts remain unseen. The simplest method to verify the plugin’s operation is by following your profile. If you possess a Mastodon profile, initiate by following your new one.
The plugin works with the following tested federated platforms, but there may be more that it works with as well:
Some things to note:
So what’s the process?
@[email protected]
or @[email protected]
, so that is what you’ll search for.Please note that it may take up to 15 minutes or so for the new post to show up in your federated feed. This is because the messages are sent to the federated platforms using a delayed cron. This avoids breaking the publishing process for those cases where users might have lots of followers. So please don’t assume that just because you didn’t see it show up right away that something is broken. Give it some time. In most cases, it will show up within a few minutes, and you’ll know everything is working as expected.
Follow the normal instructions for installing WordPress plugins.
To add a WordPress Plugin using the built-in plugin installer:
activitypub
” into the Search Plugins box.There are a few cases when manually installing a WordPress Plugin is appropriate.
Installation of a WordPress Plugin manually requires FTP familiarity and the awareness that you may put your site at risk if you install a WordPress Plugin incompatible with the current version or from an unreliable source.
Backup your site completely before proceeding.
To install a WordPress Plugin manually:
wp-content/plugins
folder in your WordPress directory online.This plugin connects your WordPress blog to popular social platforms like Mastodon, making your posts more accessible to a wider audience. Once installed, your blog can be followed by users on these platforms, allowing them to receive your new posts in their feeds.
Implemented:
To implement:
ActivityPub for WordPress extends WordPress with some Fediverse features, but it does not compete with platforms like Friendica or Mastodon. If you want to run a decentralized social network, please use Mastodon or GNU social.
If you are running your blog in a subdirectory, but have a different wp_siteurl, you don’t need the redirect, because the index.php will take care of that.
The plugin uses PHP Constants to enable, disable or change its default behaviour. Please use them with caution and only if you know what you are doing.
ACTIVITYPUB_REST_NAMESPACE
– Change the default Namespace of the REST endpoint. Default: activitypub/1.0
.ACTIVITYPUB_EXCERPT_LENGTH
– Change the length of the Excerpt. Default: 400
.ACTIVITYPUB_SHOW_PLUGIN_RECOMMENDATIONS
– show plugin recommendations in the ActivityPub settings. Default: true
.ACTIVITYPUB_MAX_IMAGE_ATTACHMENTS
– Change the number of attachments, that should be federated. Default: 3
.ACTIVITYPUB_HASHTAGS_REGEXP
– Change the default regex to detect hashtext in a text. Default: (?:(?<=\s)|(?<=<p>)|(?<=<br>)|^)#([A-Za-z0-9_]+)(?:(?=\s|[[:punct:]]|$))
.ACTIVITYPUB_USERNAME_REGEXP
– Change the default regex to detect @-replies in a text. Default: (?:([A-Za-z0-9\._-]+)@((?:[A-Za-z0-9_-]+\.)+[A-Za-z]+))
.ACTIVITYPUB_CUSTOM_POST_CONTENT
– Change the default template for Activities. Default: <strong>[ap_title]</strong>\n\n[ap_content]\n\n[ap_hashtags]\n\n[ap_shortlink]
.ACTIVITYPUB_AUTHORIZED_FETCH
– Enable AUTHORIZED_FETCH. Default: false
.ACTIVITYPUB_DISABLE_REWRITES
– Disable auto generation of mod_rewrite
rules. Default: false
.ACTIVITYPUB_DISABLE_INCOMING_INTERACTIONS
– Block incoming replies/comments/likes. Default: false
.ACTIVITYPUB_DISABLE_OUTGOING_INTERACTIONS
– Disable outgoing replies/comments/likes. Default: false
.ACTIVITYPUB_SHARED_INBOX_FEATURE
– Enable the shared inbox. Default: false
.ACTIVITYPUB_SEND_VARY_HEADER
– Enable to send the Vary: Accept
header. Default: false
.If you have activated the blog user, you will find the list of his followers in the settings under /wp-admin/options-general.php?page=activitypub&tab=followers
.
The followers of a user can be found in the menu under “Users” -> “Followers” or under wp-admin/users.php?page=activitypub-followers-list
.
For reasons of data protection, it is not possible to see the followers of other users.
fediverse:creator
implementationcount_total=false
to WP_User_Query
Announce
sget_by_username
if one of the above failNote
as default Object-Type, instead of Article
AUTHORIZED_FETCH
get_comment_ancestors
See full Changelog on GitHub.