Kirby 3.8

Panel

• Update check for Kirby and plugins #4676
• New object field #4640

Core

• Unique IDs for pages, files, users and site #4612
• Permanent URLs for pages and files with UUIDs #4612
• New $users->files() method (returning a collection of all files of the users) #4499
• Support for a new site/config/env.php file for options that are specific to a deployment: It can override all options from config.php and from the config files specific to hostname and server IP address. It can also override the url option and control which hostname-specific files will be loaded. #4580
• New $cache->getOrSet($key, $callback, $minutes) method: Retrieves the value from cache if possible, if not via callback function and adds it to the cache #4627
• New $cache->enabled() method to check if the cache is ready to store values #4661
• New option to disable the output from $kirby->render() via $_ENV['KIRBY_RENDER'] = false
• New commands root which is set to site/commands by default
• New ability to define CLI commands in Kirby plugins:

<?php

Kirby::plugin('getkirby/commander', [
    'commands' => [
        'commander' => [
            'command' => function ($cli) {
                $cli->success('Nice command!');
            }
        ]
    ]
]);

Panel

• Better gallery block features new ratio, crop and caption fields and displays images according to selected ratio #4652.
• Better error messages for blocks and layout fields #Nolt313
• The error dialog now displays multiple error lines per field #4629
• System view: Empty plugin table cells display "–" #4444
• When a login challenge has expired, the user is redirected to the login page. #4087
• Added new onFormInput handler of the structure field on form submit event #4616
• Each report in a k-stats widget can now define a dialog prop with the name of a dialog to be opened when the report is clicked. #4658
• Fiber dialogs: the submit button is now disabled while processing a submit request to prevent sending multiple requests at once accidentally #4413
• Table rows use the same outline styling when dragged as cards and lists #4682
• Easily translate options via an i18n key #3955:

# via `*` pseudo locale
options:
  a:
    *: my.i18n.key.a
  b:
    *: my.i18n.key.b

Core

• The $field->replace(), $modelWithContent->toString(), $modelWithContent->toSafeString() and Str::safeTemplate() methods now support the fallback value null (which leaves invalid tokens in the output string). #4671

Panel

• Tags field: Separates tags on blur correctly #4638
• Tags field: Doesn't lose current input when hitting Cmd+S #4590
• Various escaping issues for fields with options #4043 #4229
• Picker fields: Fixed styling for disabled/non-translatable state #4306
• Structure field: columns options now rightly overrule implied options from the field #4514
• URL field preview is properly truncated with an ellipsis when it is too long #4677
• Users view: The role filter is not shown anymore if there is only one role available #4673
• The template of the home page can be changed now #4571
• Items are properly highlighted while being dragged #4648
• The table layout heading alignment is now working properly #4630
• Uploaded XML files are no longer blocked because they contain links to external domains #4553
• The Panel now suppresses error dialog when redirecting to logout #4614
• We brought back the default slot for k-items #4635
• When the structure field is used with limit, the index number now shows correctly #4695
• The Panel now uses the correct favicon in dark mode #4691
• Reduced impact of frequent lock requests on the server load #4741

Core

• Calling a $file method inside a custom file::url component no longer causes an infinite loop #4274
• Str::excerpt() does not add superfluous space after stripped tag and before interpunctuation #4645
• Fixed calling A::average() with empty array #4269
• Site search with parameters now returns correct results #4641
• Caching is no longer disabled when the request passes an empty Authorization header. #4634
• Calling $app->user() no longer sets the response flag for "uses auth header" unless the api.basicAuth option is enabled. #4646
• A::append() has been fixed for non-associative arrays. It is now an alias for A::merge() with the A::MERGE_APPEND flag. #4345
• Language routes that return a falsy value are only called once now #4305
• $translation->exists() now works for virtual pages #4674
• Database queries can now filter by 'AND' and 'OR' as actual values (via ->where(), ->andWhere() and ->orWhere()) #4668
• Prevent race condition errors for Dir::make() #4745

