Bonsai Page Loader

A minimal WordPress plugin that displays a full-screen loading overlay (configurable background colour and logo) while a page loads, then fades it out.

Features

• Settings page under Settings → Page Loader
• Enable/disable toggle
• Configurable background colour (WP colour picker)
• Optional logo (Media Library), falls back to the site name if none is set
• Configurable fade and removal timings (ms)
• Loader markup printed via wp_body_open
• Options removed on uninstall

Requirements

• WordPress 6.0+
• PHP 8.0+
• Theme must call wp_body_open() in header.php for the loader to output. Bonsai base themes do this by default.

Usage

1. Activate the plugin.
2. Go to Settings → Page Loader.
3. Enable the loader, set a background colour, optionally choose a logo, and adjust fade/removal timings.

Data Structure

A single option is stored:

• bdc_pl_options (array): enabled, background_color, logo_id, fade_ms, remove_ms

Deleted when the plugin is uninstalled.

Updates

Ships with YahnisElsts/plugin-update-checker (installed via Composer, vendor/ committed) pointed at github.com/Bonsai-Systems/bonsai-page-loader. Sites with the plugin installed will see updates in Plugins in wp-admin, same as bonsai-code-injector and bonsai-maintenance.

To ship a new version:

1. Bump the Version: header and the BPL_VERSION constant in bonsai-page-loader.php, and add a CHANGELOG.md entry.
2. Commit and push to main.
3. Publish a GitHub Release tagged with the new version (release-assets mode is enabled, so attach a zip of the plugin folder — plain source-archive tags won't be picked up).

Sites check for updates every 6 hours ($checkPeriod argument to buildUpdateChecker()), or immediately if an admin clicks "Check again" on the Plugins screen.