Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Please take a look at our prerequisites before upgrading!
To update to the latest version inside of your composer.json file make sure to update the version of Voyager inside the require declaration inside of your composer.json to:
tcg/voyager": "1.3.*
And then run composer update
The VoyagerAuth
singleton was introduced in Voyager 1.2 and returned an instance of the guard.
In Voyager 1.3 this singleton was renamed to VoyagerGuard
and now returns the name of the guard as a string. Read more on custom guards here
The voyager.php
configuration file had a few changes.
was removed. The user-model which will be used in the voyager:admin
command is now determined based on the guard.
Be sure to ask us on our slack channel if you are experiencing any issues and we will try and assist. Thanks.
Voyager is super easy to install. After creating your new Laravel application you can include the Voyager package with the following command:
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:
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
If you prefer installing it with the dummy data run the following command:
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:
admin@admin.com
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:
If you wish to create a new admin user you can pass the --create
flag, like so:
And you will be prompted for the users name and password.
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:
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
.
The next step is to add Voyagers routes to your routes/web.php
file:
Now run
php artisan db:seed --class=VoyagerDatabaseSeeder
to seed some necessary data to your database,
php artisan hook:setup
to install the hooks system, and
php artisan storage:link
to create the storage symlink to your public folder.
After that, run composer dump-autoload
to finish your installation!
Before installing Voyager make sure you have installed one of the following versions of Laravel:
Laravel 5.5
Laravel 5.6
Laravel 5.7
Laravel 5.8
Laravel 6
Additionally Voyager requires you to use PHP 7.2 or newer.
Welcome to the Voyager documentation for version 1.3. This documentation will teach you how to install, configure, and use Voyager so that way you can create some kick ass stuff!
Hm Hm (cough)… I mean… Arrgg! Ye young scallywag! What say we learn how to steer this ship!
Before installing Voyager you may want to take a quick moment to learn what it is and what it isn't, we'll do that in the next section.