Upgrade Guide

Upgrade to 5.1

Override folder app, platform from the update source code.
Override file composer.json and composer.lock from the update source code.
Run composer install to install vendor packages
Run php artisan migrate to update database.
Remove folder public/vendor/core and run command php artisan vendor:publish --tag=cms-public --force

Override folder app, platform from the update source code.
Override file composer.json and composer.lock from the update source code.
Run composer install to install vendor packages
Run php artisan migrate to update database.
Remove folder public/vendor/core and run command php artisan vendor:publish --tag=cms-public --force

Override folder app, platform from the update source code.
Override file composer.json and composer.lock from the update source code.
Run composer install to install vendor packages
Run php artisan migrate to update database.
Remove folder public/vendor/core and run command php artisan vendor:publish --tag=cms-public --force
Remove all function setModuleName() in your plugins (if you have).

Ex:

\RvMedia::addSize('featured', 560, 380);

Run composer install to install vendor packages
Run php artisan migrate to update database.
Remove folder public/vendor/core and run command php artisan vendor:publish --tag=cms-public --force

Copy your themes and plugins to new source code (v4.0)
Run composer install to install vendor packages
Run php artisan migrate to update database.
Change in .env: FILESYSTEM_DRIVER=public
Remove /storage from image URL in your database. Ex: change /storage/uploads/abc.jpg to uploads/abc.jpg

Update helper functions: Ex:


// Before
function get_meta_data($object->id, $key, $screen, $single = false, $select = ['meta_value'])

// Now function get_meta_data($object, $key, $single = false, $select = ['meta_value'])


- Add setupModel method into your plugin forms. Ex: platform/plugins/blog/src/Forms/PostForm.php:54
```php
$this->setupModel(new Post);

Change screen's name to model class name in some functions: https://prnt.sc/pqyaiz
Language::registerModule({PLUGIN}_MODULE_SCREEN_NAME); to Language::registerModule(\Botble\{Plugin}\Models\{Plugin}::class)
SeoHelper::registerModule({PLUGIN}_MODULE_SCREEN_NAME); to SeoHelper::registerModule(\Botble\{Plugin}\Models\{Plugin}::class)

Change

config([
'packages.slug.general.supported' => array_merge(config('packages.slug.general.supported'), [{PLUGIN}_MODULE_SCREEN_NAME]),
]);

SlugHelper::registerModule(\Botble\{Plugin}\Models\{Plugin}::class);

Update your plugin's tables:
Change apply_filters(BASE_FILTER_GET_LIST_DATA, $data, {PLUGIN}_MODULE_SCREEN_NAME) to apply_filters(BASE_FILTER_GET_LIST_DATA, $data, $this->repository->getModel())

Change

$this->applyScopes(apply_filters(BASE_FILTER_TABLE_QUERY, $query, $model, {PLUGIN}_MODULE_SCREEN_NAME));

$this->applyScopes(apply_filters(BASE_FILTER_TABLE_QUERY, $query, $model));

Change

apply_filters(BASE_FILTER_TABLE_BUTTONS, $buttons, {PLUGIN}_MODULE_SCREEN_NAME);

apply_filters(BASE_FILTER_TABLE_BUTTONS, $buttons, Post::class);

Update in your plugin's controllers, remove screen name from BeforeEditContentEvent: Change

event(new BeforeEditContentEvent({PLUGIN}_MODULE_SCREEN_NAME, $request, $data));

event(new BeforeEditContentEvent($request, $data));

Override folder platform from the update source code.
Run composer update to update vendor packages.
Remove folder public/vendor/core and run command php artisan vendor:publish --tag=cms-public --force

Override folder platform from the update source code.
Update your composer.json with the latest composer.json or update changes from latest version http://prntscr.com/ohvwfw.
Run composer update to update vendor packages.
Run php artisan migrate to update database.
Replace all public.index to public.single.
Remove folder public/vendor/core and run command php artisan vendor:publish --tag=cms-public --force
We've changed method of "delete" button from GET to DELETE (http://prntscr.com/ohvrw0) so if you have custom plugins, you need to change all of it to DELETE in your plugin /routes/web.php

Route::get('delete/{id}', ...

Route::delete('delete/{id}', ...

And,

Route::post('delete-many', ...

Route::delete('delete-many', ...

Override folder platform from the update source code.
Remove folder public/vendor/core and run command php artisan vendor:publish --tag=cms-public --force
Run composer install to update vendor packages.
Run php artisan migrate to update database.
Change the value for status column from publish to published.

You need to copy your changes to new source code.
From this version, all core modules, plugins and themes are located in /platform folder.
- If you've created your plugins, you need to copy it into /platform/plugins folder.
- If you've created your themes, you need to copy it into /platform/themes folder and run command php artisan cms:theme:assets:publish your-theme to copy theme's assets to public/themes/your-theme
Run composer install and php artisan migrate
Run command php artisan storage:link

This is big version. It has many change on core system so the easiest way to upgrade to new version is copy what your changes (your themes, plugins, translations) to new source code.

Replace 2 files core/base/resources/views/layouts/master.blade.php & core/table/src/Abstracts/TableAbstract.php

Run composer install to update vendor packages.
Run php artisan migrate to update database.
Deprecated classes: Botble\Base\Tables\TableAbstract & Botble\Base\Tables\TableBuilder will be removed in the next version, please change to use Botble\Table\Abstracts\TableAbstract & Botble\Table\TableBuilder

{warning} Old custom plugins which you built with v1.1 will not work on v2.0.