Upgrading

  1. Update composer.json to the version you want (or leave a ^ in the version...)
  2. Run enso composer update --with-dependencies yadda/enso-core
  3. Follow any relevant notes below (from bottom to top)

Publishing Assets

You will probably need to publish Enso JS, CSS, webpack.mix.js etc.

# Publish ALL files (won't overwrite existing files)
enso artisan vendor:publish

# Force re-publish only css and js files
enso artisan vendor:publish --force --tag=assets
Warning!
You probably don't want to use --force without also using --tag=assets!

Upgrade notes

v0.2.x -> v1.0.0

Update dependencies

Update your laravel/framework dependecy in composer.json to 5.8.*,

Update your yadda/enso-core dependency in composer.json to ^1.0.0.

Add yadda/enso-utilities ^1.0.0 to composer.json.

Set your PHP version in composer.json:

"config": {
    "preferred-install": "dist",
    "sort-packages": true,
    "platform": {
        "php": "7.3.0"
    }
},

Run enso composer update.

You should now be able to remove the platform from composer.json.

Publish Files

You should republish assets

enso artisan vendor:publish --force --tag assets

You can republish javascript/scss files that are usually installed when Enso is first installed. These may have been overidden in your project, so do this with care.

enso artisan vendor:publish --force --tag first-time

You can republish webpack.mix.js. Again, this will overwrite any changes you have made to webpack.mix.js! You will at least need to remove references to resources/assets.

enso artisan vendor:publish --force --tag buildfiles
Run through Laravel update documentation

Discover Packages

enso artisan package:discover

kebab_case() and getConcreteClass() Helpers

The kebab_case() helper has been removed from enso-utilities. Use Str::kebab() instead.

The getConcreteClass() helper is now a static method of the Yadda\Enso\Utilities\Helpers class.

Analytics Removed

If you are using the Analytics pages in the Enso backend (not to be confused the the GA/GTM settings and templates) then you will need to install Spaties laravel-analytics package.

enso composer require spatie/laravel-analytics

You will need to manually add the EnsoAnalyticsServiceProvider to config/app.php.

'providers' => [
    // ...
    Yadda\Enso\EnsoAnalyticsServiceProvider::class,
]

Money Field removed

If you are using the MoneyField you will need to add moneyphp/money.

enso composer require moneyphp/money