Overview
Please don’t upgrade multiple versions at once (eg. from v4 to v6). Please upgrade one step at a time.
Changes
High: Blueprints work differently
You can now manage blueprints directly from the Control Panel, gone are the days of managing huge arrays or copying YAML from collection blueprints. 🚀 As part of this, blueprints will now live as YAML files in theresources/blueprints/vendor/runway
directory.
During the update process, you will have moved your blueprints to their new location. You can now remove the blueprint
key from your resource configs in config/runway.php
and delete any old blueprint files.
Medium: Augmentation
Runway v6 changes the way augmentation works behind the scenes, to bring it more inline with how Statamic itself handles augmentation.Relationships
Previously, all Eloquent relationships from your model were available in your Antlers templates, even without associated Has Many or Belongs To fields. However, with v6, only relationships with Has Many or Belongs To fields in the blueprint will be output by augmentation.Changes to the methods used to augment models
If you are manually calling Runway’s augmentation methods, you should refactor them to instead call thetoAugmentedArray
method on your Eloquent model:
Value
objects, rather than just the augmented value.
Medium: Has Many Fieldtype - Table Mode removed
Runway previously included a special “Table” mode for the Has Many fieldtype. However, the Table mode has been removed to help reduce complexity of Runway’s fieldtypes. If you were using the Table mode on any of your Has Many fields, you should switch themode
to default
.
Don’t know if you’re using the Table mode? You can find out by searching these terms in your code editor of choice:
mode: table
'mode' => 'table'
You may also view a diff of changes between v5.x and v6.0