xiaokus/voyager

A Laravel Admin Package for The Control Group to make your life easier and steer your project in the right direction

, _(*1)

, _(*2)

Voyager - The Missing Laravel Admin

Made with ❤️ by The Control Group, _(*3)

, _(*4)

Website & Documentation: https://the-control-group.github.io/voyager/, _(*5)

Video Demo Here: https://devdojo.com/series/laravel-voyager-010/, _(*6)

Join our Slack chat: https://voyager-slack-invitation.herokuapp.com/, _(*7)

View the Voyager Cheat Sheet: https://voyager-cheatsheet.ulties.com/, _(*8)

Laravel Admin & BREAD System (Browse, Read, Edit, Add, & Delete), made for Laravel 5.3., _(*9)

After creating your new Laravel application you can include the Voyager package with the following command:, _(*10)

composer require tcg/voyager

Next make sure to create a new database and add your database credentials to your .env file:, _(*11)

DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

Add the Voyager service provider to the config/app.php file in the providers array:, _(*12)

'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., _(*13)

To install Voyager without dummy simply run, _(*14)

php artisan voyager:install

If you prefer installing it with dummy run, _(*15)

php artisan voyager:install --with-dummy

And we're all good to go!, _(*16)

Start up a local development server with php artisan serve And, visit http://localhost:8000/admin., _(*17)

However if your site have problems loading the avatar and other storage files, please ensure that you have set the APP_URL environment (including port)., _(*18)

If you did go ahead with the dummy data, a user should have been created for you with the following login credentials:, _(*19)

email: admin@admin.com
password: password, _(*20)

NOTE: Please note that a dummy user is only created if there are no current users in your database., _(*21)

If you did not go with the dummy user, you may wish to assign admin priveleges to an existing user. This can easily be done by running this command:, _(*22)

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:, _(*23)

php artisan voyager:admin your@email.com --create

And you will be prompted for the users name and password., _(*24)