NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #4466 most downloaded on Packagist
The Kirby core
Latest stable
5.6.3
Last release 13 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.
Updated PHP and JS dependencies
After our 4.9.1 release yesterday, the symfony/yaml package had a security release today. This is a patched version with the updated yaml dependency.
After our 4.9.1 release yesterday, the symfony/yaml package had a security release today. This is a patched version with the updated yaml dependency.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update: After our 4.9.1 release yesterday, the symfony/yaml package had a security release today. There is a patched version with the updated yaml dep…
Update: After our 4.9.1 release yesterday, the symfony/yaml package had a security release today. There is a patched version with the updated yaml dependency: https://github.com/getkirby/kirby/releases/tag/4.9.2
This is a backport of our security release for Kirby 5. For all details and vulnerabilities see: https://github.com/getkirby/kirby/releases/tag/5.4.1
We recommend all users upgrade to Kirby 5. If an upgrade is not possible, this security release is the alternative solution.
This is a backport of our security release for Kirby 5. For all details and vulnerabilities see: https://github.com/getkirby/kirby/releases/tag/5.4.0
This is a backport of our security release for Kirby 5. For all details and vulnerabilities see: https://github.com/getkirby/kirby/releases/tag/5.4.0
We recommend all users upgrade to Kirby 5. If an upgrade is not possible, this security release is the alternative solution.
We've added a new option to disable clean file redirects to original files in your content folder. Currently, you can access the original file (rather
We've added a new option to disable clean file redirects to original files in your content folder. Currently, you can access the original file (rather than a generated thumbnail) via the URL https://yourdomain.com/some-page/some-file.jpg, which redirects you to the full file URL in the media folder. This is useful when you need clean URLs for your files. However, depending on your files and filenames, such URLs could be guessable. If you want to add an extra layer of protection for your original files, you can now disable this feature.
return [
'content' => [
'fileRedirects' => false
]
];
If you only want to switch it off for individual files, you can also pass a function.
return [
'content' => [
'fileRedirects' => function ($file) {
if ($file->filename() === 'supersecret.jpg') {
return false;
}
return true;
}
]
];
ratio option #7083KIRBY_RENDER env #7146step: any is now supported, allowing for any amount of decimals (e.g. great for lat/lng coordinates) #7158placeholder option is translatable nowAdded numeric support for image ratio option #7083
Fix regression in 4.7.1 that broke the creation of thumbs when the content folder was outside of the index root (e.g. in public folder setups) #7218
content folder was outside of the index root (e.g. in public folder setups) #7218Unfortunately, this security release contains a regression in thumbnail generation for public folder setups. If you are working with a public folder s…
Unfortunately, this security release contains a regression in thumbnail generation for public folder setups. If you are working with a public folder setup, please use version 4.7.2.
This release fixes three path traversal vulnerabilities in the Kirby core:
| Description | Severity | CVE ID |
|---|---|---|
| Path traversal of snippet names during file system lookup | Medium (6.3) | CVE-2025-30159 |
| Path traversal of collection names during file system lookup | Medium (6.3) | CVE-2025-31493 |
| Path traversal in the router for PHP's built-in server | Low (2.3) | CVE-2025-30207 |
The first two vulnerabilities only affect Kirby sites that call the snippet() or collection() helpers with dynamic name values that could be controlled by an attacker. Sites that only use fixed calls to the snippet() or collection() helpers (i.e. calls with a simple string for the snippet/collection name) are not affected.
The last vulnerability only affects Kirby setups that use PHP's built-in server. Such setups are commonly only used during local development.
All three vulnerabilities have in common that they can be exploited via path traversal. By using special elements such as .. and / separators, attackers can escape outside of the restricted location to access files or directories that are elsewhere on the system. One of the most common special elements is the ../ sequence, which in most modern operating systems is interpreted as the parent directory of the current location.
The missing path traversal checks allowed attackers to navigate and access all files on the server that were accessible to the PHP process, including files outside of the relevant system roots or even outside of the Kirby installation. Depending on the vulnerability, the existence of the traversed file could be revealed or contained PHP code could be executed.
You can read more about the vulnerabilities and their impact in the security advisories linked above.
Thanks to Bruno Meilick (@bnomei) and Tobias Möritz (@tobimori) for their responsible disclosure and for bringing this type of attack vector to our attention.
[!NOTE] If you deliberately use path traversal with the
snippet()helper in your projects, these uses will break after updating to this patched version. You can read more about this and possible alternatives in the security advisory.
$page->dirname()/diruri() docblocks #7102Media::thumb(): Fix passing File $model and test logic #7142router.php for the built-in PHP server #7188New session::store core component: return your custom SessionStore handler #6961
session::store core component: return your custom SessionStore handler #6961// `/site/config/config.php`
return [
'panel' => [
'vue' => [
'compiler' => false
]
]
];
kirby folder now uses the LICENSE.mdfile instead of composer.json to avoid false-positive blocks by web application firewalls #6932load method #6809html representation get redirected to the normal page URL without extension #6509Nothing published for this version
Add a single space after colon in headers in Response class for better server support (FrankenPHP) #6976 Thanks to @rasteiner
Fixed CSS rules messing up grid styling inside the gallery block drawer #6838
FileVersion instances #6852image option: fixed support for query string #6916page option #6735js()/css() helpers parametersFixed CSS rules messing up grid styling inside the gallery block drawer #6838
FileVersion instances #6852image option: fixed support for query string #6916page option #6735avif images are now considered resizable by default #6670
avif images are now considered resizable by default #6670autoplay handlingpanel.upload exposes upload dialog open event #6621Toolkit\Obj::toKeys() method #6651Roles filter methods #6655angle-dropdown button #6663api.methodOverwrite config option to activate pure PATCH requests #6650icon and info for query and api options #6780$field->isEmpty() for some empty arrays #6637slugs.maxlength option works now #6526toggle field allowed #6669User::roles() doesn't return only the current role for non-admin users but all available roles #6663new instead just creating a temporary object #6643$page->permalink() returns a language-based permalink for the current content language #6668create option #6718create and changeRole permissions and user options #5147 #5146UserRules::validRole()UserPermissions #6658avif images are now considered resizable by default #6670
avif images are now considered resizable by default #6670autoplay handlingpanel.upload exposes upload dialog open event #6621Toolkit\Obj::toKeys() method #6651Roles filter methods #6655angle-dropdown button #6663api.methodOverwrite config option to activate pure PATCH requests #6650icon and info for query and api options #6780$field->isEmpty() for some empty arrays #6637slugs.maxlength option works now #6526toggle field allowed #6669User::roles() doesn't return only the current role for non-admin users but all available roles #6663new instead just creating a temporary object #6643$page->permalink() returns a language-based permalink for the current content language #6668create option #6718create and changeRole permissions and user options #5147 #5146UserRules::validRole()UserPermissions #6658Fixed file caching regression #6685
Writer field: content with non-breaking changes doesn't anymore show up as changed always #6285
[!TIP] Pages section: if you are experiencing performance issues with a pages section and the table layout, you can try to use
rawvalues: trueto improve performance. This will use the unprocessed values from the content file, which is a lot more performant, but can result in some broken column previews (which would require processed values).
(image: ) KirbyTag(image: cat.jpg width: auto height: auto)
// config.php
'kirbytext' => [
'image' => [
'width' => 'auto',
'height' => 'auto',
]
];
/en/@/page/1234
/en/@/file/1234
google iconKirby\Cms\License::HISTORY const #6503k-button: use title or text of a button to set aria-label #5899$permissions->for(), $modelpermissions->can() and $modelpermissions->cannot() accept a new $default parameter #6548.k-field-type-TYPE CSS class added #5009image options from field/section #6611content.uuid.index option to prevent index lookup. Will throw an exception if a UUID model cannot be looked up from the cache alone. This requires you to keep a full UUID cache at all times but can be helpful for very large sites where any index lookup would run into memory limits. #6564
content.uuid.format to specify uuid-v4 as format.system.exception hook: return false to prevent error to be logged #5028(image: ) KirbyTag: for local files, add width: auto and/or height: auto to include the actual image dimensions as attributes #5064Cmd + S/Ctrl + S in nested structures/objects with date fields does not corrupt data anymore #6390Kirby\Exception\NotFoundException thrown during page rendering now redirects request to the error page (with 404); as Kirby\Exception\ErrorPageException already does #6553max has been reached #6468A::random() throws exception instead of error when $count is higher than array length #6555focus helper for non-native inputs #6347new Http\Uri() for relative URLs with a colon inside #6331pattern attribute for Panel fields: fixed inconsistencies between frontend and backend validation #6585preview blueprint option now supports setting role-based permissions #6572$file->previewUrl() returns null if parent page preview is deactivated/not allowed for the user #6572Nothing published for this version
This vulnerability affects all Kirby sites with enabled languages option that might have potential attackers in the group of authenticated Panel users…
Severity: high (CVSS score 8.1)
Kirby's frontend and backend code did not enforce the existing languages.create and languages.delete permissions.
The missing permission checks allowed attackers with Panel access to manipulate the language definitions. The language definitions are at the core of multi-language content in Kirby. Unauthorized modifications with malicious intent can cause significant damage.
This vulnerability affects all Kirby sites with enabled languages option that might have potential attackers in the group of authenticated Panel users.
If you have disabled the languages and/or api option and don't call any methods in your code that cause a write access to languages (language creation, update or deletion), your site is not affected.
Thanks to Sebastian Eberlein of JUNO (@SebastianEberlein-JUNO) for reporting the identified issue.
.env files in the Panel Vite build config #6516SERVER as name for the Vite host override env variable #6516Fix deprecation warning in router #5895
<k-button>: theme supports values suffixed with -icon now, e.g. positive-icon for filled buttons with only the icon colored<k-button icon="heart" theme="negative-icon" variant="filled">Love</k-button>
Kirby::plugin(
name: 'my/plugin',
extends: [],
info: [
'homepage' => 'https://my-plugin.example.com'
],
version: '1.0.0'
);
text-top, text-middle, text-bottom https://feedback.getkirby.com/592 #6374(video: ) KirbyTag: support for disablepictureinpicture attribute #6413insertNode util #6383data-theme with color names #6407download prop for k-link (and respective k-button when passing a link) to set the download attribute #6417theme prop #6423window.panel.notification.info(message). #6423QrCode class: methods accept new $border argument #6445 (thanks @rasteiner)k-login and k-login-code. #6365nodeInputRule only overwrites matched selection #6385inline: true mode is active #6386create format option is not applied to non-images anymore #6359Title and Link text translations for the different usages: #6402
Title fieldLink text field@, . and _ in filenames to be consistent with other filename rules #6462$file->changeName() now sanitizes new filenames with. included correctly #6462info or root in plugin extends array. Instead pass these as standalone named arguments.<k-login> is deprecated. Use <k-login-form> instead.<k-login-code> is deprecated. Use <k-login-code-form> instead.App::currentLanguage() method #6434App::language() to introduce new current option which creates a more predicatable way to
fetch languages in content, translation and future version methods. #6434k-login and k-login-code. #6365Nothing published for this version
New api option for Sections to define API endpoints just like for fields #6246
api option for Sections to define API endpoints just like for fields #6246<?php
return [
'thumbs' => [
'driver' => 'im',
'threads' => 2
]
];
value prop of the k-login-view component #6364$helpers docs #6257 #6287media attribute support for custom Panel favicons #5657expand, collapse, divider and chartrange input #6253calendar, date, time, timoptions inputs #6254unsigned option for integers. Defaults to true to maintain backwards compatibility.size option for varchars. Defaults to 255 to maintain backwards compatibility.float type to create a floating point columns.decimal type to create decimal columns with precision and decimal_places options. The new features are aimed at MySQL and are ignored in SQLite as they are not supported. Float and decimal both map to REAL columns in SQLite.k-user-avatar #6325A::prepend() now behaves the same as A::append() (just opposite side) for non-associative arrays #6219alpha and hue inputs: setting custom min and max props would break the inputs. Those props aren't falsely exposed anymore. #6251colorname input: props that were falsely exposed are now correctly unset #6255search input: props that were falsely exposed are now correctly unset #6256null value for Text\KirbyTag::parent() #6220Database\Query: Fixed using BETWEEN or NOT BETWEEN in →where() clause (thanks @SeriousKen) #6292Date::round() not taking timezone into account properly (thanks @SeriousKen) #6264k-tabs inline variable assignment #6324Dir::inventory() #6218Cms\Blueprint class #6206v-bind order #6333mounted lifecycle hooks instead of created #6336Dir::inventory() with various number of page models #6218Options, Query, Text and partially Toolkit packages tests, including additional tests for uncovered code #6220Lab\Example::github() linking to lab example file #6295Nothing published for this version
Don’t throw an exception in the permalinksToUrlsmethod if a model for a UUID cannot be found #6165
permalinksToUrlsmethod if a model for a UUID cannot be found #6165dump helper if it already exists. This fixes Kirby for Herd Pro users and other cases where dump is already defined by the environment #6250k-icon-frame #6315toFiles method by checking for valid file IDs #6318open_basedir #6316This release fixes several vulnerabilities that were all responsibly reported to us in February 2024:
This release fixes several vulnerabilities that were all responsibly reported to us in February 2024:
Thanks to Natwara Archeepsamooth (@PlyNatwara) for responsibly reporting the identified issues.
During our investigation of the security reports, we noticed that the documentation on the Markdown safe mode was inaccurate and incomplete.
The Markdown safe mode protects Markdown and KirbyText content from cross-site scripting (XSS) attacks. We have already documented the risk of raw HTML, however there are also risks in the Markdown syntax itself (e.g. malicious javascript: links). These risks are also mitigated by the safe mode. So we strongly recommend this mode for all Kirby sites that might have potential attackers in the group of authenticated Panel users.
The documentation on the safe mode contained a wrong code example that used an invalid safeMode option instead of the correct safe option. This has now been corrected. If you already use the safe mode, please check your code.
➡️ Read more
$file->sharpen() method for images #6227Str::excerpt() for texts without spaces #6215k-button-group wrap with long label line. #6231layout: table #6234k-icon component #6276Color field: writing options as $name => value has been deprecated #6152
The page create dialog now allows to hide the title and/or slug field by defining a string template that will be used instead
create:
title: "{{ page.location }} – {{ page.date.toDate('M Y') }}"
slug: "{{ page.location.slug }}-{{ page.date.toDate('Y-m-d') }}"
Custom fields from the create dialog will be accessible through Kirby query starting with page. (in this example the fields location and date. If no custom fields are defined, the create dialog will be skipped and the page immediately created. #6154
optionsmyColorField:
type: color
options:
type: query
query: kirby.option('my.colors')
// only values
return [
'my' => [
'colors' => [
'#3e3e3e',
'#aaa',
'#ddd',
]
]
];
// values -> labels
return [
'my' => [
'colors' => [
'#3e3e3e' => 'Color A' ,
'#aaa' => 'Color B',
'#ddd' => 'Color C',
]
]
];
When resizing images, you can now sharpen them. This often enhances the image quality when downscaling images.
$page->image('my-image.jpg')->thumb([
'width' => 300,
'height' => 200,
'sharpen' => true
]);
You can also pass an integer value to control the sharpening effect. Higher numbers create sharper images. The default is 50.
$page->image('my-image.jpg')->thumb([
'width' => 300,
'height' => 200,
'sharpen' => 25
]);
Thank you very much to @dgsiegel for implementing this feature. #6164
The link field now has proper previews in structure and object fields #5262
icon option #6006A::implode() method that also handles nested arrays #6059name, the label is now used as fallback #6137panel.dialog.open({
component: "k-search-dialog",
props: {
type: "pages"
}
});
url option not available #6145avif images #6141mobile: true are shown again in narrow viewports #6106Str class in slug field #6049$store.content: fix consistent id pattern #6057field.isVisible(): fix if statement #6098Helpers::handleErrors() correctly restores the original error handler even if an exception is thrown in the action #6105F::size() with non-existing file #6059Session data #6059V::message() with nested arrays #6059Kirby/Api/Api and Kirby/Form/Form classes when no app object is loaded$store.content.id when deleting page #6111image: false in blueprint for Panel preview images #6020preview: fields #6128NaN value after sorting files #6067field, options, parent, siblings and params inside structure fields #6181$field->toStructure()->field() now returns a copy of the structure field object as intended #6181file KirbyTag that references a non-existing file does not throw an exception anymore, when not text attribute passed #6177k-tag component #5834cancel-small icon version #5834$helper.link #5834max-width #6189k-bubble to rounded-sm to be consistent with k-tag. #6188Panel::area() #6217this.$helper.array. functions: fromObject, sortBy, split, wrap #6140FileActionsTest: static provider methods #6092Kirby\TestCase #6124$value => $name, e.g. #6152options:
"#F8B195": "Sunny rays"
"#F67280": "First-love blush"
"#C06C84": "Cherry blossom"
"#6C5B7B": "Morning gloom"
"#355C7D": "Midnight rain"
$name => value has been deprecated #6152$helper.object.clone() has been deprecated. Use the native structuredClone function instead. #6086Array.fromObject() has been deprecated. Use this.$helper.array.fromObject() instead.Array.wrap() has been deprecated. Use this.$helper.array.wrap() instead.myArray.sortBy() has been deprecated. Use this.$helper.array.sortBy(myArray) instead.myArray.split() has been deprecated. Use this.$helper.array.split(myArray) instead.ecmaVersion for eslint parse #6174Refactor the link field input event handling to improve link detection https://github.com/getkirby/kirby/pull/6198
Full Changelog: https://github.com/getkirby/kirby/compare/4.1.0-rc.2...4.1.0-rc.3
LinkField: fix dropdown for only option https://github.com/getkirby/kirby/pull/6192
Color field: writing options as $name => value has been deprecated #6152
The page create dialog now allows to hide the title and/or slug field by defining a string template that will be used instead
create:
title: "{{ page.location }} – {{ page.date.toDate('M Y') }}"
slug: "{{ page.location.slug }}-{{ page.date.toDate('Y-m-d') }}"
Custom fields from the create dialog will be accessible through Kirby query starting with page. (in this example the fields location and date. If no custom fields are defined, the create dialog will be skipped and the page immediately created. #6154
optionsmyColorField:
type: color
options:
type: query
query: kirby.option('my.colors')
// only values
return [
'my' => [
'colors' => [
'#3e3e3e',
'#aaa',
'#ddd',
]
]
];
// values -> labels
return [
'my' => [
'colors' => [
'#3e3e3e' => 'Color A' ,
'#aaa' => 'Color B',
'#ddd' => 'Color C',
]
]
];
When resizing images, you can now sharpen them. This often enhances the image quality when downscaling images.
$page->image('my-image.jpg')->thumb([
'width' => 300,
'height' => 200,
'sharpen' => true
]);
You can also pass an integer value to control the sharpening effect. Higher numbers create sharper images. The default is 50.
$page->image('my-image.jpg')->thumb([
'width' => 300,
'height' => 200,
'sharpen' => 25
]);
Thank you very much to @dgsiegel for implementing this feature. #6164
The link field now has proper previews in structure and object fields #5262
icon option #6006A::implode() method that also handles nested arrays #6059name, the label is now used as fallback #6137panel.dialog.open({
component: "k-search-dialog",
props: {
type: "pages"
}
});
url option not available #6145avif images #6141mobile: true are shown again in narrow viewports #6106Str class in slug field #6049$store.content: fix consistent id pattern #6057field.isVisible(): fix if statement #6098Helpers::handleErrors() correctly restores the original error handler even if an exception is thrown in the action #6105F::size() with non-existing file #6059Session data #6059V::message() with nested arrays #6059Kirby/Api/Api and Kirby/Form/Form classes when no app object is loaded$store.content.id when deleting page #6111image: false in blueprint for Panel preview images #6020preview: fields #6128NaN value after sorting files #6067field, options, parent, siblings and params inside structure fields #6181$field->toStructure()->field() now returns a copy of the structure field object as intended #6181file KirbyTag that references a non-existing file does not throw an exception anymore, when not text attribute passed #6177k-tag component #5834cancel-small icon version #5834$helper.link #5834this.$helper.array. functions: fromObject, sortBy, split, wrap #6140FileActionsTest: static provider methods #6092Kirby\TestCase #6124$value => $name, e.g. #6152options:
"#F8B195": "Sunny rays"
"#F67280": "First-love blush"
"#C06C84": "Cherry blossom"
"#6C5B7B": "Morning gloom"
"#355C7D": "Midnight rain"
$name => value has been deprecated #6152$helper.object.clone() has been deprecated. Use the native structuredClone function instead. #6086Array.fromObject() has been deprecated. Use this.$helper.array.fromObject() instead.Array.wrap() has been deprecated. Use this.$helper.array.wrap() instead.myArray.sortBy() has been deprecated. Use this.$helper.array.sortBy(myArray) instead.myArray.split() has been deprecated. Use this.$helper.array.split(myArray) instead.ecmaVersion for eslint parse #6174No more deprecation warning when passing empty string to Url::short() #6126
Url::short() #6126Updated translations (cs, fr, is, nl)
Updated translations (fr, it, ko, lt, nl)
-scroll-topKirby 4 is here! 🚀 Full release notes: https://getkirby.com/releases/4.0
Kirby 4 is here! 🚀
Full release notes: https://getkirby.com/releases/4.0
This is a quick patch for an upload regression that we unfortunately introduced in the last RC. Please, use this RC instead of RC.3
This is a quick patch for an upload regression that we unfortunately introduced in the last RC. Please, use this RC instead of RC.3
During an internal security review of the Kirby 4 codebase, we have discovered two cross-site scripting (XSS) vulnerabilities in the changes dialog an…
We unfortunately introduced an upload bug in this RC, which renders any uploads unusable. We are very sorry for that. Please, use RC.4 instead: https://github.com/getkirby/kirby/releases/tag/4.0.0-rc.4
During an internal security review of the Kirby 4 codebase, we have discovered two cross-site scripting (XSS) vulnerabilities in the changes dialog and the admin disable dialog for the new TOTP login feature.
Both vulnerabilities were introduced during the Kirby 4 alphas and betas and are fixed by this RC.
The vulnerabilities affect all Kirby sites on Kirby 4 alphas, betas or previous release candidates that might have potential attackers in the group of authenticated Panel users or that allow external visitors to create or update user accounts.
Sites on Kirby 3 are not affected.
# #5997<k-item> #5996Str::$defaults['slug']['allowed'] #5929getComputedStyle as last resort when colors library fails #5997:style attributes to enhance the robustness and security #5986Str::safeTemplate() method against code execution attacks with an automated test #5986$helper.string.slug: the allow parameter now defines the whole set of allowed characters, not just the characters in addition to a-z0-9 #5991The selected color in the color field (options mode) now has a clear outline #5962
Removes breaking change: this.$library.autosize is back
k-stat supports new icon prop #5908k-header: add warning for removed tabs support #5918allowHostRelativeUrls sanitization option (true by default) to perform less strict checks when the HTML <base> element is used$options array$isExternal mode specifically for external files that may be accessed directlythis.$library.autosize is back<base> element is assumed for sites in a subfolder. To revert to the old, strict behavior, set the allowHostRelativeUrls option to false.$isExternal argument for the Sane\Handler::sanitize() and ::validate() methods that custom Sane handlers need to implement; it allows to
differentiate between strings from external files that may be accessed
directly and strings that will end up directly on the pageTOTP (time-based one-time codes) are now supported for two-factor authentication via the new Kirby\Toolkit\Totp class #5654
TOTP (time-based one-time codes) are now supported for two-factor authentication via the new Kirby\Toolkit\Totp class #5654
<?php
// /site/config/config.php
return [
'auth' => [
'methods' => [
'password' => ['2fa' => true]
]
]
];
<img width="667" alt="270112837-ff0bc4d4-5649-4a90-b853-db5de432ec2c" src="https://github.com/getkirby/kirby/assets/24532/fff2a724-1192-4764-9d5c-435f271d7cfa">
Kirby 4 now supports PHP 8.3 and drops support for PHP 8.0. #5774
k-code with prismStr::camelToKebab method<?= Str::camelToKebab('fooBar') // output: foo-bar ?>
k-text-drawerthis.$panel.drawer.open({
component: "k-text-drawer",
props: {
text: "Hello world"
}
});
lab icon$plugin->assets() collection$plugin->asset('styles.css') methodPluginAsset object with many methods, e.g. $plugin->asset('styles.css')->url()https://getkirby.com/media/plugins/getkirby/test-plugin/2375797551-472389240/styles.css)css() and js() helpers support passing plugin and plugin assets objects to include all assets of the plugincss([
'assets/css/index.css',
$kirby->plugin('foo/bar')
]);
css([
'assets/css/index.css',
$kirby->plugin('foo/bar')->assets(),
]);
css([
'assets/css/index.css',
$kirby->plugin('foo/bar')->asset('styles.css'),
]);
User-friendly and safe abstraction for symmetrical authenticated encryption using the PHP sodium extension
use Kirby\Toolkit\SymmetricCrypto;
// encryption/decryption with a password
$crypto = new SymmetricCrypto(password: 'super secure');
$ciphertext = $crypto->encrypt('a very confidential string');
$plaintext = $crypto->decrypt($ciphertext);
// encryption with a random key
$crypto = new SymmetricCrypto();
$ciphertext = $crypto->encrypt('a very confidential string');
$secretKey = $crypto->secretKey();
// encryption/decryption with a previously generated key
$crypto = new SymmetricCrypto(secretKey: $secretKey);
$ciphertext = $crypto->encrypt('a very confidential string');
$plaintext = $crypto->decrypt($ciphertext);
F::safeExtension() method #5760F::safeBasename() method #5760$date->formatWithHandler() method for Kirby date objects that allows to use different date handlers or even the globally configured one (default).panel.menu config option can be a closure now that receives the $kirby object as argumentaccept: options keep the empty text to give context what's happening.Str::date() and its dependents (e.g. F::modified(), File::modified(), Dir::modified()) now respect the globally configured date handlersodium extension is available #5319k-fieldset The error boundary kills the entire field/input if an error occurs, which is way too aggressive and also makes it more difficult to handle errors properly. #5790k-stat component #5801layout prop mixin #5802k-toolbar #5806k-navigate: support custom HTML element via element propfull #5849panel.isOffline statePluginAssets::clean() #5836$helper.field.defaultValue(field) method$helper.field.form(fields)$site->search() allows to provide a string with field names as $params again #5713$collection->remove() and $collection->__unset() in Toolkit collections behave like $collection->set()/$collection->__set() by default and ignore the key case #5704site as option anymore #5717options, won't override other roles' permissions anymore #5759toolbar option for writer #5703k-string-input paddingPanel::go() calls in dialog and drawer submit code.k-navigate: focusable elements are correctly detected for dynamic contentk-tagCms\Collection::pagination() return type #5854k-navigate into a Vue component #5753k-toolbark-block-options with k-toolbar$user->passwordFile() was renamed $user->secretsFile(). The old method is kept as an alias for now but will be removed in a future version.$kirby->plugin('plugin/name')->asset('yourAsset.css)->url() #5641k-plugin-view#5803<k-breadcrumb>: view prop will be removed in a future version. Include in crumbs prop instead. #5799k-autocomplete #5823.htpasswd) was changed. The old format with just the password hash is still supported, however v4 can now store additional secrets in a JSON object in the second line of the file. This makes secrets files with a TOTP secret or other secrets incompatible with Kirby 3 sites.options now fall back to their general permission whereas previously they were denied. If you want to generally deny other roles than a specific one use the * entry for all other roles inside the options array.Str::date() method and its dependents (e.g. F::modified(), File::modified(), Dir::modified()) no longer use the date handler if a different handler was configured globally with the date.handler optionPlugin::assets() doesn't return an array anymore, but a PluginAssets collection #5641k-textarea-toolbar not k-toolbark-timeoptions-input replaces k-times. k-times is still available as deprecated alias. #5698
Kirby\Image\QrCode class, qr() helper function and >toQrCode() field method #5666$qr = new Kirby\Image\QrCode('https://getkirby.com');
$qr->toSvg(color: '#ff00ff');
$qr->toDataUri(color: '#ff00ff');
$qr->write(file: 'qr.png', size: 750, back: '#efefef')
qr('https://getkirby.com')->toSvg();
$page->myLinkField()->toQrCode()->toSvg();
k-alpha-input and k-hue-input #5693k-color-frame component to preview color swatches #5686k-coloroptions-input #5696 and k-colorname-input #5699k-search-input component #5705LazyValue class that can be used to resolve a value lazily. Collections and controllers use it to resolve many of Kirby's objects only when the collection/controller requests them, improving performance #5608k-tabs is now fully responsive #5583k-pagination always can be navigated by keys (no extra prop needed anymore) #5578Filter as label #5612font: monospace option https://kirby.nolt.io/558panel.css and panel.js config options now also support arrays with multiple entries as well as absolute URLs #5602k-calendar-input is now set up as a proper fieldset with legend and additional aria labels for improved accessibility. #5695k-tag supports an image/icon frame #5686k-tag image for preview #5686k-tag with k-color-frame in image slot #5686--table CSS properties for more controlaria-disabled propertyk-options-dropdown componentk-textk-text style support for the k-html-field-preview component--table-cell-padding property to control their padding, which leads to more reliable styling optionsselected prop for k-button to set the aria-selected attribute. #5698grad, rad and turn angels for hsl format #5589$page->search() allows to provide a string with field names as $params again getkirby.com#2094k-calendar-input can now receive a regular iso date as value.k-bubbles-field-preview and all other previews that extend it now correctly display when there are no bubblesk-color-field-preview correctly displays the pattern when no color is set--header-sticky-offset to fix it's stickiness.k-block-title stylesk-block-figurek-pagination: removed unused align and dropdown props #5578Str::short() #5688k-color is now k-colorpicker-input #5685k-coords is now k-coords-input #5685k-colorpicker-input now uses the new inputsstyles/reset/choice.cssk-time-field-preview now extends k-date-field-preview and improves time parsing and the default formattingfieldPreview mixin defines proper defaults for column and fieldk-toggle-field-preview uses the low level k-toggle-input instead of k-input to avoid unnecessary markupk-timeoptions-input replaces k-times. k-times is still available as deprecated alias. #5698k-timeoptions-input #5698<k-dropdown> was deprecated. Use <k-dropdown-content> as standalone instead.k-calendar-input replaces k-calendar. k-calendar is still available but only as deprecated alias.k-pagination doesn't support setting custom labels/titles via nextLabel, prevLabel or pageLabel #5578DS constant. Use / instead. #5590Panel\Assets::custom() now returns an array #5602kirby user, any permission check will succeed even if permission has been disabled for regular admins #5511::group() method of all collection classes to $caseInsensitive #5634k-range is gone and replaced by k-alpha-range and k-hue-rangek-choice has been removed. Use k-choice-input insteadk-choice-inputCustom icons using a 16x16 viewbox have been deprecated. In an upcoming version, Kirby will only support custom icons with a 24x24 viewbox by default.…
requests for simple data endpoints or actions #5531assets extension that allows plugins to specify assets from custom paths and with a wider range of extensions than previously supported #5557$helper.upload() JS #5487$panel.upload() will now only start up to 20 uploads concurrently and adding additional uploads consecutively whenever a previous one finishes #5491html prop for k-bubble, k-bubbles and k-bubbles-field-preview. #5493translate icon #5565Str::template() support single and double curly braces as start/end delimiters by default #5556sortBy in structure fields works now #5567k-text styles to cover more marks and general text styles for the writer and text blocks #5569k-collection and k-items: options slot gets properly exposed also for table layout #5561window.panel.$vue reference for kirbyupforEach usage #5494<svg> element with the corresponding viewBox attribute.assets directory are now always assumed to be public, independent of their file extension. If your plugin needs to store other files in the assets directory, please use the new assets extension to explicitly define the public assets. #5557Deprecated circle-outline icon, use circle instead
views dynamically with new when prop #5425megaphone, sparklingicon optioncircle-outline icon, use circle insteadheart-outline icon, use heart insteadstar-outline icon, use star insteadroad-sign iconcircle icon is now named circle-filledheart icon is now named heart-filledstar icon is now named star-filledThis pre-release comes with the security fixes from 3.9.6 and the patch from 3.9.6.1:
quote node (by default not included in nodes dropdown)languages.variables config option to disable managing translations in the Panelsize (small, medium, large, huge) and columns via new selector prop layout:
type: layout
layouts:
...
selector:
# `small`, `medium`, `large` or `huge`
size: huge
columns: 6
This pre-release comes with the security fixes from 3.9.6 and the patch from 3.9.6.1:
twitter KirbyTag and Helper have been removed. Use legacy plugin if you still rely on these: legacy-twitter.zipThis is a pre-release for Kirby 4, which will be released later this year. Find out more about features and our roadmap on our Kirby 4 release page: h
This is a pre-release for Kirby 4, which will be released later this year. Find out more about features and our roadmap on our Kirby 4 release page: https://getkirby.com/releases/4.0
access and list permissions for files #5219App::multilang and App::defaultLanguage are correctly updated #5342Language::update when updating the default language->toUrl() method for invalid uuids #5367…and $model->contentFileName() methods have been deprecated and will be removed in Kirby 5.
templatesIgnore for pages section - https://kirby.nolt.io/130 #5322anchor type for the link field
<img src="https://github.com/getkirby/kirby/assets/3788865/a333f7f9-9a31-43b1-bfb4-5643c53051da" alt="screenshot of the anchor type" width="250">custom type for the link field
<img src="https://github.com/getkirby/kirby/assets/3788865/5e20d84d-6b72-42c6-a5c1-92dff2e8ad8a" alt="screenshot of the custom type" width="300">anchor icondefault: true to always use the currently logged in user as defaultfocus option for file blueprints to enable/disable setting focus point in the Panel (defaults to true for all viewable images, false for all other files) #5316App::models() method that returns a generator for each model (site, files, pages and users) of the site [#5337]https://github.com/getkirby/kirby/pull/5337Cmd key (instead use variants with Ctrl key) #5268files typek-bubble more flexible #5305Kirby\Cms\Structure extends Kirby\Cms\Items and Kirby\Cms\StructureObject extends Kirby\Cms\ItemPage::isAccessible instead of Page::isReadable #5220query endpoint for Kql plugin to coreContent namespace
Content, ContentTranslation and Field classes (compatibility aliases are provided for now) #5283ContentStorage class that currently holds more of the storage related business logicContentStorageHandler interface and internal PlainTextContentStorageHandler class to bundle all low-level content logic in one place #5283Content namespace #5283query should not be used anymore for custom API endpoints, it will be used for the Kql plugin/core implementation$model->contentFile(), $model->contentFiles(), $model->contentFileDirectory(), $model->contentFileExtension() and $model->contentFileName() methods have been deprecated and will be removed in Kirby 5.default, not Kirby\Cms\Block. #5299new Structure()/new StructureObject() don't work anymore as before. Use Structure::factory()/StructureObject::factory() insteadStr::uuid() as blocks doItems::factory() and all inheriting classes throw an exception now if malformed data is passeddefault: true to keep this functionality$model->contentFile(), $model->contentFiles(), $model->contentFileDirectory(), $model->contentFileExtension(), $model->contentFileName(), $model->readContent() and $model->writeContent() methods in a page model will no longer have an effect as these methods are no longer called by the core. Please extend the new Kirby\\Content\\PlainTextContentStorage class instead and return an instance of your custom class from $model->storage(). However please note that the interface of PlainTextContentStorage is internal and may change in the future.$translations->start() and $translations->stop() methods were no longer in use and have been removed. Content files are automatically converted by the Language class.$languages->codes() now returns ['default'] for single language installations #5339Page tree now uses the icon defined in each page's blueprint #5239 !Untitled
\Kirby\Panel\PageCreateDialog::$fieldTypes[] = 'yourFieldType'upload: use upload.parent for mime check #5245textarea and writer for now in the Page Create Dialog until we have a better idea how to handle dialogs in layers #5243->toUrl() to return null on empty fields #5259panel.dialog for remove dialogs #5242PageCreateDialog #5235Toolkit\A ****#5227Form classes #5209This is a pre-release for Kirby 4, which will be released later this year. Find out more about features and our roadmap on our Kirby 4 release page: h
This is a pre-release for Kirby 4, which will be released later this year. Find out more about features and our roadmap on our Kirby 4 release page: https://getkirby.com/releases/4.0
:has() CSS selector #5203I18n::translate method name to fix the language view #5193This is the first public alpha releae for Kirby 4 🌱
This is the first public alpha releae for Kirby 4 🌱
We've prepared a release page with information about the alpha, all new features and docs: https://getkirby.com/releases/4.0
Update Symfony YAML component to v6 https://github.com/getkirby/kirby/issues/6161
The version number might seem a bit weird. Here's the explanation:
The version number might seem a bit weird. Here's the explanation:
The latest stable release of Kirby 3 is Kirby 3.9.8, which has support for PHP 8.0 until PHP 8.2. But we cannot offer support for PHP 8.3 without dropping support for PHP 8.0, due to version restrictions in our dependencies. So we decided to introduce this additional release, which adds support for PHP 8.3 (and nothing else) but also drops support for 8.0, while still keeping Kirby 3.9.8 around with the support for PHP 8.0. Depending on your hosting requirements, you can now choose between either Kirby 3.9.8 or Kirby 3.10.0.
New A::every(), A::find() and A::some() methods that implement the functionality of the JavaScript functions with the same names (thanks to @rasteiner
A::every(), A::find() and A::some() methods that implement the functionality of the JavaScript functions with the same names (thanks to @rasteiner) #5724// config.cli.php
return [
'option.one' => 1,
'option.two' => 2,
];
.pht extension can no longer be uploaded to a Kirby site to provide additional protection in older server setups beyond our recommendations in the security guide (thanks to @akabe1). #5925sodium extension is available #5319$collection->remove() and $collection->__unset() in Toolkit collections behave like $collection->set()/$collection->__set() by default and ignore the key case #5704New A::every(), A::find() and A::some() methods that implement the functionality of the JavaScript functions with the same names (thanks to @rasteiner
A::every(), A::find() and A::some() methods that implement the functionality of the JavaScript functions with the same names (thanks to @rasteiner) #5724// config.cli.php
return [
'option.one' => 1,
'option.two' => 2,
];
.pht extension can no longer be uploaded to a Kirby site to provide additional protection in older server setups beyond our recommendations in the security guide (thanks to @akabe1). #5925sodium extension is available #5319$collection->remove() and $collection->__unset() in Toolkit collections behave like $collection->set()/$collection->__set() by default and ignore the key case #5704Adds support for whoops.blocklist config option to mask variables that are displayed when showing errors with Whoops. (thanks to @hyr)
Adds support for whoops.blocklist config option to mask variables that are displayed when showing errors with Whoops. (thanks to @hyr)
return [
// mask everything
'whoops' => [
'blocklist' => [
'_COOKIE' => array_keys($_COOKIE),
'_SERVER' => array_keys($_SERVER),
'_ENV' => array_keys($_ENV),
]
]
];
return [
// mask specific things
'whoops' => [
'blocklist' => [
'_SERVER' => [
'AWS_ACCESS_KEY_ID',
'AWS_SECRET_ACCESS_KEY',
],
]
]
];
kirby as user id #5514Database\Query::fetch() #5651 (thanks @adamkiss)Str::pool(): New base32 and base32hex pools (useful when a Str::random() needs to be printed in a human-readable way without easy to confuse 0/O and 1/I). #5715k-text-input for text field if no specific component exists for its type #5369.mjs extension #5473$page->isUnlisted() which falsely would return true for drafts #5506$collection->group() for case-sensitive #5631Nothing published for this version
This release fixes several vulnerabilities that were all responsibly reported to us in June 2023:
This release fixes several vulnerabilities that were all responsibly reported to us in June 2023:
Thanks to Shankar Acharya (@5hank4r), Alexandre Zanni (@noraj) at ACCEIS and Patrick Falb (@dapatrese) at FORMER 03 for responsibly reporting the identified issues.
.htaccessWe have updated the .htaccess that ships with our kits to the new version 2023-07-22, which adds protection against browser MIME type detection from malicious file uploads for files that have already been copied to the media folder. We recommend to update your sites’ .htaccess or server configuration with the new changes if you might have potential attackers in your group of authenticated Panel users or if your sites allow file uploads by visitors and the file extensions of uploaded files are not limited to a fixed safe list.
You can find the changes to the .htaccess in this commit and read more about the added rules in the security guide.
Thanks to Shankar Acharya (@5hank4r) for making us aware of this potential attack vector.
The Panel now sends the Content-Security-Policy: frame-ancestors 'none' header to increase the protection against clickjacking attacks. The session cookie was already set to SameSite before, so this is an additional layer of protection.
Thanks to Shankar Acharya (@5hank4r) for suggesting this security enhancement.
Xml data handler (e.g. Data::decode($string, 'xml')) and the Xml::parse() method no longer process XML external entities.link, label, info and value now all support translations and Kirby queries #5256collection() helper (and corresponding methods) allow passing an $options array which will be provided as additional arguments to the collection closure (thanks to @ceesvanegmond)<?php
// site/controller/news.php
$articles = collection('news', ['order' => 'asc']);
// site/collection/news.php
use Kirby\Cms\Site;
return function (Site $site, string $order) {
return $site->find('news')->children()->template('article')->orderBy($order);
};
lock API routes for files that are ancestors of a page called files #5273page() alongside provided objects with the same name #5276search component #5297Nothing published for this version
Vue is now separately accessible at window.Vue #5158
Vue is now separately accessible at window.Vue #5158cs, is_IS, ru)HasFiles::file() now also uses $in parameter when looking up UUIDs #5159Database::lastError() doesn't crash anymore when no error occurred #5165$collection->indexOf() returns false instead of the index 0 when the passed element was not found in the collection #5175next() and prev() methods are now type-hinted to return static for improved IDE support #5039collection() helper #5169Nothing published for this version
F::move() now detects if the source and target are on different filesystems; it then copies the file and deletes the source on success instead of atom
F::move() now detects if the source and target are on different filesystems; it then copies the file and deletes the source on success instead of atomically moving the file #5124noopener where it's already implied by noreferrer #5138when for field groups (thanks @youngcut) #5143fields:
showit:
type: toggle
myGroup:
type: group
when:
showit: true
fields:
myField1:
type: text
myField2:
type: text
yaml.handler to 'symfony'. We plan to switch over to the Symfony handler in the next major releases. For now, 'spyc' remains the default.<?php
// File: /site/config/config.php
return [
'yaml.handler' => 'symfony'
];
$file->update(['template' => null]) allows unsetting template again #5131alt text from image source does not get adopted (thanks @holmey) #5132Nothing published for this version
New Str methods: ::match, ::matches and ::matchAll (thanks to @adamkiss) #5034
Str methods: ::match, ::matches and ::matchAll (thanks to @adamkiss) #5034A methods: ::count, ::has, ::reduce, ::slice and ::sum (thanks to @adamkiss) #5032pretty: true mode is not used https://kirby.nolt.io/518On March 21, 2023, we made minor edits to our license agreement (EULA) based on community feedback we received in the last months.
You can find the full text of the new EULA on the Kirby website, together with a diff from the previous version and the following summary:
One column per quarter.