laraveladminpanel/admin

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

Laravel Admin Panel

forked from the-control-group/voyager, _(*1)

Made with ❤️, _(*2)

• Demo: https://demo.laraveladminpanel.com
• Documentation: https://laravel-admin-panel.readme.io/docs

Laravel Admin & CRUD System (Browse, Read, Edit, Add, & Delete), supporting Laravel 5.4 and newer!, _(*3)

Installation Steps

1. Require the Package

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

composer require laraveladminpanel/admin

2. Add the DB Credentials & APP_URL

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

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

APP_URL=http://localhost:8000

Only if you are on Laravel 5.4 will you need to Add the Service Provider., _(*7)

3. Run The Installer

Lastly, we can install admin. 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., _(*8)

To install Admin Panel without dummy simply run, _(*9)

php artisan admin:install

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

php artisan admin: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, _(*11)

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

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

Creating an Admin User

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

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

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

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

php artisan admin: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:, _(*18)

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

And you will be prompted for the user's name and password., _(*19)

For phpunit, you need to run these commands in the root folder of the site:, _(*20)

composer require orchestra/database ^3.5 --dev
composer require orchestra/testbench-browser-kit ^3.5 --dev

And add line "LaravelAdminPanel\Tests\": "vendor/laraveladminpanel/admin/tests/" in a composer.json, _(*21)

"autoload-dev": {
    "psr-4": {
        "Tests\\": "tests/",
        "LaravelAdminPanel\\Tests\\": "vendor/laraveladminpanel/admin/tests/"
    }
},

And finally run this command:, _(*22)

composer dump-autoload