Filament Edit Profile Plugin

The plugin integrates with Filament's native MFA system.

Required Setup: You must first configure MFA in your Filament panel following the Official Filament MFA Documentation. This typically requires running migrations and adding the TwoFactorAuthenticatable trait to your User model.

Controlling Visibility: By default, the MFA section is visible if the setup is complete. You can control this using shouldShowMultiFactorAuthentication() in your Panel Provider:

• Conditional visibility: Pass a Closure returning a boolean.
• Disable completely: Pass false.
• Default behavior: If the method is not called, it defaults to true (visible).

->plugins([
    FilamentEditProfilePlugin::make()
        ->shouldShowMultiFactorAuthentication(
            fn() => auth()->user()->id === 1, // optional
            // OR
            false // optional
        )
 ])

To enable profile photo management, follow these steps:

1. Migration: Publish and run the avatar migration: php artisan vendor:publish --tag="filament-edit-profile-avatar-migration" followed by php artisan migrate.
2. Model: Add avatar_url to your User model's $fillable array.
3. Contract: Implement Filament\Models\Contracts\HasAvatar in your User model and define getFilamentAvatarUrl():

   public function getFilamentAvatarUrl(): ?string
   {
       $avatarColumn = config('filament-edit-profile.avatar_column', 'avatar_url');
       return $this->$avatarColumn ? Storage::url($this->$avatarColumn) : null;
   }

4. Plugin Configuration: Enable the form in the plugin setup:

   ->shouldShowAvatarForm(
       value: true,
       directory: 'avatars',
       rules: 'mimes:jpeg,png|max:1024'
   )

5. Storage: Run php artisan storage:link.

use Filament\Models\Contracts\HasAvatar;
use Illuminate\Support\Facades\Storage;

class User extends Authenticatable implements HasAvatar
{
    public function getFilamentAvatarUrl(): ?string
    {
        $avatarColumn = config('filament-edit-profile.avatar_column', 'avatar_url');
        return $this->$avatarColumn ? Storage::url($this->$avatarColumn) : null;
    }
}

The plugin can list active browser sessions for the user.

Requirements:

1. Session Driver: Your SESSION_DRIVER must be set to database in your .env file to list individual sessions. If using any other driver, only the "Log Out Other Browser Sessions" action will be visible.
2. Middleware: To ensure the "Log Out Other Sessions" action works, you must register the Illuminate\Session\Middleware\AuthenticateSession middleware in your Filament panel.

Configuration: Use shouldShowBrowserSessionsForm() to enable or disable this feature via a Closure or Boolean.

SESSION_DRIVER=database

use Illuminate\Session\Middleware\AuthenticateSession;

$panel->authMiddleware([
    AuthenticateSession::class,
]);

// In your plugin registration:
->plugins([
    FilamentEditProfilePlugin::make()
        ->shouldShowBrowserSessionsForm(
            fn() => auth()->user()->id === 1, // optional
            // OR
            false // optional
        )
])

You can extend the profile form with custom fields stored in a JSON custom_fields column on the users table.

Setup Steps:

1. Database: Publish and run the migration: php artisan vendor:publish --tag="filament-edit-profile-custom-field-migration" followed by php artisan migrate.
2. User Model: Add custom_fields to the $fillable array and cast it to array in the casts() method.
3. Configuration: Publish the config file: php artisan vendor:publish --tag="filament-edit-profile-config".
4. Define Fields: Edit config/filament-edit-profile.php to set 'show_custom_fields' => true and define your fields in the 'custom_fields' array.

php artisan vendor:publish --tag="filament-edit-profile-custom-field-migration"
php artisan migrate
php artisan vendor:publish --tag="filament-edit-profile-config"

// User Model
protected $fillable = [
    'name',
    'email',
    'password',
    'custom_fields',
];

protected function casts(): array
{
    return [
        'email_verified_at' => 'datetime',
        'password' => 'hashed',
        'custom_fields' => 'array'
    ];
}