Panel

• Panel drag texts now use UUIDs (KirbyText) or permalinks (Markdown) for absolute references #4612
• Custom login views no longer need to display errors themselves with k-login-alert, instead they can this.$emit("error", error) #4577
• The properties for the system view are now combined in the backend for easier extension and testing #4658
• Updated npm dependencies #4639
• New blueprint syntax for options (with polyfills for the old syntax): #4624

# manual options
# shorthand
options:
  - a
  - b
  - c

# long form
options:
  type: array
  options:
    - a
    - b
    - c

# api
options:
  type: api
  url: https://api.getkirby.com
  query: Companies

# query
options:
  type: query
  query: site.contactoptions.toStructure
  text: "{< item.nameWithHtml >}"
  value: "{{ item.twitter }}"

Core

• Optimized code base to take advantage of PHP 8
  • Using PHP match statements instead of switch in various places #4452
  • Using |null for nullable type hints #4453
  • Using PHP's new null safe operator #4455
  • Kirby\Toolkit\A: Improve type hinting #4495
  • Removed unused variables from PHP catch statements #4457
  • Use PHP's instanceof instead of is_a() #4609
• Support for default caches (via Core::caches()) #4535
• Kirby\Database\Query: New third parameter $mode for ->filterQuery()  #4564
• Added a new Option namespace with refactored options classes #4624
• New syntax for Helpers::handleErrors():

  Helpers::handleErrors(
    fn () => // error to suppress,
    fn (int $errno, string $errstr): bool => // condition when to suppress error
    $value // return value for when the error is suppressed
  );

• $kirby->impersonate($user, $callback): The $callback will not be bound anymore to the $kirby instance in Kirby 3.9.0, $this inside the callback will refer to the current context and not $kirby instead. Using $this as $kirby inside the callback will throw a deprecation warning in debug mode. #4498
• Blueprints: The headline option for sections will be removed in a future Kirby version. Use label instead. #4515
• $kirby->server() has been deprecated and will be removed in Kirby 3.9.0. Use $kirby->environment() instead. #4515
• Kirby\Form\Options, Kirby\Form\OptionsApi, Kirby\Form\OptionsQuery have been deprecated and will be removed in Kirby 3.9. Use their Kirby\Option equivalents instead.

{generation}.{major}.{minor}(.{patch})

Panel

• The multiselect field no longer displays the option value as info #4624

Core

• Kirby 3.8.0 requires a minimum of PHP 8.0.
• uuid and permalink cannot be used as field name or custom method for any page, file, user or site anymore. Content fields can only be accessed via e.g. $model->content()->get('permalink').
• The first-level URL path @ is now blocked.
• Kirby's upload sanitizer no longer checks XML files for external links because they can be pretty common in many XML-based formats; if you want to keep the strict behavior, set Kirby\Sane\Xml::$allowedDomains = [], set this property to a custom allowlist or write a custom Sane handler for your XML-based format #4553
• Kirby now automatically loads the site/config/env.php file; if you already use this file path for a different purpose, please rename the file to a different name #4580
• A::average() returns null when passed an empty array #4649
• The default token fallback in Str::safeTemplate() changed from an empty string to null (which leaves invalid tokens in the output string). This behavior is consistent with Str::template().
• $translation->exists() now returns true for translations without an actual content file but where an content array has been provided
• The deprecated master branch of the Kirby repository was deleted. If you install Kirby via Git, e.g. as a submodule, please use the main branch instead.
• Database queries: subsequent ->where() clauses don't support passing the mode (AND|OR) as last parameter anymore, but will interpret these as actual values to filter against. Use ->andWhere() or ->orWhere() instead. #4668
• Helpers::handleErrors()'s 2nd parameter now only determines whether the error is suppressed, its 3rd parameter defines what is returned when an error is suppressed

Removed deprecated code #4478 #4515

Removed dump component. Disable dump() via KIRBY_HELPER_DUMP instead and create your own function.

PHP methods

Classes

Class Aliases

API