NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #4129 most downloaded on Packagist
The Kirby core
Latest stable
5.6.3
Last release 17 days ago
05 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
297 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Custom asset methods #4989 (thanks to @tobimori)
$block->field(), $layout->field() and $layoutColumn->field(). #5053A::keyBy() method to add keys to an array (thanks to @adamkiss) #5040flip and sortBy #5035youtube embed JS helper #5059A::fill accepts a closure/callable (thanks to @adamkiss) #5036$helper.field.form(fields) function to set up values for an empty form #5076Page::create() doesn’t ignore isDraft prop any longer (thanks to @SeriousKen) #5042Pages::factory() correctly considers isDraft/draft props as well as $draft parameter (thanks to @SeriousKen) #5043alt attribute issue for asset() helper #5066->inline(), ->nl2br() and ->toTimestamp() field methods when field is empty or not exists #5063doNotTrack argument in youtube embed JS helper #5059when condition #4838Unauthenticated response #4967Dir::index(): $ignore parameter works now #5010Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Deprecation warnings can now be disabled granularly by setting Helpers::$deprecations[' '] = false in your site/config/config.php. You can find the po…
Helpers::$deprecations['<deprecation-key>'] = false in your site/config/config.php. You can find the possible deprecation keys in kirby/src/Cms/Helpers.php. #5014Xml::attr() (introduced in 3.9.0) is no longer displayed by default because there are use cases where both the old and new behavior are fine. If you still want to check your code, you can enable the deprecation warning with Helpers::$deprecations['xml-attr-empty-string'] = true. #4934null is now handled gracefully #5004Nothing published for this version
We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.9
We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.9
Nothing published for this version
Nothing published for this version
The multiselect field search works again #4951
Vue: Usage of v-model on all Kirby components (and in general) has been soft-deprecated (no consequences yet, but strongly recommend to avoid it/move…
page('note').cover.toFile?.url does not crash anymore when no cover file is present, but returns nulla ? b : c, a ?: c and a ?? bpage.render:before|after: https://kirby.nolt.io/419language.create:before|after: It is triggered when a new language is created.language.update:before|after: It is triggered when the language is updated.language.delete:before|after: It is triggered when the language is deleted.'content.uuid' => 'uuid-v4' to switch the built-in UUID generator to UUID v4 mode #4868Uri::domain() might contain the auth and port parts, by explicitly mentioning them in the docblock. #4846info prop can be translated #4840v-model on all Kirby components (and in general) has been soft-deprecated (no consequences yet, but strongly recommend to avoid it/move away from it). Use :value="" @input="" instead, e.g.// before
v-model="myValue"
// now
:value="myValue"
@input="myValue = $event"
::class notation fro better IDE support #4826Database package #4812set(), del() #4817$children usage #4818v-bind usage #4819v-model occurrences with :value="value" @input="value = $event", due to https://v3-migration.vuejs.org/breaking-changes/v-model.html #4822Nothing published for this version
Nothing published for this version
Old Kirby\Toolkit\Query class has been deprecated and will be removed in Kirby 3.10.0. Use Kirby\Query\Query instead, e.g.Query::factory($query)->reso…
kirby, collection("your-collection"), page("blog"), file("blog/test.pdf"), site, user("homer"), t("your.i18n.key")site.myLazyFunction(() => site.children) - no support for parameters or others, only as lazy-calling measureKirby\Query namespace with new Kirby\Query\Query class (to be used going forward for queries). Old Kirby\Toolkit\Query class has been deprecated and will be removed in Kirby 3.10.0. Use Kirby\Query\Query instead, e.g.Query::factory($query)->resolve($data). #4626
new Query($query, $data): Passing $data to constructor will be deprecated. Use (new Query($query))->resolve($data) instead.Query::result() will be deprecated. Use $query->resolve($data) instead.Nothing published for this version
This vulnerability allowed user enumeration, which is a type of vulnerability that allows attackers to confirm which users are registered in a Kirby i…
Severity: medium (CVSS score 4.8)
Errors that occur during the processing of the code-based login and password reset were in some cases passed to the user. This includes errors of the code challenge itself (e.g. if the email could not be sent) and errors thrown inside the user.login:failed hook.
This vulnerability allowed user enumeration, which is a type of vulnerability that allows attackers to confirm which users are registered in a Kirby installation. This information can be abused for social engineering attacks against users of the site or to find out the organizational structure of the company.
This vulnerability only affects you if you are using the code or password-reset auth method with the auth.methods option. It can only be successfully exploited under server configuration conditions outside of the attacker's control.
Thanks to Florian Merz (@florianmrz) of hatchery.io for responsibly reporting the identified issue.
Severity: medium (CVSS score 6.5)
We used the opportunity to review other parts of Kirby's authentication handling and found another part that is affected by a similar user enumeration vulnerability caused by a response discrepancy in Kirby's brute force protection system.
This vulnerability affects all Kirby sites with user accounts (unless Kirby's API and Panel are disabled in the config). It can only be exploited for targeted attacks because the attack does not scale to brute force.
content.uuid option #4755F::load() and F::loadOnce() now guard against unintended output when passing a new 4th parameter $allowOutput as false #4656A::merge($array1, $array2, $array3, A::MERGE_APPEND) now supports to merge more than 2 arrays #4675store prop description #4780go($site->homePage()) redirects to absolute URLs again. #4781uuid value for models when the content.uuid option is disabled #4787UUIDs can be deactivated locally via content.uuid option #4755
content.uuid option #4755F::load() and F::loadOnce() now guard against unintended output when passing a new 4th parameter $allowOutput as false #4656A::merge($array1, $array2, $array3, A::MERGE_APPEND) now supports to merge more than 2 arrays #4675store prop description #4780go($site->homePage()) redirects to absolute URLs again. #4781We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.8
We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.8
Nothing published for this version
Nothing published for this version
Nothing published for this version
One last 3.7.x release with a few useful improvements and bug fixes (while also correcting what GitHub considers our latest release).
One last 3.7.x release with a few useful improvements and bug fixes (while also correcting what GitHub considers our latest release).
video KirbyTag will automatically add the playsinline attribute whenever the autoplay option is enabled https://github.com/getkirby/kirby/pull/4596url field to remove non-functional pattern property https://github.com/getkirby/kirby/issues/4597$query->where() (including orWhere() and andWhere()) on a database query object with the last argument being the number zero no longer creates an invalid query in PHP 7.4 https://github.com/getkirby/kirby/pull/4607kirby repository, the CI no longer fails at the Codecov reporting step https://github.com/getkirby/kirby/pull/4606You are also *not* affected by these vulnerabilities if your site doesn't have untrustworthy users with Panel access or a way to modify field values f…
Severity: high (CVSS score 7.1)
The tags and multiselect fields allow to select tags from an autocompleted list. The tags field also allows to enter new tags or edit existing tags. Kirby already handled escaping of the autocompleted tags, but unfortunately the Panel used HTML rendering for new or edited tags as well as for custom tags from the content file.
This allowed attackers with Panel access to store malicious HTML code in a tag. The browser of the victim who visited the modified page in the Panel will then have rendered this malicious HTML code.
It also allowed self-inflicted XSS attacks in the tags field (meaning that malicious code is executed in the browser of the user who entered it). This could be used in social engineering attacks where a victim is convinced by an attacker to enter malicious code into a tags field.
Visitors without Panel access could only use this attack vector if your site allows changing the content of a tags or multiselect field from a frontend form (for example user self-registration or the creation of pages from a contact or other frontend form). If you validate or sanitize the provided form data, you are already protected against such attacks by external visitors.
You are also not affected by these vulnerabilities if your site doesn't have untrustworthy users with Panel access or a way to modify field values from the frontend or if you don't use the tags or multiselect fields.
Note: The fixes for these vulnerabilities have the side effect that values in the tags and multiselect fields that come from dynamic options are displayed with double escaping (e.g. the & character is displayed as &). We will fix the double escaping issues with a refactoring of the options fields (tags, multiselect, checkboxes, radio, select and toggles) in Kirby 3.8.
Helpers::handleErrors() method for custom PHP error handling #4569F::unlink() method for idempotent deletion of files and links (native PHP unlink() without a warning when the file is already deleted) #4569toggles field preview now uses bubbles #4566vuedraggable.js library #4504<br>
Beforedist/css/style.css 106.29 KiB / gzip: 18.02 KiB
dist/js/index.js 303.70 KiB / gzip: 71.99 KiB
dist/js/vendor.js 375.31 KiB / gzip: 120.69 KiB
Afterdist/js/vuedraggable.js 40.74 KiB / gzip: 14.12 KiB
dist/css/style.css 106.29 KiB / gzip: 18.01 KiB
dist/js/index.js 304.25 KiB / gzip: 72.37 KiB
dist/js/vendor.js 334.73 KiB / gzip: 107.00 KiB
k-text has a new html prop to pass content that should be rendered as HTML (instead of providing text via the default slot). Use carefully as rendering HTML can be a gateway for XSS attacks. #4578/ #4508intl date handler now consistently uses the configured default locale #4304Http\Uri and Http\Params classes and the param() and params() helpers now automatically handle URL encoding and decoding for a more robust behavior with special charactersHttp\Uri when extending via Uri::$schemes property #4575Added support for hot module reloading (HMR) during plugin development using kirbyup #4541
Helpers::handleErrors() method for custom PHP error handlingF::unlink() method for idempotent deletion of files and links (native PHP unlink() without a warning when the file is already deleted)The toggles field preview now uses bubbles #4566
Reduced size of the Panel's vendor JS file by adding code splitting for the vuedraggable.js library #4504
Before
dist/css/style.css 106.29 KiB / gzip: 18.02 KiB
dist/js/index.js 303.70 KiB / gzip: 71.99 KiB
dist/js/vendor.js 375.31 KiB / gzip: 120.69 KiB
After
dist/js/vuedraggable.js 40.74 KiB / gzip: 14.12 KiB
dist/css/style.css 106.29 KiB / gzip: 18.01 KiB
dist/js/index.js 304.26 KiB / gzip: 72.29 KiB
dist/js/vendor.js 333.99 KiB / gzip: 106.81 KiB
Node dependencies have been updated #4568
k-text has a new html prop to pass content that should be rendered as HTML (instead of providing text via the default slot). Use carefully as rendering HTML can be a gateway for XSS attacks. #4578
Now text block field input extendable with preview #3016
/ #4508intl date handler now consistently uses the configured default locale #4304Panel: the loading spinner has reduced opacity #4496
subpages option works correctly again #4309$page->childrenAndDrafts() collection is now immediately updated when a child page or draft is modified #2767Panel: the loading spinner has reduced opacity #4496
Yep, minor releases should not have breaking changes, but we consider this a non-breaking breaking change that helps fix a bug. The old account.logout…
Unfortunately, we introduced a regression in structure fields in this release. Please use the patch release instead https://github.com/getkirby/kirby/releases/tag/3.7.2.1
\n characters of YAML-encoded values no longer cause Kirby to consider a field multi-line. #4505onInput handler of the structure field #4513$block->prev() & $block->next() no longer return hidden blocks from a visible block #4480account.logout of the account area was replaced by the logout view of the new logout areaYep, minor releases should not have breaking changes, but we consider this a non-breaking breaking change that helps fix a bug. The old account.logout view was such an internal feature. We are confident that it has never been extended by anyone.
Yep, minor releases should not have breaking changes, but we consider this a non-breaking breaking change that helps fix a bug. The old account.logout…
\n characters of YAML-encoded values no longer cause Kirby to consider a field multi-line. #4505onInput handler of the structure field #4513$block->prev() & $block->next() no longer return hidden blocks from a visible block #4480account.logout of the account area was replaced by the logout view of the new logout areaYep, minor releases should not have breaking changes, but we consider this a non-breaking breaking change that helps fix a bug. The old account.logout view was such an internal feature. We are confident that it has never been extended by anyone.
Plugins that only provide Panel styles and/or scripts don't need to add an index.php anymore, index.js and index.css will still be loaded in the Panel
index.php anymore, index.js and index.css will still be loaded in the Panel #4445bool column type for the Database classes #4433es for es_ES) #4447Forwarded headerX-Forwarded-Host header or host key in the Forwarded header, Kirby falls back to the server name; this improves compatibility with CloudFlare #4443Forwarded header into account when checking whether the Panel is installable on a local installation #4490debug mode is active #4448inline: true only store first paragraph when multiple are pasted #4310url option from domain-specific config files. #4311$collection->__set() methods consistently no longer return the class instance to match PHP's definition for this method #4458Nothing published for this version
We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.7
We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.7
Nothing published for this version
Nothing published for this version
Nothing published for this version
New A::random() and $collection->random() methods to get one or multiple random items from arrays and collections, optionally shuffled. Unless shuffle
A::random() and $collection->random() methods to get one or multiple random items from arrays and collections, optionally shuffled. Unless shuffled, the overall order of the returned items is kept. #4270Toolkit\Obj objects and derived objects, like so: #4268$thing = new Obj(['one' => '👋', 'two' => 'Kirby']);
$properties = $thing->get(['one', 'three'], ['three' => 'fallback']);
// results in ['one' => '👋', 'three' => 'fallback']
Uri class, the params prop can now be set to false to treat colons/semicolons in the path as literals and not as param separators. This is useful for parsing external non-Kirby URIs. #2948(in alphabetical order)
Nothing published for this version
New intl date handler (e.g. for date.handler config option) using the ICU date/time format syntax
intl date handler (e.g. for date.handler config option) using the ICU date/time format syntax// different ways to use it:
// passing format string
Str::date($time, 'M/d/yy', 'intl');
$page->myDateField()->toDate('M/d/yy');
// passing IntlDateFormatter instance
$formatter = new IntlDateFormatter(null, IntlDateFormatter::LONG, IntlDateFormatter::SHORT);
$page->myDateField()->toDate($formatter);
$query->page() method #2738$query->where() with callback duplicating the where queries #2831Cache-Control: no-store header like other responses with an active session #4101$kirby->response() are now also respected when a route returns a full Response object #4101(in alphabetical order)
Nothing published for this version
Support for a model. entry for model queries (as placeholder alias for page., file., user. or site.), which allows a query syntax that can be shared b
model. entry for model queries (as placeholder alias for page., file., user. or site.), which allows a query syntax that can be shared between different model typesfields:
layout:
type: layout
label: Layout
extends:
- layout/layouts
- layout/fieldsets
- layout/settings
title as alias for name #4177label as new, better alternative to headlinefor sections #4194Html::video() supports the allowfullscreen attribute again, used by YouTube #4212converter prop for PHP 8.1 #4226(in alphabetical order)
Nothing published for this version
Unfortunately, we introduced a regression in this release that broke parameters in URLs. I.e. https://example.com/blog/page:2 and thus also pagination
Unfortunately, we introduced a regression in this release that broke parameters in URLs. I.e. https://example.com/blog/page:2 and thus also pagination and all kinds of URL filters based on such parameters. A patch is now available: https://github.com/getkirby/kirby/releases/tag/3.6.3.1
Kirby auto-detects the base URL for your site unless you hard-code it in your config with the url option. This auto-detection is based on the your SERVER_NAME settings by default. This is totally safe unless your server is not correctly configured. In order to protect you from security issues with an insecure server configuration, you get more options to set allowed base URLs now. By default, the auto-detection will just work as before. Here are the new and existing options you have.
SERVER_NAMEJust like before, you can just ignore the URL option or use the Server::HOST_FROM_SERVER constant to let Kirby find the correct base URL, based on the SERVER_NAME.
return [
];
// or
return [
'url' => Server::HOST_FROM_SERVER
];
This can be combined with the new Server::HOST_ALLOW_EMPTY option to accept empty hostnames. This will lead to relative URLs i.e. /some-url for your installation:
return [
'url' => Server::HOST_FROM_SERVER | Server::HOST_ALLOW_EMPTY
];
You can also still set the base URL for your site. This will disable any form of auto-detection of URLs. But it also means that you might have to keep different versions for your local installation, staging and your production server.
return [
'url' => 'https://example.com'
];
This also still works for relative URLs without a host.
return [
'url' => '/'
];
With the new option to define a set of allowed base URLs, your Kirby installation will automatically pick the right one based on HTTP_HOST, HTTP_X_FORWARDED_HOST or SERVER_NAME (whatever is provided) and makes sure to send an error on an invalid hosts. This is perfect when you cannot fully trust your server configurations on various environments.
return [
'url' => [
'https://example.com',
'https://staging.example.com',
'http://example.test'
]
];
If you fully trust your server setup, you can allow any host name coming from HTTP_HOST or HTTP_X_FORWARDED_HOST. This could be necessary in some situations, but is insecure if you don't know what you are doing with your server configuration.
return [
'url' => Server::HOST_FROM_HEADER
];
Again, this can be combined with the Server::HOST_ALLOW_EMPTY option to allow the host name to be left empty. It will lead to relative URLs for your installation:
return [
'url' => Server::HOST_FROM_HEADER | Server::HOST_ALLOW_EMPTY
];
$locale parameter in t() and tc() helpers #4160contributing.md #4197license.md which replicates the license terms on our sitecontributing.md & readme.md are now back in the main directory of the repo instead of the .github subdirectory$inline parameter to Markdown component plugins #4127npm run dev #4134k-button-link element in dropdown now works #4148$text initialisation which fails in PHP8.1 #4155Mime class. #4174(in alphabetical order)
Nothing published for this version
Nothing published for this version
No longer throws deprecation warning passing null to Str functions
The date and time fields have been a constant struggle in the past. We dedicated this release to fix various bugs and enhance the overall look and UX of those fields. Smart input parsing supports various date formats while writing or pasting dates. Navigate through parts of a date or time with tab and modify year, month, day, hour, minute and second with arrow keys. Combined with a new time dropdown, full support for am/pm, various display options and other features, the new fields are a major step ahead.
https://user-images.githubusercontent.com/24532/151949983-0ad77d44-bfd9-4885-be9e-3e8e99233402.mp4
You can now add rel="alternate stylesheet" in the css() helper #4099
css('assets/css/index.css', ['rel' => 'alternate stylesheet', 'title' => 'High contrast']);
The markdown parser now supports a safe mode, which escapes any custom HTML, while still parsing markdown correctly. Safe mode can now be enabled like this:
// helpers
kirbytext($text, [
'markdown' => [
'safe' => true
]
]);
kirbytextInline($text, [
'markdown' => [
'safe' => true
]
]);
markdown($text, [
'safe' => true
]);
// field methods
$page->text()->kirbytext([
'markdown' => [
'safe' => true
]
]);
$page->text()->kirbytextInline([
'markdown' => [
'safe' => true
]
]);
$page->text()->markdown([
'safe' => true
]);
The safe mode is now also available as global markdown setting:
<?php
// config.php
return [
'markdown' => [
'safe' => true
]
];
There are new options to define custom submit and cancel handlers for Fiber dialogs
// short version
this.$dialog('some/dialog', ({ dialog, value }) => {
// custom submit handler
});
// in options
this.$dialog('some/dialog', {
cancel: () => {
// custom cancel handler
},
submit: ({ dialog, value }) => {
// custom submit handler
}
});
Dialogs can now also be defined synchronously instead of loading them from the server.
this.$dialog({
component: 'k-remove-dialog',
props: {
text: 'Do you really want to delete this entry?'
},
cancel: () => {
// custom cancel handler
},
submit: ({ dialog, value }) => {
// custom submit handler
}
});
Kirby\Toolkit\Date class #4040timestamp() helperiso plugin for dayjs to parse and format ISO date/time/datetime stringsThanks to @PaulMorel for his support: #4091
Cms\File::niceSize, Cms\Files::niceSize() and Filesystem\Dir::niceSize() #4045a.merge(n, "time"): merges a defined part (date or time) of dayjs object b into dayjs object adayjs.pattern('YYYY-MM-DD"): class that supports analysing and interpreting a specific dayjs format patterndayjs.round("minute", 5): method to round current dayjs object to nearest step (unit and size)dayjs.units(is12h): a map between units and dayjs tokens given 12/24h clockdayjs.validate(): helper to validate a current dayjs object against a min/max boundarythis.$fiber global in Vuestep prop to inputsnull to parameter to is_file() function in Tpl::load() method on PHP 8.1 #4032Str functionsurl() helper throws deprecation warning with PHP 8.1 #4047link in pages, files and users fields works correctly again #4062$page->prevUnlisted() returns wrong collection item #4086Page::findById() in PHP 8.1 #4119panel.favicon option now supports single string as valuereturn [
'panel' => [
'favicon' => 'assets/favicon.ico'
]
];
composer.json to Composer API 2.2 #4066mustangostang/spyc repository from composerSpyc class into /dependenciesspyc_load(), spyc_load_file(), spyc_dump() functions(in alphabetical order)
Fixed z-index issue for in dropdowns #4072
Allow rel="alternate stylesheet" in css() helper #4099
rel="alternate stylesheet" in css() helper #4099css('assets/css/index.css', ['rel' => 'alternate stylesheet', 'title' => 'High contrast']);
No longer throws deprecation warning passing null to Str functions
The markdown parser now supports a safe mode, which escapes any custom HTML, while still parsing markdown correctly. Safe mode can now be enabled like this:
// helpers
kirbytext($text, [
'markdown' => [
'safe' => true
]
]);
kirbytextInline($text, [
'markdown' => [
'safe' => true
]
]);
markdown($text, [
'safe' => true
]);
// field methods
$page->text()->kirbytext([
'markdown' => [
'safe' => true
]
]);
$page->text()->kirbytextInline([
'markdown' => [
'safe' => true
]
]);
$page->text()->markdown([
'safe' => true
]);
The safe mode is now also available as global markdown setting:
<?php
// config.php
return [
'markdown' => [
'safe' => true
]
];
There are new options to define custom submit and cancel handlers for Fiber dialogs
// short version
this.$dialog('some/dialog', ({ dialog, value }) => {
// custom submit handler
});
// in options
this.$dialog('some/dialog', {
cancel: () => {
// custom cancel handler
},
submit: ({ dialog, value }) => {
// custom submit handler
}
});
Dialogs can now also be defined synchronously instead of loading them from the server.
this.$dialog({
component: 'k-remove-dialog',
props: {
text: 'Do you really want to delete this entry?'
},
cancel: () => {
// custom cancel handler
},
submit: ({ dialog, value }) => {
// custom submit handler
}
});
Kirby\Toolkit\Date class #4040timestamp() helperiso plugin for dayjs to parse and format ISO date/time/datetime stringsCms\File::niceSize, Cms\Files::niceSize() and Filesystem\Dir::niceSize() #4045a.merge(n, "time"): merges a defined part (date or time) of dayjs object b into dayjs object adayjs.pattern('YYYY-MM-DD"): class that supports analysing and interpreting a specific dayjs format patterndayjs.round("minute", 5): method to round current dayjs object to nearest step (unit and size)dayjs.units(is12h): a map between units and dayjs tokens given 12/24h clockdayjs.validate(): helper to validate a current dayjs object against a min/max boundarythis.$fiber global in Vuenull to parameter to is_file() function in Tpl::load() method on PHP 8.1 #4032Str functionsurl() helper throws deprecation warning with PHP 8.1 #4047link in pages, files and users fields works correctly again #4062$page->prevUnlisted() returns wrong collection item #4086step prop to inputspanel.favicon option now supports single string as valuereturn [
'panel' => [
'favicon' => 'assets/favicon.ico'
]
];
$helpers and their unit tests #4057composer.json to Composer API 2.2 #4066mustangostang/spyc repository from composerSpyc class into /dependenciesspyc_load(), spyc_load_file(), spyc_dump() functionspages() helper does not throw deprecation warning for arrays as single parameter https://github.com/getkirby/kirby/issues/3938
system.exception hook that can be used to log an error or exception in a log file or via a service like Sentry https://github.com/getkirby/kirby/pull/3952Toolkit\Html::$inlineList with array of tags that are allowed in inline context https://github.com/getkirby/kirby/pull/3884srcset for potentially smaller preview imagesrouter.php now allows the document root to be set manually https://github.com/getkirby/kirby/pull/3963Str::date($time, $format, $handler) method to format a timestamp as date string https://github.com/getkirby/kirby/pull/3992npm run format during pre-commit hook. https://github.com/getkirby/kirby/pull/3995Kirby\Sane\Svg class now supports more attributes like xml:space and enable-background. https://github.com/getkirby/kirby/issues/3982Kirby\Toolkit\Dom: Added support for the special xml: namespaceImageMagick driver now include the ICC color profile for better color accuracy. Note that this currently does not work for PNG images. https://github.com/getkirby/kirby/issues/2537pages() helper does not throw deprecation warning for arrays as single parameter https://github.com/getkirby/kirby/issues/3938Asset objects can be used as Panel preview images again https://github.com/getkirby/kirby/issues/3933Response::download() https://github.com/getkirby/kirby/issues/3956Panel::go() and other exceptions are supported in the panel.route:before hook https://github.com/getkirby/kirby/pull/3964route:before and route:after hooks only get called for core routing calls https://github.com/getkirby/kirby/issues/3951Str methods handle an empty $needle string https://github.com/getkirby/kirby/issues/3459'dropdowns' => [
'example' => function () {
return [ ... ]
}
]
strip_tags with array of tags https://github.com/getkirby/kirby/pull/3884Optional chaining operator on Frontend https://github.com/getkirby/kirby/pull/3908claviska/simpleimage dependency https://github.com/getkirby/kirby/pull/3989Iterator::getIterator() https://github.com/getkirby/kirby/pull/3991/filesnull to native functions that actually don't accept null but a specific type (string, int...). https://github.com/getkirby/kirby/pull/3990true/punycode with symfony/polyfill-intl-idn dependency https://github.com/getkirby/kirby/pull/3988(in alphabetical order)
We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.6
We've prepared a special site for this release with all new features and changes: https://getkirby.com/releases/3.6
Use Tailwind sr-only utility instead of k-offscreen Old class name is still available to avoid breaking change
To learn more about Kirby 3.6 and the RC phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
--color-dark: #313740;--z-fatal--z-offlinesr-only utility instead of k-offscreen Old class name is still available to avoid breaking changek-offline-warning componenterror.offlineTo learn more about Kirby 3.6 and the RC phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
To learn more about Kirby 3.6 and the RC phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
k-link component now correctly handles absolute URLswriter field allows relative URLs again. #3754Fixed breaking change in FieldClass::store method #3866
To learn more about Kirby 3.6 and the RC phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
Toolkit\Dom::toString method now exports the document with the same structure as the input. #3887image/svg MIME type is now recognized by the Sane classesFieldClass::store method #3866empty prop #3872cardlets layout optionCms\Collection::has(): 1st parameter got renamed to $keyCms\Collection::indexOf(): 1st parameter got renamed to $needleCms\Collection::query(): 1st parameter got renamed to $argumentsTo learn more about Kirby 3.6 and the RC phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
To learn more about Kirby 3.6 and the RC phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
We received a lot of feedback about the confusing state of the Settings view in the Panel. Technically, it was never really about settings. It was a mixture of system information and languages. This is why we decided to replace this view with two new views. A new system view with all kinds of additional information about your Kirby installation and a brand new languages view.
The system view contains the version and license information from the previous settings view. But now it also features additional health information about your setup, which will be extended step by step in later releases. It also contains a list of your installed plugins.
Languages and system views can be switched on or off by role with the new access permissions:
# users/editor.yml
title: Editor
permissions:
access:
system: false
languages: false
The new languages view is now only visible in the menu when you switch to a multi-language setup. It features the same language editor from previous versions. We will be extending this view with more options in the future.
home option for user blueprints to control redirect after login #3834When a user logs in to the Panel, they normally get redirected to the last view they've been on before they've been logged out or the Site view. When you work with permissions, you might want to block the Site view or redirect the user to a completely different view instead. This is now possible with the new home option for user blueprints. This way you can define the redirect for each role individually. Redirects can be simple paths or dynamic locations via string queries.
Simple paths
title: Editor
home: /panel/account
Queries to panel views
title: Editor
home: "{{ site.find('blog').children.first.panel.url }}"
Queries to pages
title: Editor
home: "{{ site.find('blog').children.first.url }}"
Technically this has been in there for ages, but we never documented it :)
The new slug field is perfect when you want to create sanitized strings for IDs, URL paths, css class names, etc.
Setup
fields:
className:
label: Class Name
type: slug
Sync option You can sync the slug field with another field. Whenever the editor types something into the synced field, the slug field will update with a sluggified version of the input:
fields:
className:
label: Class Name
type: slug
sync: title
Allow option By default, the slug field will strip out or replace any non-alphabetic, non-numeric character with a simple dash. You can define additional allowed characters with the allow option:
fields:
className:
label: Class Name
type: slug
sync: title
allow: _
Remote class now by default prefers the system certificate authority bundle (CA bundle) for verifying remote TLS connections if a bundle is configured in php.ini (curl.cainfo option). If no bundle is configured, Kirby will still use its internal CA bundle.Kirby\Form\FieldClass classNothing published for this version
To learn more about Kirby 3.6 and the beta phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
To learn more about Kirby 3.6 and the beta phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
Developers can now easily integrate their own email providers (sendgrid, mailgun, mailchimp, sparkpost, etc), instead of using Kirby's default PHPMailer library.
class CustomEmailProvider extends Kirby\Email\Email
{
public function send(bool $debug = false): bool
{
// sending stuff
return true;
}
}
Kirby::plugin('my/email', [
'components' => [
'email' => function ($kirby, $props, $debug) {
return new CustomEmailProvider($props, $debug);
}
]
]);
Using the new 5 extensions below, you can write your own custom methods for the blocks and layout fields.
layoutsMethods (layouts collection)layoutMethods (each layout)layoutColumnMethods (each layout column)blocksMethods (blocks collection)blockMethods (each block)<?php
Kirby::plugin('my/blocksLayoutMethods', [
'blockMethods' => [
'test' => function () {
return 'block method';
}
],
'blocksMethods' => [
'test' => function () {
return 'blocks method';
}
],
'layoutMethods' => [
'test' => function () {
return 'layout method';
}
],
'layoutColumnMethods' => [
'test' => function () {
return 'layout column method';
}
],
'layoutsMethods' => [
'test' => function () {
return 'layouts method';
}
]
]);
Now each block type can have its own custom model. Like models for page templates or user roles.
<?php
use Kirby\Cms\Block;
class HeadingBlock extends Block
{
public function id(): string
{
return 'custom id';
}
}
Kirby::plugin('my/blockModels', [
'blockModels' => [
'heading' => HeadingBlock::class
]
]);
When defining a custom model, the Kirby\Cms\Block class represents the default model for all blocks.
<?php
use Kirby\Cms\Block;
class DefaultBlock extends Block
{
public function id(): string
{
return 'custom id';
}
}
class HeadingBlock extends DefaultBlock
{
public function test(): string
{
return 'Hello World!';
}
}
Kirby::plugin('my/blockModels', [
'blockModels' => [
'Kirby\\Cms\\Block' => DefaultBlock::class
'heading' => HeadingBlock::class
]
]);
DST Root CA X3 CA certificate (previously used for Let's Encrypt certificates) has been removed from the CA bundle to prevent "expired certificate" warnings when requesting remote resources (like in options API fields) on some server systems #3765k-item now features former k-list-item slots againF::modified() does no longer calculate a maximum between mtime and ctime for file changes. This could in theory lead to different timestamps in some scenarios. Very unlikely though.Added fallbacks for deprecated CSS classes #3706
To learn more about Kirby 3.6 and the beta phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
It's finally here! You can now copy and paste blocks between block and layout fields and even create blocks from pasted HTML and text.
You can now provide default values for all Kirbytag attributes in your config.
return [
'kirbytext' => [
'video' => [
'class' => 'video',
],
'image' => [
'imgclass' => 'margin-5'
],
'link' => [
'rel' => 'nofollow'
],
]
];
paragraph iconToolkit\Dom class that allows to parse, modify and sanitize DOM-based documents (XML and HTML)Sane classes now have new sanitize() and sanitizeFile() methods that will apply the same rules as validate() but directly modify the input string/file so it is valid afterwardsSane\Html class for validating and sanitizing HTML files or HTML snippets$file->sanitizeContents() methodSane classes)Sane classes now have proper XML namespace support so that custom namespace prefixes are properly detectedDb::$queries['insert'] have been fixed #3140files will no longer create havoc #3187text prop on site working again #3696Sane classes have been renamed for consistency with the new Toolkit\Dom classSane\Svg::$allowedNamespaces attribute now expects namespace reference names as the array keys instead of full attribute names (so xmlns:xlink should become just xlink and xmlns should become an empty string)Sane\Svg::$allowedTags attribute (before $allowedElements) now is an associative array with the allowed attributes for this tag as the valuehas been deprecated, use instead
To learn more about Kirby 3.6 and the beta phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
It's now possible to extend or replace every important aspect of our backend and frontend logic for the Panel. You can have your own page search, your own dialogs and even your own dropdowns for files, pages or users. Add options, fields or entire new views. It's pretty magical.
You can find more in our docs:
We've extended our icon set for the Panel significantly: http://getkirby.com/releases/3.6/features/icons
- audio
- crop
- display
- flag
- food
- grid
- grid-bottom
- grid-bottom-left
- grid-bottom-right
- grid-full
- grid-left
- grid-right
- grid-top
- grid-top-right
- grid-top-left
- h1
- h2
- h3
- h4
- h5
- h6
- heart-outline
- info
- images
- mobile
- order-alpha-asc
- order-alpha-desc
- order-num-asc
- order-num-desc
- paypal
- pin
- pipette
- play
- print
- qr-code
- server
- shuffle
- sitemap
- star-outline
- sun
- table
- tablet
- text-center
- text-justify
- text-left
- text-right
- tiktok
toggle field now supports the query syntax in the text propertyk-dropdown-content component is now compatible with our dynamic Fiber dropdowns. You can pass a string for the options prop and the component will automatically load the matching Fiber dropdown defined in PHP.<k-dropdown-content options="my/custom/dropdown" />
will now load the Fiber dropdown defined like this in one of your areas:
Kirby::plugin('custom/dropdown', [
'areas' => [
'custom' => [
'dropdowns' => [
'my/custom/dropdown' => function () {
return [
[
'icon' => 'trash',
'text' => 'Delete',
'link' => '/go/some/where'
]
];
}
];
]
]
]);
Str::safeTemplate() method that escapes HTML from all regular query placeholders, allows HTML with new {< site.myMethodWithHtml >} syntax$model->toSafeString() method that uses Str::safeTemplate() instead of Str::template()RadioInput component now supports (escaped) HTML in the info property for radio options.$field->replace() method no longer returns the model ID for empty fields, instead an empty string is returned as expected. #3652this.$helper.upload now correctly uses the method parameterk-progress: fixed not updating when value prop changed—-align instead of --algin) #3641read: false #3650image: false and image: icon options work again in pages and files sections. #3633panel/src/component/Blocks to panel/src/component/Forms/Blockspanel/src/component/Writer to panel/src/component/Forms/Writer<k-text align="right"> has been deprecated, use <k-text align="end"> insteadThis is <strong>{{ page.important }}</strong>) still works as normal. If placeholders need to return HTML, you can use the new {< site.myMethodWithHtml >} syntax. In this case you need to ensure manually that the returned HTML code is safe. With the {{ }} syntax, Kirby performs the escaping for you.<k-box text="..." /> property is now rendered as plain text by default instead of as HTML code. For the previous behavior use <k-box text="..." :html="true" />.To learn more about Kirby 3.6 and the alpha phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
To learn more about Kirby 3.6 and the alpha phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
You can now define blueprint settings in a callback and base blueprint setups on config options, content and more.
<?php
Kirby::plugin('my/plugin', [
'blueprints' => [
'pages/blog' => function ($kirby) {
return [
'title' => 'Blog',
'sections' => [
// ...
]
];
}
]
]);
$file->sha1() methodForm fields and info boxes now show up immediately in the Panel. This massively improves the received performance and usability.
api.csrf option is automatically set to dev when the panel.dev option is trueNew minimum browser requirements (browsers with dynamic import() support):
Removed outdated $api methods in Vue:
$api.pages.breadcrumb$api.files.breadcrumb$api.users.breadcrumb$api.site.breadcrumb$api.site.options$api.roles.options$api.translations.optionsTo learn more about Kirby 3.6 and the alpha phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
To learn more about Kirby 3.6 and the alpha phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
For context sensitive dropdown menus – such as the option dropdowns for pages, files or users – you need to collect a lot of information before the menu can be opened. Which options are available for the current model? Which permissions are to be considered, etc.? We solve this with asynchronous dropdowns, which load their options from the API.
With Fiber, we've managed to simplify those asynchronous dropdowns significantly. We can now create new complex dropdowns right in PHP in minutes. Dropdowns are part of the new Panel areas. Here's an example for a potential plugin.
Kirby::plugin('your-plugin/todos', [
'areas' => [
'todos' => [
...
'dropdowns' => [
'todos/(:any)' => function (string $id) {
// find the $todo here. (i.e. from a database)
return [
[
'text' => 'Edit',
'dialog' => 'todos/' . $id . '/edit',
'icon' => 'edit'
],
[
'text' => 'Duplicate',
'dialog' => 'todos/' . $id . '/duplicate',
'icon' => 'copy'
],
[
'text' => 'Delete',
'dialog' => 'todos/' . $id . '/delete',
'icon' => 'trash'
]
];
}
]
]
]
]);
Your dropdown options can then be loaded in your Vue code like this:
<k-dropdown>
<k-button icon="cog" @click="$refs.options.toggle()">Options</k-button>
<k-dropdown-content ref="options" :options="$dropdown('todos/the-todo-id')" />
</k-dropdown>
The most exciting part: it will soon be possible to overwrite and extend our default dropdowns for pages, files and users 🎉
Just think about it. You can create simple plugins to add additional options to cross-post page content on social media, start generating static versions, edit files, and so much more. It's all up to you.
Very much like the new Fiber views, dialogs and dropdowns, Panel search is now also massively simplified. Our default searches for pages, files and users already run on Fiber in this new release and your plugins can now create their own new search types, which will automatically be available in our search dialog.
Kirby::plugin('your-plugin/todos', [
'areas' => [
'todos' => [
...
'searches' => [
'todos' => [
'label' => 'Todos',
'icon' => 'check',
'query' => function () {
// search for $todos here.
$results = [];
foreach ($todos as $todo) {
$results[] = [
'image' => [ // optional image settings ],
'text' => $todo->text(),
'link' => '/todos/' . $todo->id(),
'info' => 'Get it done!'
];
}
return $results;
}
]
]
]
]
]);
That's all it takes to create your own search index for your own plugins.
The search will automatically appear in the search dialog, but can also be run manually from your Vue components with …
const query = 'Searchy search';
const todos = await this.$search('todos', query);
Like all other Fiber features, it will soon be possible to overwrite and extend our default searches for pages, files and users 🎉
$blocks->hasType() method$layouts->toBlocks() method$layouts->hasBlockType() methodv-direction directive to set the dir attribute based on the current content translation #3568Data\Json::decode() and Data\Xml::decode() methods now accept empty strings and treat them as an empty data set (empty array) for consistency with Data\Txt::decode() and Data\Yaml::decode() #3565dir attribute for fields #3568.k-block-handle has been replaced with .k-sort-handleStr::template(): the parameters $fallback, $start and $end have been deprecated and throw a deprecation warning. Use instead an $options array with fa…
To learn more about Kirby 3.6 and the alpha phase, check out our dedicated preview site: https://getkirby.com/releases/3.6
The Page Duplicate Dialog now also accepts a title for the new page
Add horizontal rules to your blocks with the new line block. It automatically supports and imports hr blocks from the old Editor plugin.
panel.favicon optionSet your own favicon(s) for the panel – the last step to a full white-label solution
'panel.favicon' => [
'apple-touch-icon' => [
'type' => 'image/png',
'url' => 'assets/apple-touch-icon.png',
],
'shortcut icon' => [
'type' => 'image/svg+xml',
'url' => 'assets/favicon.svg',
],
'alternate icon' => [
'type' => 'image/png',
'url' => 'assets/favicon.png',
]
]
.k-panel[data-language] for the current content translation language.k-panel[data-default-language] for the default content translation language.k-panel[data-translation] for the current Panel UI/user language.k-panel[data-role] for current user role.k-panel[data-user] for current user ID.k-page-view[data-id] for page ID.k-page-view[data-template] for page's intended template.k-file-view[data-id] for file ID.k-file-view[data-template] for file's template.k-user-view[data-id] for user ID.k-user-view[data-role] for user's role.k-site-view[data-id] for site ID (/).k-site-view[data-template] for site's template (site).k-languages-dropdown for content translation language dropdown.k-page-view-options, .k-file-view-options and .k-user-view-options for options dropdown on model views.k-page-view-preview, .k-file-view-preview, .k-site-view-preview and .k-user-view-preview for preview button on model views.k-pages-section .k-item[data-id], .k-pages-section .k-item[data-status] and .k-pages-section .k-item[data-template].k-files-section .k-item[data-id] and .k-files-section .k-item[data-template].k-status-icon .k-status-icon-{status} for the page's status buttonSystem::title() method (is now used for all emails to replace "Kirby Panel" as generic title)$files->size() and $files->niceSize() methodsF::size and F::niceSize accept array of file pathsDir::size() has new $recursive parameterlicense root allows to store the license outside the config dir for easier deployments and multi-site setups.image block now escapes the content output from the source, alt and link fields. This protects against XSS attacks against site visitors.$t() JS helper now supports a fallback value as third parameterStr::widont applies to punctuation with gapStr::template(): the parameters $fallback, $start and $end have been deprecated and throw a deprecation warning. Use instead an $options array with fallback, start and/or end keys as third parameter.F::niceSize() doesn't check anymore whether file exists.k-panel[data-translation] is now .k-panel[data-language].k-panel[data-default-translation] is now .k-panel[data-default-language]Check out our Kirby 3.6.0 alpha site: https://getkirby.com/releases/3.6
Check out our Kirby 3.6.0 alpha site: https://getkirby.com/releases/3.6
One column per quarter.