bS Preloader

This plugin adds a preloader, the content will be shown when the page is fully loaded. When clicking a link (not # and external url), the preloader fades in again (not working on Mac Safari and all iOS Browsers) to get a smooth page transition.

Installation

1. Download Plugin
2. In your admin panel, go to Plugins > and click the Add New button.
3. Click Upload Plugin and Choose File, then select the Plugin’s .zip file. Click Install Now.
4. Click Activate to use your new Plugin right away.

Override template via theme

Template file can be found within the /bs-preloader/templates/ plugin directory.

Edit file in an upgrade-safe way using overrides. Copy the template into a directory within your theme named /bs-preloader-main keeping the same file structure but removing the /templates/ subdirectory. Path must be /your-theme/bs-preloader-main/preloader.php.

The copied file will now override the bS Preloader default template file. Change classes or HTML as you want.

Default template shows the Bootstrap Spinner spinner-border:

<div id="preloader" class="align-items-center justify-content-center position-fixed top-0 end-0 bottom-0 start-0 zi-1070">
  <div id="status" class="spinner-border text-primary" role="status">
    <span class="visually-hidden">Loading...</span>
  </div>
</div>

Change the class from spinner-border to spinner-grow and a different loader will be shown:

Of course you can also display your logo, a gif or your own css animation there instead of the Bootstrap Spinners, it just has to be inside the div id="status".

This code will display the site logo instead the spinner:

<div id="preloader" class="align-items-center justify-content-center position-fixed top-0 end-0 bottom-0 start-0 zi-1070">
  <div id="status" role="status">
    <span class="visually-hidden">Loading...</span>
    <img src="<?php echo esc_url( get_stylesheet_directory_uri() ); ?>/img/logo/logo.svg" alt="logo" class="logo">
  </div>
</div>

For editing it is advantageous to have the preloader permanently displayed. Temporarily use the following css to not let the loader fade out. When you’re done with the design, delete the css again.

#preloader {
  display: flex !important;
}

#status {
  display: block !important;
}

Changelog

Earlier versions can be downloaded via the Github repository. Install/downgrade via the plugin uploader.