Config options

A reminder that Kirby config options docs can be found at https://getkirby.com/docs/guide/configuration, but here we will explain what is in Zero One theme config.

Multi-environment setup

From Zero One version 1.1.0 in zero-one/site/config/ folder there are three files:

  • config.php

  • config.localhost.php

  • and config.www.thezero.club.php. This one you should rename to your domain name.

The config.localhost.php and config.yourdomain.com.php should have only those options that are different on localhost and on live server. In Zero One default setup only difference is a debug option, which is at localhost set to true, and on live server set to false.

If you are not using a multi-environment setup you can add all config options into site/config.php and delete the other configs.

One of the options you will need to add on the live server if you want to edit content from the panel is panel install, see more at https://www.one.thezero.club/guide/installation/server#panel-install.

# Example setup

/site/config/config.localhost.php
/site/config/config.staging.yourdomain.com.php
/site/config/config.yourdomain.com.php
/site/config/config.www.yourdomain.com.php

Learn more https://getkirby.com/docs/guide/configuration#multi-environment-setup

Debug

Debug is set to true in localhost and of course to false on the server.

Custom panel CSS

There is an import for the custom panel CSS file. Zero One use it to customize Editor user role permissions. That file is assets/css/panel.css and you can customize it further.

Smartypants

Smartypants are on by default in Zero One. Learn more about it at https://getkirby.com/docs/reference/system/options/smartypants

Autoresize

To save time with images we integrated the great Kirby Autoresize plugin from Thomas Günther, and choose to resize every image larger than 2500px to that size. You can change it to another size if it suits you. It is also configured to set the resized image quality to 85%. You can change that too.

Srcset

There is a srcset image size setup, and it is used only for images inserted into Editor in articles.

Robots

There is also some settings code for Kirby 3 Robots.txt plugin from Bruno Meilick. You can add your custom rules, so check the plugin documentation.

Sitemap

The Zero One theme has a sitemap integrated using https://gitlab.com/kirbyzone/sitemapper Kirby plugin. It is added in the Kirby 3 Robots.txt plugin config data.

Language detect support

Learn more about it https://www.one.thezero.club/guide/site-options/multi-language#languages-detect-support

If you are using multi-domain (separate domain for language), language detect can't work, so please turn it off. You can remove whole language detect code from config file.

Commentions plugin options

From Zero One version 5 the Commention plugin is removed because its author discontinued its development.

Hooks

There is also a little site.update:after hook which is needed to write CSS code from Site Styling Custom CSS input to assets/css/site.css.

Plugins

We also disallowed version info for some plugins that shouldn't have that information.

And that's it, the rest is up to you. 🙂

Last updated