Upgrade Between Versions
1.1 -> 1.2
This release doesn't contain breaking changes.
To upgrade the libraries to v1.2 run:
composer require --update-with-dependencies vanilo/framework '~1.2'
1.0 -> 1.1
This release doesn't contain breaking changes.
To upgrade the libraries to v1.1 run:
composer require --update-with-dependencies vanilo/framework '~1.1'
0.5 -> 1.0
This release doesn't contain breaking changes.
To upgrade the libraries to v1.0 run:
composer require --update-with-dependencies vanilo/framework 1.0
New Migrations
There are some new migrations, run them:
php artisan migrate
0.4 -> 0.5
This release drops PHP 7.0 support, minimum requirement is PHP 7.1.3.
To upgrade the libraries to v0.5 run:
composer require --update-with-dependencies vanilo/framework 0.5
New Migrations
There are some new migrations, run them:
php artisan migrate
That's all.
0.3 -> 0.4
To upgrade the libraries to v0.4 run:
composer require --update-with-dependencies vanilo/framework 0.4
New Migrations
There are some new migrations, run them:
php artisan migrate
Frontend Assets
The Admin of the new version is built on top of AppShell v1.2.
The Laravel mix (webpack) compilation has slightly changed.
Update webpack.mix.js
so that it look something like this:
mix.js('resources/js/app.js', 'public/js') // <- default js, comes with Laravel. /!\ `resources/assets/js` with Laravel < 5.7
// These 2 lines are for Vanilo Admin (AppShell):
.js('vendor/konekt/appshell/src/resources/assets/js/appshell.standalone.js', 'public/js/appshell.js')
.sass('vendor/konekt/appshell/src/resources/assets/sass/appshell.sass', 'public/css')
// default css, comes with Laravel: /!\ `resources/assets/js` with Laravel < 5.7
.sass('resources/sass/app.scss', 'public/css');
It's recommended to use Laravel Mix v2:
In package.json
:
{
"laravel-mix": "^2.0"
}
Run these commands to install new dependencies and compile the assets:
yarn install
yarn run dev
0.2 -> 0.3
Minimum Versions
If using the Vanilo Framework, then the minimum versions are:
- Laravel 5.5
- PHP 7.1.3
- GD Extension is required for product images
Minimal requirements for components (without Framework):
- Laravel 5.4
- PHP 7.0
New Buyable Methods
The Buyable
contract has 3 new methods, thus if any of your models implements Buyable
, you also
have to implement them:
-
hasImage()
-
getThumbnailUrl()
-
getImageUrl()
The support package offers default implementations for the new, image related methods:
-
BuyableNoImage
: "Null image" trait for products that don't actually have images. -
BuyableImageSpatieV7
: Adapter for using images with Spatie's Laravel Media Library V7.
BaseRequest Moved From AppShell To Concord
If you used the Konekt\AppShell\Contracts\Requests\BaseRequest
in your application, then you need
to use Konekt\Concord\Contracts\BaseRequest
instead.
As of AppShell v0.9.7 the interface has been moved to Concord v1.1.
Migrations
There are some, run them:
php artisan migrate
Storage Link Required
For product image support, your application should have a storage link.
To create the symbolic link, you may use the storage:link Artisan command:
php artisan storage:link
Rebuild The Assets When Using The Admin
If you're using Vanilo's Admin, then rebuild your assets (eg. yarn run dev
) to catch up with the updated look&feel.