FediBoost

Beskrivelse

FediBoost extends the ActivityPub plugin by automatically boosting your WordPress posts on your connected Mastodon accounts when they are published.

When you publish a new post on your WordPress site, FediBoost will automatically boost (reblog) that post on your linked Mastodon account, helping increase visibility across the fediverse.

Features:

  • Automatic boosting of new posts to connected Mastodon accounts
  • Seamless integration with the ActivityPub plugin
  • No additional configuration required after setup

Requirements:

  • The ActivityPub plugin must be installed and configured
  • A connected Mastodon account via ActivityPub

Developer Hooks

FediBoost provides several filters that allow developers to customize its behavior. All filters follow WordPress coding standards and can be added to your theme’s functions.php file or a custom plugin.

fediboost_should_boost_post

Control whether a specific post should be boosted. Return false to skip boosting for the given post. Default: true.

Parameters:

  • $should_boost (bool) — Whether the post should be boosted.
  • $post (WP_Post) — The post object being published.

Example:

add_filter( 'fediboost_should_boost_post', function( $should_boost, $post ) {
    // Don't boost posts in the "internal" category.
    if ( has_category( 'internal', $post ) ) {
        return false;
    }
    return $should_boost;
}, 10, 2 );

fediboost_boost_delay

Delay in seconds between post publication and the boost action. Default: 30.

Parameters:

  • $delay (int) — The delay in seconds.

Example:

add_filter( 'fediboost_boost_delay', function( $delay ) {
    // Wait 2 minutes before boosting.
    return 120;
} );

fediboost_manage_capability

WordPress capability required to manage FediBoost settings. Default: ‘manage_options’. Note: a floor of ‘edit_others_posts’ is enforced regardless of this filter’s return value, so you cannot lower the requirement below that capability.

Parameters:

  • $capability (string) — The required capability.

Example:

add_filter( 'fediboost_manage_capability', function( $capability ) {
    // Allow editors to manage FediBoost settings.
    return 'edit_others_posts';
} );

fediboost_max_accounts

Maximum number of connected Mastodon accounts. Default: 10.

Parameters:

  • $max (int) — The maximum number of accounts.

Example:

add_filter( 'fediboost_max_accounts', function( $max ) {
    // Allow up to 25 connected accounts.
    return 25;
} );<h3>External Services</h3>

FediBoost connects to external Mastodon instances that you configure (e.g., mastodon.social). This communication is essential for the plugin to function and is initiated only with the instance you explicitly provide.

During setup:

  • FediBoost registers an OAuth application on your Mastodon instance and performs an authorization flow so it can act on your behalf.

When a post is published:

  • FediBoost searches for the post on your Mastodon instance and performs a reblog (boost) via the Mastodon API.

Data sent to your Mastodon instance:

  • Your instance URL
  • OAuth authorization codes
  • Search queries to locate your posts
  • Reblog (boost) requests

Data stored locally on your WordPress site:

  • Encrypted OAuth tokens
  • Your Mastodon username
  • Your Mastodon instance URL

Each Mastodon instance has its own privacy policy and terms of service. You can find a list of instances and their policies at joinmastodon.org/servers.

This plugin does not send data to any third-party service other than the Mastodon instance(s) you explicitly configure.

Installation

  1. Ensure the ActivityPub plugin is installed and activated.
  2. Upload the fediboost folder to /wp-content/plugins/ or install via the WordPress plugin installer.
  3. Activate FediBoost through the Plugins menu.
  4. Go to Settings > FediBoost.
  5. Enter your Mastodon instance URL (e.g., mastodon.social) and authorize the connection.
  6. New posts will automatically be boosted to your connected Mastodon account when published.

FAQ

Does this plugin work without the ActivityPub plugin?

No, FediBoost requires the ActivityPub plugin to be installed and properly configured. FediBoost extends ActivityPub’s functionality to add automatic boosting capabilities.

Can I choose which posts get boosted?

Currently, FediBoost will boost all newly published posts. Future versions may include options to selectively boost posts based on categories, tags, or other criteria. Developers can use the fediboost_should_boost_post filter to programmatically control which posts are boosted. See the Developer Hooks section below for details.

What happens if I change my WordPress authentication salts?

FediBoost encrypts OAuth tokens using your WordPress authentication salts (defined in wp-config.php). If these salts are changed — for example, by a security plugin, during a security incident response, or by manually editing wp-config.php — all stored tokens will become invalid. You will need to reconnect your Mastodon accounts under Settings > FediBoost after any salt change. This is standard behavior for WordPress plugins that encrypt sensitive data using the built-in salts.

The OpenSSL PHP extension is required for token encryption. If OpenSSL is not available, FediBoost will not be able to store account credentials securely and will display an admin notice.

Anmeldelser

Der er ingen anmeldelser for denne widget.

Bidragsydere & udviklere

“FediBoost” er open source-software. Følgende personer har bidraget til dette plugin.

Bidragsydere

Ændringslog

1.0.0

  • Initial release
  • Automatic boosting of published posts to connected Mastodon accounts