argon

by laravel-frontend-presets

laravel-frontend-presets /argon

Argon Frontend Preset For Laravel Framework 5.5 and Up

148 Stars 65 Forks Last release: 6 months ago (v1.1.0) MIT License 96 Commits 15 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Argon Frontend Preset For Laravel Framework 5.5 and Up

version license GitHub issues open GitHub issues closed

Current version: Argon v1.0.10. More info at https://www.creative-tim.com/product/argon-dashboard-laravel.

Product Image

Note

We recommend installing this preset on a project that you are starting from scratch, otherwise your project's design might break.

Prerequisites

If you don't already have an Apache local environment with PHP and MySQL, use one of the following links:

  • Windows: https://updivision.com/blog/post/beginner-s-guide-to-setting-up-your-local-development-environment-on-windows
  • Linux: https://howtoubuntu.org/how-to-install-lamp-on-ubuntu
  • Mac: https://wpshout.com/quick-guides/how-to-install-mamp-on-your-mac/

Also, you will need to install Composer: https://getcomposer.org/doc/00-intro.md
And Laravel: https://laravel.com/docs/7.x/installation

Installation

After initializing a fresh instance of Laravel (and making all the necessary configurations), install the preset using one of the provided methods:

Via composer

  1. Cd
    to your Laravel app
  2. Type in your terminal:
    composer require laravel/ui
    and
    php artisan ui vue --auth
  3. Install this preset via
    composer require laravel-frontend-presets/argon
    . No need to register the service provider. Laravel 5.5 & up can auto detect the package.
  4. Run
    php artisan ui argon
    command to install the Argon preset. This will install all the necessary assets and also the custom auth views, it will also add the auth route in
    routes/web.php
    (NOTE: If you run this command several times, be sure to clean up the duplicate Auth entries in routes/web.php)
  5. In your terminal run
    composer dump-autoload
  6. Run
    php artisan migrate --seed
    to create basic users table

By using the archive

  1. In your application's root create a presets folder
  2. Download an archive of the repo and unzip it
  3. Copy and paste argon-master folder in presets (created in step 2) and rename it to argon
  4. Open
    composer.json
    file
  5. Add
    "LaravelFrontendPresets\\ArgonPreset\\": "presets/argon/src"
    to
    autoload/psr-4
    and to
    autoload-dev/psr-4
  6. Add
    LaravelFrontendPresets\ArgonPreset\ArgonPresetServiceProvider::class
    to
    config/app.php
    file
  7. Type in your terminal:
    composer require laravel/ui
    and
    php artisan ui vue --auth
  8. In your terminal run
    composer dump-autoload
  9. Run
    php artisan ui argon
    command to install the Argon preset. This will install all the necessary assets and also the custom auth views, it will also add the auth route in
    routes/web.php
    (NOTE: If you run this command several times, be sure to clean up the duplicate Auth entries in routes/web.php)
  10. Run
    php artisan migrate --seed
    to create basic users table

Usage

Register a user or login using [email protected] and secret and start testing the preset (make sure to run the migrations and seeders for these credentials to be available).

Besides the dashboard and the auth pages this preset also has an edit profile page. All the necessary files (controllers, requests, views) are installed out of the box and all the needed routes are added to

routes/web.php
. Keep in mind that all of the features can be viewed once you login using the credentials provided above or by registering your own user.

Dashboard

You can access the dashboard either by using the "Dashboard" link in the left sidebar or by adding /home in the url.

Profile edit

You have the option to edit the current logged in user's profile (change name, email and password). To access this page just click the "User profile" link in the left sidebar or by adding /profile in the url.

The

App\Http\Controllers\ProfileController
handles the update of the user information.
public function update(ProfileRequest $request)
{
    auth()->user()->update($request->all());

return back()->withStatus(__('Profile successfully updated.'));

}

Also you shouldn't worry about entering wrong data in the inputs when editing the profile, validation rules were added to prevent this (see

App\Http\Requests\ProfileRequest
). If you try to change the password you will see that other validation rules were added in
App\Http\Requests\PasswordRequest
. Notice that in this file you have a custom validation rule that can be found in
App\Rules\CurrentPasswordCheckRule
.
public function rules()
{
    return [
        'old_password' => ['required', 'min:6', new CurrentPasswordCheckRule],
        'password' => ['required', 'min:6', 'confirmed', 'different:old_password'],
        'password_confirmation' => ['required', 'min:6'],
    ];
}

Change log

Please see the changelog for more information on what has changed recently.

Credits

License

MIT License.

Screen shots

Argon Login

Argon Dashboard

Argon Users

Argon Profile

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.