# Changelog

If you have doubts about how to update, please make sure you read our how-to update guide <https://www.one.thezero.club/guide/installation/updating>.&#x20;

{% hint style="warning" %}
**NEVER OVERWRITE:**&#x20;

* your theme **`content`** folder. That's where your site content is.

**BE CAREFUL WITH:**

* your **`site/config/`** folder files. If you made some changes to it.
* your **`site/languages/`**&#x66;older files.&#x20;
  {% endhint %}

{% hint style="danger" %}
If you are unsure of what you are doing, it is always wise to back up the website before updating.&#x20;
{% endhint %}

## 5.4.0 - 24.03.2026

Full GDPR support, SEO Audit, full-feature Sitemap, new blocks, and more! 🚀

{% hint style="danger" %}
**If you haven't updated yet to Zero One version 5.0.0**, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>. After you update to 5.0.2 (available in your Gumroad account) following the instructions for the 5.0.0 version, you can update to the 5.4.0 version.&#x20;

**If you didn't update to the 5.2.0 version,** you can have some panel errors, easily solvable by following the instructions for the 5.2.0 version <https://www.one.thezero.club/changelog#id-5.2.0-29.05.2025>

**If you didn't update to the 5.3.0 version**, please check the 5.3.0 version instructions <https://www.one.thezero.club/changelog#id-5.3.0-25.09.2025>. Because you should also update the config files, and the site/theme folder.&#x20;
{% endhint %}

{% hint style="info" %}

**How to update to 5.4.0 instructions:**

<mark style="color:red;">**On your old install, delete these:**</mark>

1. **`assets/app` folder**
2. **`assets/js` folder**
3. **`kirby` folder**
4. **`site/config/config.php` file**
5. **`site/plugins` folder** ( ⚠️ If you added some additional plugins, make sure to skip those)
6. **`composer.json` file**

<mark style="color:green;">**Add the files from new Zero One version:**</mark>

1. **`assets/app` folder**
2. **`assets/js` folder**
3. **`kirby` folder**
4. **`site/config/config.php` file**
5. **`site/plugins` folder**
6. **`composer.json` file**
   {% endhint %}

#### What this update brings:

