FediBoost
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.