Skip to content
🌱 Official Laravel Liana for Forest
Branch: devel
Clone or download
Latest commit 2c65671 Aug 30, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
config [-] Technical - Use the "official" domain for the default server host Jul 3, 2018
src [-] Records Deletion - Delete a record which has already been deleted… Aug 24, 2018
.gitignore [+] Add the Licence Jan 11, 2018
CHANGELOG.md Release 0.5.1 Aug 30, 2018
LICENCE [+] Add the Licence Jan 11, 2018
README.md [-] Readme - Add some documentation about configuration cache (#69) Apr 27, 2018
composer.json
gulpfile.js [*] Build - Fix the build script Jan 11, 2018
package.json
yarn.lock [*] Build - Fix the yarn.lock Jan 11, 2018

README.md

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.

Installation

Visit Forest's website, enter your email and click "Get started". You will then follow a 4-step process:

  1. Choose your stack (Laravel)
  2. Install Forest Liana
composer require forestadmin/forest-laravel

 Next, if you're using Laravel 5.4 or below, add the service provider to config/app.php

ForestAdmin\ForestLaravel\ForestServiceProvider::class,

Still in the console, enter this command to install the config file in the config/ directory.

php artisan vendor:publish

Generate a secret key for your application on http://forestadmin.com, and configure the 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
  1. Get your app running, provide your application URL and check if you have successfully installed Forest Liana on your app.
  2. 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 support@forestadmin.com

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:

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit a Pull request so that we can review your changes

Licence

GPL v3

You can’t perform that action at this time.