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

v2.2.17

This update replaces the existing Amazon API library. If you are using the AmazonProductField, you will need to remove the existing one and add it's replacement:

  • enso composer remove exeu/apai-io
  • enso composer require thewirecutter/paapi5-php-sdk

You will also need to update the config file services.php to include the 'region' for each of the defined locales. See Documentation for details on the correct region for a given locale.

'locales' => [
    'co.uk' => [
        'associate_tag' => env('AMAZON_UK_ASSOCIATE_TAG', 'my-uk-associate-tag-123'),
        'region' => 'eu-west-1', // Add this line to each locale.
    ],

v2.2.11

This update adds the ability to login as another user. If you have overriden the the edit-actions template for users (views/vendor/enso-crud/users/lists/edit-actions.blade.php), you will need to add a corresponding button to it.

  <a href="{{ route('admin.users.login-as-user', $item->getKey()) }}" class="button is-info">Login as</a>

v2.2.10

This update introduces image lightness detection. You should add this option to config/enso/media.php:

    /**
     * Light/Dark area definitions. These should be arrays of 4 values:
     *  Top left pixel of area (x-axis)
     *  Top left pixel of area (y-axis)
     *  Width of area
     *  Height of area
     *
     * Bear in mind that the [0, 0] is in the top left corner.
     */
    'light_dark_areas' => [
        // 'full' => [0, 0, '100%', '100%'],
    ],

v2.2.5

Republish assets.

You can now store multiselect values as full objects rather than just objects when storing in flexible content. Just pass 'fullobject' as the second parameter when creating the field. E.g.:

(new MultiSelectField('things', 'fullobject'))
    ->useAjax(route('admin.things.index'), Thing::class),

v2.2.0

Memory limit is changed to 1G when resizing images. You will need to add the following to config/enso/media.php

'memory_limit' => env('ENSO_MEDIA_MEMORY_LIMIT', '1G'),

You can then override this by setting ENSO_MEDIA_MEMORY_LIMIT in your .env.

File upload size limit is now 5MB by default. If you need to upload larger files you can set this per-file-field by calling $field->setMaxFileSize($size_in_mb).

v2.1.0

background_color has been removed from Yadda\Enso\Media\Filters\Preset, Yadda\Enso\Media\Console\Commands\RegenerateImages as well as from the following methods on Yadda\Enso\Media\Models\ImageFile: makeResizes, makeResize, getResizeUrl. You should instead set background_color as the six parameter of your preset in config\enso\media.php.

v2.0.11

Make sure to republish assets

v2.0.8

The views enso-analytics::head and enso-analytics::body are now available. They cover gtag and gtm usage and will only work in production.

v2.0.7

You will need to republish

enso stop
# At this point udpate your .env DB_CONNECTION to "sqlite" and DB_DATABASE to ":memory:"
docker run --rm -i -v $(pwd):/opt -w /opt shippingdocker/php-composer:latest composer update --with-dependencies yadda/enso-core
docker run --rm -i -v $(pwd):/opt -v ~/.ssh:/root/.ssh -w /opt shippingdocker/php-composer:latest php artisan vendor:publish --tag=docker --force
# Revert .env changes
enso start

v2.0.6

  • If you are using the AmazonProductField, manually add the asinCheck route
Route::group(['middleware' => ['web', 'enso']], function () {
    Route::get('admin/amazon/asin-check', '\Yadda\Enso\Crud\Controllers\AmazonProductController@asinCheck');
});

v1.0.x -> v2.0.0

  • Update your laravel/framework dependecy in composer.json to ^6.0,
  • Update your yadda/enso-core and yadda/enso-utilities dependencies in composer.json to ^2.0.0.
  • Replace pion/laravel-chunk-upload with rpsimao/laravel-chunk-upload
  • Follow the Laravel upgrade guide
  • Carbon 2 is now a requirement instead of Carbon 1. You may need to update your code