1.5
Core concepts
Customization
Troubleshooting
Installation
Voyager is super easy to install. After creating your new Laravel application you can include the Voyager package with the following command:
1
composer require tcg/voyager
Copied!
Next make sure to create a new database and add your database credentials to your .env file, you will also want to add your application URL in the
APP_URL variable:1
APP_URL=http://localhost
2
DB_HOST=localhost
3
DB_DATABASE=homestead
4
DB_USERNAME=homestead
5
DB_PASSWORD=secret
Copied!
Finally, we can install Voyager. You can choose to install Voyager with dummy data or without the dummy data. The dummy data will include 1 admin account (if no users already exist), 1 demo page, 4 demo posts, 2 categories and 7 settings.
To install Voyager without dummy data simply run
1
php artisan voyager:install
Copied!
If you prefer installing it with the dummy data run the following command:
1
php artisan voyager:install --with-dummy
Copied!
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 the URL http://localhost:8000/admin in your browser.If you installed with the dummy data, a user has been created for you with the following login credentials:
email:[email protected]password:password
Quick note
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:
1
php artisan voyager:admin [email protected]
Copied!
If you wish to create a new admin user you can pass the
--create flag, like so:1
php artisan voyager:admin [email protected] --create
Copied!
And you will be prompted for the users name and password.
Advanced
This section is meant for users who are installing Voyager on an already existing Laravel installation or for users who want to perform a manual install. If this is not the case, you should go back to the installation documentation or skip this section.
The first thing you should do is publish the assets that come with Voyager. You can do that by running the following commands:
1
php artisan vendor:publish --provider="TCG\Voyager\VoyagerServiceProvider"
2
php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravelRecent"
Copied!
Next, call
php artisan migrate to migrate all Voyager table.If you want to change migrations, for example to use a different table for users, don't migrate. Instead copy Voyagers migrations to
database/migrations, make your changes, turn off the config option database.autoload_migrations and then migrate.Now, open your User-Model (usually
app/User.php) and make the class extend \TCG\Voyager\Models\User instead of Authenticatable.1
<?php
2
​
3
class User extends \TCG\Voyager\Models\User
4
{
5
// ...
6
}
Copied!
The next step is to add Voyagers routes to your
routes/web.php file:1
<?php
2
​
3
Route::group(['prefix' => 'admin'], function () {
4
Voyager::routes();
5
});
Copied!
Now run
php artisan db:seed --class=VoyagerDatabaseSeeder
to seed some necessary data to your database, and
php artisan storage:link
to create the storage symlink to your public folder.After that, run
composer dump-autoload to finish your installation!Last modified 6mo ago
Export as PDF
Copy link
Contents
Advanced