2.x

[Baspa]

Remaining tasks

• Check composer.json files
• Fix tests (workflows)
• Add tests
• Try to upgrade existing website from 0.x or 1.x to 2.x.
• @Baspa: clear up redundant code
• @Baspa: improve code quality in changed files (Uploadcare.php, ContentFieldValueObserver, etc.)
• @Baspa: write automated tests as described in Productive
• @Baspa: check for code that's purely for Uploadcare. This code should not be present in "core" and other packages.
• Check for todo's in code.

Release notes

What's changed

• Fields package now provides the hydrate method to allow you to transform raw values stores in the database into a runtime representation. Useful when you want to convert stored IDs into models, format dates or process JSON data into specific objects.
• Media package now provides an event to handle file uploads via custom providers (like Uploadcare) or to perform file processing before saving.
• Backstage Uploadcare Field now contains a "media grid picker" to pick already uploaded media files to prevent duplicate files in Uploadcare.
• All uploaded media files are now saved in the media table, including metadata in the media_relationships table. Here unique (meta)data for each content_field_value is stored.
• The media package now includes laravel-translations to set (and translate) alt text for each configured language.

Breaking changes

• Media ULIDs are now stored in the content_field_values table instead of the whole file objects. You can migrate existing Uploadcare data using php artisan vendor:publish --tag=backstage/uploadcare-field-migrations && migrate. When you want to get the meta of an "edit", you can access it like $media->edit.
• Relationships on Content model will now be returned as a Collection instead of an array.
• $item->field('image') will now return a Media model
• $images in blocks will now return a single Media model when not multiple. When multiple, it will return a collection instead of an array.
• The following PageComponent slots are replaced by stacks: headFirst > head-first, headLast > headLast, bodyFirst > body-first, bodyLast > body-last

Upgrade guide

Uploadcare

To upgrade when using Uploadcare, run:

composer update && php artisan vendor:publish --tag=backstage/uploadcare-field-migrations && migrate

Not using Uploadcare?

Simply run composer update.

[Casmo]

Ik heb:

• use Backstage\Fields\Contracts\HydratesValues; toegevoegd fields (alleen voor Text::class) nu.
• Deze hydrate() functie wordt nu aangeroepen bij $content->field('slug'); (indien het field deze implementeerd)
• Text::class wordt nu ook geregistreerd bij de FieldsServiceProvider

De hydrate() functie wordt ook gebruikt bij de Content Form voor het vullen van de values. Ik weet niet of we dat willen. Ik zou eigenlijk de hydrate() functie echt alleen gebruiken voor front(enders). Even onderzoeken nog.

Er moet nog hoop gedaan worden want de hydrate() functie wordt nu op meer plekken (dubbel) gebruikt. Kijken of we deze code uit cms kunnen halen en naar de specifieke fields kunnen toevoegen.