Description
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
- Ensure the ActivityPub plugin is installed and activated.
- Upload the
fediboostfolder to/wp-content/plugins/or install via the WordPress plugin installer. - Activate FediBoost through the Plugins menu.
- Go to Settings > FediBoost.
- Enter your Mastodon instance URL (e.g., mastodon.social) and authorize the connection.
- 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_postfilter 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.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“FediBoost” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “FediBoost” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- Automatic boosting of published posts to connected Mastodon accounts
