Material Dashboard 2 Laravel

The project follows the standard Laravel directory structure, with specific locations for dashboard components and views. Key directories include:

• app/Http/Controllers: Contains logic for DashboardController, ProfileController, SessionsController, and RegisterController.
• app/Models: Contains the User model.
• resources/views/components: Contains reusable Blade components such as layout.blade.php, plugins.blade.php, footers/, and navbars/.
• resources/views/pages: Contains various pre-built dashboard pages like billing.blade.php, notifications.blade.php, profile.blade.php, tables.blade.php, and virtual-reality.blade.php.
• resources/views/dashboard: Contains the main index.blade.php for the dashboard.
• resources/views/errors: Contains Blade templates for standard HTTP error codes (401, 403, 404, 419, 500, etc.).

If you encounter bugs, use GitHub Issues as the official tracker. To ensure a faster resolution, follow these guidelines:

1. Verify Version: Ensure you are using the latest version of the Material Dashboard by checking the CHANGELOG on the Creative Tim website.
2. Reproduce: Provide clear, reproducible steps to trigger the issue.
3. Browser Context: Specify which browser you are using, as some issues may be browser-specific.

The Material Dashboard preset extends the laravel/ui package by adding a custom material command to the ui CLI tool. You can trigger the installation of the Material Dashboard scaffolding by running the ui material command in your terminal. This will execute the MaterialPreset::install() process and output a success message upon completion.

php artisan ui material

New users can register via the /sign-up route. The App/Http/Controllers/RegisterController.php handles the creation of the user account. It validates the name, email, and password, creates the user, logs them in, and redirects them to /dashboard.

// Example: Registration logic in App/Http/Controllers/RegisterController.php
public function store(){
    $attributes = request()->validate([
        'name' => 'required|max:255|unique:users,name',
        'email' => 'required|email|max:255|unique:users,email',
        'password' => 'required|min:5|max:255',
    ]);

    $user = User::create($attributes);
    auth()->login($user);
    
    return redirect('/dashboard');
} 

Logged-in users can manage their profile at the /user-profile URL. The App/Http/Controllers/ProfileController.php handles updates to the following fields:

• email (must be unique, excluding current user)
• name
• phone (max 10 characters)
• about (max 150 characters)
• location

// Example: Profile update logic in App/Http/Controllers/ProfileController.php
public function update()
{
    $user = request()->user();
    $attributes = request()->validate([
        'email' => 'required|email|unique:users,email,'.$user->id,
        'name' => 'required',
        'phone' => 'required|max:10',
        'about' => 'required:max:150',
        'location' => 'required'
    ]);
    auth()->user()->update($attributes);
    return back()->withStatus('Profile successfully updated.');
}

Once the installation is complete and migrations/seeders have been run, you can access the dashboard using the following default credentials:

• Email: admin@material.com
• Password: secret

Access the dashboard at the /dashboard URL.

The project officially aims to support the last two versions of the following browsers:

• Chrome
• Firefox
• Edge
• Safari
• Opera

The User model includes a setPasswordAttribute mutator. This means when you assign a value to the password attribute, it is automatically hashed using bcrypt(). You do not need to manually hash the password before saving it to the model.

// When you do this:
$user->password = 'my-secret-password';
$user->save();

// The model automatically executes:
// $this->attributes['password'] = bcrypt('my-secret-password');