Forest Laravel Liana
The official Laravel liana for Forest. Forest is a modern admin interface (see the live demo) that works on all major web frameworks. forestadmin/forest-laravel is the package that makes Forest admin work on any Laravel application.
Visit Forest's website, enter your email and click "Get started". You will then follow a 4-step process:
- Choose your stack (Laravel)
- Install Forest Liana
composer require forestadmin/forest-laravel
Next, if you're using Laravel 5.4 or below, add the service provider to
Still in the console, enter this command to install the config file in the
php artisan vendor:publish
Generate a secret key for your application on http://forestadmin.com, and
config/forest.php file like this:
return [ 'secret_key' => 'YOUR-SUPER-SECRET-SECRET-KEY', // Insert the secret key provided by Forest 'auth_key' => 'YOUR-SUPER-SECRET-AUTH-KEY', // Choose a secret to secure your data access 'models_path' => 'app/models' // Specify the path of your Laravel models ];
You may use the laravel cache for configuration. In this case, you must re-generate it:
php artisan config:cache
Finally, you need to generate a mapping of your database schema and send it to http://forestadmin.com running the following command:
$ php artisan forest:send-apimap
- Get your app running, provide your application URL and check if you have successfully installed Forest Liana on your app.
- Choose your credentials, log into https://app.forestadmin.com and start customizing your admin interface!
NOTE: If you’re stuck, can’t get something working or need some help, feel free to contact the Forest team at firstname.lastname@example.org
How it works
Installing forestadmin/forest-laravel into your app will automatically generate an admin REST API for your app. This API allows the Forest admin UI to communicate with your app and operate on your data. Note that data from your app will never reach Forest's servers. Only your UI configuration is saved. As this package is open-source, you're free to extend the admin REST API for any operation specific to your app.
How to contribute
This liana is officially maintained by Forest. We're always happy to get contributions for other fellow lumberjacks. All contributions will be reviewed by Forest's team before being merged into master.
Here is the contribution workflow:
- Fork the repo on GitHub
- Clone the project to your own machine
- Commit changes to your own branch
- Push your work back up to your fork
- Submit a Pull request so that we can review your changes