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:
- Mastodon
- Pleroma/Akkoma
- friendica
- Hubzilla
- Pixelfed
- Socialhome
- Misskey
- Firefish (rebrand of Calckey)
Some things to note:
- 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.
- 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 still resolve duplicate content issues with search engines and will enable ActivityPub author profiles to work.
- 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?
- Install the ActivityPub plugin.
- Go to the plugin’s settings page and adjust the settings to your liking. Click the Save button when ready.
- Make sure your blog’s author profile page is active if you are using author profiles.
- 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. - On your blog, publish a new post.
- From Mastodon, check to see if the new post appears in your Home feed.
Note: 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.
Captures
Blocs
Aquesta extensió proporciona 4 blocs.
- Fediverse Followers Display your followers from the Fediverse on your website.
- Federated Reply Respond to posts, notes, videos, and other content on the fediverse. Ensure the URL originates from a federated social network like Mastodon, as other URLs might not function as expected.
- Fediverse Reactions Display Fediverse likes and reposts
- 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:
- Aneu a Extensions > Afegeix nova.
- Escriviu «
activitypub
» al quadre Cerca extensions. - Cerqueu l’extensió de WordPress que voleu instal·lar.
- 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ó.
- Feu clic a Instal·la ara per instal·lar l’extensió de WordPress.
- La pantalla d’instal·lació resultant mostrarà la instal·lació com a correcta o avisarà de qualsevol problema durant la instal·lació.
- 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:
- Download your WordPress Plugin to your desktop.
- Download from the WordPress directory
- Baixeu des de GitHub
- 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.
-
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?
-
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.
-
What if you are running your blog behind a reverse proxy with Apache?
-
If you are using a reverse proxy with Apache to run your host you may encounter that you are unable to have followers join the blog. This will occur because the proxy system rewrites the host headers to be the internal DNS name of your server, which the plugin then uses to attempt to sign the replies. The remote site attempting to follow your users is expecting the public DNS name on the replies. In these cases you will need to use the ‘ProxyPreserveHost On’ directive to ensure the external host name is passed to your internal host.
If you are using SSL between the proxy and internal host you may also need to
SSLProxyCheckPeerName off
if your internal host can not answer with the correct SSL name. This may present a security issue in some environments. -
Constants
-
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_URL_REGEXP
– Change the default regex to detect urls in a text. Default:(www.|http:|https:)+[^\s]+[\w\/]
.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.ACTIVITYPUB_DISABLE_REWRITES
– Disable auto generation ofmod_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 theVary: Accept
header. Default:false
.
-
Where can you manage your followers?
-
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.
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 26 configuracions regionals. Gràcies als traductors per les seves aportacions.
Traduïu «ActivityPub» a la vostra 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
4.7.0
- Added: Comment counts get updated when the plugin is activated/deactivated/deleted
- Added: A filter to make custom comment types manageable in WP.com Calypso
- Changed: Hide ActivityPub post meta keys from the custom Fields UI
- Changed: Bumped minimum required PHP version to 7.2
- Fixed: Undefined array key warnings in various places
- Fixed: @-mentions in federated comments being displayed with a line break
- Fixed: Fetching replies from the same instance for Enable Mastodon Apps
- Fixed: Image captions not being included in the ActivityPub representation when the image is attached to the post
- Changed: Print
_activityPubOptions
in thewp_footer
action on the frontend.
4.6.0
- Added: A filter to allow modifying the ActivityPub preview template
- Added:
@mentions
in the JSON representation of the reply - Added: Settings to enable/disable e-mail notifications for new followers and direct messages
- Changed: HTML to e-mail text conversion
- Changed: Direct Messages: Test for the user being in the to field
- Changed: Better support for FSE color schemes
- Fixed: Reactions: Provide a fallback for empty avatar URLs
4.5.1
- Changed: Reactions block: Remove the
wp-block-editor
dependency for frontend views - Fixed: Direct Messages: Don’t send notification for received public activities
4.5.0
- Changed: Reactions (likes and reposts) now enabled by default
- Added: Reactions block to display likes and reposts
- Added:
icon
support forAudio
andVideo
attachments - Added: Send “new follower” emails
- Added: Send “direct message” emails
- Added: Account for custom comment types when calculating comment counts
- Added: Plugin upgrade routine that automatically updates comment counts
- Changed: Email templates for Likes and Reposts
- Changed: Interactions moderation
- Changed: Compatibility with Akismet
- Changed: Comment type mapping for
Like
andAnnounce
- Changed: Signature verification for API endpoints
- Changed: Changed priority of Attachments, to favor
Image
overAudio
andVideo
- Fixed: Empty
url
attributes in the Reply block no longer cause PHP warnings
4.4.0
- Added: Setting to enable/disable Authorized-Fetch
- Changed: Added screen reader text for the “Follow Me” block for improved accessibility
- Changed: Added
media_type
support to Activity-Object-Transformers - Changed: Clarified settings page text around which users get Activitypub profiles
- Changed: Add a filter to the REST API moderators list
- Fixed: Prevent hex color codes in HTML attributes from being added as post tags
- Fixed: A typo in the custom post content settings
- Fixed: Prevent draft posts from being federated when bulk deleted
4.3.0
- Added: A
pre_activitypub_get_upload_baseurl
filter - Added: Fediverse Preview on post-overview page
- Added: GitHub action to enforce Changelog updates
- Added: New contributors
- Changed: Basic enclosure validation
- Changed: More User -> Actor renaming
- Changed: Outsource Constants to a separate file
- Changed: Better handling of
readme.txt
andREADME.md
- Fixed: editor error when switching to edit a synced Pattern
- Fixed: Fediverse preview showing
preferredUsername
instead ofname
- Fixed: Potential fatal error in Enable Mastodon Apps
- Fixed: Broken escaping of Usernames in Actor-JSON
- Fixed: Show Followers name instead of avatar on mobile view
- Fixed: Missing attachement-type for enclosures
- Fixed: Prevention against self pings
See full Changelog on GitHub.