ActivityPub

Descripció

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 @example.com@example.com, and authors like Jane and Bob would have their individual profiles at @jane@example.com and @bobz@example.com, respectively.

An example: I give you my Mastodon profile name: @pfefferle@mastodon.social. 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 @jane@example.com.

Once you follow Jane’s @jane@example.com profile, any blog post she crafts on example.com will land in your Home feed. Simultaneously, by following the blog-wide profile @example.com@example.com, 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:

  1. The blog-wide profile is only compatible with sites with rewrite rules enabled. If your site does not have rewrite rules enabled, the author-specific profiles may still work.
  2. Many single-author blogs have chosen to turn off or redirect their author profile pages, usually via an SEO plugin like Yoast or Rank Math. This is usually done to avoid duplicate content with your blog’s home page. If your author page has been deactivated in this way, then ActivityPub author profiles won’t work for you. Instead, you can turn your author profile page back on, and then use the option in your SEO plugin to noindex the author page. This will duplicate content issues with search engines and will enable ActivityPub author profiles to work.
  3. Once ActivityPub is installed, only new posts going forward will be available in the fediverse. Likewise, even if you’ve been using ActivityPub for a while, anyone who follows your site, will only see new posts you publish from that moment on. They will never see previously-published posts in their Home feed. This process is very similar to subscribing to a newsletter. If you subscribe to a newsletter, you will only receive future emails, but not the old archived ones. With ActivityPub, if someone follows your site, they will only receive new blog posts you publish from then on.

So what’s the process?

  1. Install the ActivityPub plugin.
  2. Go to the plugin’s settings page and adjust the settings to your liking. Click the Save button when ready.
  3. Make sure your blog’s author profile page is active if you are using author profiles.
  4. Go to Mastodon or any other federated platform, and search for your profile, and follow it. Your new profile will be in the form of either @your_username@example.com or @example.com@example.com, so that is what you’ll search for.
  5. On your blog, publish a new post.
  6. From Mastodon, check to see if the new post appears in your Home feed.

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.

Blocs

Aquesta extensió proporciona 2 blocs.

  • Fediverse Followers Display your followers from the Fediverse on your website.
  • Follow me on the Fediverse Display your Fediverse profile so that visitors can follow you.

Instal·lació

Seguiu les instruccions habituals per instal·lar extensions del WordPress.

Instal·lació automàtica de l’extensió

Per afegir una extensió de WordPress mitjançant l’instal·lador d’extensions integrat:

  1. Aneu a Extensions > Afegeix nova.
  2. Escriviu «activitypub» al quadre Cerca extensions.
  3. Cerqueu l’extensió de WordPress que voleu instal·lar.
    1. Feu clic a Detalls per obtenir més informació sobre l’extensió i les instruccions que podeu imprimir o desar per ajudar a configurar l’extensió.
    2. Feu clic a Instal·la ara per instal·lar l’extensió de WordPress.
  4. La pantalla d’instal·lació resultant mostrarà la instal·lació com a correcta o avisarà de qualsevol problema durant la instal·lació.
  5. En cas d’èxit, feu clic a Activa l’extensió per activar-la o a Torna a l’instal·lador d’extensions per a més accions.

Instal·lació manual de l’extensió

Hi ha alguns casos en què és adequat instal·lar manualment una extensió del WordPress.

  • Si voleu controlar la ubicació i el procés d’instal·lació d’una extensió de WordPress.
  • Si el vostre servidor no permet la instal·lació automàtica d’una extensió de WordPress.
  • Si voleu provar la última versió en desenvolupament.

La instal·lació manual d’una extensió de WordPress requereix familiaritat amb FTP i la consciència que podeu posar en perill el vostre lloc web si instal·leu una extensió de WordPress incompatible amb la versió actual o d’una font poc fiable.

Feu una còpia de seguretat completa del vostre lloc web abans de continuar.

Per instal·lar un extensió del WordPress manualment:

  • Baixeu l’extensió de WordPress al vostre escriptori.
  • Si la baixeu com a arxiu zip, extraieu la carpeta de l’extensió al vostre escriptori.
  • Amb el vostre programa FTP, pengeu la carpeta de l’extensió a la carpeta wp-content/plugins del vostre directori del WordPress en línia.
  • Aneu a la pantalla d’extensions i cerqueu a la llista l’extensió penjada recentment.
  • Feu clic a Activa per activar-la.

PMF

tl;dr

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.

Quin és l’estat d’aquesta extensió?

Implementat:

  • blog profile pages (JSON representation)
  • author profile pages (JSON representation)
  • enllaços personalitzats
  • bústia d’entrada/sortida funcional
  • seguiu (accepteu seguidors)
  • compartiu entrades
  • rebeu comentaris/reaccions
  • verificació de la signatura

Per implementar:

  • suport de comentaris imbricats
  • replace shortcodes with blocks for layout

Què és «ActivityPub for WordPress»

