bloom-ux/bunnycdn-offloader

Simple BunnyCDN offloader for WordPress

dev-main 2026-07-16 00:52 UTC

Requires

• php: >=7.4
• bunnycdn/storage: ^3.4
• composer/installers: ^1||^2
• deliciousbrains/wp-background-processing: ^1.3
• soulseekah/wp-lock: dev-master

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^1
• php-parallel-lint/php-parallel-lint: ^1
• phpcompatibility/php-compatibility: ^9.3
• squizlabs/php_codesniffer: ^3.6
• wp-cli/wp-cli: ^2
• wp-coding-standards/wpcs: ^3

GPL-2.0-or-later

• Felipe Lavín Zumaeta

Published on Packagist.org on 2026-07-16 00:52 UTC

README

A simple plugin to upload and serve your attachment files from Bunny CDN.

Installation

Install with composer: composer require bloom-ux/wp-bunnycdn-offloader

Configuration

Define the following environment variables:

# The secret API key used as password to upload files to your storage
BLOOM_BUNNY_STORAGE_API_KEY=""

# The storage zone name
BLOOM_BUNNY_STORAGE_ZONE=""

# Two-letter code of the storage region (ie: "br")
BLOOM_BUNNY_STORAGE_REGION=""

# Full URL to your assets (it can include a folder). ie: "https://my-storage.b-cdn.net/subfolder/"
BLOOM_BUNNY_PUBLIC_URL=""

Disable uploads to Bunny

To disable uploads to Bunny (useful in development environments or during imports), define the constant BLOOM_BUNNY_OFFLOADER_DISABLE as true in wp-config.php:

define( 'BLOOM_BUNNY_OFFLOADER_DISABLE', true );

Or use the environment variable in your .env file:

BLOOM_BUNNY_OFFLOADER_DISABLE=true

When this option is active, the plugin will not register hooks or WP-CLI commands, so files will not be uploaded to Bunny CDN and will be served from the local server.