Migration steps
This is the official documentation of the forestadmin/laravel-forestadmin v2+ and forestadmin/symfony-forestadmin PHP agents.
This section concerns the migration of a Laravel v1 agent to a Laravel v2 agent.
Step 1: ForestCollection
The ForestCollection trait does not exist anymore in the new agent. You should remove it from your code.
Steps 2: Install the new agent
Check the version installed in your composer.json file is ^2.0.0.
Step 3: Run the installation command
Don't remove your FOREST_AUTH_SECRET and FOREST_ENV_SECRET from your .env file. It will be used by the new agent. If you had published the previous configuration file config/forest.php in your application, you must delete it to use the new file published automatically by the command below.
Run the command install:
Step 4: Configuration
By default, the agent retrieves all models in your application's App namespace.
Step 5: Customization
Previously, when you wanted to customize a SmartAction, you had to set it in each model. Now, you need to set it in the config/forest_admin.php file. You have to remove your previous SmartActions and put them in the configuration file. More information is in the dedicated guide
Last updated