Quick Note. Laravel 5.5 just got released and we will be releasing Voyager 1.0 very soon, but in the meantime you can use Laravel 5.4 to install Voyager 0.11
Want to try out the latest version with Laravel 5.5? Be sure to use composer require tcg/voyager dev-master
Made with ❤️ by The Control Group
Website & Documentation: https://laravelvoyager.com
Video Demo Here: https://devdojo.com/series/laravel-voyager-010/
Join our Slack chat: https://voyager-slack-invitation.herokuapp.com/
View the Voyager Cheat Sheet: https://voyager-cheatsheet.ulties.com/
Laravel Admin & BREAD System (Browse, Read, Edit, Add, & Delete), made for Laravel 5.3.
After creating your new Laravel application you can include the Voyager package with the following command:
composer require tcg/voyager
Next make sure to create a new database and add your database credentials to your .env file:
DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret
You will also want to update your website URL inside of the APP_URL
variable inside the .env file:
APP_URL=http://localhost:8000
Add the Voyager service provider to the config/app.php
file in the providers
array:
'providers' => [
// Laravel Framework Service Providers...
//...
// Package Service Providers
TCG\Voyager\VoyagerServiceProvider::class,
// ...
// Application Service Providers
// ...
],
Lastly, we can install voyager. You can do this either with or without dummy data. The dummy data will include 1 admin account (if no users already exists), 1 demo page, 4 demo posts, 2 categories and 7 settings.
To install Voyager without dummy simply run
php artisan voyager:install
If you prefer installing it with dummy run
php artisan voyager:install --with-dummy
Troubleshooting: Specified key was too long error. If you see this error message you have an outdated version of MySQL, use the following solution: https://laravel-news.com/laravel-5-4-key-too-long-error
And we're all good to go!
Start up a local development server with php artisan serve
And, visit http://localhost:8000/admin.
If you did go ahead with the dummy data, a user should have been created for you with the following login credentials:
email:
admin@admin.com
password:password
NOTE: Please note that a dummy user is only created if there are no current users in your database.
If you did not go with the dummy user, you may wish to assign admin privileges to an existing user. This can easily be done by running this command:
php artisan voyager:admin your@email.com
If you did not install the dummy data and you wish to create a new admin user you can pass the --create
flag, like so:
php artisan voyager:admin your@email.com --create
And you will be prompted for the users name and password.