/filament-profile

A simple profile management page for Filament. ✨

Primary LanguagePHPMIT LicenseMIT

A simple profile page for Filament.

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

This package provides a very simple Profile page that allows the current user to manage their name, email address and password inside of Filament.

Screenshot of Page

Installation

You can install the package via Composer:

composer require ryangjchandler/filament-profile

Optionally, you can publish the views using

php artisan vendor:publish --tag="filament-profile-views"

Usage

This package will automatically register the Profile page as a Livewire component, but won't automatically add it to Filament. You should add the following line of code to your AppServiceProvider::register() method.

Filament::registerPages([
    \RyanChandler\FilamentProfile\Pages\Profile::class;
]);

If you visit your Filament panel now, you'll see a new Account navigation group as well as a Profile page.

Customising the Profile page

Since the package does not automatically add the Profile page to your Filament panel, you are free to extend the page and customise it yourself.

You should first run the following command in your terminal:

php artisan filament:page Profile

This will create a new App\Filament\Pages\Profile class in your project.

You can then update this class to extend the RyanChandler\FilamentProfile\Pages\Profile class.

namespace App\Filament\Pages;

use RyanChandler\FilamentProfile\Pages\Profile as BaseProfile;

class Profile extends BaseProfile
{
    // ...
}

Filament will automatically register your new Profile page and you're able to customise it to your liking. You can remove the navigation group, modify the form, etc.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.