ActivityPub for WordPress amplia el WordPress amb algunes característiques del Fedivers, però no competeix amb plataformes com Friendica o Mastodon. Si voleu executar una xarxa social descentralitzada, utilitzeu Mastodon o GNU social.

Què passa si esteu executant el vostre blog en un subdirectori?

Perquè WebFinger funcioni, s’ha d’assignar al directori arrel de l’URL on resideix el vostre blog.

Apache

Afegiu el següent al fitxer .htaccess al directori arrel:

RedirectMatch "^\/\.well-known/(webfinger|nodeinfo|x-nodeinfo2)(.*)$" /blog/.well-known/$1$2

On «blog» és el camí al subdirectori on resideix el vostre blog.

Nginx

Afegiu el següent a site.conf a sites-available:

location ~* /.well-known {
    allow all;
    try_files $uri $uri/ /blog/?$args;
}

On «blog» és el camí al subdirectori on resideix el vostre blog.

Ressenyes

29 de abril de 2023
This plugin is absolutely fabulous. I had never expected that connecting my WordPress site to the Fediverse would be SO SIMPLE. However, one thing surprised me. In the settings, the default is that it posts your 'full content' of your post to the Fediverse, rather than the more logical 400-character 'excerpt' Mastodon users won't be happy with getting posts of sometimes thousands of characters in their feed. I therefore suggest making 'excerpt' the default and people can choose 'full content' if they really wish that.
19 de gener de 2023 1 resposta
The indieweb and fediverse communities are doing great work and need to be acknowledged this plugin works well and the devs are constantly improving it
12 de gener de 2023
With this plugin your posts appear automatically on Mastodon. Replies on Mastodon becomes comments on your post. Really, it couldn't be easier.
1 de gener de 2023
Was able to subscribe to my WP weblog from Mastodon, post, and then all the replies went back as comments to my weblog post. Just lovely.
15 de desembre de 2022 3 respostes
<p>I am changing my review because not only has the issue of what to do if your blog is in a subdirectory been solved, but the solution is a tiny simple little snippet of code. This is now within reach for the vast majority. Now that it is working, it works like a dream. Anybody who has to manage multiple social media presences should use this, and even if you just have one, this takes a few steps off your to-do list and will save you lots of time. Definitely install this on your site. BTW, this is also good because you really want to nurture your relationship with federated platforms. If you're concerned about both free speech for real and fighting the spread of disinformation, federated platforms are the present and the future.  Support this. Spend on this. Seriously.</p>
Llegiu totes les 15 ressenyes

Col·laboradors i desenvolupadors

«ActivityPub» és programari de codi obert. La següent gent ha col·laborat en aquesta extensió.

Col·laboradors

“ActivityPub” s'ha traduït a 14 configuracions regionals. Gràcies als traductos per les seves aportacions.

Tradueix “ActivityPub” a la teva llengua.

Interessats en el desenvolupament?

Navegueu pel codi, baixeu-vos el repositori SVN, o subscriviu-vos al registre de desenvolupament per fisl de subscripció RSS.

Registre de canvis

Project maintained on GitHub at automattic/wordpress-activitypub.

1.0.1

  • Update: improve image attachment detection using the block editor
  • Update: better error code handling for API responses
  • Update: use a tag stack instead of regex for protecting tags for Hashtags and @-Mentions
  • Compatibility: better signature support for subpath-installations
  • Compatibility: allow deactivating blocks registered by the plugin
  • Compatibility: avoid Fatal Errors when using ClassicPress
  • Compatibility: improve the Group-Actor to play nicely with existing implementations
  • Fixed: truncate long blog titles and handles for the “Follow me” block
  • Fixed: ensure that only a valid user can be selected for the “Follow me” block
  • Fixed: fix a typo in a hook name
  • Fixed: a problem with signatures when running WordPress in a sub-path

1.0.0

  • Add: blog-wide Account (catchall, like example.com@example.com)
  • Add: a Follow Me block (help visitors to follow your Profile)
  • Add: Signature Verification: https://docs.joinmastodon.org/spec/security/
  • Add: a Followers Block (show off your Followers)
  • Add: Simple caching
  • Add: Collection endpoints for Featured Tags and Featured Posts
  • Add: Better handling of Hashtags in mobile apps
  • Update: Complete rewrite of the Follower-System based on Custom Post Types
  • Update: Improved linter (PHPCS)
  • Compatibility: Add a new conditional, \Activitypub\is_activitypub_request(), to allow third-party plugins to detect ActivityPub requests
  • Compatibility: Add hooks to allow modifying images returned in ActivityPub requests
  • Compatibility: Indicate that the plugin is compatible and has been tested with the latest version of WordPress, 6.3
  • Compatibility: Avoid PHP notice on sites using PHP 8.2
  • Fixed: Load the plugin later in the WordPress code lifecycle to avoid errors in some requests
  • Fixed: Updating posts
  • Fixed: Hashtag now support CamelCase and UTF-8

0.17.0

  • Fix type-selector
  • Allow more HTML elements in Activity-Objects

0.16.5

  • Return empty content/excerpt on password protected posts/pages

