Release 2.2.0

Author: giuscris

CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+# [2.2.0](https://github.com/getformwork/formwork/releases/tag/2.2.0)
+
+**Enhancements**
+- **Add support for taxonomies**
+- **Add the possibility to define item field options in the array fields**
+- **Add the possibility to define field layout tabs**
+- **Add Greek and Turkish translations (🤖 AI generated, reviews are welcome)**
+- Add the possibility to specify field layout section order in page schemes
+- Add the possibility to set markdown editor placeholder and disabled state
+- Add the possibility to pass asset metadata
+- Normalize data structure by removing dots when merging defaults and frontmatter
+- Improve performance traversing the page ancestors instead of the entire page subtree
+- Improve sorting based on a second array with `Arr::sort()`
+- Add the possibility to delete pages in place from the panel tree
+- Add the possibility to save and create a new page in the panel
+- Add the possibility to duplicate pages from the panel
+- Add the possibility to select route alias destinations with page field in the panel
+- Add the possibility to define route params constraints with `Route::where()`
+- Add `PageCollection::havingTaxonomy()` to filter pages by taxonomy
+- Add `AbstractCollection::keyBy()`
+- Add `AbstractCollection::each()`
+- Add icons to panel navigation
+- Build panel app as modules and use async imports for chunk splitting
+- Allow loading scripts as module in the panel with asset meta `module`
+- Remove markdown editor layout shift and add loading animation
+- Add loading animations to statistics charts
+- Display canonical route in the page editor as in other views
+
+**Security**
+- Use `innerHTML` only if needed and on escaped input
+
+**Bug fixes**
+- Fix page handling of fields with dot notation in the frontmatter
+- Fix page setters and default values handling
+- Fix URL-encoded strings in request input keys
+- Remove propagation of site description metadata to all pages
+- Fix color input initalization without default value
+- Avoid PHP 8.5 deprecations
+
+**Deprecations**
+- Deprecate `allowTags` option in page schemes
+
 # [2.1.5](https://github.com/getformwork/formwork/releases/tag/2.1.5)
 
 **Bug fixes**

formwork/fields/array.php

@@ -22,6 +22,8 @@
 
             /**
              * Return whether the field allows empty values
+             *
+             * @since 2.2.0
              */
             'allowEmptyValues' => function (Field $field): bool {
                 return $field->is('allowEmptyValues', false);
@@ -52,6 +54,8 @@
 
             /**
              * Return the fields for each item in the array
+             *
+             * @since 2.2.0
              */
             'items' => function (Field $field, array $default = []) use ($fieldFactory): FieldCollection {
                 $fields = new FieldCollection();

formwork/src/Assets/Asset.php

@@ -110,6 +110,8 @@ public function toBase64(): string
 
     /**
      * Get asset metadata value by key
+     *
+     * @since 2.2.0
      */
     public function getMeta(string $key, mixed $default = null): mixed
     {

formwork/src/Assets/Assets.php

@@ -47,6 +47,8 @@ public function add(string $key, array $meta = []): void
 
     /**
      * Return whether the collection has an asset with the given key
+     *
+     * @since 2.2.0
      */
     public function has(string $key): bool
     {

formwork/src/Cms/App.php

@@ -49,7 +49,7 @@ final class App
     /**
      * Current Formwork version
      */
-    public const string VERSION = '2.1.5';
+    public const string VERSION = '2.2.0';
 
     /**
      * App services container

formwork/src/Data/AbstractCollection.php

@@ -316,6 +316,8 @@ public function limit(int $length): static
 
     /**
      * Run a callback for each item in the collection. If the callback returns `false`, iteration is stopped
+     *
+     * @since 2.2.0
      */
     public function each(callable $callback): static
     {
@@ -508,6 +510,8 @@ public function groupBy(string $key, mixed $default = null): array
 
     /**
      * Return a copy of the collection indexed by the given key from each item
+     *
+     * @since 2.2.0
      */
     public function keyBy(string $key, mixed $default = null): static
     {

formwork/src/Fields/Layout/Layout.php

@@ -48,6 +48,8 @@ public function sections(): SectionCollection
 
     /**
      * Get layout tabs
+     *
+     * @since 2.2.0
      */
     public function tabs(): TabCollection
     {

formwork/src/Fields/Layout/Section.php

@@ -39,7 +39,7 @@ public function is(string $key, bool $default = false): bool
     }
 
     /**
-     * Get field label
+     * Get section label
      */
     public function label(): ?string
     {
@@ -48,6 +48,8 @@ public function label(): ?string
 
     /**
      * Get section order
+     *
+     * @since 2.2.0
      */
     public function order(): int
     {

formwork/src/Fields/Layout/Tab.php

@@ -7,6 +7,9 @@
 use Formwork\Data\Traits\DataGetter;
 use Formwork\Fields\Translations\Translations;
 
+/**
+ * @since 2.3.0
+ */
 class Tab implements Arrayable
 {
     use DataGetter;

formwork/src/Http/Request.php

@@ -513,6 +513,8 @@ protected function getForwardedDirective(string $name): array
     /**
      * Prepare data keys by decoding URL-encoded characters
      *
+     * @since 2.2.0
+     *
      * @param array<mixed> $data
      *
      * @return array<mixed>