filamerce/filament-user-profile

Simple filament user profile.

v1.1.1 2025-02-28 14:29 UTC

Requires

• php: ^8.2
• filament/filament: ^3.0.9
• illuminate/contracts: ^11.0|^12.0
• jenssegers/agent: ^2.6
• spatie/laravel-package-tools: ^1.14.0

Requires (Dev)

• larastan/larastan: ^2.0|^3.0
• laravel/pint: ^1.0
• laravel/sanctum: ^4.0
• orchestra/testbench: ^8.8|^9.0|^10.0
• pestphp/pest: ^2.20|^3.7
• pestphp/pest-plugin-arch: ^2.0|^v3.0.0
• pestphp/pest-plugin-laravel: ^2.0|^v3.1.0
• pestphp/pest-plugin-livewire: ^2.1|^v3.0.0

MIT

• webard

• user
• laravel
• profile
• filament

README

This package draws inspiration from Filament Breezy but does not include two-factor authentication (2FA) functionality.

Rather than offering multiple plugin options, this package provides a streamlined approach to extending and replacing components.

Installation

To install the package, execute the following command:

composer require filamerce/filament-user-panel

Register Plugin

To register the plugin, use the following code snippet:

use Filamerce\FilamentUserProfile\UserProfilePlugin;

$panel->plugins([
    UserProfilePlugin::make()
]);

Options

Register User Menu Item

Control whether the plugin should automatically register the user menu item:

UserProfilePlugin::make()
    ->registerUserMenu(false);

Custom Profile Page

Replace the entire ProfilePage with your custom component:

UserProfilePlugin::make()
    ->profilePage(MyProfileComponent::class);

Custom Profile Components

Manage the registered components and their order:

use Filamerce\FilamentUserProfile\Livewire\PersonalInfo;
use Filamerce\FilamentUserProfile\Livewire\UpdatePassword;

UserProfilePlugin::make()
    ->profileComponents([
        'personal_info' => PersonalInfo::class,
        'update_password' => UpdatePassword::class,
    ]);

Replace Profile Component

Replace a specific profile component:

use My\Component\PersonalInfo;

UserProfilePlugin::make()
    ->replaceProfileComponent('personal_info', PersonalInfo::class);

Register New Profile Component

Register a new profile component:

use My\Component\SomeComponent;

UserProfilePlugin::make()
    ->registerProfileComponent('some_component', SomeComponent::class);

Remove Profile Component

Remove a specific profile component:

use My\Component\SomeComponent;

UserProfilePlugin::make()
    ->removeProfileComponent('personal_info');

Laravel Sanctum

Laravel Sanctum is automatically detected, and a component to manage Sanctum tokens is displayed in the profile. Control the available abilities with the following code:

UserProfilePlugin::make()
    ->sanctumAbilities(['read', 'write']);

By default, all tokens are registered with all abilities ([*]).

Two-Factor Authentication

This package is compatible with stephenjude/filament-two-factor-authentication. Simply register the component as shown below:

UserProfilePlugin::make()
    ->registerProfileComponent('2fa', \Stephenjude\FilamentTwoFactorAuthentication\Livewire\TwoFactorAuthentication::class)