Upgrade Guide
The upgrading process is almost identical for all our packages; I'll list all the significant changes. If you found any missing information or had a bug, please open an issue in the corresponding repository for your package.
Preparation
Upgrade Filament
First, update your filament app; after the upgrade, all Zeus packages won't be active by default, so it's an excellent opportunity to check and ensure that your app works perfectly after the upgrade.
Upgrade Other Plugins
Ensure all other plugins in your app are updated for v3; check their versions and update them.
Livewire Model Binding
Enable livewire model binding in the livewire config:
'legacy_model_binding' => true,
Registering The Plugins
All Zeus plugins depend on other plugins, and you must register them all.
Supported Plugins
1->plugins([ 2 // ... 3 SpatieLaravelTranslatablePlugin::make() 4 //If you don't use multi-language 5 ->defaultLocales([config('app.locale')]) 6 // or if you have more 7 ->defaultLocales(['en', 'es']), 8 9 // required for 'Sky' and 'dynamic dashboard' only10 FilamentNavigation::make(),11])
Zeus Plugins
Now you can register Zeus plugins as needed.
1->plugins([2 // ...3 WindPlugin::make(),4 SkyPlugin::make(),5 BoltPlugin::make(),6 RainPlugin::make(),7])
Theme and Assets
Custom Classes:
You need to add these files to your tailwind.config.js
file in the content
section.
-
Core
- frontend:
-
./vendor/lara-zeus/core/resources/views/**/*.blade.php
-
- frontend:
-
Wind
- filament:
-
./vendor/lara-zeus/wind/resources/views/filament/**/*.blade.php
-
./vendor/lara-zeus/wind/src/Filament/Resources/LetterResource.php
-
- frontend:
-
./vendor/lara-zeus/wind/resources/views/themes/**/*.blade.php
-
- filament:
-
Sky
- filament:
-
./vendor/lara-zeus/wind/resources/views/filament/**/*.blade.php
-
./vendor/lara-zeus/sky/src/Models/PostStatus.php
-
- frontend:
-
./vendor/lara-zeus/wind/resources/views/themes/**/*.blade.php
-
./vendor/lara-zeus/sky/src/Models/PostStatus.php
-
- filament:
-
Bolt
- filament:
-
./vendor/lara-zeus/bolt/resources/views/filament/**/*.blade.php
-
- frontend:
-
./vendor/lara-zeus/bolt/resources/views/themes/**/*.blade.php
-
- filament:
-
Thunder
- filament:
-
./vendor/lara-zeus/bolt/resources/views/filament/**/*.blade.php
-
- frontend:
-
./vendor/lara-zeus/bolt/resources/views/themes/**/*.blade.php
-
./vendor/lara-zeus/thunder/src/Models/TicketsStatus.php
-
- filament:
-
Rain
- filament:
-
./vendor/lara-zeus/rain/resources/views/filament/**/*.blade.php
-
- frontend:
-
./vendor/lara-zeus/rain/resources/views/themes/**/*.blade.php
-
./vendor/lara-zeus/rain/src/Models/Columns.php
-
- filament:
-
Artemis
- frontend:
-
./vendor/lara-zeus/artemis/resources/views/**/*.blade.php
-
- frontend:
Frontend Views
You must publish the missing new blade files if you publish the frontend views. Also, worth checking your published views and comparing them with the new ones; a lot has stayed the same but minor improvements.
Migrate The Configurations
With the new filament structures, no more config files.
All the configurations can be set by your panel provider. You need to check the Configuration.php
class for each package.
now, you can delete all old config files
Publish The Migration
To make sure you have all migration, republish them by:
1php artisan migrate