Kirby 4

Dialogs for fields

Fields can now define their own dialogs on the backend.

• Fields with array definition:

  return [
  'props' => [
    // ...
  ],
  'dialogs' => function () {
    return [
      [
        'pattern' => 'delete',
        'load' => function () {},
        'submit' => function () {},
      ]
    ];
  }
  ];

  
  

• Field classes:

  class MyField extends FieldClass
  {
  public function dialogs(): array
  {
    return [
      [
        'pattern' => 'delete',
        'load' => function () {},
        'submit' => function () {},
      ]
    ];
  }
  }

The route patterns for field dialogs are automatically prefixed with the following scheme:

dialogs/$modelPath/fields/$fieldName/$pattern

Here's an example:

dialogs/pages/blog/fields/blocks/delete

In a field component, the dialog can be opened by using the field endpoint:

this.$dialog(this.endpoints.field + "/delete")

New Icons

We've added new icons to our Panel iconset:

• clear
• split
• merge

New Components

• <k-code>
• <k-dialog-body>
• <k-dialog-box>
• <k-dialog-buttons>
• <k-dialog-fields>
• <k-dialog-footer>
• <k-dialog-form>
• <k-dialog-notification>
• <k-dialog-search>
• <k-dialog-text>
• <k-notification>
• <k-drawer-body>
• <k-drawer-fields>
• <k-drawer-header>
• <k-drawer-notification>
• <k-drawer-tabs>
• <k-tree>
• <k-page-tree>
• <k-browser>
• <k-file-browser>

New helpers

• $helper.focus(element)
• $helper.object.length(object)
• $helper.string.isEmpty(string)
• $helper.url.base
• $helper.url.buildQuery
• $helper.url.buildUrl
• $helper.url.isAbsolute
• $helper.url.isSameOrigin
• $helper.url.isUrl
• $helper.url.makeAbsolute
• $helper.url.toObject

New JS error classes

• RequestError
• JsonRequestError

More to come …

We are not done here …

Core

• Throw proper errors when thumbnails cannot be generated 
• Removed config/blueprints directory with dead block blueprints and moved default blueprints for site, page and file to in-code arrays in Kirby\Cms\Core::blueprints()
• Removed Kirby\Toolkit\Properties trait from Kirby\Api\Api, Kirby\Cms\Api, Kirby\Email\Email,  Kirby\Email\Body, Kirby\Cms\Auth\Status, Kirby\Cms\App, Kirby\Cms\ContentTranslation, Kirby\Cms\ModelWithContent, Kirby\Toolkit\Pagination , Kirby\Http\Uri , Kirby\Cms\FileVersion, Kirby\Filesystem\Asset, Kirby\Filesystem\File, Kirby\Image\Image classes and Kirby\Filesystem\IsFile trait
• Kirby\Cms\Language, Kirby\Cms\Plugin, Kirby\Cms\Role and Kirby\Cms\StructureObject don't extend Kirby\Cms\Model (and thus also don't use the Kirby\Toolkit\Properties trait) anymore

Panel

• Cleaned up k-toolbar component

• Drawer Component Structure

  <k-overlay type="drawer">
    <form class="k-drawer" method="dialog">
        <k-drawer-notification />
        <k-drawer-header />
        <k-drawer-body>
            <k-drawer-fields />
        </k-drawer-body>
    </form>
  </k-overlay>

• Portals: Dialogs, Drawers and other Overlays are now seperated into different portals. This is done by setting the overlay type:

  • <k-overlay type="dialog">
  • <k-overlay type="drawer">
  • <k-overlay>
    An overlay without a type will use the default overlay portal. Separating them into different portals gives us more control over z-index and layering of elements.

• Removed v-model from k-form and k-fieldset

• Removed $listeners usage from k-draggable, k-button and subcomponents, k-link, k-headline, k-form, k-block, k-block-title, k-box, k-image, k-content-item

Core

• Kirby\Cms\Model in favor of Kirby\Cms\ModelWithContent
• Kirby\Email\Email::clone() and Kirby\Email\Body::clone()

Panel

