Changelog

Where to Find the Latest Version?

If you have installed the plugin via Composer, you can update it by running the following command in your terminal:

composer update

If you have downloaded the plugin as a ZIP file, you can download the latest version from the releases page on GitHub.

What's New?

v2.0.0 Latest

Released on December 20, 2024.

Kirby Live Preview v2 is a major release with support for Kirby 5. This major release requires a new license key. If you already have a license, you will receive either a free upgrade to v2 or a 50% discount on your new license. Head over to the Kirby Tools Hub to get your discount or read more in the license compatibility guide.

🚀 Features

• Support for Kirby 5.

v1.5.0

Released on November 15, 2024.

🚀 Features

• New updateStrategy to control the preview update behavior. If set to blur, the preview is updated when any Kirby text-like, number-like, or blocks field loses focus.

To change the default strategy from interval to blur, set the updateStrategy property in your blueprint:

type: preview
updateStrategy: blur

v1.3.0

Released on June 18, 2024.

🚀 Features

• New license management that allows activating licenses directly in the Panel.
• Deprecated the private Composer repository in favor of Packagist.

v1.2.3

Released on May 14, 2024.

🚀 Features

• Allow query language in help text.
• Ignore any links that contain a hash as a redirect to the Panel.

v1.2.2

Released on April 29, 2024.

🚀 Features

• Ignore links for Panel redirects that contain a data-preview-ignore attribute.

🐞 Bug Fixes

• Ignore same-page links for Panel redirects from the preview iframe.

v1.2.1

Released on March 28, 2024.

🚀 Features

• Support Composer installation from a private repository.

🐞 Bug Fixes

• Rerender the preview frame on file sorting changes.

v1.2.0

Released on March 25, 2024.

🚀 Features

• Change rendering frequency with the updateInterval option or disable it completely.

🐞 Bug Fixes

• Saving with Cmd + S now works correctly when the focus is on the preview frame.

v1.1.0

Released on March 24, 2024.

🚀 Features

• Resolve permalinks in writer fields to redirect links to the corresponding Panel page.
• Support detecting the preview mode in the frontend with the data-preview-mode attribute in CSS and JavaScript:
  assets/css/main.css

  [data-preview-mode] .cookie-banner {
    display: none;
  }
  

  assets/js/main.js

  const isPreviewMode = document.documentElement.dataset.previewMode === "true";
  

• Support preview mode detection in the backend with the previewMode content key:
  site/snippets/footer.php

  $isPreviewMode = $page->previewMode()->isTrue();
  

v1.0.5

Released on March 22, 2024.

🚀 Features

• Inject <base> tag into the preview iframe to ensure relative asset URLs work correctly.

v1.0.4

Released on March 22, 2024.

🐞 Bug Fixes

• Add default background to preview embeds.

v1.0.3

Released on March 22, 2024.

• Initial release of the Kirby Live Preview plugin.