0.16.4

  • Remove scripts later in the queue, to also handle scripts added by blocks
  • Add published date to author profiles

0.16.3

  • “cc”, “to”, … fields can either be an array or a string
  • Remove “style” and “script” HTML elements from content

0.16.2

  • Fix fatal error in outbox

0.16.1

  • Fix “update and create, posts appear blank on Mastodon” issue

0.16.0

  • Add “Outgoing Mentions” (#213) props @akirk
  • Add configuration item for number of images to attach (#248) props @mexon
  • Use shortcodes instead of custom templates, to setup the Activity Post-Content (#250) props @toolstack
  • Remove custom REST Server, because the needed changes are now merged into Core.
  • Fix hashtags (#261) props @akirk
  • Change priorites, to maybe fix the hashtag issue

0.15.0

  • Enable ActivityPub only for users that can publish_posts
  • Persist only public Activities
  • Fix remote-delete

0.14.3

  • Better error handling. props @akirk

0.14.2

  • Fix Critical error when using Friends Plugin and adding new URL to follow. props @akirk

0.14.1

  • Fix “WebFinger not compatible with PHP < 8.0”. props @mexon

0.14.0

  • Friends support: https://wordpress.org/plugins/friends/ props @akirk
  • Massive guidance improvements. props mediaformat & @akirk
  • Add Custom Post Type support to outbox API. props blueset
  • Better hash-tag support. props bocops
  • Fix user-count (NodeInfo). props mediaformat

0.13.4

  • fix webfinger for email identifiers

0.13.3

  • fix: Create and Note should not have the same ActivityPub ID

0.13.2

  • fix Follow issue AGAIN

0.13.1

  • fix Inbox issue

0.13.0

  • add Autor URL and WebFinger health checks
  • fix NodeInfo endpoint

0.12.0

  • use “pre_option_require_name_email” filter instead of “check_comment_flood”. props @akirk
  • save only comments/replies
  • check for an explicit “undo -> follow” action. see https://wordpress.org/support/topic/qs-after-latest/

0.11.2

  • fix inconsistent %tags% placeholder

0.11.1

  • fix follow/unfollow actions

0.11.0

0.10.1

  • fix inbox activities, like follow
  • fix debug

0.10.0

  • add image alt text to the ActivityStreams attachment property in a format that Mastodon can read. props @BenLubar
  • use the “summary” property for a title as Mastodon does. props @BenLubar
  • support authorized fetch to avoid having comments from “Anonymous”. props @BenLubar
  • add new post type: “title and link only”. props @bgcarlisle

0.9.1

  • disable shared inbox
  • disable delete activity

0.9.0

  • some code refactorings
  • fix #73

0.8.3

  • fixed accept header bug

0.8.2

  • add all required accept header
  • better/simpler accept-header handling
  • add debugging mechanism
  • Add setting to enable AP for different (public) Post-Types
  • explicit use of global functions

0.8.1

  • fixed PHP warnings

0.8.0

  • Moved followers list to user-menu

0.7.4

  • added admin_email to metadata, to be able to “Manage your instance” on https://fediverse.network/manage/

0.7.3

  • refactorings
  • fixed PHP warnings
  • better hashtag regex

0.7.2

  • fixed JSON representation of posts https://merveilles.town/@xuv/101907542498716956

0.7.1

  • fixed inbox problems with pleroma

0.7.0

  • finally fixed pleroma compatibility
  • added “following” endpoint
  • simplified “followers” endpoint
  • fixed default value problem

0.6.0

  • add tags as hashtags to the end of each activity
  • fixed pleroma following issue
  • followers-list improvements

0.5.1

  • fixed name-collision that caused an infinite loop

0.5.0

  • complete refactoring
  • fixed bug #30: Password-protected posts are federated
  • only send Activites when ActivityPub is enabled for this post-type

0.4.4

  • show avatars

0.4.3

  • finally fixed backlink in excerpt/summary posts

0.4.2

  • fixed backlink in excerpt/summary posts (thanks @depone)

0.4.1

  • finally fixed contact list

0.4.0

  • added settings to enable/disable hashtag support
  • fixed follower list
  • send activities only for new posts, otherwise send updates

0.3.2

  • added “followers” endpoint
  • change activity content from blog ‘excerpt’ to blog ‘content’

0.3.1

  • better json encoding

0.3.0

  • basic hashtag support
  • temporarily deactivated likes and boosts
  • added support for actor objects
  • fixed encoding issue

0.2.1

  • customizable backlink (permalink or shorturl)
  • show profile-identifiers also on profile settings

0.2.0

  • added option to switch between content and excerpt
  • removed html and duplicate new-lines

0.1.1

  • fixed “excerpt” in AS JSON
  • added settings for the activity-summary and for the activity-object-type

0.1.0

  • added basic WebFinger support
  • added basic NodeInfo support
  • fully functional “follow” activity
  • send new posts to your followers
  • receive comments from your followers

0.0.2

  • refactoring
  • functional inbox
  • nicer profile views

0.0.1

  • initial