• this.$events: Use this.$panel.events instead.
• this.$panel.events.$on: Use this.$panel.events.on instead
• this.$panel.events.$off: Use this.$panel.events.off instead
• this.$panel.events.$emit: Use this.$panel.events.emit instead
• this.$store.dispatch("isLoading"): Use this.$panel.isLoading instead
• this.$translation: Use this.$panel.translation instead
• this.$store.dispatch("dialog") is deprecated. Use this.$panel.dialog.open and this.$panel.dialog.close instead
• this.$store.dispatch("drag", drag) has been deprecated. Use this.$panel.drag = drag instead

Removed deprecated code

• Kirby\Form\Options, Kirby\Form\OptionsApi and Kirby\Form\OptionsQuery classes have been removed. Use Kirby\Option\Options, Kirby\Option\OptionsApi or Kirby\Option\OptionsQuery instead.
• Kirby\Toolkit\Query class has been removed. Use Kirby\Query\Query instead.
• Passing the $slot or $slots variables to snippets was deprecated and support has now finally been removed.

Core

• We have added more native PHP type hints throughout the system. When eextending core classes, this might require you to update your method to include those type hints as well.
• When thumb generation fails, the image API now throws an error and no longer loads the original image.
• Files: manipulate and focus are now used by core methods. They are no longer available for custom file methods and content fields with these names can only be accessed via e.g. $file->content()->get('focus').
• I18n::translate(): If $fallback is an array and neither the array $key nor the array $fallback have a matching entry for the locale, the first element of the $key array will now be returned (not anymore the one from $fallback). If $fallback is a string, it will be considered with priority over both of these.
• If overwriting the hidden field, it must return 'hidden' => true now
• Kirby\Uuid\Uuid is now an abstract class, child classes need to implement the id method
• Kirby\Uuid\Uuid::key() can now also return null if the new $generate parameter isn't passed as true and no UUID has yet been generated for the model
• Errors are no longer hidden when a response is converted to a string
• Kirby\Cms\ModelWithContent doesn't extend Kirby\Cms\Model anymore.
• Removed the ::clone() method from Kirby\Cms\Auth\Status, Kirby\Http\Uri, Kirby\Cms\FileVersion, Kirby\Filesystem\Asset, Kirby\Filesystem\File, Kirby\Image\Image, Kirby\Cms\Plugin, Kirby\Cms\Role, Kirby\Cms\StructureObject and Kirby\Cms\ContentTranslation classes
• Removed the ::hardcopy() method from Kirby\Api\Api, Kirby\Cms\Api,Kirby\Email\Email, Kirby\Email\Body, Kirby\Cms\Auth\Status, Kirby\Toolkit\Pagination, Kirby\Http\Uri, Kirby\Cms\FileVersion, Kirby\Filesystem\Asset, Kirby\Filesystem\File, Kirby\Image\Image, Kirby\Cms\Role, Kirby\Cms\StructureObject and Kirby\Cms\ContentTranslation classes
• Removed ::site() method from Kirby\Cms\Plugin, Kirby\Cms\Role and Kirby\Cms\StructureObject classes
• Removed ::kirby() method from Kirby\Cms\Role and Kirby\Cms\StructureObject classes
• Unauthenticated API and Panel calls now return a correct 401 HTTP code instead of 403.

Panel

• this.$library.autosize has been removed, wrap <textarea> elements inside <k-autosize> element instead.
• Defining the footer slot in <k-dialog> will no longer wrap the slot content in the <footer> element. This can now be more flexibly handled by using <k-dialog-footer> inside the slot.
• The form drawer no longer automatically closes on submit. This is introducing the same behaviour as in dialogs. Auto-closing might often not be the intended result of submitting the form and it's easier to close it manually in a submit handler than to re-open it again.
• this.$store.state.isLoading is no longer available. You can now use window.panel.isLoading or this.$panel.isLoading in Vue components to access the current loading state.
• this.$store.state.dialog is no longer available. Use this.$panel.dialog instead.
• Removed this.$store.state.drag, use window.panel.drag/this.$panel.drag instead.
• k-button , k-link, k-headline and k-content-item only emit the click event. For other native events, use the .native event listener modifier
• Native events (e.g. click, dbclick) need the .native modifier now when used on k-block and k-block-title
• Need to use .native modifier for all previous event listeners on k-box and k-image