* NEW [GDPR Cookie Consent](https://www.thezero.club/demo/one/features/full-gdpr-support) functionality + Google Map and YouTube, Vimeo, Dailymotion video protection
* NEW [Built-in SEO Audit](https://www.thezero.club/demo/one/features/seo-audit)! In cooperation with [Kirby Tools](https://kirby.tools/seo-audit/)
* NEW Our own full-featured sitemap!
* NEW Leader content block
* NEW [Tabs content block](https://www.thezero.club/demo/one/layout-builder/tabs)
* NEW Breadcrumb block
* NEW Autogenerated /llms.txt file (see [AI support](https://www.thezero.club/demo/one/features/ai-support))
* NEW Columns option for markdown/textarea field
* NEW Article SEO meta options
* NEW panel translation - Spanish language
* NEW favicon.ico autogeneration
* UIkit updated to 3.25.13 version
* Kirby updated to the 5.3.2 version
* assets/js folder restructured
* Removed Swup page transitions and added new custom page transitions
* Improved animations
* Improved text link animation
* Article author page improved!
  * Now it can show the author's description, website, and social networks from the profile information
* General SEO improved
* General accessibility improved
* Added more complex content option to the Accordion block
* Added Card footer and card anchor link
* Image block link improved
* New video block options for self-hosted videos
* Countdown block improved
* Description block improved
* Additional button for custom products
* NEW Disable header parallax option
* Layout Builder layouts improved and extended
* Code editor plugin fixed
* Config updated (removed custom language detect and smartypants)
* LESS PHP plugin updated
* REMOVED Contact controller
* REMOVED Kirby3 Feed plugin
* ADDED Kirby SEO Audit plugin

***

## 5.3.2 - 06.11.2025

Small, but needed update because it fixes one issue:

* Form Block Suite plugin updated to 5.1.6 version
  * This update fixes this issue <https://github.com/plain-solutions-gmbh/kirby-form-block-suite/issues/79>
* Kirby updated to the 5.1.3 version
* Some small fixes

{% hint style="danger" %}
**If you haven't updated yet to Zero One version 5.0.0**, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>. After you update to 5.0.2 (available in your Gumroad account) following the instructions for the 5.0.0 version, you can update to 5.3.0 version.&#x20;

**If you didn't update to the 5.2.0 version,** you can have some panel errors, easily solvable by following the instructions for the 5.2.0 version <https://www.one.thezero.club/changelog#id-5.2.0-29.05.2025>

**If you didn't update to the 5.3.0 version**, please follow the 5.3.0 version instructions <https://www.one.thezero.club/changelog#id-5.3.0-25.09.2025>
{% endhint %}

{% hint style="info" %}
**How to update instructions if you already have the Zero One 5.3 version:**

<mark style="color:red;">**On your old install, delete these:**</mark>

1. **`kirby` folder**
2. **`site/plugins/zero-one` folder**&#x20;
3. **`site/plugins/kirby-form-block-suite` folder**&#x20;

<mark style="color:green;">**Add the files from new Zero One version:**</mark>

1. **`kirby` folder**
2. **`site/plugins/zero-one` folder**&#x20;
3. **`site/plugins/kirby-form-block-suite` folder**&#x20;
   {% endhint %}

***

## 5.3.1 - 09.10.2025

This is a small update that fixes:

* Missing language switch in Site options
* Update Kirby to 5.1.2 version

{% hint style="danger" %}
**If you haven't updated yet to Zero One version 5.0.0**, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>. After you update to 5.0.2 (available in your Gumroad account) following the instructions for the 5.0.0 version, you can update to 5.3.0 version.&#x20;

**If you didn't update to the 5.2.0 version,** you can have some panel errors, easily solvable by following the instructions for the 5.2.0 version <https://www.one.thezero.club/changelog#id-5.2.0-29.05.2025>

**If you didn't update to the 5.3.0 version**, please follow the 5.3.0 version instructions <https://www.one.thezero.club/changelog#id-5.3.0-25.09.2025>
{% endhint %}

{% hint style="info" %}
**How to update to 5.3.1 instructions:**

<mark style="color:red;">**On your old install, delete these:**</mark>

1. **`kirby` folder**
2. **`site/plugins/zero-one` folder**&#x20;

<mark style="color:green;">**Add the files from new Zero One version:**</mark>

1. **`kirby` folder**
2. **`site/plugins/zero-one` folder**&#x20;

<mark style="color:orange;">**Form Builder config options change:**</mark> if you used Form Builder config options, change the options name from **`microman.formblock`** to **`plain.formblock`.**

<mark style="color:red;">\*</mark><mark style="color:red;">**Reminder**</mark> that you actually don't need this files, but they are available only as an example and starting point for your [config files](https://www.one.thezero.club/guide/installation/config-options) (Kirby configuration files). But if you have already in your install, and don't update them you will get a PHP error telling you to change **`microman.formblock`** to **`plain.formblock`** in your config files.
{% endhint %}

***

## 5.3.0 - 25.09.2025

Kirby 5 compatibility update has arrived! 🚀&#x20;

{% hint style="danger" %}
**If you haven't updated yet to Zero One version 5.0.0**, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>. After you update to 5.0.2 (available in your Gumroad account) following the instructions for the 5.0.0 version, you can update to this version.&#x20;

**If you didn't update to the 5.2.0 version,** you can have some panel errors, easily solvable by following the instructions for the 5.2.0 version <https://www.one.thezero.club/changelog#id-5.2.0-29.05.2025>
{% endhint %}

{% hint style="info" %}
**How to update to 5.3.0 instructions:**

<mark style="color:red;">**On your old install, delete these:**</mark>

1. **`kirby` folder**
2. **`site/config/config.php` file**
3. **`site/config/config.www.thezero.club.php`** **file**[<mark style="color:red;">**\***</mark>](#user-content-fn-1)[^1]
4. **`site/config/config.localhost.php`** **file**[<mark style="color:red;">**\***</mark>](#user-content-fn-1)[^1]
5. **`site/config/config.zero-one.test.php`** **file**[<mark style="color:red;">**\***</mark>](#user-content-fn-1)[^1]
6. **`site/plugins` folder** ( ⚠️ If you added some additional plugins, make sure to skip those)
7. **`site/theme` folder** ( ⚠️ If you have your additional customizations, make sure to skip those)
8. **`composer.json` file**
9. **`.gitignore`** **file**

<mark style="color:green;">**Add the files from new Zero One version:**</mark>

1. **`kirby` folder**
2. **`site/config/config.php` file**
3. **`site/config/config.www.thezero.club.php`** **file**[<mark style="color:red;">\*</mark>](#user-content-fn-1)[^1]
4. **`site/config/config.localhost.php`** **file**[<mark style="color:red;">\*</mark>](#user-content-fn-1)[^1]
5. **`site/config/config.zero-one.test.php`** **file**[<mark style="color:red;">**\***</mark>](#user-content-fn-1)[^1]
6. **`site/plugins` folder**
7. **`site/theme` folder**
8. **`composer.json` file**
9. **`.gitignore`** **file**

<mark style="color:orange;">**Form Builder config options change:**</mark> if you used Form Builder config options, change the options name from **`microman.formblock`** to **`plain.formblock`.**

<mark style="color:red;">\*</mark><mark style="color:red;">**Reminder**</mark> that you actually don't need this files, but they are available only as an example and starting point for your [config files](https://www.one.thezero.club/guide/installation/config-options) (Kirby configuration files). But if you have already in your install, and don't update them you will get a PHP error telling you to change **`microman.formblock`** to **`plain.formblock`** in your config files.
{% endhint %}

#### What this update brings:

1. Kirby updated to 5.1.1
   * Check out new Kirby 5 features if you haven't already <https://getkirby.com/releases/5>
2. Improved panel performance
   * We migrated panel translations from PHP to JSON
   * If you create a new translation file now, you just drop it in the site/plugins/zero-one/languages folder, and it works
   * We migrated Zero One panel views to Vue components. Besides better performance, you can now also [disable the Vue template compiler](https://getkirby.com/docs/reference/system/options/panel#disable-the-vue-template-compiler)
   * Layout Builder main blueprint and the Subgrid block blueprint are reverted to YAML files, and now they are overridable again
3. The Dutch language is now available in the panel! 🚀
   * Big thanks to Jan for this 🙏
4. Accessibility is additionally improved
5. Almost all blocks now have Advanced tab options
6. Updated plugins:
   * Code editor
   * Bettersearch
   * Kirby Form Block Suite
   * Less PHP

We stripped out some large features on which we are working on, because work on those have been delaying this update. And we need more time to finish those. So you can expect new update soon.&#x20;

***

## 5.2.1 - 02.06.2025

This is a small update fixing custom code inputs in Site Styling tab, for multi-language websites.&#x20;

**If you already updated to 5.2.0 version** you can just remove **`site/plugins/zero-one`** folder and add one from the downloaded files.

**If you haven't updated to 5.2.0 version** use the instructions provided for the 5.2.0 version below. 👇

## ⚠️ 5.2.0 — 29.05.2025

Dear Kirby friends, new Zero One update has arrived! 🚀

{% hint style="danger" %}
**If you haven't update yet to Zero One version 5.0.0**, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>. After you update to 5.0.2 (available in your Gumroad account) following the instructions for 5.0.0 version, just then you can update to this version.&#x20;
{% endhint %}

{% hint style="info" %}
**How to update to 5.2.0 instructions:**

<mark style="color:red;">**On your old install delete these:**</mark>

1. **`assets/app/` folder**
2. **`assets/js/` folder**
3. **`kirby` folder**
4. **`site/plugins` folder** ( ⚠️ If you added some additional plugins make sure to skip those)
5. **`site/config/config.php` file**
6. **`composer.json` file**

<mark style="color:green;">**Add the files from new Zero One version:**</mark>

1. **`assets/app/` folder**
2. **`assets/js/` folder**
3. **`kirby` folder**
4. **`site/config/config.php` file**
5. **`site/plugins` folder**
6. **`composer.json` file**

<mark style="color:green;">**Also, after you update files, make sure to:**</mark>

Turn on Style Compiler in Site Styling tab -> Save -> And refresh any frontend page to create new updated website styles. After that Turn off Style Compiler and save again.
{% endhint %}

{% hint style="danger" %}
**This update has one breaking change that could cause panel errors on some installs.** This is related to the migration of the old Kirby Color plugin field to the new Kirby color field. Although many people won't have this issue, people that used Hex colors for background overlay color will. Unfortunately, we must do this migration now, because old Kirby Color field plugin will not be compatible to Kirby 5 version.&#x20;

<mark style="color:green;">But don't worry, the errors are easily fixable, check out the video below this section.</mark>

It can happen only in these fields:

* Site Settings
  * Header Options -> Header background image -> Image overlay color field
  * Footer Options (Old) -> Footer Background -> Image -> Overlay color field
  * Footer Builder (New) -> Layout Section, Column Options Styling options, Card background field
* Layout Builder
  * Section settings -> Custom background overlay
  * Column Options Block -> Style tab -> Background -> Custom
  * Card Block -> Card Options tab -> Background options
* Page Options
  * Header Settings -> Custom Background -> Image overlay color field

<mark style="color:red;">**Below is a video with instructions on how to fix those panel errors ⇣**</mark>
{% endhint %}

{% embed url="<https://youtu.be/YUjSl3exgBE>" %}
Color field migration - Zero One 5.2.0
{% endembed %}

#### The most prominent features and improvements this update brings:

* Panel performance improvements 🚀
* Various styling improvements
* Swup script improvements
* **NEW** Navbar button icon
* Topbar improvements and new options
* Additional options for Heading and Text blocks
* Custom List **NEW** Custom icon option
* **Custom marks for Text and Heading block** 🚀🚀🚀
  * Small text
  * Highlight text
  * Label text
  * Badge text
  * Outline text
  * Gradient text
  * Highlight underline text
* **NEW** Site Styling options for Gradient text and Highlight underline text
* **NEW** options for Slideshow, Image slider and Content slider
  * Animation speed
  * Autoplay interval
  * Pause on hover
* **NEW** Projects title options
* **NEW** Blog option to hide authors
* **NEW** shop option to remove social share
* **NEW** options for Advanced tab for pages: Custom Head, Body and Footer code
* **NEW** options and styling for Custom navigation block
* Sitemap improvements
* Meta information improvements
* **Kirby update to 4.7.2 version**
* **Plugins updated to latest versions**
* <mark style="color:red;">Kirby Color plugin removed</mark>
* <mark style="color:orange;">Migration all color fields to new Kirby color field</mark>

***

## 5.1.0 — 20.02.2025

Here we go! New big update has arrived! 🚀

#### The most prominent features of this update:

1. Accessibility improved! Fully compatible to new EU laws ✅
2. Improved responsive images! Your website will be faster on smaller devices, and look better on bigger
3. Layout Builder performance improvements
4. Various Zero One styles improved
5. Kirby updated to 4.6.1 and some new functionalities used
6. UIkit updated to 3.22.2
7. New demo! 🚀 Check out <https://www.thezero.club/demo/one-event/>
8. **Blog improved:** 🚀
   * New design!
     * <https://www.thezero.club/demo/one/journal>
   * Blog container width option
   * Blog grid columns options
   * Blog classic image size
   * Sidebar width option
   * New article author page!
   * Blog pages now have RSS feed! Just add .rss on your blog page URL
9. **Article improved: 🚀**
   * New Table of contents option
     * <https://www.thezero.club/demo/one/journal/tips-for-camera-protection-while-travelling>
   * Multiple categories are possible now
   * List of already available tags for tags creation
   * Featured posts in the sidebar
10. **Work & Projects improvement:** 🚀
    * New brand option!
      * <https://www.thezero.club/demo/one/work>
11. Shop improved:
    * Shop container width option
12. **New blocks:** 🚀
    1. Featured text block
    2. Countdown block
13. **Blocks improved: 🚀**
    * Button block internal link now supports anchors
    * Image block now has tablet width settings
    * Info block is heavily improved, it can be used as alert note
    * Latest Articles block has filters (category, tags, featured) now!
      * <https://www.thezero.club/demo/one/layout-builder/articles>
    * Fancy Gallery block has many new options
      * <https://www.thezero.club/demo/one/layout-builder/gallery>
    * Featured Products block has filters (category, tags, featured, new) now!
    * Products list block has filters (category, tags, featured, new) now!
    * Featured Projects block has filter (tags) now!
    * Slideshow block have new autoplay options
    * Form Builder various fixes
14. **SEO improved: 🚀**
    * Categories and tags are now indexable!
    * Article meta improved
    * Product meta improved
    * Products now have schema data!
    * Sitemap improved! Video support 🚀
15. Plugins:
    1. Removed Sitemapper plugin
    2. Added Getkirby feed plugin (for the sitemap)
16. New icons from UIkit
17. File templates now have "change" option
18. New custom border radius option in Site Styling
19. Contact form spam security improved 💪
20. German panel language heavily improved thanks to Torsten 🙏
21. Snipcart integration updated

{% hint style="danger" %}
**If you didn't update yet to Zero One version 5.0.0**, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>. After you update to 5.0.2 (avaliable in your Gumroad account) following the instructions for 5.0.0 version, just then you can update to this version.&#x20;
{% endhint %}

**If you already updated to Zero One version 5** follow the instructions below

{% hint style="info" %}
**How to update instructions:**

<mark style="color:red;">**On your old install delete these:**</mark>

1. **`assets/app/` folder**
2. **`kirby` folder**
3. **`site/plugins` folder** ( ⚠️ If you added some additional plugins make sure to skip those)
4. **`site/theme` folder** ( ⚠️ If you have your additional customizations make sure to skip those, and remove old Commentions snippets, and add new Form Builder files)
5. **`composer.json` file**

<mark style="color:green;">**Add the files from new Zero One version:**</mark>

1. **`assets/app/` folder**
2. **`kirby` folder**
3. **`site/config/formblock_default.json` file**
4. **`site/plugins` folder**
5. **`site/theme` folder**
6. **`composer.json` file**

<mark style="color:green;">**Also make sure to:**</mark>

Turn on Style Compiler in Site Styling tab -> Save -> And refresh any frontend page to create new updated website styles. After that Turn off Style Compiler and save again.
{% endhint %}

## 5.0.2 -- 09.05.2024

This is a minor update which brings several fixes, and few improvements:

1. PHP Composer support fix
2. Blog, Shop and Work templates fix, so they work properly as a sub-page
3. Desktop sub-menu fix when navbar is positioned on the left
4. Block selection scroll overflow fix
5. [Kirby Autoresize](https://github.com/medienbaecker/kirby-autoresize) plugin removed, Zero One now use [Kirby core function](https://getkirby.com/docs/reference/panel/blueprints/file#optimize-uploaded-images) for that&#x20;
6. Plugin folders renamed:
   1. `kirby-code-editor` folder in `site/plugins` renamed to `code-editor`
   2. `kirby-similar` folder in `site/plugins` renamed to `similar`
7. Kirby Form Block Suite plugin updated to latest version, and made compatibility fixes in `site/theme` folder.&#x20;
8. **NEW block added - a Space Block**. It is a simple but very needed block, it adds vertical space between content elements, when needed

{% hint style="danger" %}
**If you didn't update yet to Zero One version 5.0.0**, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>
{% endhint %}

**If you already updated to Zero One version 5** follow the instructions below

{% hint style="info" %}
**How to update instructions:**

**On your old install delete these:**

1. **`site/config/config.php` file** ( ⚠️ if you made changes to this file make sure to save those, but we suggest using [Multi-environment setup](https://www.one.thezero.club/guide/installation/config-options#multi-environment-setup) for config)
2. **`site/plugins` folder** ( ⚠️ If you added some additional plugins make sure to skip those)
3. **`site/theme` folder** ( ⚠️ If you have your additional customizations make sure to skip those, and remove old Commentions snippets, and add new Form Builder files)
4. **`composer.json` file**
5. **`composer.lock` file**

**Add the files from new Zero One version:**

1. **`site/config/config.php` file**
2. **`site/plugins` folder**
3. **`site/theme` folder**
4. **`composer.json` file**
   {% endhint %}

## 5.0.1 -- 17.04.2024

This is a small update fixing one issue that influenced multi-language websites causing site.txt for secondary language can't update changes.&#x20;

{% hint style="danger" %}
If you didn't update yet to Zero One version 5.0.0, follow the update instructions for that version <https://www.one.thezero.club/changelog#id-5.0.0-13.04.2024>
{% endhint %}

**If you already updated to Zero One version 5** you don't need to update everything again, you can just remove the following code from **`site/config/config.php`** file, from line 21

```php
// Kirby Form Block Suite plugin https://github.com/youngcut/kirby-form-block-suite
'ready' => function($kirby) {
  $sender_email = $kirby->site()->email();
  $sender_name = $kirby->site()->title();
  return [
     'microman.formblock' => [
       'from_email' => ["$sender_email" => "$sender_name"],
     ]
  ];
},
```

We also updated the documentation for Form Builder, so please check it out

{% embed url="<https://www.one.thezero.club/guide/form-builder-premium>" %}
Form Builder documentation
{% endembed %}

## ⚠️ 5.0.0 -- 13.04.2024

And finally! We can't believe this update is finished. But the wait is finally over! And it was worth it 🚀

#### The most prominent features of this update:

1. Kirby 4 compatibility 🚀
2. [NEW Form Builder (Premium)](https://www.one.thezero.club/guide/form-builder-premium) 🚀
3. [Translatable panel](https://www.one.thezero.club/guide/administration-panel/translating-panel) + French language panel translation 🚀
4. NEW Language Switch dropdown option
5. NEW Option for SEO Meta title - Remove Site name
6. Image width/height improvements
7. NEW Anchor only link possibility in Menu Builder
8. Heading improvements using new Slot snippet
9. Many blocks improvements
10. Many code optimisations
11. Some styling improvements
12. Some accesability improvements

{% hint style="danger" %} <mark style="color:red;">**IMPORTANT NOTE:**</mark>**&#x20;This update brings several braking changes:**

1. [Old Page Builder is removed](https://www.one.thezero.club/guide/old-page-builder-deprecation) ⚠️ Make sure to migrate all your pages created with Old Page Builder to New Layout Builder before updating to Zero One v5
2. Commentions plugin is removed ⚠️ Because the plugin author stopped development of the plugin, and it is not compatible to Kirby 4. So, at the moment only option for comments is Embed comments
3. K3 Image Clip plugin is removed ⚠️ We integrated new Kirby focus crop functionality instead

**We suggest you watch the video below on how to update to Zero One 5.**
{% endhint %}

{% embed url="<https://www.youtube-nocookie.com/embed/wjtnRgHxjl8?si=Quf966m5l4WV28H9>" %}
How to update to Zero One 5
{% endembed %}

{% hint style="info" %}

#### How to update?

<mark style="color:red;">**On your old install delete these:**</mark>

1. <mark style="color:purple;">**`assets/app`**</mark>**&#x20;folder**
2. <mark style="color:purple;">**`assets/css/panel.css`**</mark>**&#x20;file**
3. <mark style="color:purple;">**`kirby`**</mark>**&#x20;folder**
4. <mark style="color:purple;">**`site/config/config.php`**</mark>**&#x20;file** ( ⚠️ if you made changes to this file make sure to save those, but we suggest using [Multi-environment setup](https://www.one.thezero.club/guide/installation/config-options#multi-environment-setup) for config)
5. <mark style="color:purple;">**`site/plugins`**</mark>**&#x20;folder** ( ⚠️ If you added some additional plugins make sure to skip those)
6. <mark style="color:purple;">**`site/theme`**</mark>**&#x20;folder** ( ⚠️ If you have your additional customizations make sure to skip those, and remove old Commentions snippets, and add new Form Builder files)
7. <mark style="color:purple;">**`composer.json`**</mark>**&#x20;file**

<mark style="color:green;">**Add the files from new Zero One version:**</mark>

1. <mark style="color:purple;">**`assets/app`**</mark>**&#x20;folder**
2. <mark style="color:purple;">**`assets/css/panel.css`**</mark>**&#x20;file**
3. <mark style="color:purple;">**`kirby`**</mark>**&#x20;folder**
4. <mark style="color:purple;">**`site/config/config.php`**</mark>**&#x20;file**
5. <mark style="color:purple;">**`site/config/formblock_default_de.json`**</mark>**&#x20;file**
6. <mark style="color:purple;">**`site/config/formblock_default_en.json`**</mark>**&#x20;file**
7. <mark style="color:purple;">**`site/config/formblock_default_fr.json`**</mark>**&#x20;file**
8. <mark style="color:purple;">**`site/plugins`**</mark>**&#x20;folder**
9. <mark style="color:purple;">**`site/theme`**</mark>**&#x20;folder**
10. <mark style="color:purple;">**`composer.json`**</mark>**&#x20;file**
11. <mark style="color:green;">**THIS IS IMPORTANT: After you add all files from new Zero One version, do this**</mark>
    1. Turn on Style Compiler in Site Styling tab -> Save -> And refresh any frontend page to create new updated website styles. After that Turn off Style Compiler and save again.&#x20;
    2. Go to your website root URL and add "resave" so you get **`yourwebsite.com/resave`** URL, press Enter, and let the Zero One update your old content to new features. If your website is installed localy, of course go **`localhost/yourwebsitefolder/resave`** URL. <mark style="color:red;">**Be patient, depending on the number of your pages it can take a while.**</mark> For approximately 50 pages it takes about 1-2 minutes. After it is finished, it will say "Your content is updated!". **After that you should delete `site/plugins/resave` plugin from your installation**.&#x20;
    3. <mark style="color:red;">**If your website is multilanguage than repeat resave process for every language**</mark>, by using this URL structure **`yourwebsite.com/{language-code}/resave`** (example: yourwebsite.com/en/resave, yourwebsite.com/de/resave, etc.).
12. Revisit some settings:
    1. Site Settings and its options, and see some options need configuration. Because we removed Kirby Link Field plugin, and now use inbuilt Kirby Link Field you must **configure right navbar button again**.
    2. Projects header image - we made some improvements so you need to reconfigure header settings there

<mark style="color:red;">**If you are updating from a version earlier than Zero One 4.5.0 then you should update the .htaccess file as well.**</mark>
{% endhint %}

#### What's changed? (Useful for developers)

1. **Changes in&#x20;**<mark style="color:purple;">**assets**</mark>**&#x20;folder**
   1. Changes in assets/app/custom files - various styling improvements
   2. Changes in assets/css/panel.css file - removed Kirby 3 panel styling
2. **Changes in&#x20;**<mark style="color:purple;">**kirby**</mark>**&#x20;folder** - Kirby updated to version 4.2.0
3. **Changes to&#x20;**<mark style="color:purple;">**site/config/config.php**</mark>**&#x20;file ⚠️**
   1. Removed Commentions plugin options
   2. Added Form Builder options
   3. Improved custom CSS stylesheet functioning in multilanguage websites
4. **Changes in&#x20;**<mark style="color:purple;">**site/plugins/**</mark>**&#x20;folder**
   1. <mark style="color:green;">Kirby Robots plugin updated to latest version</mark>
   2. <mark style="color:green;">Kirby Better Search updated to latest version</mark>
   3. <mark style="color:green;">Less PHP updated to latest version</mark>
   4. <mark style="color:red;">Old Table Field plugin removed</mark>, <mark style="color:green;">new</mark> [<mark style="color:green;">Kirby Table Field</mark>](https://github.com/bogdancondorachi/kirby-table-field) <mark style="color:green;">added</mark>
   5. <mark style="color:red;">Kirby Sanitizer plugin removed</mark>
   6. <mark style="color:red;">Kirby Link Field plugin removed</mark> - Now using new Kirby inbuilt Link field
   7. <mark style="color:red;">K3 Image Clip plugin removed</mark> - Now using Kirby inbuilt Kirby focus function
   8. <mark style="color:red;">Commentions plugin removed</mark>
   9. <mark style="color:green;">**Zero One plugin updated to Version 5.0.0**</mark>
   10. <mark style="color:green;">**Added Kirby Form Block Suite plugin -**</mark> NOTE that this is modified version of the original [Kirby Form Block Suite](https://github.com/youngcut/kirby-form-block-suite) plugin
   11. <mark style="color:green;">**Added Resave plugin**</mark> - This is the custom plugin created with the help of Bastian Allgeier. This plugin helps to update your old version Zero One content to new Zero One version.
5. **Changes in&#x20;**<mark style="color:purple;">**site/theme/**</mark>**&#x20;folder**
   1. <mark style="color:red;">Removed Commentions snippets</mark>
   2. <mark style="color:green;">Added Form Builder customisations</mark>

## 4.5.2 -- 04.10.2023

This minor update fixes some recently discovered Safari browser issues, primarily with background images. From now on, we are adding Safari testing to our regular workflow because they had several strange updates in the last year, and now Safari behaves differently than other browsers.&#x20;

{% hint style="info" %}
**How to update?**

<mark style="color:blue;">**If you already have the Zero One 4.5.0 or higher version then delete:**</mark>

* **`assets/app` folder**
* **`kirby` folder**
* **`site/plugins/zero-one` folder**&#x20;

<mark style="color:blue;">**and add the same ones from Zero One version 4.5.2**</mark>

* **`assets/app` folder**
* **`kirby` folder**
* **`site/plugins/zero-one` folder**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**

<mark style="color:red;">**If you are updating from a version earlier than Zero One 4.5.0 then update as noted in the 4.5.0 instructions below.**</mark>
{% endhint %}

#### What does this update bring?

* Besides Safari-related fixes, we also improved the performance of all background images (header, layout section, column, card, megamenu...)
* There is also one **new feature**: To-top button
  * You can turn it on in the Site Settings sidebar options

## 4.5.1.1 -- 08.08.2023

This is a minor update that brings some important security fixes for Kirby, but it also brings several improvements.&#x20;

{% hint style="info" %}
**How to update?**

<mark style="color:blue;">**If you already have the Zero One 4.5.0 or higher version then delete:**</mark>

* **`assets/app` folder**
* **`kirby` folder**
* **`site/plugins` folder**&#x20;
  * If you added some additional plugins make sure to skip those.
* **`composer.json` file**
* **htaccess file (if you already added something additional to this file, don't delete it, scroll a little bit down, there is a piece of code you need to add to this file)**

<mark style="color:blue;">**and adding the same ones from Zero One version 4.5.1.1**</mark>

* **`assets/app` folder**
* **`kirby` folder**
* **`site/plugins` folder**
* **`composer.json`file**
* **htaccess**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**

<mark style="color:red;">**If you are updating from a version earlier than Zero One 4.5.0 then update as noted in the 4.5.0 instructions below.**</mark>
{% endhint %}

#### Security fix

The Kirby 3.9.6 security fix <https://github.com/getkirby/kirby/releases/tag/3.9.6> is fixed by updating Kirby, but to strengthen it further the code below should be added to htaccess file

```apacheconf
# set security headers in all responses
<IfModule mod_headers.c>

# serve files as plain text if the actual content type is not known
# (hardens against attacks from malicious file uploads)
Header set Content-Type "text/plain" "expr=-z %{CONTENT_TYPE}"
Header set X-Content-Type-Options "nosniff"

</IfModule>
```

#### Zero One improvements

* Few styling improvements for buttons and custom decimal list
* Kirby Robots txt plugin updated to the latest version
* **New feature:** Card block now has an image and link option 🚀&#x20;
  * Now you can create beautiful cards with image top/bottom and link it some other content

## 4.5.1 -- 19.07.2023

Hi there, here we go! The new update is ready 🥳 Actually this is only the first part of one big update. And this is the smaller part, but it brings some important fixes and improvements. We didn't want you to wait all the way, and to lower the pressure on us here it is.&#x20;

{% hint style="info" %}
**How to update?**

<mark style="color:blue;">**If you already have the Zero One 4.5.0 or higher version then delete:**</mark>

* **`assets/app` folder**
  * If you added your fonts or something else to the assets folder, make sure to skip those
* **`kirby` folder**
* **`site/plugins` folder**&#x20;
  * If you added some additional plugins make sure to skip those.
* **`composer.json` file**

<mark style="color:blue;">**and adding the same ones from Zero One version 4.5.1**</mark>&#x20;

* **`assets/app` folder**
* **`kirby` folder**
* **`site/plugins` folder**
* **`composer.json`file**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**

<mark style="color:red;">**If you are updating from a version earlier than Zero One 4.5.0 then update as noted in the 4.5.0 instructions below.**</mark>
{% endhint %}

#### What this update brings:

* **Complete PHP 8.2 compatibility in all environments**
* **Kirby updated to 3.9.5**
* Plugins updated:
  * [Kirby 3 Similar](https://github.com/texnixe/kirby3-similar) plugin
  * Sitemapper plugin
* New Style Compiler options, and general styling improvements
  * **You can now fine-grain shadows per element, and add your own shadows** 🚀
  * **You can now change responsive breakpoints** 🚀
  * Offcanvas overlay options
  * Changed LESS files in `assets/app/custom/elements/` folder
    * button.less
    * card.less
    * dotnav.less
    * form.less
    * navbar.less
    * offcanvas.less
    * variables.less
* Blocks selection is improved
  * Change in `assets/css/panel.css` file
* **SEO improvements** 🚀
  * Site SEO settings improved
    * Basic Structured Data (Schema) added, you can turn it on in Site SEO & Files tab
  * Page SEO improved
    * Now when you omit a page from the sitemap “noindex, nofollow” will also be added to that page
* New Email option in Site Settings (in the sidebar), to choose or not to see the sender's IP address
* **Page Options to hide Navbar and Footer** 🚀 Great for landing pages
* **Advanced tab added all pages. Now you can add custom CSS to the page** 🚀
* **Blog, Work, and Shop templates now have the option to add additional content using Layout Builder before or after subpages listing** 🚀
* More layouts added to Layout Builder and Subgrid block 🚀
* Changes to allowed template selection on creation
  * Changed order
  * Now is allowed to create Blog, Work, and Shop as subpages 🚀 Let us know if you bump into some issues when running these templates as subpages
* **Button block now has anchor link as one of the options** 🚀
* Fixes
  * One rarely caused issue was fixed for submenu generation
  * Currency issue in Featured products block
  * Layout section Custom class issue
  * Page Builder Hero block issue
  * Added missing LinkedIn icon to icons list

#### What we are working on:

* Zero One Form Builder
* Panel translatability (if you are one of the file code "explorers" you will see that a fair amount of work is already done 🙂)
* Panel translation to French
* Heavy improvement of the Blog template and Article template
* Heavy improvement of the Work template
* New blocks:
  * Lead block
  * Tab block
  * Features block
  * Timeline/steps block
  * And more
* Various improvements on already included blocks
* Styling improvements
* New demos

## 4.5.0.2 -- 22.03.2023

This is a small update that brings some fixes, compatibilities, and one cool new feature.

{% hint style="info" %}
**How to update?**

If you already updated to the Zero One 4.5.0 version then delete:

* **`assets/app` folder**
* **`kirby` folder**
* **`site/plugins` folder**&#x20;
* **`composer.json` file**

**and adding the same ones from Zero One version 4.5.0.2**&#x20;

* **`assets/app` folder**
* **`kirby` folder**
* **`site/plugins` folder**
* **`composer.json`file**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**

<mark style="color:red;">**If you are updating from a version earlier than Zero One 4.5.0 then update as noted in the 4.5.0 instructions below.**</mark>
{% endhint %}

#### What this update brings

* Kirby updated to 3.9.2
* Compatibility with PHP 8.2 🚀
  * NOTE: if you have errors with 8.2 version make sure to update PHP to the latest version
* Kirby Link Field plugin updated to the latest version
* Less PHP plugin updated to the latest version
* Media index settings
  * There is a new toggle in Site Settings where you can choose what files you can select in image select fields throughout the website. For some users this will be a superb feature 🚀

#### There is also a new demo - Personal website 🚀

You can see it at <https://www.thezero.club/demo/one-personal/>

## 4.5.0.1 -- 14.02.2023

This is a small update that fixes a few bugs. Now Zero One is bug-free! (to our knowledge)&#x20;

{% hint style="info" %}
**How to update?**

If you already updated to the Zero One 4.5.0 version then delete:

* **`assets/app` folder**
* **`site/plugins/zero-one` folder**&#x20;
* **`composer.json` file**

**and adding the same ones from Zero One version 4.5.0.1**&#x20;

* **`assets/app` folder**
* **`site/plugins/zero-one` folder**
* **`composer.json`file**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**

<mark style="color:red;">**If you are updating from a version earlier than Zero One 4.5.0 then update as noted in the 4.5.0 instructions below.**</mark>
{% endhint %}

#### What this update brings

* Solves 3 bugs/errors
  * small bug with new hreflang links for multi-language websites
  * image select bug in footer layout builder blocks
  * external source image bug in Image blocks
* UIkit updated to 3.15.24 version
* Added new Mastodon icon

After this update today, in most of the files select fields you will be able to select an image (or video, or audio in specific files) from anywhere on the website, from any page or site on any page and site. 🚀 This feature is something many of you requested.&#x20;

## ⚠️ 4.5.0 -- 10.02.2023

And finally, this update arrived 🙏 We are sorry it took longer than expected, we wanted to make many improvements, and make better organisation of the old codebase.&#x20;

{% hint style="warning" %}
**Important note:** although Zero One now uses Kirby 3.9.1 version, it is not yet fully compatible with PHP 8.2, and that's primarily because of [Kirby 3 Similar](https://github.com/texnixe/kirby3-similar) plugin. We expect that to be solved very soon. Also, Kirby dropped support for PHP 7.4 from 3.9 version so make sure to update to PHP 8.0 or 8.1.&#x20;
{% endhint %}

{% hint style="info" %}
**How to update?**

If you haven't made changes to the theme files or installed additional plugins, you can update easily by deleting these old folders/files in your install:

* **`assets` folder**
  * if you added custom fonts, **just skip the fonts folder and fonts.css file**, but make sure to update all other files, there are many changes to all files
* **`site/plugins` folder**&#x20;
  * some plugins are removed, and some new added, make sure to do this properly
* **`kirby` folder**
* **`site/config/config.php` file**
  * yes, there are some important changes to config this time
* **`composer.json` file**

**and adding the same ones from Zero One version 4.5.0**&#x20;

* **`assets` folder**
* **`kirby` folder**
* **`site/plugins` folder**
* **`site/config/config.php` file**
* **`composer.json`file**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**
{% endhint %}

{% hint style="danger" %}
**Breaking changes in this update:**

* Snipcart options are moved from the Shop page to Site Settings. Now is possible to have many infinite numbers of Shop pages and use them as categories.&#x20;
* The products cover image ratio option is moved to Site Settings
* Projects cover image size options are moved to Site Settings
* Dropped support for PHP 7.4
  {% endhint %}

#### What this update brings:

1. UIkit updated to version 3.15.23
2. Getkirby updated to version 3.9.1 🚩
3. **New Main Menu Builder** 🚀 Now you can choose whether the main navigation will be generated from pages structure, or you will create custom navigation with the builder. Also, the builder brings solutions for landing pages and link anchors
4. **Mega menu possibilities** 🚀 Now you can turn your subpages dropdowns to mega menus, customize width and background, similar to what you can do with layout backgrounds.
5. **Icons for menu items** 🚀
6. **Additional icon for right-side navigation** 🚀
7. **Navbar button improvements** 🚀
8. **Products search virtual page** 🚀
9. **Products search block** 🚀
10. **Products list block** 🚀
11. **Better search plugin integrated** 🚀 Now Zero One search works much better
12. **New Audio/Podcast block** 🚀
13. **New Typed (Animated) text block** 🚀
14. **New Syntax Highlighting option for Code block** 🚀
15. **New custom navigation block** 🚀
16. New mobile logo options
17. New dedicated file templates for each file type
18. Added proper hreflang support for multi-language websites
19. Improved categories and tags to support multiple words fully
20. Improved general theme styling, especially for buttons and cards
21. **New button styling options** 🚀 Now you can customize buttons in the panel
22. Panel styling improvements
23. Panel organization improvements
24. Related articles are now slider
25. Related products are now slider
26. Almost all blocks have some improvement, either it is some new option or better code quality
27. Almost every blueprint file was optimized and improved
28. Fixed multilanguage issue with Custom CSS input
29. All plugins updated to the latest versions
30. Removed Kirby 3 Janitor plugin. It has some braking changes, we can't deal now with.
31. Zero One got rebranded, it has a new logo now. 😀

**And to say it again, almost every file has some changes, so make sure to update properly.**&#x20;

## 4.4.0 -- 11.08.2022

And thank God, this update is finally finished 🙏 It was super difficult in terms of strategy and amount of changes, but also in user experience aspects and testing. That's why it took much longer than expected to complete. But you will love the results! 🚀&#x20;

#### New Layout Builder has arrived! 🚀

Many many new things are possible now, but it is just a starter of what's coming in the next couple of updates.&#x20;

You can see Layout Builder in action at <https://www.thezero.club/demo/one/builders/layout-builder>. Make sure to check out the subpages too, there are some interesting examples of new possibilities!

Learn more in the documentation <https://www.one.thezero.club/guide/layout-builder>

#### New demo

Yeeey, there is a new demo <https://www.thezero.club/demo/one-furniture/>

#### New blocks:

* **Layout Builder specific**
  * Column options! 🚀 You can fine-grain the behaviour of every column!
  * Subgrid
  * Card
  * Content slider
  * Image slider
  * Slideshow
  * Gallery
  * Articles
  * Projects
  * Products
* New Table block! 🚀
* Description list block
* HTML block
* Page links list block! 🚀 Useful when you want to add a list of links automatically and dynamically

#### Improved blocks:

* Heading block! Many new options 🚀
* Text block! Also many new options 🚀
* Image block! Many new great options 🚀 Now you can custom resize every image, and use the new Ratio feature! Great improvement for image sizes and performance, and visual display too!
* Markdown block
* Page Builder Hero and Grid block now have SVG divider option!

#### What else this update brings:

* New blog articles layout! 🚀
* Footer can now be fully created with Layout Builder! 🚀 Super useful!
* Home and Project template pages now have option to switch between old Page Builder and new Layout Builder
* Product pages description now can be created with Layout Builder! 🚀
* Shop now has an additional 4 column grid option
* Select images from Site not only from Page! 🚀 This option is added to many places. For example, when you choose page background image in the selection will be shown images from site (root folder) not only from the page folder.
* Site blueprint is now divided into sections, which are separated files. Very useful if you are making custom Site options and changes to site.yml file.
* composer.json changed (versions)
* Kirby updated to 3.7.3 version
* UIkit updated to 3.15.1 version
  * **Changed files in `assets/app/custom/` folder**
    * elements/card.less
    * elements/dotnav.less
    * elements/offcanvas.less
    * elements/slideshow\.less
    * elements/variables.less
* Commentions plugin updated to 1.0.7 version
* K3 image clip plugin updated to 3.1.0 version
* Kirby3 Janitor plugin updated to 2.16.1 version
* Table field plugin added and integrated

{% hint style="info" %}
**How to update?**

If you haven't made changes to the theme files or installed additional plugins, you can update easily by deleting these old folders/files in your install:

* **`assets` folder**
* **`site/plugins` folder**
* **`kirby` folder**
* **`composer.json` file**

**and adding the same ones from Zero One version 4.4.0**&#x20;

* **`assets` folder**
* **`kirby` folder**
* **`site/plugins` folder**
* **`composer.json`file**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**&#x20;
{% endhint %}

{% hint style="warning" %}
Make sure to go through new options, specifically to the Home page, to select the prefered page builder, and to Site Settings footer options to set the prefered footer builder. **And of course to test the new Layout Builder!** 🚀
{% endhint %}

## 4.3.2 -- 11.05.2022

It seems that we just can't create small updates. 😬 Although you have been active with requests and ideas, so we decided to make you happy. 😎

#### This update brings some cool stuff:

* SVG shape divider for header area ([see video](https://twitter.com/YourZeroBase/status/1516364339606925317?cxt=HHwWisC5xabVmosqAAAA)) 🚀
* Custom cover sizes for Projects, and few more options (Masonry possible too)  🚀
* New options for Site Styling (compiler)
  * Global border width
  * Navbar font options
  * Offcanvas colors and size options
  * Many new typography options
* Snipcart updated to 3.4.0 version with new scripts loader, only when called. Speed boost 🚀
* Many new footer options 🚀
* New custom product fields (checkbox, text, textarea, read-only)
* Articles now support multiple authora (co-authors)&#x20;
* Improved image performance&#x20;
* Various fixes
* Added some examples to Zero One blank demo
* Kirby updated to 3.6.6
* Kirby3 Janitor plugin updated to 2.16.0 version (No more issues)

{% hint style="warning" %}
**Make sure to go through new options in:**

* Site Settings (Header Options, Footer)
* Labels
* Site Styling
* **Header background image in pages now have a switch you must turn on**. Adding that option allowed us to improve many things. For example, now is possible to choose only color without image. But, unfortunate thing is that you must turn on that switch on every page you already had background image for the header.
* Work template

Also, don't forget you can copy paste Page Builder blocks, and even the whole Page Builder pages. 🚀 I see many still forget about this.
{% endhint %}

**If you made some changes to LESS/CSS files:**

* Some code is removed from `assets/app/custom/app.less` and added to `assets/app/custom/elements/projects.less` and `assets/app/custom/elements/products.less`
* New `assets/app/custom/elements/shapedivider.less`
* Modified `assets/app/custom/elements/_import.less` to support that

A reminder that you don't ever need to change Zero One plugin files (`site/plugins/zero-one/`) because you can always overwrite Zero One files using this system <https://www.one.thezero.club/guide/theme-extending>

## 4.3.1.1 -- 11.04.2022

**PHP 7.4 compatibility fix**

The updated plugin [Kirby3 Janitor](https://github.com/bnomei/kirby3-janitor) caused it. Version 2.15.0 only works with PHP 8.0 and higher.

The issue is reported <https://github.com/bnomei/kirby3-janitor/issues/71>

**SOLUTION:** We reduced Kirby3 Janitor version to 2.13.0

## 4.3.1 -- 09.04.2022

**Improvements, fixes and new features! 🚀**&#x20;

This update brings:

* PHP 8.1 compatibility
* All images now auto-convert to WebP with fallback to the original, even the background images! 🚀 And you don't have to do anything. 😎 Just update to this version and your website will be more than a double lighter.&#x20;
* Variable products! 🚀 Now your products can have custom options 🥳
* Three image sizes for product images! Not just square anymore
* Product quantity now has cool buttons! 🐱‍🏍
* New Cookie consent option! New inbuilt option for cookie consent. You can choose between popup or modal 🥳
* Gallery content block improved! Thanks to Demlak for this 🙏
* Mobile navigation improved!&#x20;
  * The parent page is now clickable! Thanks to Demlak for this too 🙏
  * Sub sub pages are now supported too!
* Articles sorting in navigations fixed ❗
* Blog sorting fix ❗ We made one error in the previous version, which is now fixed.
* Improved custom code experience in the panel with code-highlighting features
* Kirby updated (and tested) to version [3.6.4](https://github.com/getkirby/kirby/releases/tag/3.6.4)
* Third-party plugins updated and tested
* Getuikit updated (and compatibility changes made) to version 3.13.7
* Snipcart updated to 3.3.3 version

#### What files are changed?

Almost every single file, so no point in writing them.

#### Breaking changes?

We are dropping out the main Zero One demo from the download. But more demos are on the way, which will be of more use.&#x20;

## 4.3.0 -- 24.02.2022

**And finally! Zero One has e-commerce power!** 🚀&#x20;

It took longer than we expected, but it is better than many anticipated 😎 It is a full feature e-commerce shop, with all power you can expect from the best.&#x20;

And that's not all, there are many improvements too, let's list the most important:

* Updated:
  * Kirby to 3.6.2 version
  * UIkit to 3.11.1 version
  * Kirby plugins to the latest versions
* Improved:
  * Added `translate: false` for styling fields and a few more
  * Latest Articles (Page Builder) now support multiple blogs, you can select now
  * Latest Projects (Page Builder) now support multiple work pages, you can select now
  * The Blog page now has an option to create any date format you like
  * Blog archive pages&#x20;
  * Contact form inputs security
  * SEO meta
  * Mobile navigation
  * And many code optimisations
* New:
  * Full feature [shop](https://www.thezero.club/demo/one/shop)! 🚀 Learn more at <https://www.one.thezero.club/guide/shop-page>
  * [Featured products](https://www.thezero.club/demo/one/page-builder/featured-products-section) Page Builder section

{% hint style="info" %}
**How to update?**

If you haven't made changes to the theme files or installed additional plugins, you can update easily by deleting these old folders/files in your install:

* **`assets` folder**
* **`site/plugins` folder**
* **`kirby` folder**
* **`composer.json` file**

**and adding the same ones from Zero One version 4.3.0**&#x20;

* **`assets` folder**
* **`kirby` folder**
* **`site/plugins` folder**
* **`composer.json`file**

**and removing the next lines from** `site/config/config.php`

```php
// https://getkirby.com/docs/reference/system/options/date
'date'  => [
    'handler' => 'strftime'
],
```

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh any page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**&#x20;

**Also, go to and fill in new options:**

* Site Settings tab (**NEW OPTIONS**)
* Labels tab (**MANY NEW LABELS**)
* Blog page (**ADD DATE FORMAT**)
  {% endhint %}

## 4.2.0 -- 12.01.2022

This update brings several important fixes and one long-anticipated feature. 🚀

* Fixes
  * Panel language change error caused by Sitemapper plugin
  * Footer background image issue (Thanks Reto Frei for reporting!)
  * Improved page transitions
* Features
  * **NEW** Navbar transparent options, site-wide and page override (Project and Article also)
  * Editor permissions improved
  * **NEW** Main navigation dropdown page option. Select whether a specific page should have subpages visible in the main navigation. Now you can have multiple Blog or Work pages without issues.

{% hint style="warning" %}
After updating you must go to Blog and Work template pages and in the Page Options tab toggle the new Disallow submenu option.
{% endhint %}

## 4.1.0.1 -- 11.12.2021

Just a small fix, in Site Settings in Page transitions we missed including the link to documentation page <https://www.one.thezero.club/guide/theme-extending/page-transitions-swup>.

## 4.1.0 -- 10.12.2021

Kirby 3.6 compatibility and bundle of improvements!

#### In short:

* Kirby updated to 3.6.1.1 and compatibility changes made
  * **FEATURE:** Now you can copy-paste blocks and more than that! 🚀
  * **FEATURE:** Writing experience is improved with new Writer/Text field 🚀
* UIkit updated to 3.9.4
* All plugins are updated
* Cachebuster plugin replaced with [Kirby3 Fingerprint](https://github.com/bnomei/kirby3-fingerprint) plugin
* New maintenance options in the panel.&#x20;
  * **FEATURE:** Now you can clear the pages cache from the panel 🚀
  * **FEATURE:** You can create a website backup from the panel 🚀
* **FEATURE:** New topbar option
* **FEATURE:** New fensy-shmensy page transition effects 🚀
* **FEATURE:** New Site Settings options&#x20;
* General panel improvements &#x20;
* **FEATURE:** Improved custom CSS experience 🚀
* Contact form submit anchor added
* SEO meta improvements
* Many code reorganisations, optimisations and improvements

{% hint style="info" %}
**How to update?**

If you haven't made changes to the theme files or installed additional plugins, you can update easily by deleting these old folders/files in your install:

* **`assets` folder**
* **`kirby` folder**&#x20;
* **`site/plugins` folder**
* **`site/config/config.php` file**
* **`.htaccess` file**
* **`composer.json` file**

**and adding the same ones from Zero One version 4.1.0**&#x20;

* **`assets` folder**
* **`kirby` folder**&#x20;
* **`site/plugins` folder**
* **`site/config/config.php`file**
* **`.htaccess` file**
* **`composer.json`file**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh some page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**&#x20;
{% endhint %}

## 4.0.2 -- 06.08.2021

New content blocks, improvements, and updates!

**In short:**

* Kirby updated to 3.5.7.1
* Language switch improvements
* Sticky navbar now has a fixed option
* Table block now supports Html elements
* New content blocks
  * Banner
  * Contact form

If you made changes to LESS/CSS files, and want to manually add new code, these are the changes:

**Added code**

{% code title="assets/app/custom/app.less" %}

```css
/* Language */
.tm-language {
    letter-spacing: 1px;
}

/* Banner */
.tm-banner-overlay {
    position: relative;
    background: @global-background;
    top: -40px;
    left: -20px;
    max-width: 90%;
    padding: 20px;
}
```

{% endcode %}

**Changed code**

{% code title="assets/app/custom/elements/navbar.less" %}

```css
FROM THIS
.hook-navbar-nav-item() {
    position: relative;
    letter-spacing: 1px;
    padding-bottom: 3px;
    
INTO THIS
.hook-navbar-nav-item() {
    position: relative;
    letter-spacing: 1px;
```

{% endcode %}

## 4.0.1 -- 20.06.2021

This is just a small fix. Email templates were not linked correctly, so the contact form didn't work. If you do not want to download the new version only for this, you can fix it yourself.

Just go to `site/plugins/zero-one/index.php` find line 114 and

```yaml
// CHANGE THIS
'email.html' => __DIR__ . '/templates/emails/email.html.php',
'email' => __DIR__ . '/templates/emails/email.php'

// INTO THIS
'emails/email.html' => __DIR__ . '/templates/emails/email.html.php',
'emails/email' => __DIR__ . '/templates/emails/email.php'
```

## ⚠️ 4.0.0 -- 14.06.2021

**Here we go! Zero One becomes a Kirby plugin!** 🚀

We completely restructured everything, went through every theme file, made many improvements, and added many new options.&#x20;

#### Here goes the list of notable improvements:

* Page Builder visual and performance improvements
* Improvement of every Page Builder section
* Improvement of every Content blocks block
* New Content blocks
  * Accordion
  * Button
  * Table
* Advanced background options all over the place, in blocks, header, and footer
* Parallax background is possible now
* Grid section has many new options, sub-grid is possible now too
* Hero has a video background option
* The navbar now can have a centered logo and subnav can be styled by your liking
* New navbar links effect (you can choose between old and new effect)
* New header options
* Improved animations in many places
* New styling options, now your website can have shadows or rounded corners on some elements
* Improved buttons
* New Work/Projects options and styling improvements
* Article styling improvement
* New slideshow options
* And many more small fixes and improvements

**But, most importantly Zero One becomes a plugin!** Why is this so great? Because you can overwrite any plugin file by copying it to your theme folder. Change it, extend it, and safely update Zero One to new versions without worry. Your changes will stay untouched. Like a WordPress child theme, but more powerful.

{% hint style="info" %}
**HOW TO UPDATE TO THE 4.0.0 VERSION?**&#x20;

**If you haven't made changes to the theme files or installed additional plugins, you can update easily by deleting these old folders in your install:**

* **`assets` folder**
* **`kirby` folder**&#x20;
* **`site/plugins` folder**
* **`site/theme` folder**
* **`composer.json`**

**and adding the same ones from Zero One version 4.0.0:**&#x20;

* **`assets` folder**
* **`kirby` folder**&#x20;
* **`site/plugins` folder**
* **`site/theme` folder**
* **`composer.json`**

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh some page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**&#x20;
{% endhint %}

{% hint style="warning" %}
**Note that you will have to go through your website content and fix some things because there are new options in:**

* **Site Settings Tab**
* **Site Styling Tab**
* **Pages header background image**
* **In Page Builder blocks (Hero, Grid, Slideshow\...)**
* **Crop the featured image again in Projects (the size has changed)**
  {% endhint %}

**If you made changes to some theme files, I hope you wrote documentation of your changes and know what those files are.** Because Zero One is a plugin now, every file you leave in `site/theme/` folder will overwrite the same file from `zero-one` plugin. **For example:**  `site/theme/snippets/header.php` will overwrite `site/plugins/zero-one/snippets/header.php` and the same is with any other file. So you can actually update to Zero One version 4.0.0 if you do that properly (leave your changed files in the `site/theme/` folder).

You will see that there are few files left in `site/theme/` folder. They are in `site/theme/snippets/` folder to be exact. Those are files that overwrite Commensions plugin form files, and they are needed to stay there.&#x20;

## ⚠️ 3.0.0 -- 20.02.2021

**And finally!** We know this update release took longer than expected, but Kirby 3.5 brought extensive changes to many functions Zero One is using. Primarily, we are speaking about the new Kirby Blocks field - Kirby Builder and Kirby Editor plugins in one core field. Also, some plugins we use in Zero One needed compatibility fixes.&#x20;

**Kirby builder migration to Blocks field went smoothly, but there are some issues with Editor plugin migration to Blocks field. The Editor is mostly used in articles, but there is also a Page Builder Editor block.**&#x20;

{% hint style="danger" %}
**Some Editor blocks are gone in the transition:**

* Gallery (we created a new block, but it won't update your old content)
* Table (coming soon)
* Intro (we created a new block, but it won't update your old content)
* Info (we created a new block, but it won't update your old content)

So, wherever you used these blocks you will need to recreate them after the update.&#x20;

**Also, after updating to Zero One 3.0.0, you will need to click on every text block in the Editor and save it again.** Because Kirby doesn't add `<p>` tags in transition. I wrote about that and a few more issues to the Kirby team in the forum <https://forum.getkirby.com/t/editor-to-blocks-lost-features/20483>. Recently, Bastian made an announcement about that subject  <https://forum.getkirby.com/t/the-end-of-the-editor-plugin/21167>

**Remember, if you don't want to update, your website is working perfectly fine, you can always stay on your current Zero One version. It will always work correctly as long as the PHP version is available, which is a decade for sure.**
{% endhint %}

{% hint style="success" %}
We must give big thanks and praise to Bastian and Kirby team for the hard work they invested in Kirby 3.5 version. Also, personally to Bastian, because he checked and updated some things in the Zero One theme himself. He is, besides being a great creator, a great human bei
{% endhint %}

{% hint style="info" %}
**If you haven't made changes to the theme files or installed additional plugins, you can update easily by deleting these old folders in your install, and adding new from Zero One version 3.0.0:**

* **assets folder**
* **kirby folder**&#x20;
* **site/plugins folder**
* **site/theme folder**&#x20;

**After that turn on** [**Style Compiler**](https://www.one.thezero.club/guide/theme-styling) **in site options, refresh some page, and your theme styles will be recreated. Of course, turn off Style Compiler after that.**&#x20;
{% endhint %}

#### We deleted older changelog logs to lighten this page a bit. Keep only the last 2 years of logs.

[^1]: Read \*Reminder below


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.one.thezero.club/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
